前端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>{
&quot;channelid&quot;: &quot;1453095343397809152&quot;,
&quot;data&quot;: {
&quot;billno&quot;: &quot;MDCGTHOrg-000222211240002&quot;,
&quot;billstatus&quot;: &quot;B&quot;,
&quot;billtype&quot;: 1417536521019329536,
&quot;bizdate&quot;: &quot;2022-11-24 00:00:00&quot;,
&quot;biztype&quot;: 688847172015446016,
&quot;comment&quot;: &quot;&quot;,
&quot;createtime&quot;: &quot;2022-11-24 17:02:39&quot;,
&quot;creator&quot;: 1387805407904268288,
&quot;currency&quot;: 1,
&quot;deliveraddress&quot;: &quot;&quot;,
&quot;entryentity&quot;: [
{
&quot;amount&quot;: 3.5398230088,
&quot;amountandtax&quot;: 4.0000000000,
&quot;auxqty&quot;: 0,
&quot;baseqty&quot;: 2.0000000000,
&quot;baseunit&quot;: 1397807644697168896,
&quot;curamount&quot;: 0,
&quot;curamountandtax&quot;: 0,
&quot;curtaxamount&quot;: 0,
&quot;discountamount&quot;: 0,
&quot;discountrate&quot;: 0,
&quot;discounttype&quot;: &quot;NULL&quot;,
&quot;entrycomment&quot;: &quot;&quot;,
&quot;entryinvorg&quot;: 1392640574401553408,
&quot;entryreqorg&quot;: 1392640574401553408,
&quot;entrysettleorg&quot;: 1392640574401553408,
&quot;goodsid&quot;: 1450698617168866304,
&quot;id&quot;: 1560957219082611713,
&quot;invstatus&quot;: 691928582720825344,
&quot;invtype&quot;: 688884005529250816,
&quot;ispresent&quot;: false,
&quot;joinbaseqty&quot;: 0,
&quot;joinqty&quot;: 0,
&quot;keeper&quot;: 1392640574401553408,
&quot;keepertype&quot;: &quot;bos_org&quot;,
&quot;linetype&quot;: 1194150915045641216,
&quot;lotnumber&quot;: &quot;&quot;,
&quot;material&quot;: 1450698638635314176,
&quot;outkeepertype&quot;: &quot;&quot;,
&quot;outownertype&quot;: &quot;&quot;,
&quot;owner&quot;: 1392640574401553408,
&quot;ownertype&quot;: &quot;bos_org&quot;,
&quot;price&quot;: 1.7699115044,
&quot;priceandtax&quot;: 2.0000000000,
&quot;qty&quot;: 2.0000000000,
&quot;receivedate&quot;: &quot;2022-11-24 00:00:00&quot;,
&quot;returnbaseqty&quot;: 0,
&quot;returnqty&quot;: 0,
&quot;rowclosestatus&quot;: &quot;A&quot;,
&quot;rowterminatestatus&quot;: &quot;A&quot;,
&quot;seq&quot;: 1,
&quot;stock&quot;: 1450780035806932992,
&quot;stockqty&quot;: 2.0000000000,
&quot;stockunit&quot;: 1397807644697168896,
&quot;supplierlot&quot;: &quot;&quot;,
&quot;supplyqty&quot;: 2.0000000000,
&quot;taxamount&quot;: 0.4601769912,
&quot;taxrate&quot;: 13.0000000000,
&quot;taxrateid&quot;: 1,
&quot;unit&quot;: 1397807644697168896,
&quot;warehouse&quot;: 1450784412236001280
}
],
&quot;exchangerate&quot;: 0,
&quot;exratedate&quot;: &quot;2022-11-24 00:00:00&quot;,
&quot;exratetable&quot;: 1390615957327586304,
&quot;id&quot;: 1560957219082612737,
&quot;invalidstatus&quot;: &quot;B&quot;,
&quot;istax&quot;: true,
&quot;modifier&quot;: 1387805407904268288,
&quot;modifytime&quot;: &quot;2022-11-24 17:03:21&quot;,
&quot;org&quot;: 1392640574401553408,
&quot;paymode&quot;: &quot;CREDIT&quot;,
&quot;purdept&quot;: 1392640574401553408,
&quot;purorg&quot;: 1392640574401553408,
&quot;refundtype&quot;: &quot;A&quot;,
&quot;settleorg&quot;: 1392640574401553408,
&quot;store&quot;: 1450666889079435264,
&quot;supplier&quot;: 1110082709432067072,
&quot;supplieraddress&quot;: &quot;&quot;,
&quot;totalallamount&quot;: 0,
&quot;totalamount&quot;: 0,
&quot;totaltaxamount&quot;: 0
},
&quot;posid&quot;: &quot;1515806714258020352&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>{
&quot;data&quot;: {
&quot;success&quot;: false,
&quot;message&quot;: &quot;ID为 2132843666002179073 的门店采购退货单已审核，不能修改&quot;
},
&quot;errorCode&quot;: &quot;0&quot;,
&quot;message&quot;: null,
&quot;status&quot;: true
}</code></pre>
<h5>返回示例2</h5>
<pre><code>{
&quot;data&quot;: {
&quot;success&quot;: true,
&quot;billId&quot;: &quot;1560957219082612737&quot;,
&quot;billNo&quot;: &quot;MDCGTHOrg-000222211240002&quot;
},
&quot;errorCode&quot;: &quot;0&quot;,
&quot;message&quot;: null,
&quot;status&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>