对账
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>报表接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li>` <a href="http://api-test.boka.vc/analytic/business/reconciliation/bill">http://api-test.boka.vc/analytic/business/reconciliation/bill</a></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">compIds</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">List</td>
<td>门店id集合</td>
</tr>
<tr>
<td style="text-align: left;">startDate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>开始日期 <strong>yyyy-MM-dd</strong></td>
</tr>
<tr>
<td style="text-align: left;">endDate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>结束日期 <strong>yyyy-MM-dd</strong></td>
</tr>
<tr>
<td style="text-align: left;">fromDate</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>创建日期-开始日期 <strong>yyyy-MM-dd</strong> 包含两种日期时区分使用（例：账务+创建日期）</td>
</tr>
<tr>
<td style="text-align: left;">toDate</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>创建日期-结束日期 <strong>yyyy-MM-dd</strong> 包含两种日期时区分使用（例：账务+创建日期）</td>
</tr>
<tr>
<td style="text-align: left;">billTypeList</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List</td>
<td>单据类型，全部不传，0:卖卡 1:换购 2:收银 3:还款 4:退款 5:转卡 6:升级</td>
</tr>
<tr>
<td style="text-align: left;">categoryList</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List</td>
<td>支付类别，全部不传，cash:现金 rights:权益 free:免单 debt:欠款 voucher: 抵用</td>
</tr>
<tr>
<td style="text-align: left;">paymentList</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List</td>
<td>选择支付，全部不传，取常用资料“支付方式”的code</td>
</tr>
<tr>
<td style="text-align: left;">rangeList</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">List</td>
<td>消费内容，project:项目 product:产品 rights:权益</td>
</tr>
<tr>
<td style="text-align: left;">rightsTypeList</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List</td>
<td>权益类型，全部不传，4:品项 5:套餐 6:储值 7:资格 8:抵扣券 9:组合</td>
</tr>
<tr>
<td style="text-align: left;">rightsList</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List</td>
<td>权益code，全部不传，取指定权益类别对应权益资料的code</td>
</tr>
<tr>
<td style="text-align: left;">purchaseStatus</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Integer</td>
<td>购买类型，全部不传，0首购 1复购</td>
</tr>
<tr>
<td style="text-align: left;">prjCategoryList</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List</td>
<td>项目统计分类，全部不传，取常用资料“项目统计类别”的code</td>
</tr>
<tr>
<td style="text-align: left;">prjCodeList</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List</td>
<td>选择项目，全部不传，取项目资料的code</td>
</tr>
<tr>
<td style="text-align: left;">prdCategoryList</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List</td>
<td>产品统计分类，全部不传，取常用资料“产品统计类别”的code</td>
</tr>
<tr>
<td style="text-align: left;">prdCodeList</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List</td>
<td>选择产品，全部不传，取产品资料的code</td>
</tr>
<tr>
<td style="text-align: left;">exist</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Integer</td>
<td>单据员工，0：全部 1：单据员工 2：无单据员工</td>
</tr>
<tr>
<td style="text-align: left;">employeeList</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List</td>
<td>单据员工，全部不传，取员工资料的code</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Integer</td>
<td>复核状态，0：全部 1：已核对 2：未核对</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Integer</td>
<td>签字状态，0：全部 1：已签字 2：未签字</td>
</tr>
<tr>
<td style="text-align: left;">keyword</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>单据编号</td>
</tr>
<tr>
<td style="text-align: left;">memberList</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List</td>
<td>选择客户，全部不传，取会员资料的id</td>
</tr>
<tr>
<td style="text-align: left;">channelList</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List</td>
<td>进店渠道，全部不传，取常用资料“进店渠道”的code</td>
</tr>
<tr>
<td style="text-align: left;">sourceList</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List</td>
<td>单据来源，全部不传，详见“sourceList说明”</td>
</tr>
<tr>
<td style="text-align: left;">departmentList</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List</td>
<td>营业归属，全部不传，取常用资料“部门管理”的code</td>
</tr>
<tr>
<td style="text-align: left;">createUsers</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">List</td>
<td>操作人，全部不传，取“账号管理”的工号</td>
</tr>
<tr>
<td style="text-align: left;">sort</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>排序方式，详见“sort说明”</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">Integer</td>
<td>单据计算，0：全部 1：手动输入 2：系统计算</td>
</tr>
<tr>
<td style="text-align: left;">pageNum</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Int</td>
<td>页码</td>
</tr>
<tr>
<td style="text-align: left;">pageSize</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Int</td>
<td>分页大小</td>
</tr>
</tbody>
</table>
<p>sourceList说明</p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数值</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">back</td>
<td style="text-align: left;">美容网页/平板端</td>
</tr>
<tr>
<td style="text-align: left;">staff</td>
<td style="text-align: left;">美容店员端</td>
</tr>
<tr>
<td style="text-align: left;">manager</td>
<td style="text-align: left;">美容管理端</td>
</tr>
<tr>
<td style="text-align: left;">secretary</td>
<td style="text-align: left;">小秘书</td>
</tr>
<tr>
<td style="text-align: left;">client</td>
<td style="text-align: left;">智慧美业预约小程序</td>
</tr>
<tr>
<td style="text-align: left;">market</td>
<td style="text-align: left;">营销平台小程序</td>
</tr>
<tr>
<td style="text-align: left;">memberShip</td>
<td style="text-align: left;">会员通小程序</td>
</tr>
<tr>
<td style="text-align: left;">boss</td>
<td style="text-align: left;">博卡老板端</td>
</tr>
<tr>
<td style="text-align: left;">cashier</td>
<td style="text-align: left;">博卡收银端</td>
</tr>
</tbody>
</table>
<p>sort说明</p>
<table>
<thead>
<tr>
<th style="text-align: left;">排序</th>
<th style="text-align: left;">正序</th>
<th>倒序</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">账务日期</td>
<td style="text-align: left;">billingDate:asc</td>
<td>billingDate:desc</td>
</tr>
<tr>
<td style="text-align: left;">创建日期</td>
<td style="text-align: left;">createTime:asc</td>
<td>createTime:desc</td>
</tr>
<tr>
<td style="text-align: left;">单据编号</td>
<td style="text-align: left;">no:asc</td>
<td>no:desc</td>
</tr>
<tr>
<td style="text-align: left;">客户姓名</td>
<td style="text-align: left;">member:asc</td>
<td>member:desc</td>
</tr>
</tbody>
</table>
<h5>参数示例</h5>
<pre><code>{
&quot;compIds&quot;: [&quot;5d6494c5033f9f3274eb991a&quot;],
&quot;startDate&quot;: &quot;2024-12-01&quot;,
&quot;endDate&quot;: &quot;2024-12-31&quot;,
&quot;fromDate&quot;: &quot;2024-12-01 00:00:00&quot;,
&quot;toDate&quot;: &quot;2024-12-31 23:59:59&quot;,
&quot;billTypeList&quot;: [0, 2],
&quot;categoryList&quot;: [&quot;cash&quot;, &quot;rights&quot;, &quot;free&quot;, &quot;debt&quot;, &quot;voucher&quot;],
&quot;paymentList&quot;: [&quot;cash&quot;, &quot;store&quot;, &quot;item&quot;, &quot;innerTransfer&quot;,&quot;cashVoucher&quot;],
&quot;rangeList&quot;: [&quot;project&quot;, &quot;product&quot;, &quot;rights&quot;],
&quot;rightsTypeList&quot;: [4, 5, 6, 7, 8, 9],
&quot;rightsList&quot;: [&quot;2024102415545835019306&quot;, &quot;2024101216022402293062&quot;, &quot;2024102211082737347822&quot;, &quot;2024080215032196588964&quot;, &quot;2024080215095406460546&quot;, &quot;2024080215271580168662&quot;],
&quot;purchaseStatus&quot;: 1,
&quot;prjCategoryList&quot;: [&quot;2024070918051026178005&quot;, &quot;2024081316330491020751&quot;, &quot;2024081316331100703798&quot;],
&quot;prjCodeList&quot;: [&quot;002&quot;, &quot;0024&quot;, &quot;003&quot;],
&quot;prdCategoryList&quot;: [&quot;2024070918052596214545&quot;, &quot;2024081614392924596341&quot;, &quot;2024081614393934880515&quot;, &quot;2024081614394764682713&quot;],
&quot;prdCodeList&quot;: [&quot;2022062819150683472012&quot;, &quot;2022062915543107228007&quot;, &quot;2024101013581836156982&quot;],
&quot;exist&quot;: 2,
&quot;employeeList&quot;: [&quot;6699df39e4b081f9d9d13fb3&quot;, &quot;668f4f85e4b041cafe108f36&quot;, &quot;66ce8c21e4b0bd4a59dfeecf&quot;, &quot;669a12cbe4b04c53b8d6a295&quot;, &quot;672ac242e4b0ac6ce4db79c4&quot;],
&quot;status&quot;: 0,
&quot;sign&quot;: 0,
&quot;keyword&quot;: &quot;SY0012412&quot;,
&quot;memberList&quot;: [&quot;65de903df29cd2412f379ca1&quot;, &quot;669889270419587072&quot;],
&quot;channelList&quot;: [&quot;visitor&quot;, &quot;miniApp&quot;],
&quot;sourceList&quot;: [&quot;back&quot;, &quot;staff&quot;],
&quot;departmentList&quot;: [&quot;2024070917533913882117&quot;, &quot;2024111917371344300615&quot;],
&quot;createUsers&quot;: [&quot;ADMIN&quot;, &quot;MRADMIN&quot;],
&quot;sort&quot;: &quot;createTime:desc&quot;,
&quot;type&quot;: 0,
&quot;pageNum&quot;: 1,
&quot;pageSize&quot;: 100
}</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">billId</td>
<td style="text-align: left;">String</td>
<td>单据id</td>
</tr>
<tr>
<td style="text-align: left;">billType</td>
<td style="text-align: left;">Integer</td>
<td>单据类别</td>
</tr>
<tr>
<td style="text-align: left;">memberId</td>
<td style="text-align: left;">String</td>
<td>会员id</td>
</tr>
<tr>
<td style="text-align: left;">memberName</td>
<td style="text-align: left;">String</td>
<td>会员姓名（散客同字段）</td>
</tr>
<tr>
<td style="text-align: left;">channelCode</td>
<td style="text-align: left;">String</td>
<td>进店渠道编号</td>
</tr>
<tr>
<td style="text-align: left;">channelName</td>
<td style="text-align: left;">String</td>
<td>进店渠道名称</td>
</tr>
<tr>
<td style="text-align: left;">no</td>
<td style="text-align: left;">String</td>
<td>单号</td>
</tr>
<tr>
<td style="text-align: left;">billingDate</td>
<td style="text-align: left;">Date</td>
<td>账务日期</td>
</tr>
<tr>
<td style="text-align: left;">createTime</td>
<td style="text-align: left;">Date</td>
<td>创建日期</td>
</tr>
<tr>
<td style="text-align: left;">createTime</td>
<td style="text-align: left;">Date</td>
<td>创建日期</td>
</tr>
<tr>
<td style="text-align: left;">customerSign</td>
<td style="text-align: left;">String</td>
<td>客户签名</td>
</tr>
<tr>
<td style="text-align: left;">reviewStatus</td>
<td style="text-align: left;">Integer</td>
<td>复核状态;0未复核 1已复核</td>
</tr>
<tr>
<td style="text-align: left;">details</td>
<td style="text-align: left;">List</td>
<td>单据明细</td>
</tr>
</tbody>
</table>
<p>details说明</p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">goodsType</td>
<td style="text-align: left;">Integer</td>
<td>商品（消费明细）类别</td>
</tr>
<tr>
<td style="text-align: left;">goodsCode</td>
<td style="text-align: left;">String</td>
<td>商品编号</td>
</tr>
<tr>
<td style="text-align: left;">goodsName</td>
<td style="text-align: left;">String</td>
<td>商品名称</td>
</tr>
<tr>
<td style="text-align: left;">times</td>
<td style="text-align: left;">float</td>
<td>数量</td>
</tr>
<tr>
<td style="text-align: left;">totalAmount</td>
<td style="text-align: left;">float</td>
<td>单据总金额</td>
</tr>
<tr>
<td style="text-align: left;">paymentList</td>
<td style="text-align: left;">List</td>
<td>支付方式集合</td>
</tr>
<tr>
<td style="text-align: left;">employeeList</td>
<td style="text-align: left;">List</td>
<td>销售/服务员工集合</td>
</tr>
</tbody>
</table>
<p>paymentList说明</p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">payCode</td>
<td style="text-align: left;">String</td>
<td>支付编号</td>
</tr>
<tr>
<td style="text-align: left;">payName</td>
<td style="text-align: left;">String</td>
<td>支付名称</td>
</tr>
<tr>
<td style="text-align: left;">payAmount</td>
<td style="text-align: left;">float</td>
<td>支付金额</td>
</tr>
</tbody>
</table>
<p>employeeList说明</p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">staffCode</td>
<td style="text-align: left;">String</td>
<td>员工编号</td>
</tr>
<tr>
<td style="text-align: left;">staffName</td>
<td style="text-align: left;">String</td>
<td>员工姓名</td>
</tr>
<tr>
<td style="text-align: left;">performance</td>
<td style="text-align: left;">float</td>
<td>业绩</td>
</tr>
<tr>
<td style="text-align: left;">commission</td>
<td style="text-align: left;">float</td>
<td>提成</td>
</tr>
</tbody>
</table>
<h5>汇总-返回示例</h5>
<pre><code>{
&quot;code&quot;: 200,
&quot;result&quot;: {
&quot;hasNextPage&quot;: true,
&quot;hasPreviousPage&quot;: false,
&quot;isFirstPage&quot;: true,
&quot;isLastPage&quot;: false,
&quot;list&quot;: [
{
&quot;billId&quot;: &quot;669695580258172928&quot;,
&quot;billType&quot;: 0,
&quot;billingDate&quot;: 1731859200000,
&quot;channelCode&quot;: &quot;miniApp&quot;,
&quot;channelName&quot;: &quot;小程序&quot;,
&quot;createTime&quot;: 1731892907000,
&quot;custId&quot;: &quot;MRCS&quot;,
&quot;details&quot;: [
{
&quot;amount&quot;: 1000.0,
&quot;employeeList&quot;: [
{
&quot;billId&quot;: &quot;669695580258172928&quot;,
&quot;billType&quot;: 0,
&quot;billingDate&quot;: 1731859200000,
&quot;compId&quot;: &quot;5d6494c5033f9f3274eb991a&quot;,
&quot;custId&quot;: &quot;MRCS&quot;,
&quot;departmentCode&quot;: &quot;2024070917533913882117&quot;,
&quot;departmentName&quot;: &quot;美容部&quot;,
&quot;id&quot;: &quot;669695582405656579&quot;,
&quot;isDelete&quot;: 0,
&quot;staffCode&quot;: &quot;00020&quot;,
&quot;staffId&quot;: &quot;67074a22e4b09873dab1f57b&quot;,
&quot;staffName&quot;: &quot;产品_2410100&quot;
}
],
&quot;goodsCode&quot;: &quot;2024091214164436199616&quot;,
&quot;goodsName&quot;: &quot;导入001&quot;,
&quot;goodsType&quot;: 6,
&quot;paymentList&quot;: [
{
&quot;amount&quot;: 1000,
&quot;billGoodsId&quot;: &quot;669695582405656576&quot;,
&quot;billGoodsType&quot;: 6,
&quot;billId&quot;: &quot;669695580258172928&quot;,
&quot;billType&quot;: 0,
&quot;billingDate&quot;: 1731859200000,
&quot;compId&quot;: &quot;5d6494c5033f9f3274eb991a&quot;,
&quot;custId&quot;: &quot;MRCS&quot;,
&quot;id&quot;: &quot;669695582405656578&quot;,
&quot;isDelete&quot;: 0,
&quot;memberId&quot;: &quot;654709286152437760&quot;,
&quot;payAmount&quot;: 1000,
&quot;payCategoryCode&quot;: &quot;cash&quot;,
&quot;payCode&quot;: &quot;cash&quot;,
&quot;payName&quot;: &quot;现金&quot;,
&quot;payPercent&quot;: 1
}
],
&quot;times&quot;: 1.0,
&quot;totalAmount&quot;: &quot;1000.0&quot;
}
],
&quot;memberId&quot;: &quot;654709286152437760&quot;,
&quot;memberName&quot;: &quot;王振&quot;,
&quot;no&quot;: &quot;MK001241118001&quot;,
&quot;totalAmount&quot;: &quot;1000.00000&quot;
}
],
&quot;nextPage&quot;: 2,
&quot;pageNum&quot;: 1,
&quot;pageSize&quot;: 20,
&quot;pages&quot;: 8,
&quot;prePage&quot;: 1,
&quot;size&quot;: 0,
&quot;total&quot;: 158
},
&quot;success&quot;: true
}</code></pre>
<h5>备注</h5>
<ul>
<li>无</li>
</ul>