参照订单生退换货单
<p><strong>简要描述:</strong> </p>
<ul>
<li>参照订单生退换货单接口</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li>` <a href="http://localhost:8080/api/billoperation/apiaction?token=12345678">http://localhost:8080/api/billoperation/apiaction?token=12345678</a></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_refund</td>
</tr>
<tr>
<td style="text-align: left;">action</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>refundOrderAddRef</td>
</tr>
<tr>
<td style="text-align: left;">ids</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>参照订单据ID(仅支持单张订单)</td>
</tr>
<tr>
<td style="text-align: left;">partParam</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>单据id-时间戳关系映射(仅支持单张订单)</td>
</tr>
<tr>
<td style="text-align: left;">externalData</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Map</td>
<td>externalDataMap.put("bodyIds", bodyIdStr) bodyIdStr:所选订单行的id集合以逗号分隔的字符串</td>
</tr>
</tbody>
</table>
<p><strong> 参照订单生退换货单接口:主要功能是根据oms中一张订单对象,转成一张退换货单对象,并以Json格式返回此对象,以便做后续处理。</strong></p>
<p><strong>请求示例</strong></p>
<pre><code>{"billnum":"ec_refund","action":"refundOrderAddRef","ids":"1513017685971200","partParam":{"1513017685971200":"2019-12-09 21:00:26"},"externalData":{"bodyIds":"1513017685971201,1513017685971202"}}</code></pre>
<p><strong>返回示例</strong></p>
<pre><code>{
"code": 200,
"message": "操作成功",
"data": "[{"shop_id":1505563505840384,"distributor_nick":null,"oribillid":1513017685971200,"order_status":"buyers_have_paid","tid":"747182627676264085","total_fee":0.11,"refund_fee":0.11,"payment":0,"buyer_nick":"小小321","created":"2019-12-1019: 12: 25","moneytype":"CNY","umall_memeberId":null,"shipMode":"EnterpriseDeliver","srctype":5,"code":"20191210191225254001","newAddTradePerson":"wlb6","newAddTradeTime":"2019-12-1019: 12: 25","receiver_name":"小小","receiver_mobile":"15733201096","shop_name":"LJ企业发货店铺","plat":"1","tenant":1403451793166592,"org":1403451813925120,"refund_type":"1","refundNum":1,"refundOrderDetail":[{"refund_phase":"onsale","cTradeCodeLine":"DD15052019120500000003","created":"2019-12-1019: 12: 25","tid":"747182627676264085","oid":"747182627676264085","num_iid":"593912690768","title":"艾玛纸001","sku_id":"1406289393684736","sku":"颜色分类: 金色","citemID":1406289393684736,"productID":1406289391063296,"iWarehouseId":1406594025165056,"outer_id":null,"num":1,"enableNum":1,"actualReturnQuantity":1,"price":0.1,"payment":0.1,"total_fee":0.1,"isGift":0,"goodtype":0,"isInbound":0,"exchange_lable":"th","provider":null,"org":1403451813925120,"tenant":1403451793166592,"cTradeLineId":"1513017685971201","id":1513017685971201,"product_skucode":"liujie00001","product_skuname":"LJ测试商品","product_code":"liujie00001","product_name":"LJ测试商品","Warehouse_code":"1002","Warehouse_name":"LJ电商测试仓"},{"refund_phase":"onsale","cTradeCodeLine":"DD15052019120500000003","created":"2019-12-1019: 12: 25","tid":"747182627676264085","oid":"747182627676264085_post","num_iid":null,"title":"运费","sku_id":"1406344743309568","sku":null,"citemID":1406344743309568,"productID":1406344741392640,"iWarehouseId":null,"outer_id":null,"num":0E-8,"enableNum":0E-8,"actualReturnQuantity":0E-8,"price":0E-8,"payment":0.01,"total_fee":0.01,"isGift":0,"goodtype":2,"isInbound":0,"exchange_lable":"th","provider":null,"org":1403451813925120,"tenant":1403451793166592,"cTradeLineId":"1513017685971202","id":1513017685971202,"product_skucode":"004","product_skuname":"运费","product_code":"004","product_name":"运费"}],"_convert_refundOrderDetail":"ok","refund_phase":"onsale","inbound_status":"2"}]"
}</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;">id</td>
<td style="text-align: left;">表头主键</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">plat</td>
<td style="text-align: left;">平台</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">shop_id</td>
<td style="text-align: left;">店铺</td>
<td>Long</td>
</tr>
<tr>
<td style="text-align: left;">refund_id</td>
<td style="text-align: left;">退款单号(唯一编码)</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">tid</td>
<td style="text-align: left;">交易编号</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">oribillid</td>
<td style="text-align: left;">退款单原单id</td>
<td>Long</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">平台状态</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">refund_type</td>
<td style="text-align: left;">退款类型</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">convert_type</td>
<td style="text-align: left;">转单状态</td>
<td>Long</td>
</tr>
<tr>
<td style="text-align: left;">fail_reason</td>
<td style="text-align: left;">失败原因</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">convert_time</td>
<td style="text-align: left;">转单时间</td>
<td>DateTime</td>
</tr>
<tr>
<td style="text-align: left;">total_fee</td>
<td style="text-align: left;">实收金额(订单交易总金额)</td>
<td>Decimal</td>
</tr>
<tr>
<td style="text-align: left;">refund_fee</td>
<td style="text-align: left;">退款申请单金额</td>
<td>Decimal</td>
</tr>
<tr>
<td style="text-align: left;">payment</td>
<td style="text-align: left;">实际退款金额</td>
<td>Decimal</td>
</tr>
<tr>
<td style="text-align: left;">refundFee</td>
<td style="text-align: left;">退款金额</td>
<td>Decimal</td>
</tr>
<tr>
<td style="text-align: left;">refundNum</td>
<td style="text-align: left;">退货数量</td>
<td>Decimal</td>
</tr>
<tr>
<td style="text-align: left;">buyer_nick</td>
<td style="text-align: left;">买家昵称</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">reason</td>
<td style="text-align: left;">退款原因</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">desc</td>
<td style="text-align: left;">退款说明</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">company_name</td>
<td style="text-align: left;">退货快递公司</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">sid</td>
<td style="text-align: left;">退货快递单号</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">created</td>
<td style="text-align: left;">退款申请时间</td>
<td>DateTime</td>
</tr>
<tr>
<td style="text-align: left;">modified</td>
<td style="text-align: left;">修改时间</td>
<td>DateTime</td>
</tr>
<tr>
<td style="text-align: left;">down_time</td>
<td style="text-align: left;">下载时间</td>
<td>DateTime</td>
</tr>
<tr>
<td style="text-align: left;">order_status</td>
<td style="text-align: left;">订单交易状态</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">good_status</td>
<td style="text-align: left;">货物状态</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">sys_status</td>
<td style="text-align: left;"></td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">refund_status</td>
<td style="text-align: left;">退货状态</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">refund_version</td>
<td style="text-align: left;">退款版本号</td>
<td>Long</td>
</tr>
<tr>
<td style="text-align: left;">image_id</td>
<td style="text-align: left;">图片id</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">image_name</td>
<td style="text-align: left;">图片名称</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">image_url</td>
<td style="text-align: left;">图片url</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">isClosed</td>
<td style="text-align: left;">是否关闭</td>
<td>ShortInt</td>
</tr>
<tr>
<td style="text-align: left;">bill_code</td>
<td style="text-align: left;">收款单号</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">blend_person</td>
<td style="text-align: left;">勾兑人</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">transferPerson</td>
<td style="text-align: left;">转单人</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">auditPerson</td>
<td style="text-align: left;">审核人</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">audit_date</td>
<td style="text-align: left;">审核日期</td>
<td>DateTime</td>
</tr>
<tr>
<td style="text-align: left;">blend_date</td>
<td style="text-align: left;">勾兑时间</td>
<td>DateTime</td>
</tr>
<tr>
<td style="text-align: left;">isBlend</td>
<td style="text-align: left;">是否勾对</td>
<td>ShortInt</td>
</tr>
<tr>
<td style="text-align: left;">memo</td>
<td style="text-align: left;">备注</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">blend_id</td>
<td style="text-align: left;">勾兑ID</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">编码</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">tenant_id</td>
<td style="text-align: left;">租户</td>
<td>Long</td>
</tr>
<tr>
<td style="text-align: left;">org_id</td>
<td style="text-align: left;">组织档案节点</td>
<td>Long</td>
</tr>
<tr>
<td style="text-align: left;">salerptcode</td>
<td style="text-align: left;"></td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">salerptid</td>
<td style="text-align: left;"></td>
<td>Long</td>
</tr>
<tr>
<td style="text-align: left;">srctype</td>
<td style="text-align: left;">单据类型</td>
<td>ShortInt</td>
</tr>
<tr>
<td style="text-align: left;">bsalerpt</td>
<td style="text-align: left;"></td>
<td>ShortInt</td>
</tr>
<tr>
<td style="text-align: left;">salerpter</td>
<td style="text-align: left;"></td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">salerpttime</td>
<td style="text-align: left;"></td>
<td>DateTime</td>
</tr>
<tr>
<td style="text-align: left;">newAddTradePerson</td>
<td style="text-align: left;">制单人</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">newAddTradeTime</td>
<td style="text-align: left;">制单时间</td>
<td>DateTime</td>
</tr>
<tr>
<td style="text-align: left;">distributor_nick</td>
<td style="text-align: left;">分销商昵称</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">moneytype</td>
<td style="text-align: left;">币种</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">isAuditing</td>
<td style="text-align: left;">是否审核</td>
<td>ShortInt</td>
</tr>
<tr>
<td style="text-align: left;">original_refund_phase</td>
<td style="text-align: left;"></td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">refund_phase</td>
<td style="text-align: left;">退款阶段</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">inbound_status</td>
<td style="text-align: left;">入库状态</td>
<td>String</td>
</tr>
<tr>
<td style="text-align: left;">inbound_time</td>
<td style="text-align: left;">入库时间</td>
<td>String</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>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">id</td>
<td style="text-align: left;">表体主键</td>
<td style="text-align: left;">String</td>
</tr>
<tr>
<td style="text-align: left;">good_status</td>
<td style="text-align: left;">货物状态</td>
<td style="text-align: left;">String</td>
</tr>
<tr>
<td style="text-align: left;">tid</td>
<td style="text-align: left;">交易编号</td>
<td style="text-align: left;">String</td>
</tr>
<tr>
<td style="text-align: left;">oid</td>
<td style="text-align: left;">子订单号</td>
<td style="text-align: left;">String</td>
</tr>
<tr>
<td style="text-align: left;">num_iid</td>
<td style="text-align: left;">平台商品编码</td>
<td style="text-align: left;">String</td>
</tr>
<tr>
<td style="text-align: left;">product_name</td>
<td style="text-align: left;">商品名称</td>
<td style="text-align: left;">String</td>
</tr>
<tr>
<td style="text-align: left;">title</td>
<td style="text-align: left;">商品标题</td>
<td style="text-align: left;">String</td>
</tr>
<tr>
<td style="text-align: left;">sku</td>
<td style="text-align: left;">平台商品SKU信息</td>
<td style="text-align: left;">String</td>
</tr>
<tr>
<td style="text-align: left;">cwhcode</td>
<td style="text-align: left;">仓库id</td>
<td style="text-align: left;">Long</td>
</tr>
<tr>
<td style="text-align: left;">isGift</td>
<td style="text-align: left;">是否赠品</td>
<td style="text-align: left;">ShortInt</td>
</tr>
<tr>
<td style="text-align: left;">cbatch</td>
<td style="text-align: left;">批号</td>
<td style="text-align: left;">String</td>
</tr>
<tr>
<td style="text-align: left;">sku_id</td>
<td style="text-align: left;">sku_id</td>
<td style="text-align: left;">String</td>
</tr>
<tr>
<td style="text-align: left;">citemID</td>
<td style="text-align: left;">商品ID</td>
<td style="text-align: left;">Long</td>
</tr>
<tr>
<td style="text-align: left;">productID</td>
<td style="text-align: left;">系统商品ID</td>
<td style="text-align: left;">Long</td>
</tr>
<tr>
<td style="text-align: left;">num</td>
<td style="text-align: left;">数量</td>
<td style="text-align: left;">Decimal</td>
</tr>
<tr>
<td style="text-align: left;">price</td>
<td style="text-align: left;">价格</td>
<td style="text-align: left;">Decimal</td>
</tr>
<tr>
<td style="text-align: left;">total_fee</td>
<td style="text-align: left;">金额</td>
<td style="text-align: left;">Decimal</td>
</tr>
<tr>
<td style="text-align: left;">memo</td>
<td style="text-align: left;">备注</td>
<td style="text-align: left;">String</td>
</tr>
<tr>
<td style="text-align: left;">created</td>
<td style="text-align: left;">退款申请时间</td>
<td style="text-align: left;">DateTime</td>
</tr>
<tr>
<td style="text-align: left;">modified</td>
<td style="text-align: left;">修改时间</td>
<td style="text-align: left;">DateTime</td>
</tr>
<tr>
<td style="text-align: left;">org_id</td>
<td style="text-align: left;">组织档案节点</td>
<td style="text-align: left;">Long</td>
</tr>
<tr>
<td style="text-align: left;">tenant_id</td>
<td style="text-align: left;">租户</td>
<td style="text-align: left;">Long</td>
</tr>
<tr>
<td style="text-align: left;">salerptbodyid</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">Long</td>
</tr>
<tr>
<td style="text-align: left;">actualReturnQuantity</td>
<td style="text-align: left;">实际退货数量</td>
<td style="text-align: left;">Decimal</td>
</tr>
<tr>
<td style="text-align: left;">cTradeCodeLine</td>
<td style="text-align: left;">电商订单号</td>
<td style="text-align: left;">String</td>
</tr>
<tr>
<td style="text-align: left;">cTradeLineId</td>
<td style="text-align: left;">订单行ID</td>
<td style="text-align: left;">String</td>
</tr>
<tr>
<td style="text-align: left;">refund_phase</td>
<td style="text-align: left;">退款阶段</td>
<td style="text-align: left;">String</td>
</tr>
<tr>
<td style="text-align: left;">payment</td>
<td style="text-align: left;">实收金额</td>
<td style="text-align: left;">Decimal</td>
</tr>
<tr>
<td style="text-align: left;">enableNum</td>
<td style="text-align: left;">可退数量</td>
<td style="text-align: left;">Decimal</td>
</tr>
<tr>
<td style="text-align: left;">isInbound</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">ShortInt</td>
</tr>
<tr>
<td style="text-align: left;">goodtype</td>
<td style="text-align: left;"></td>
<td style="text-align: left;">ShortInt</td>
</tr>
</tbody>
</table>
<p><strong>备注</strong> </p>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>