OMS接口文档

OMS接口文档


收款单导入

<p><strong>简要描述:</strong> </p> <ul> <li>收款单导入 (一张收款单由一个表头和一个表体组成)</li> </ul> <p><strong>请求URL:</strong> </p> <ul> <li><code>http://localhost:8080/api/billoperation/apiaction?token=12345678</code></li> </ul> <p><strong>请求方式:</strong></p> <ul> <li>POST </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;">billnum</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>单据编码 ec_collectionbill</td> </tr> <tr> <td style="text-align: left;">action</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>操作类型 importCollectionBill</td> </tr> <tr> <td style="text-align: left;">externalData</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>导入数据</td> </tr> </tbody> </table> <p><strong>导入数据详情(externalData详细信息):</strong> <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;">billCode</td> <td style="text-align: left;">单据编号</td> <td style="text-align: left;">String</td> <td>是</td> </tr> <tr> <td style="text-align: left;">billDate</td> <td style="text-align: left;">单据日期</td> <td style="text-align: left;">DateTime</td> <td>是</td> </tr> <tr> <td style="text-align: left;">customer</td> <td style="text-align: left;">客户(YS不传)</td> <td style="text-align: left;">String</td> <td>否</td> </tr> <tr> <td style="text-align: left;">currency</td> <td style="text-align: left;">币种</td> <td style="text-align: left;">String</td> <td>是</td> </tr> <tr> <td style="text-align: left;">tid</td> <td style="text-align: left;">交易编号</td> <td style="text-align: left;">String</td> <td>是</td> </tr> <tr> <td style="text-align: left;">fee</td> <td style="text-align: left;">金额</td> <td style="text-align: left;">Decimal</td> <td>是</td> </tr> <tr> <td style="text-align: left;">accountFee</td> <td style="text-align: left;">应收款</td> <td style="text-align: left;">Decimal</td> <td>是</td> </tr> <tr> <td style="text-align: left;">prepaymentFee</td> <td style="text-align: left;">预收款</td> <td style="text-align: left;">Decimal</td> <td>是</td> </tr> <tr> <td style="text-align: left;">otherFee</td> <td style="text-align: left;">其他费用</td> <td style="text-align: left;">Decimal</td> <td>是</td> </tr> <tr> <td style="text-align: left;">inputPerson</td> <td style="text-align: left;">录入人</td> <td style="text-align: left;">String</td> <td>否</td> </tr> <tr> <td style="text-align: left;">daliyNum</td> <td style="text-align: left;">收款日报号</td> <td style="text-align: left;">String</td> <td>否</td> </tr> <tr> <td style="text-align: left;">bdaliy</td> <td style="text-align: left;">是否收款日结</td> <td style="text-align: left;">Short</td> <td>否</td> </tr> <tr> <td style="text-align: left;">desc</td> <td style="text-align: left;">退款说明</td> <td style="text-align: left;">String</td> <td>否</td> </tr> <tr> <td style="text-align: left;">daliytime</td> <td style="text-align: left;">收款日结时间</td> <td style="text-align: left;">DateTime</td> <td>否</td> </tr> <tr> <td style="text-align: left;">daliyid</td> <td style="text-align: left;">收款日报id</td> <td style="text-align: left;">Long</td> <td>否</td> </tr> <tr> <td style="text-align: left;">daliyoperater</td> <td style="text-align: left;">销售日报单号</td> <td style="text-align: left;">String</td> <td>否</td> </tr> <tr> <td style="text-align: left;">shop_id</td> <td style="text-align: left;">店铺ID</td> <td style="text-align: left;">Long</td> <td>是</td> </tr> <tr> <td style="text-align: left;">ys_customer</td> <td style="text-align: left;">YS客户ID</td> <td style="text-align: left;">Long</td> <td>否</td> </tr> <tr> <td style="text-align: left;">collectionBillDetail</td> <td style="text-align: left;">收款单表体List</td> <td style="text-align: left;">List</td> <td>是</td> </tr> </tbody> </table> <p><strong>表体(collectionBillDetail)</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;">fundproperties</td> <td style="text-align: left;">款项性质(枚举:0-其他费用,1-预收款,2-应收款)</td> <td style="text-align: left;">Short</td> <td>是</td> </tr> <tr> <td style="text-align: left;">fee</td> <td style="text-align: left;">金额</td> <td style="text-align: left;">Decimal</td> <td>是</td> </tr> <tr> <td style="text-align: left;">costitem</td> <td style="text-align: left;">费用项目ID(款项性质为“应收款”的收款单行,费用项目不传)</td> <td style="text-align: left;">Long</td> <td>是</td> </tr> </tbody> </table> <p><strong>请求示例</strong></p> <pre><code> { "billnum": "ec_collectionbill", "action": "importCollectionBill", "externalData": "[{\"billCode\":\"SKD2020061700001239\",\"billDate\":\"2019-07-14 00:00:00\",\"currency\":\"CNY\",\"tid\":\"292021743163352606\",\"fee\":1.00000000,\"accountFee\":72.23000000,\"otherFee\":72.23000000,\"prepaymentFee\":32.23000000,\"inputPerson\":\"张嘎\",\"daliyNum\":\"SKRB1231231243\",\"bdaliy\":1,\"desc\":\"这是原因\",\"daliytime\":\"2019-07-14 00:00:00\",\"daliyid\":\"292021743166352606\",\"daliyoperater\":\"XSRB2020061500323231\",\"shop_id\":\"292021743166352606\",\"ys_customer\":292021743166352606,\"collectionBillDetail\":[{\"fundproperties\":1,\"fee\":1.00000000,\"costitem\":\"292021743166352606\"}]}]" }</code></pre> <p><strong>返回示例</strong></p> <pre><code>{ "code": 200, "message": "导入成功1单" }</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;">string</td> <td>200:成功;其他:失败</td> </tr> <tr> <td style="text-align: left;">message</td> <td style="text-align: left;">string</td> <td>错误消息</td> </tr> </tbody> </table> <p><strong>备注</strong> </p> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML