代理商保证金扣减和退还接口
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>代理商保证金扣减和退还接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>https://wbhtest.hrtn.net/digit/agent/margin/prv-margin-log/deductOrRefundAgentMargin</code></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;">agentCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>代理商编码</td>
</tr>
<tr>
<td style="text-align: left;">marginType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">long</td>
<td>保证金账户类型 0:预存款账户 1:代收费保证金账户 2:商誉保证金账户 3:设备保证金账户 4:其他保证金账户 对应值参见字典表:MarginAcountType</td>
</tr>
<tr>
<td style="text-align: left;">bossOperatorId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>BOSS操作员ID</td>
</tr>
<tr>
<td style="text-align: left;">bossOperatorChinese</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>BOSS操作员中文</td>
</tr>
<tr>
<td style="text-align: left;">bossOperatorDepartmentId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>BOSS操作部门ID</td>
</tr>
<tr>
<td style="text-align: left;">bossOperatorDepartmentChinese</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>BOSS操作部门中文</td>
</tr>
<tr>
<td style="text-align: left;">list</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>多笔保证金扣除或退还操作</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">list列表参数说明-参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">acountConsume</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">BigDecimal</td>
<td>操作金额(正数代表增加业务回退,退还保证金;负数代表业务收费,扣减保证金)</td>
</tr>
<tr>
<td style="text-align: left;">bossSerialNumber</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>BOSS业务流水号</td>
</tr>
<tr>
<td style="text-align: left;">bossOperateTypeCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>BOSS操作类型编码</td>
</tr>
<tr>
<td style="text-align: left;">bossOperateTypeChinese</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>BOSS操作类型中文</td>
</tr>
</tbody>
</table>
<p>|bossCutOffTime |是 |string | BOSS业务结算时间 |</p>
<h5>返回示例</h5>
<pre><code>{
"success": true,
"retCode": "0",
"retMsg": "成功",
"retData": {
"id": 1,
"marginCode": null,
"agentCode": "9ed95d81ac504eee965d3412e12eba77",
"marginType": 1,
"enable": null,
"marginBalance": 400.00,
"createTime": null,
"updateTime": "2022-08-02 11:38:29",
"mctName": "建1",
"agent": "02",
"creditCodes": null,
"channelType": null,
"channelScenario": null,
"headName": null,
"headPhone": null,
"businessUrl": null,
"status": 2,
"channelMode": 1,
"availableBalance": 400.00,
"chargeSyncStatus": 1
}
}
}</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;">chargeSyncStatus</td>
<td style="text-align: left;">int</td>
<td>BOSS收费状态标识 0:失败 1:成功</td>
</tr>
<tr>
<td style="text-align: left;">agentCode</td>
<td style="text-align: left;">string</td>
<td>代理商编码</td>
</tr>
<tr>
<td style="text-align: left;">mctName</td>
<td style="text-align: left;">string</td>
<td>主体名称</td>
</tr>
<tr>
<td style="text-align: left;">agent</td>
<td style="text-align: left;">string</td>
<td>主体类型 00个体工商户 01企业 02事业单位 03个人</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">int</td>
<td>代理商状态0合同待签约1保证金&押金缴纳2业务授权</td>
</tr>
<tr>
<td style="text-align: left;">marginBalance</td>
<td style="text-align: left;">BigDecimal</td>
<td>保证金余额</td>
</tr>
<tr>
<td style="text-align: left;">availableBalance</td>
<td style="text-align: left;">BigDecimal</td>
<td>保证金可用余额</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>