POS门店采购退货单数据接口

POS门店采购退货单数据接口


前端POS保存门店采购退货单接口

<p>[TOC]</p> <ul> <li><a href="https://www.showdoc.com.cn/PosPurRetApplyApiService/11558529458965884">文档维护</a></li> </ul> <h5>简要描述</h5> <ul> <li>前端POS保存门店采购退货单接口</li> </ul> <h5>请求 URL</h5> <ul> <li><code>http://xx.com/ierp/kapi/v2/xcsy_pos/PosPurRetApplyApiService/savePurRetApply</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST</li> </ul> <h5>请求示例</h5> <pre><code>{ &amp;quot;channelid&amp;quot;: &amp;quot;1453095343397809152&amp;quot;, &amp;quot;data&amp;quot;: { &amp;quot;billno&amp;quot;: &amp;quot;MDCGTHOrg-000222211240002&amp;quot;, &amp;quot;billstatus&amp;quot;: &amp;quot;B&amp;quot;, &amp;quot;billtype&amp;quot;: 1417536521019329536, &amp;quot;bizdate&amp;quot;: &amp;quot;2022-11-24 00:00:00&amp;quot;, &amp;quot;biztype&amp;quot;: 688847172015446016, &amp;quot;comment&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;createtime&amp;quot;: &amp;quot;2022-11-24 17:02:39&amp;quot;, &amp;quot;creator&amp;quot;: 1387805407904268288, &amp;quot;currency&amp;quot;: 1, &amp;quot;deliveraddress&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;entryentity&amp;quot;: [ { &amp;quot;amount&amp;quot;: 3.5398230088, &amp;quot;amountandtax&amp;quot;: 4.0000000000, &amp;quot;auxqty&amp;quot;: 0, &amp;quot;baseqty&amp;quot;: 2.0000000000, &amp;quot;baseunit&amp;quot;: 1397807644697168896, &amp;quot;curamount&amp;quot;: 0, &amp;quot;curamountandtax&amp;quot;: 0, &amp;quot;curtaxamount&amp;quot;: 0, &amp;quot;discountamount&amp;quot;: 0, &amp;quot;discountrate&amp;quot;: 0, &amp;quot;discounttype&amp;quot;: &amp;quot;NULL&amp;quot;, &amp;quot;entrycomment&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;entryinvorg&amp;quot;: 1392640574401553408, &amp;quot;entryreqorg&amp;quot;: 1392640574401553408, &amp;quot;entrysettleorg&amp;quot;: 1392640574401553408, &amp;quot;goodsid&amp;quot;: 1450698617168866304, &amp;quot;id&amp;quot;: 1560957219082611713, &amp;quot;invstatus&amp;quot;: 691928582720825344, &amp;quot;invtype&amp;quot;: 688884005529250816, &amp;quot;ispresent&amp;quot;: false, &amp;quot;joinbaseqty&amp;quot;: 0, &amp;quot;joinqty&amp;quot;: 0, &amp;quot;keeper&amp;quot;: 1392640574401553408, &amp;quot;keepertype&amp;quot;: &amp;quot;bos_org&amp;quot;, &amp;quot;linetype&amp;quot;: 1194150915045641216, &amp;quot;lotnumber&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;material&amp;quot;: 1450698638635314176, &amp;quot;outkeepertype&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;outownertype&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;owner&amp;quot;: 1392640574401553408, &amp;quot;ownertype&amp;quot;: &amp;quot;bos_org&amp;quot;, &amp;quot;price&amp;quot;: 1.7699115044, &amp;quot;priceandtax&amp;quot;: 2.0000000000, &amp;quot;qty&amp;quot;: 2.0000000000, &amp;quot;receivedate&amp;quot;: &amp;quot;2022-11-24 00:00:00&amp;quot;, &amp;quot;returnbaseqty&amp;quot;: 0, &amp;quot;returnqty&amp;quot;: 0, &amp;quot;rowclosestatus&amp;quot;: &amp;quot;A&amp;quot;, &amp;quot;rowterminatestatus&amp;quot;: &amp;quot;A&amp;quot;, &amp;quot;seq&amp;quot;: 1, &amp;quot;stock&amp;quot;: 1450780035806932992, &amp;quot;stockqty&amp;quot;: 2.0000000000, &amp;quot;stockunit&amp;quot;: 1397807644697168896, &amp;quot;supplierlot&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;supplyqty&amp;quot;: 2.0000000000, &amp;quot;taxamount&amp;quot;: 0.4601769912, &amp;quot;taxrate&amp;quot;: 13.0000000000, &amp;quot;taxrateid&amp;quot;: 1, &amp;quot;unit&amp;quot;: 1397807644697168896, &amp;quot;warehouse&amp;quot;: 1450784412236001280 } ], &amp;quot;exchangerate&amp;quot;: 0, &amp;quot;exratedate&amp;quot;: &amp;quot;2022-11-24 00:00:00&amp;quot;, &amp;quot;exratetable&amp;quot;: 1390615957327586304, &amp;quot;id&amp;quot;: 1560957219082612737, &amp;quot;invalidstatus&amp;quot;: &amp;quot;B&amp;quot;, &amp;quot;istax&amp;quot;: true, &amp;quot;modifier&amp;quot;: 1387805407904268288, &amp;quot;modifytime&amp;quot;: &amp;quot;2022-11-24 17:03:21&amp;quot;, &amp;quot;org&amp;quot;: 1392640574401553408, &amp;quot;paymode&amp;quot;: &amp;quot;CREDIT&amp;quot;, &amp;quot;purdept&amp;quot;: 1392640574401553408, &amp;quot;purorg&amp;quot;: 1392640574401553408, &amp;quot;refundtype&amp;quot;: &amp;quot;A&amp;quot;, &amp;quot;settleorg&amp;quot;: 1392640574401553408, &amp;quot;store&amp;quot;: 1450666889079435264, &amp;quot;supplier&amp;quot;: 1110082709432067072, &amp;quot;supplieraddress&amp;quot;: &amp;quot;&amp;quot;, &amp;quot;totalallamount&amp;quot;: 0, &amp;quot;totalamount&amp;quot;: 0, &amp;quot;totaltaxamount&amp;quot;: 0 }, &amp;quot;posid&amp;quot;: &amp;quot;1515806714258020352&amp;quot; }</code></pre> <h5>请求参数说明</h5> <h6>门店采购退货单(xcsy_purretapply)</h6> <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;">id</td> <td style="text-align: left;">long</td> <td>单据ID</td> </tr> <tr> <td style="text-align: left;">billno</td> <td style="text-align: left;">string</td> <td>单据编号</td> </tr> <tr> <td style="text-align: left;">billstatus</td> <td style="text-align: left;">string</td> <td>单据状态 暂存:A 已提交:B 已审核:C</td> </tr> <tr> <td style="text-align: left;">creator</td> <td style="text-align: left;">long</td> <td>创建人</td> </tr> <tr> <td style="text-align: left;">modifier</td> <td style="text-align: left;">long</td> <td>修改人</td> </tr> <tr> <td style="text-align: left;">auditor</td> <td style="text-align: left;">long</td> <td>审核人</td> </tr> <tr> <td style="text-align: left;">auditdate</td> <td style="text-align: left;">datetime</td> <td>审核日期</td> </tr> <tr> <td style="text-align: left;">modifytime</td> <td style="text-align: left;">datetime</td> <td>修改时间</td> </tr> <tr> <td style="text-align: left;">createtime</td> <td style="text-align: left;">datetime</td> <td>创建时间</td> </tr> <tr> <td style="text-align: left;">org</td> <td style="text-align: left;">long</td> <td>退货组织</td> </tr> <tr> <td style="text-align: left;">entryentity</td> <td style="text-align: left;">JSONARRAY</td> <td>商品明细</td> </tr> <tr> <td style="text-align: left;">contacter</td> <td style="text-align: left;">long</td> <td>联系人</td> </tr> <tr> <td style="text-align: left;">supplieraddress</td> <td style="text-align: left;">string</td> <td>供应商联系地址</td> </tr> <tr> <td style="text-align: left;">deliver</td> <td style="text-align: left;">long</td> <td>送货方</td> </tr> <tr> <td style="text-align: left;">delivercontacter</td> <td style="text-align: left;">long</td> <td>送货联系人</td> </tr> <tr> <td style="text-align: left;">deliveraddress</td> <td style="text-align: left;">string</td> <td>送货联系地址</td> </tr> <tr> <td style="text-align: left;">invoicesupplier</td> <td style="text-align: left;">long</td> <td>发票方</td> </tr> <tr> <td style="text-align: left;">receivesupplier</td> <td style="text-align: left;">long</td> <td>收款方</td> </tr> <tr> <td style="text-align: left;">deliveraddressid</td> <td style="text-align: left;">long</td> <td>送货联系地址</td> </tr> <tr> <td style="text-align: left;">supplieraddressid</td> <td style="text-align: left;">long</td> <td>供应商联系地址</td> </tr> <tr> <td style="text-align: left;">currency</td> <td style="text-align: left;">long</td> <td>本位币</td> </tr> <tr> <td style="text-align: left;">settlecurrency</td> <td style="text-align: left;">long</td> <td>结算币别</td> </tr> <tr> <td style="text-align: left;">exratetable</td> <td style="text-align: left;">long</td> <td>汇率表</td> </tr> <tr> <td style="text-align: left;">exratedate</td> <td style="text-align: left;">datetime</td> <td>汇率日期</td> </tr> <tr> <td style="text-align: left;">exchangerate</td> <td style="text-align: left;">decimal</td> <td>汇率</td> </tr> <tr> <td style="text-align: left;">paymode</td> <td style="text-align: left;">string</td> <td>付款方式 现购:CASH 赊购:CREDIT</td> </tr> <tr> <td style="text-align: left;">settletype</td> <td style="text-align: left;">long</td> <td>结算方式</td> </tr> <tr> <td style="text-align: left;">istax</td> <td style="text-align: left;">bool</td> <td>含税 是:true 否:false</td> </tr> <tr> <td style="text-align: left;">totaltaxamount</td> <td style="text-align: left;">decimal</td> <td>税额</td> </tr> <tr> <td style="text-align: left;">totalamount</td> <td style="text-align: left;">decimal</td> <td>金额</td> </tr> <tr> <td style="text-align: left;">totalallamount</td> <td style="text-align: left;">decimal</td> <td>价税合计</td> </tr> <tr> <td style="text-align: left;">settleorg</td> <td style="text-align: left;">long</td> <td>结算组织</td> </tr> <tr> <td style="text-align: left;">paycondition</td> <td style="text-align: left;">long</td> <td>付款条件</td> </tr> <tr> <td style="text-align: left;">store</td> <td style="text-align: left;">long</td> <td>申请门店</td> </tr> <tr> <td style="text-align: left;">purorg</td> <td style="text-align: left;">long</td> <td>采购组织</td> </tr> <tr> <td style="text-align: left;">purdept</td> <td style="text-align: left;">long</td> <td>采购部门</td> </tr> <tr> <td style="text-align: left;">purgroup</td> <td style="text-align: left;">long</td> <td>采购组</td> </tr> <tr> <td style="text-align: left;">buyer</td> <td style="text-align: left;">long</td> <td>采购员</td> </tr> <tr> <td style="text-align: left;">supplier</td> <td style="text-align: left;">long</td> <td>供应商</td> </tr> <tr> <td style="text-align: left;">biztype</td> <td style="text-align: left;">long</td> <td>业务类型</td> </tr> <tr> <td style="text-align: left;">bizdate</td> <td style="text-align: left;">datetime</td> <td>申请日期</td> </tr> <tr> <td style="text-align: left;">refundtype</td> <td style="text-align: left;">string</td> <td>退货类型 库存退货:A 检验退货:B</td> </tr> <tr> <td style="text-align: left;">comment</td> <td style="text-align: left;">string</td> <td>备注</td> </tr> <tr> <td style="text-align: left;">billtype</td> <td style="text-align: left;">long</td> <td>单据类型</td> </tr> <tr> <td style="text-align: left;">invalidstatus</td> <td style="text-align: left;">string</td> <td>作废状态 已作废:A 未作废:B</td> </tr> <tr> <td style="text-align: left;">invaliddate</td> <td style="text-align: left;">datetime</td> <td>作废日期</td> </tr> <tr> <td style="text-align: left;">invalidor</td> <td style="text-align: left;">long</td> <td>作废人</td> </tr> <tr> <td style="text-align: left;">purreturnreason</td> <td style="text-align: left;">long</td> <td>退货原因</td> </tr> </tbody> </table> <h6>商品明细(entryentity)</h6> <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;">id</td> <td style="text-align: left;">long</td> <td>单据分录ID</td> </tr> <tr> <td style="text-align: left;">seq</td> <td style="text-align: left;">int</td> <td>分录行号</td> </tr> <tr> <td style="text-align: left;">material</td> <td style="text-align: left;">long</td> <td>物料编码</td> </tr> <tr> <td style="text-align: left;">materialversion</td> <td style="text-align: left;">long</td> <td>物料版本</td> </tr> <tr> <td style="text-align: left;">auxpty</td> <td style="text-align: left;">long</td> <td>辅助属性</td> </tr> <tr> <td style="text-align: left;">unit</td> <td style="text-align: left;">long</td> <td>单位</td> </tr> <tr> <td style="text-align: left;">qty</td> <td style="text-align: left;">decimal</td> <td>数量</td> </tr> <tr> <td style="text-align: left;">baseunit</td> <td style="text-align: left;">long</td> <td>基本单位</td> </tr> <tr> <td style="text-align: left;">baseqty</td> <td style="text-align: left;">decimal</td> <td>基本数量</td> </tr> <tr> <td style="text-align: left;">auxunit</td> <td style="text-align: left;">long</td> <td>辅助单位</td> </tr> <tr> <td style="text-align: left;">auxqty</td> <td style="text-align: left;">decimal</td> <td>辅助数量</td> </tr> <tr> <td style="text-align: left;">price</td> <td style="text-align: left;">decimal</td> <td>单价</td> </tr> <tr> <td style="text-align: left;">priceandtax</td> <td style="text-align: left;">decimal</td> <td>含税单价</td> </tr> <tr> <td style="text-align: left;">taxrateid</td> <td style="text-align: left;">long</td> <td>税率</td> </tr> <tr> <td style="text-align: left;">taxrate</td> <td style="text-align: left;">decimal</td> <td>税率(%)</td> </tr> <tr> <td style="text-align: left;">discounttype</td> <td style="text-align: left;">string</td> <td>折扣方式 折扣率:A 单位折扣额:B 无:NULL</td> </tr> <tr> <td style="text-align: left;">discountrate</td> <td style="text-align: left;">decimal</td> <td>单位折扣(率)</td> </tr> <tr> <td style="text-align: left;">amount</td> <td style="text-align: left;">decimal</td> <td>金额</td> </tr> <tr> <td style="text-align: left;">curamount</td> <td style="text-align: left;">decimal</td> <td>金额本位币</td> </tr> <tr> <td style="text-align: left;">taxamount</td> <td style="text-align: left;">decimal</td> <td>税额</td> </tr> <tr> <td style="text-align: left;">curtaxamount</td> <td style="text-align: left;">decimal</td> <td>税额本位币</td> </tr> <tr> <td style="text-align: left;">discountamount</td> <td style="text-align: left;">decimal</td> <td>折扣额</td> </tr> <tr> <td style="text-align: left;">amountandtax</td> <td style="text-align: left;">decimal</td> <td>价税合计</td> </tr> <tr> <td style="text-align: left;">curamountandtax</td> <td style="text-align: left;">decimal</td> <td>价税合计本位币</td> </tr> <tr> <td style="text-align: left;">entryreqorg</td> <td style="text-align: left;">long</td> <td>需求组织</td> </tr> <tr> <td style="text-align: left;">entryinvorg</td> <td style="text-align: left;">long</td> <td>库存组织</td> </tr> <tr> <td style="text-align: left;">entrysettleorg</td> <td style="text-align: left;">long</td> <td>结算组织</td> </tr> <tr> <td style="text-align: left;">entrypayorg</td> <td style="text-align: left;">long</td> <td>付款组织</td> </tr> <tr> <td style="text-align: left;">producedate</td> <td style="text-align: left;">datetime</td> <td>生产日期</td> </tr> <tr> <td style="text-align: left;">expirydate</td> <td style="text-align: left;">datetime</td> <td>到期日期</td> </tr> <tr> <td style="text-align: left;">receivedate</td> <td style="text-align: left;">datetime</td> <td>收货日期</td> </tr> <tr> <td style="text-align: left;">warehouse</td> <td style="text-align: left;">long</td> <td>ERP仓库</td> </tr> <tr> <td style="text-align: left;">location</td> <td style="text-align: left;">long</td> <td>ERP仓位</td> </tr> <tr> <td style="text-align: left;">invtype</td> <td style="text-align: left;">long</td> <td>库存类型</td> </tr> <tr> <td style="text-align: left;">invstatus</td> <td style="text-align: left;">long</td> <td>库存状态</td> </tr> <tr> <td style="text-align: left;">ownertype</td> <td style="text-align: left;">string</td> <td>货主类型 核算组织:bos_org 供应商:bd_supplier 客户:bd_customer</td> </tr> <tr> <td style="text-align: left;">owner</td> <td style="text-align: left;">long</td> <td>货主</td> </tr> <tr> <td style="text-align: left;">keepertype</td> <td style="text-align: left;">string</td> <td>保管者类型 库存组织:bos_org 供应商:bd_supplier 客户:bd_customer</td> </tr> <tr> <td style="text-align: left;">keeper</td> <td style="text-align: left;">long</td> <td>保管者</td> </tr> <tr> <td style="text-align: left;">outinvtype</td> <td style="text-align: left;">long</td> <td>出库库存类型</td> </tr> <tr> <td style="text-align: left;">outinvstatus</td> <td style="text-align: left;">long</td> <td>出库库存状态</td> </tr> <tr> <td style="text-align: left;">outownertype</td> <td style="text-align: left;">string</td> <td>出库货主类型 核算组织:bos_org 供应商:bd_supplier 客户:bd_customer</td> </tr> <tr> <td style="text-align: left;">outowner</td> <td style="text-align: left;">long</td> <td>出库货主</td> </tr> <tr> <td style="text-align: left;">outkeepertype</td> <td style="text-align: left;">string</td> <td>出库保管者类型 库存组织:bos_org 供应商:bd_supplier 客户:bd_customer</td> </tr> <tr> <td style="text-align: left;">outkeeper</td> <td style="text-align: left;">long</td> <td>出库保管者</td> </tr> <tr> <td style="text-align: left;">lot</td> <td style="text-align: left;">long</td> <td>批号主档</td> </tr> <tr> <td style="text-align: left;">lotnumber</td> <td style="text-align: left;">string</td> <td>批号</td> </tr> <tr> <td style="text-align: left;">ispresent</td> <td style="text-align: left;">bool</td> <td>赠品 是:true 否:false</td> </tr> <tr> <td style="text-align: left;">project</td> <td style="text-align: left;">long</td> <td>项目</td> </tr> <tr> <td style="text-align: left;">supplierlot</td> <td style="text-align: left;">string</td> <td>供应商批号</td> </tr> <tr> <td style="text-align: left;">joinqty</td> <td style="text-align: left;">decimal</td> <td>关联数量</td> </tr> <tr> <td style="text-align: left;">joinbaseqty</td> <td style="text-align: left;">decimal</td> <td>关联基本数量</td> </tr> <tr> <td style="text-align: left;">returnqty</td> <td style="text-align: left;">decimal</td> <td>累计退库数量</td> </tr> <tr> <td style="text-align: left;">returnbaseqty</td> <td style="text-align: left;">decimal</td> <td>累计退库基本数量</td> </tr> <tr> <td style="text-align: left;">rowclosestatus</td> <td style="text-align: left;">string</td> <td>行关闭状态 正常:A 已关闭:B</td> </tr> <tr> <td style="text-align: left;">rowterminatestatus</td> <td style="text-align: left;">string</td> <td>行终止状态 正常:A 已终止:B</td> </tr> <tr> <td style="text-align: left;">entrycomment</td> <td style="text-align: left;">string</td> <td>备注</td> </tr> <tr> <td style="text-align: left;">goodsid</td> <td style="text-align: left;">long</td> <td>商品编码</td> </tr> <tr> <td style="text-align: left;">goodsclass</td> <td style="text-align: left;">long</td> <td>商品分类</td> </tr> <tr> <td style="text-align: left;">brand</td> <td style="text-align: left;">long</td> <td>商品品牌</td> </tr> <tr> <td style="text-align: left;">stock</td> <td style="text-align: left;">long</td> <td>门店仓库</td> </tr> <tr> <td style="text-align: left;">supplyqty</td> <td style="text-align: left;">decimal</td> <td>申请数量</td> </tr> <tr> <td style="text-align: left;">linetype</td> <td style="text-align: left;">long</td> <td>行类型</td> </tr> <tr> <td style="text-align: left;">stockunit</td> <td style="text-align: left;">long</td> <td>库存单位</td> </tr> <tr> <td style="text-align: left;">stockqty</td> <td style="text-align: left;">decimal</td> <td>库存单位数量</td> </tr> </tbody> </table> <h5>返回示例1</h5> <pre><code>{ &amp;quot;data&amp;quot;: { &amp;quot;success&amp;quot;: false, &amp;quot;message&amp;quot;: &amp;quot;ID为 2132843666002179073 的门店采购退货单已审核,不能修改&amp;quot; }, &amp;quot;errorCode&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;message&amp;quot;: null, &amp;quot;status&amp;quot;: true }</code></pre> <h5>返回示例2</h5> <pre><code>{ &amp;quot;data&amp;quot;: { &amp;quot;success&amp;quot;: true, &amp;quot;billId&amp;quot;: &amp;quot;1560957219082612737&amp;quot;, &amp;quot;billNo&amp;quot;: &amp;quot;MDCGTHOrg-000222211240002&amp;quot; }, &amp;quot;errorCode&amp;quot;: &amp;quot;0&amp;quot;, &amp;quot;message&amp;quot;: null, &amp;quot;status&amp;quot;: true }</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;">status        </td> <td style="text-align: left;">string  </td> <td>API外层调用成功:true API外层调用失败:false                  </td> </tr> <tr> <td style="text-align: left;">message        </td> <td style="text-align: left;">string  </td> <td>API外层调用错误信息            </td> </tr> <tr> <td style="text-align: left;">errorCode</td> <td style="text-align: left;">string</td> <td>API外层调用错误代码</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">json</td> <td>业务执行结果</td> </tr> </tbody> </table> <h5>data 说明</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;">success                </td> <td style="text-align: left;">string    </td> <td>业务逻辑执行成功:true 业务逻辑执行失败:false              </td> </tr> <tr> <td style="text-align: left;">message            </td> <td style="text-align: left;">string  </td> <td>业务逻辑执行错误信息              </td> </tr> <tr> <td style="text-align: left;">billId            </td> <td style="text-align: left;">string  </td> <td>单据ID              </td> </tr> <tr> <td style="text-align: left;">billNo            </td> <td style="text-align: left;">string  </td> <td>单号              </td> </tr> </tbody> </table> <h5>备注</h5> <ul> <li>更多返回错误代码请看首页的错误代码描述</li> </ul>

页面列表

ITEM_HTML