湖北电子渠道BOSS

湖北电子渠道BOSS


代理商保证金扣减和退还接口

<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保证金&amp;押金缴纳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>

页面列表

ITEM_HTML