账单导入
<p><strong>使用场景:</strong> </p>
<ul>
<li>通过接口导入账单,员工可通过通企付企业服务助手查询账单并分享账单码牌用于收款</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>pay/billImport</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>请求类型:</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;">orgId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string(30)</td>
<td>服务商id,用于服务商模式,传了此参数需要用服务商秘钥进行验签</td>
</tr>
<tr>
<td style="text-align: left;">mchNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(30)</td>
<td>商户号</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(24)</td>
<td>应用ID,默认为商户appId,若为服务商模式,需传入服务商appId</td>
</tr>
<tr>
<td style="text-align: left;">reqTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(13)</td>
<td>请求时间,13位时间戳</td>
</tr>
<tr>
<td style="text-align: left;">version</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(3)</td>
<td>接口版本,固定:1.0</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>签名</td>
</tr>
<tr>
<td style="text-align: left;">signType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(10)</td>
<td>签名类型,MD5/RSA/SM2</td>
</tr>
<tr>
<td style="text-align: left;">termNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td>收款模板编号</td>
</tr>
<tr>
<td style="text-align: left;">billsInfo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>账单信息(最大1000笔),为JSONArray字符串</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">billsInfo参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(20)</td>
<td>账单金额(单位:元)</td>
</tr>
<tr>
<td style="text-align: left;">billEffTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(20)</td>
<td>账单生效时间<br>yyyy-mm-dd HH:mm:ss</td>
</tr>
<tr>
<td style="text-align: left;">billExpTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(20)</td>
<td>账单失效时间<br>yyyy-mm-dd HH:mm:ss</td>
</tr>
<tr>
<td style="text-align: left;">payeePhone</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(11)</td>
<td>业务员手机号</td>
</tr>
<tr>
<td style="text-align: left;">field1</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(255)</td>
<td>模板自定义字段1</td>
</tr>
<tr>
<td style="text-align: left;">field2</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(255)</td>
<td>模板自定义字段2</td>
</tr>
<tr>
<td style="text-align: left;">field3</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(255)</td>
<td>模板自定义字段3</td>
</tr>
<tr>
<td style="text-align: left;">field4</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(255)</td>
<td>模板自定义字段4</td>
</tr>
<tr>
<td style="text-align: left;">field5</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(255)</td>
<td>模板自定义字段5</td>
</tr>
</tbody>
</table>
<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;">code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>返回状态:0-处理成功,9999-异常,具体错误详见msg字段</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>返回信息:具体错误原因,例如:签名失败、参数格式校验错误</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>签名信息:对data内数据签名,如data为空则不返回</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>返回数据:json格式数据</td>
</tr>
</tbody>
</table>
<p><strong>data数据格式</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;">importBatch</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(30)</td>
<td>导入批次号</td>
</tr>
<tr>
<td style="text-align: left;">billsInfo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>账单信息(账单校验异常时返回)</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">billsInfo参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(20)</td>
<td>账单金额(单位:元)</td>
</tr>
<tr>
<td style="text-align: left;">billEffTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(20)</td>
<td>账单生效时间<br>yyyy-mm-dd HH:mm:ss</td>
</tr>
<tr>
<td style="text-align: left;">billExpTime</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(20)</td>
<td>账单失效时间<br>yyyy-mm-dd HH:mm:ss</td>
</tr>
<tr>
<td style="text-align: left;">payeePhone</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(11)</td>
<td>业务员手机号</td>
</tr>
<tr>
<td style="text-align: left;">field1</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(255)</td>
<td>模板自定义字段1</td>
</tr>
<tr>
<td style="text-align: left;">field2</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(255)</td>
<td>模板自定义字段2</td>
</tr>
<tr>
<td style="text-align: left;">field3</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(255)</td>
<td>模板自定义字段3</td>
</tr>
<tr>
<td style="text-align: left;">field4</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(255)</td>
<td>模板自定义字段4</td>
</tr>
<tr>
<td style="text-align: left;">field5</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(255)</td>
<td>模板自定义字段5</td>
</tr>
<tr>
<td style="text-align: left;">failMsg</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(255)</td>
<td>账单校验异常原因</td>
</tr>
</tbody>
</table>