巨益OMS退换货单创建_v1API接口文档
退换货单创建_v1
接口地址：returnorder.create
请求方法： POST
加工厂： {"operation":{"method":"none"}}
接口请求参数
| 序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
|---|---|---|---|---|---|---|
| 1 | extendProps | extendProps | object | 1 | 退货单信息 | 否 |
| 2 | orderCode | orderCode | string | 1 | orderCode | 否 |
| 3 | orderLines | orderLines | array | 1 | 订单信息 | 是 |
| 4 | batchCode | batchCode | string | 1 | 批次编码,示例值(P123) | 否 |
| 5 | expireDate | expireDate | string | 1 | 过期日期(YYYY-MM-DD),示例值(2016-09-09) | 否 |
| 6 | inventoryType | inventoryType | string | 1 | 库存类型(ZP=正品;CC=残次;JS=机损;XS=箱损;默认为ZP),示例值(ZP) | 否 |
| 7 | itemCode | itemCode | string | 1 | 商品编码,示例值(I1234) | 是 |
| 8 | itemId | itemId | string | 1 | 仓储系统商品编码(条件为提供后端（仓储系统）商品编码的仓储系统),示例值(CK1234) | 否 |
| 9 | orderFlag | orderFlag | string | 1 | 用字符串格式来表示订单标记列表(比如VISIT^ SELLER_AFFORD^SYNC_RETURN_BILL等;中间用“^”来隔开订单标记list (所 有字母全部大写) VISIT=上门；SELLER_AFFORD=是否卖家承担运费(默认是)SYNC_RETURN_BILL=同时退回发票),示例值(visit) | 是 |
| 10 | orderLineNo | orderLineNo | string | 1 | 单据行号,示例值(D1234) | 否 |
| 11 | ownerCode | ownerCode | string | 1 | 货主编码,示例值(HZ1234) | 是 |
| 12 | planQty | planQty | string | 1 | 应收商品数量,示例值(12) | 是 |
| 13 | produceCode | produceCode | string | 1 | 生产批号,示例值(P1234) | 否 |
| 14 | productDate | productDate | string | 1 | 生产日期(YYYY-MM-DD),示例值(2016-09-09) | 否 |
| 15 | returnReason | returnReason | string | 1 | 退货原因,示例值(破损退货) | 是 |
| 16 | sourceOrderCode | sourceOrderCode | string | 1 | 交易平台订单,示例值(PD1224) | 否 |
| 17 | subSourceOrderCode | subSourceOrderCode | string | 1 | 交易平台子订单编码,示例值(PL1234) | 否 |
| 18 | outBizCode | outBizCode | string | 1 | outBizCode | 否 |
| 19 | outCode | outCode | string | 1 | outCode | 否 |
| 20 | returnOrder | returnOrder | object | 1 | 退货单信息 | 是 |
| 21 | buyerNick | buyerNick | string | 1 | 买家昵称,示例值(淘宝) | 否 |
| 22 | expressCode | expressCode | string | 1 | 运单号,示例值(YD1234) | 否 |
| 23 | logisticsCode | logisticsCode | string | 1 | 物流公司编码(SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通、ZTO=中通(ZTO)、HTKY=百世汇通、 UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、 AMAZON=亚马逊物流、OTHER=其他;只传英文编码),示例值(SF) | 是 |
| 24 | logisticsName | logisticsName | string | 1 | 物流公司名称,示例值(顺丰) | 否 |
| 25 | orderFlag1 | orderFlag1 | string | 1 | 用字符串格式来表示订单标记列表(比如VISIT^ SELLER_AFFORD^SYNC_RETURN_BILL等;中间用“^”来隔开订单标记list (所 有字母全部大写) VISIT=上门；SELLER_AFFORD=是否卖家承担运费(默认是)SYNC_RETURN_BILL=同时退回发票),示例值(VISIT) | 是 |
| 26 | orderType | orderType | string | 1 | 单据类型(THRK=退货入库;HHRK=换货入库;只传英文编码),示例值(THRK) | 是 |
| 27 | preDeliveryOrderCode | preDeliveryOrderCode | string | 1 | 原出库单号(ERP分配),示例值(PD1234) | 否 |
| 28 | preDeliveryOrderId | preDeliveryOrderId | string | 1 | 原出库单号(WMS分配),示例值(PDI1234) | 是 |
| 29 | remark | remark | string | 1 | 备注信息,示例值(备注) | 否 |
| 30 | returnOrderCode | returnOrderCode | string | 1 | ERP的退货入库单编码,示例值(R1234) | 是 |
| 31 | sellerNick | sellerNick | string | 1 | 卖家名称,示例值(汤姆店铺) | 否 |
| 32 | senderInfo | senderInfo | object | 1 | 发件人信息 | 是 |
| 33 | area | area | string | 1 | 区域,示例值(余杭) | 否 |
| 34 | city | city | string | 1 | 城市,示例值(杭州) | 是 |
| 35 | company | company | string | 1 | 公司名称,示例值(淘宝) | 否 |
| 36 | countryCode | countryCode | string | 1 | 国家二字码,示例值(051532) | 否 |
| 37 | detailAddress | detailAddress | string | 1 | 详细地址,示例值(杭州市余杭区989号) | 是 |
| 38 | string | 1 | 电子邮箱,示例值(345@gmail.com) | 否 | ||
| 39 | mobile | mobile | string | 1 | 移动电话,示例值(13214567869) | 否 |
| 40 | name | name | string | 1 | 姓名,示例值(老王) | 是 |
| 41 | province | province | string | 1 | 省份,示例值(浙江省) | 是 |
| 42 | tel | tel | string | 1 | 固定电话,示例值(81020340) | 是 |
| 43 | town | town | string | 1 | 村镇,示例值(横加桥) | 否 |
| 44 | zipCode | zipCode | string | 1 | 邮编,示例值(043300) | 否 |
| 45 | shopNick | shopNick | string | 1 | 店铺名称,示例值(汤姆店铺) | 否 |
| 46 | sourcePlatformCode | sourcePlatformCode | string | 1 | 订单来源平台编码, string (50),TB= 淘宝 、TM=天猫 、JD=京东、DD=当当、PP=拍拍、YX=易讯、EBAY=ebay、QQ=QQ网购、AMAZON=亚马逊、SN=苏宁、GM=国美、WPH=唯品会、JM=聚美、LF=乐蜂、MGJ=蘑菇街、JS=聚尚、PX=拍鞋、YT=银泰、YHD=1号店、VANCL=凡客、YL=邮乐、YG=优购、1688=阿里巴巴、POS=POS门店、MIA=蜜芽、GW=商家官网、CT=村淘、YJWD=云集微店、PDD=拼多多、OTHERS=其他,示例值(TB) | 否 |
| 47 | sourcePlatformName | sourcePlatformName | string | 1 | 订单来源平台名称,示例值(淘宝) | 否 |
| 48 | warehouseCode | warehouseCode | string | 1 | 仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER),示例值(W1234) | 是 |
接口响应参数
| 序号 | 字段 | 名称 | 类型 | 默认值 | 描述 | 是否必要 |
|---|
巨益OMS的接口：退换货单创建_v1（returnorder.create），由轻易云数据集成平台API资产管理模块整理收纳，并且根据巨益OMS版本更新同步实时更新。API资产管理平台提供了丰富的API开发和测试工具，支持API的快速迭代和创新，加速产品的上市速度，提升企业的市场竞争力。
