新增代理商
<p><strong>简要描述：</strong> </p>
<ul>
<li>新增代理商接口</li>
</ul>
<p>作者 ：夏杨</p>
<p><strong>请求URL：</strong> </p>
<ul>
<li><code>/api-agent/agent/addAgent</code></li>
</ul>
<p><strong>请求方式：</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>Content-type：</strong></p>
<ul>
<li>Application/json</li>
</ul>
<p><strong>参数：</strong> </p>
<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;">agentName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>代理商名称</td>
</tr>
<tr>
<td style="text-align: left;">businessLicenseNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>营业执照号</td>
</tr>
<tr>
<td style="text-align: left;">province</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>省</td>
</tr>
<tr>
<td style="text-align: left;">city</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>市</td>
</tr>
<tr>
<td style="text-align: left;">area</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>区</td>
</tr>
<tr>
<td style="text-align: left;">address</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>详细地址</td>
</tr>
<tr>
<td style="text-align: left;">legalPersonName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>法人姓名</td>
</tr>
<tr>
<td style="text-align: left;">legalPersonIdCard</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>法人身份证号码</td>
</tr>
<tr>
<td style="text-align: left;">contactName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>联系人名称</td>
</tr>
<tr>
<td style="text-align: left;">contactMobile</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>联系人手机号</td>
</tr>
<tr>
<td style="text-align: left;">accountName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>账户名</td>
</tr>
<tr>
<td style="text-align: left;">accountNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>帐号</td>
</tr>
<tr>
<td style="text-align: left;">bankDeposit</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>开户行</td>
</tr>
<tr>
<td style="text-align: left;">businessLicenseUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>营业执照</td>
</tr>
<tr>
<td style="text-align: left;">accountPermitUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>开户证明</td>
</tr>
<tr>
<td style="text-align: left;">legalPersonCardFrontUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>身份证正面</td>
</tr>
<tr>
<td style="text-align: left;">legalPersonCardReverseUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>身份证反面</td>
</tr>
<tr>
<td style="text-align: left;">managerName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户经理姓名</td>
</tr>
<tr>
<td style="text-align: left;">managerMobile</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户经理手机号码</td>
</tr>
<tr>
<td style="text-align: left;">agentCashierDesks</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">List<AgentCashierDesk></td>
<td>收银台信息</td>
</tr>
<tr>
<td style="text-align: left;">cashierDeskType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>收银台类型</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>APPID</td>
</tr>
<tr>
<td style="text-align: left;">alipayId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>支付宝PID</td>
</tr>
<tr>
<td style="text-align: left;">noticeAddress</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>通知地址</td>
</tr>
<tr>
<td style="text-align: left;">agentPayProducts</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">List<AgentPayProduct></td>
<td>支付产品信息</td>
</tr>
<tr>
<td style="text-align: left;">productId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>产品ID</td>
</tr>
<tr>
<td style="text-align: left;">productNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>产品编号</td>
</tr>
<tr>
<td style="text-align: left;">cashierDeskType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>收银台类型</td>
</tr>
<tr>
<td style="text-align: left;">openStatus</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>是否开通</td>
</tr>
<tr>
<td style="text-align: left;">payProductRate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>费率</td>
</tr>
<tr>
<td style="text-align: left;">agentAreaCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Integer</td>
<td>代理区域编码</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<pre><code>{
"msg": "新增代理商信息成功!",
"data": null,
"code": "200"
}</code></pre>
<p><strong>返回参数说明</strong> </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;">code</td>
<td style="text-align: left;">int</td>
<td>返回码</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">String</td>
<td>消息</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">Object</td>
<td>返回数据</td>
</tr>
</tbody>
</table>
<p><strong>返回码说明</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">返回码</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">200</td>
<td>成功</td>
</tr>
<tr>
<td style="text-align: left;">500</td>
<td>失败</td>
</tr>
<tr>
<td style="text-align: left;">400</td>
<td>系统异常</td>
</tr>
<tr>
<td style="text-align: left;">300</td>
<td>统一的参数异常（具体内容以返回结果为准）</td>
</tr>
<tr>
<td style="text-align: left;">50001</td>
<td>超级管理员不允许创建代理商</td>
</tr>
<tr>
<td style="text-align: left;">50002</td>
<td>联系人手机号码已存在</td>
</tr>
</tbody>
</table>
<p><strong>参数示例</strong> </p>
<pre><code>{
"agentName":"测试代理商",
"businessLicenseNo":"营业执照编号001",
"province":1,
"city":1,
"area":1,
"address":"代理商测试详细地址",
"legalPersonName":"夏杨",
"legalPersonIdCard":"430623199011162418",
"contactName":"夏杨",
"contactMobile":"15973143345",
"accountName":"夏杨",
"accountNo":"630072007100080185",
"bankDeposit":"中国银行长沙市麓谷支行",
"businessLicenseUrl":"营业执照URL",
"accountPermitUrl":"开户许可URL",
"legalPersonCardFrontUrl":"身份证正面URL",
"legalPersonCardReverseUrl":"身份证反面URL",
"managerName":"夏杨",
"managerMobile":"15973143344",
"agentCashierDesks":[
{
"cashierDeskType":1,
"appId":"wx123456",
"alipayId":"ali123456",
"noticeAddress":"www.baidu.com"
},
{
"cashierDeskType":2
}
],
"agentPayProducts":[
{
"productId":1,
"productNo":"WECHAT_SCAN",
"cashierDeskType":1,
"openStatus":1,
"payProductRate":"0.11"
},
{
"productId":2,
"productNo":"WECHAT_GZH",
"cashierDeskType":1,
"openStatus":1,
"payProductRate":"0.12"
},
{
"productId":3,
"productNo":"ALIPAY_SCAN",
"cashierDeskType":1,
"openStatus":1,
"payProductRate":"0.13"
}
]
}</code></pre>
<p><strong>备注</strong> </p>
<ul>
<li>具体的的返回码、消息、返回数据，以具体的返回结果为准</li>
</ul>