# 订单中心模块
API域名以及签名 统一签名, 此模块路由最新地址为/open/v6, 旧版本路由可以继续使用
全局响应参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 0:成功 其他失败 |
| data | Object | 返回数据 |
| message | String | 错误信息 |
# 交易订单创建
(1)接口地址:/order/sales/createV2
(2)请求方式:POST
(3)请求数据类型:application/json
(4)响应数据类型:application/json
(5)请求参数:
| 参数名称 | 数据类型 | 是否必须 | 参数说明 |
|---|---|---|---|
| appId | String | true | 应用编号 |
| requestId | String | true | 请求号 |
| requestTime | Long | true | 请求时间戳,单位秒 |
| platformOrderNo | String | true | 平台交易号(三方平台交易单号) |
| platformOrderStatus | String | false | 平台订单状态(WAIT_SELLER_SEND_GOODS:等待卖家发货,即:买家已付款 WAIT_BUYER_CONFIRM_GOODS:等待买家确认收货,即:卖家已发货 TRADE_FINISHED:交易成功 TRADE_CLOSED:付款以后用户退款成功,交易自动关闭) |
| storeCode | String | true | 店铺编码 |
| orderType | Integer | true | 订单类型:0:销售订单、3:补发订单 |
| memberName | String | true | 会员昵称 |
| platformCreateTime | String | true | 下单时间,格式:yyyy-MM-dd HH:mm:ss |
| platformPayTime | String | true | 支付时间,格式:yyyy-MM-dd HH:mm:ss |
| receiverName | String | true | 收货人 |
| mobile | String | true | 手机 |
| phone | String | true | 电话 |
| country | String | true | 国 |
| province | String | true | 省 |
| city | String | true | 市 |
| district | String | true | 区 |
| address | String | true | 详细地址 |
| postFee | BigDecimal | false | 快递费 |
| reissueReason | String | false | 补发原因 |
| buyerMemo | String | false | 买家备注 |
| sellerMemo | String | false | 客服备注 |
| openExtensions | String | false | 扩展信息(可以储存json信息) |
| detailList | List | true | 订单明细集合 |
| └ platformNo | String | true | 子订单号(平台明细编码) |
| └ qty | Integer | true | 数量(注:数量不能小于1) |
| └ skuCode | String | true | 规格编码 |
| └ price | BigDecimal | false | 商品价格(销售单价) |
| └ totalFee | BigDecimal | false | 应付金额(销售金额) |
| └ actualPrice | BigDecimal | false | 实付单价(成交单价) |
| └ payment | BigDecimal | false | 实付金额(成交金额) |
| └ settlementFee | BigDecimal | true | 结算金额 |
| └ settlementPrice | BigDecimal | true | 结算价 |
| └ discountFee | BigDecimal | false | 优惠金额 |
| └ giftStrategyCode | String | false | 赠品策略编码 |
(6)请求示例:
{
"platformOrderNo": "331XXXXX7710XX",
"orderType": 0,
"platformOrderStatus": "WAIT_SELLER_SEND_GOODS",
"storeCode": "01XX1XXXX",
"receiverName": "陈**",
"mobile": "136****6086",
"phone": "",
"memberName": "member",
"country": "中国",
"province": "广东省",
"city": "湛江市",
"district": "霞山区",
"address": "XXXXXXXXX",
"platformCreateTime": "2023-04-19 11:17:57",
"platformPayTime": "2023-04-19 11:17:57",
"postFee": 0,
"reissueReason": "会员发货订单",
"detailList": [
{
"platformNo": "3XXXXXXXXXX",
"skuCode": "6926523450105",
"qty": 1,
"price": 0,
"totalFee": 0,
"actualPrice": 0,
"payment": 0,
"settlementFee": 0,
"settlementPrice": 0,
"discountFee": 0,
"giftStrategyCode": "3XXXXXXXXXX"
}
]
}
(7)响应参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 0:成功 其他失败 |
| data | Object | 交易单创建返回信息 |
| └ platformOrderNo | String | 平台交易号 |
| └ salesOrderId | Long | oms交易单ID |
| message | String | 错误信息 |
(8)响应示例:
{
"code": 0,
"data": {
"platformOrderNo": "",
"salesOrderCode": "SO单号",
"salesOrderId": 0
},
"message": ""
}
# 交易订单取消
(1)接口地址:/order/sales/cancel
(2)请求方式:POST
(3)请求数据类型:application/json
(4)响应数据类型:application/json
(5)请求参数:
| 参数名称 | 数据类型 | 是否必须 | 参数说明 |
|---|---|---|---|
| appId | String | true | 应用编号 |
| requestId | String | true | 请求号 |
| requestTime | Long | true | 请求时间戳,单位秒 |
| platformOrderNo | String | true | 平台交易号(三方平台交易单号) |
| salesOrderCode | String | true | OMS销售编码 |
| reason | String | false | 取消原因 |
(6)请求示例:
{
"platformOrderNo": "",
"salesOrderCode": "SO单号",
"reason": ""
}
(7)响应参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 0:成功 其他失败 |
| data | Object | 无返回数据 |
| message | String | 错误信息 |
(8)响应示例:
{
"code": 0,
"data": {},
"message": ""
}
# 班牛换货申请和换货通知单创建
(1)接口地址:/order/exchange/create
(2)请求方式:POST
(3)请求数据类型:application/json
(4)响应数据类型:application/json
(5)请求参数:
| 参数名称 | 数据类型 | 是否必须 | 参数说明 |
|---|---|---|---|
| appId | String | true | 应用编号 |
| projectId | String | true | 项目id |
| taskId | String | true | taskId |
| userId | String | true | 用户id |
| address | String | false | 详细地址 |
| backExpressCode | String | false | 退入快递编码 |
| backExpressName | String | false | 退入快递名称 |
| backExpressNo | String | false | 退入快递单号 |
| buyerMemo | String | false | 买家说明 |
| city | String | false | 市 |
| country | String | false | 国家 |
| district | String | false | 区 |
| exchangeCode | String | false | 换货单号 |
| isExchangeFirst | Integer | false | 是否优先换 1:是、0:否 |
| exchangeOutDetailList | List | false | 换货订单换出明细 |
| └ platformNo | String | false | 子单号 |
| └ productCode | String | false | 商品编码 |
| └ productName | String | false | 商品名称 |
| └ qty | Integer | true | 数量 |
| └ skuCode | String | true | SKU编码 |
| └ skuName | String | false | SKU名称 |
| └ type | String | false | 类型 |
| └ typeCode | String | false | 类型编码 |
| exchangeReason | String | false | 换货原因 |
| isAutoFillAddress | Boolean | true | 是否自动填充地址(true:取原销售订单地址信息后自动填充到该换货申请中,false:不更改地址信息) |
| mobile | String | false | 手机号 |
| platformOrderNo | String | true | 平台交易号 |
| province | String | false | 省 |
| receiver | String | false | 收货人 |
| returnInDetailList | List | false | 换货订单退入明细 |
| └ id | Long | true | 明细id |
| └ platformNo | String | true | 子单号 |
| └ qty | Integer | true | 数量 |
| salesOrderId | Long | true | 销售订单id |
| sellerMemo | String | false | 卖家备注 |
(6)请求示例:
{
"appId": "1",
"projectId": "1",
"taskId": "1",
"userId": "1",
"address": "闻堰街道",
"backExpressCode": "ZT",
"backExpressName": "中通",
"backExpressNo": "test102401",
"buyerMemo": "姚",
"city": "杭州市",
"country": "中国",
"district": "浙江省",
"exchangeCode": "",
"isExchangeFirst": 1,
"exchangeOutDetailList": [
{
"platformNo": "2022102016162801",
"productCode": "6941428688156",
"productName": "蜜橙_DCW",
"qty": 1,
"skuCode": "6941428688156",
"skuName": "6941428688156",
"type": "",
"typeCode": ""
}
],
"exchangeReason": "天无理由换货",
"isAutoFillAddress": false,
"mobile": "",
"platformOrderNo": "2022102016162801",
"province": "13600678310",
"receiver": "章",
"returnInDetailList": [
{
"id": "371241299",
"platformNo": "2022102016162801",
"qty": 1
}
],
"salesOrderId": 152273460,
"sellerMemo": "音"
}
(7)响应参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 0:成功 其他失败 |
| data | Object | 无返回数据 |
| message | String | 错误信息 |
(8)响应示例:
{
"code": 0,
"data": null,
"message": "操作成功"
}
# 班牛销售订单明细信息查询
(1)接口地址:/order/salesDetail/list
(2)请求方式:POST
(3)请求数据类型:application/json
(4)响应数据类型:application/json
(5)请求参数:
| 参数名称 | 数据类型 | 是否必须 | 参数说明 |
|---|---|---|---|
| platformOrderNo | String | true | 平台交易号(三方平台交易单号) |
| storeCode | String | false | 店铺编码 |
| isAll | String | false | 是否查询全部(Y:查询作废订单,N或者为空不包含作废订单) |
(6)请求示例:
{
"platformOrderNo": "3064563540143586756",
"storeCode": "01TM1001",
"isAll": "Y"
}
(7)响应参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 0:成功 其他失败 |
| data | Object | 返回数据 |
| └ orderList | List | 班牛订单信息列表 |
| └ city | String | 市 |
| └ country | String | 国家 |
| └ deliveryStatus | Integer | 发货状态(10:待发货 20:部分发货 30:全部发货 50:已作废 60:已取消) |
| └ dispatchStatus | Integer | 配货状态(10:待推送 20:待发货 30:部分发货 40:已发货 50:已取消 60:推送中 70:推送失败 80:配货单取消中) |
| └ refundStatus | Integer | 退款状态(0:无退款 10:部分退款 20:全部退款) |
| └ dispatchTime | String | 预计配货时间,格式:yyyy-MM-dd HH:mm:ss |
| └ district | String | 区 |
| └ isHangUp | Integer | 是否挂起(0-否 1-是) |
| └ isHold | Integer | 是否留单(0-否 1-是) |
| └ isSelfPickUp | Integer | 是否自提(0-否 1-是) |
| └ isHour | Integer | 是否小时达(0-否 1-是) |
| └ isConsolidate | Integer | 是否集运(0-否 1-是) |
| └ premiumExpress | String | 加价快递(有值就是顺丰加价) |
| └ orderDetailList | List | 订单明细列表 |
| └ actualPrice | BigDecimal | 实付单价 |
| └ adjustFee | BigDecimal | 手工调整金额 |
| └ consignTime | String | 发货时间,格式:yyyy-MM-dd HH:mm:ss |
| └ detailStatus | Integer | 订单明细状态:20:待配货,30:待发货,40:已发货,50:已作废,60:已取消,70:已完成 |
| └ detailType | Integer | 0:原始订单明细,1:修改后的订单明细 |
| └ discountFee | BigDecimal | 优惠金额 |
| └ divideOrderFee | BigDecimal | 分摊之后的实付金额 |
| └ expressCode | String | 快递编码 |
| └ expressName | String | 快递名称 |
| └ expressNo | String | 快递单号 |
| └ giftType | Integer | 赠品类型(1:平台 2:促销 3:手动) |
| └ id | Long | 订单明细编号 |
| └ imgUrl | String | 商品图片 |
| └ isBox | Integer | 是否是箱规拆分(0-否 1-是) |
| └ isDropShipping | Integer | 是否代发(0-否 1-是) |
| └ isExchange | Integer | 是否换货(0-否 1-是) |
| └ isGift | Integer | 是否是赠品(0-否 1-是) |
| └ isReturnGoods | Integer | 是否有货物退回(0-否 1-是) |
| └ isSplit | Integer | 商品拆分(0-否 1-是) |
| └ isSub | Integer | 是否是组合商品拆分(0-否 1-是) |
| └ partMjzDiscount | BigDecimal | 优惠分摊金额 |
| └ payment | BigDecimal | 实付金额 |
| └ platformNo | String | 平台子单号 |
| └ platformOuterProductCode | String | 平台商家商品编码 |
| └ platformOuterSkuCode | String | 平台商家规格编码 |
| └ platformProductCode | String | 平台商品编码 |
| └ platformProductId | String | 平台商品id |
| └ platformProductName | String | 平台商品名称 |
| └ platformSkuCode | String | 平台规格编码 |
| └ platformSkuId | String | 平台规格id |
| └ platformSkuName | String | 平台规格名称 |
| └ platformStatus | Integer | 平台明细状态 |
| └ presellDeliveryDate | String | 预售预计发货日期,格式:yyyy-MM-dd |
| └ price | BigDecimal | 商品价格 |
| └ productCode | String | 商品编码 |
| └ productId | Long | 商品id |
| └ productName | String | 商品名称 |
| └ qty | Integer | 商品数量 |
| └ quantity | Integer | 发货数量 |
| └ refundStatus | Integer | 退款状态(0:否 10:已申请退款 20:已退款) |
| └ refundType | String | 退款类型(0:退货退款 1:退款 2:换货) |
| └ salesOrderId | Long | 销售单ID |
| └ settlementFee | BigDecimal | 结算金额 |
| └ settlementPrice | BigDecimal | 结算单价 |
| └ skuCode | String | 规格编码 |
| └ skuId | Long | 规格id |
| └ skuName | String | 规格编码 |
| └ totalFee | BigDecimal | 应付金额 |
| └ warehouseCode | String | 实体仓库编码 |
| └ warehouseName | String | 实体仓库名称 |
| └ orderExt | Object | 班牛销售单扩展信息 |
| └ buyerMemo | String | 买家备注 |
| └ currency | String | 币种 |
| └ isInBlacklist | Integer | 是否在黑名单中(0-否 1-是) |
| └ memberId | Long | 会员id |
| └ memberName | String | 会员名称 |
| └ payment | BigDecimal | 支付金额 |
| └ platformOrderStatus | String | 平台订单状态 |
| └ platformPayTime | String | 平台订单付款时间,格式:yyyy-MM-dd HH:mm:ss |
| └ postFee | BigDecimal | 邮费 |
| └ sellerMemo | String | 卖家备注 |
| └ orderFrom | Integer | 订单来源(0:平台 1:手动 2:导入) |
| └ orderStatus | Integer | 订单状态(0:新建 -10:转换异常 -15:占用异常 -20:审核异常 10:待审核 20:待配货 30:已配货 40:已发货 50:已作废 60:已取消 70:已完成) |
| └ orderType | Integer | 订单类型:0-销售订单、1-预付订单、2-换货订单、3-补发订单 |
| └ originalOrderCode | String | 原始订单编号 |
| └ originalOrderId | Long | 原始订单id |
| └ platformCreateTime | String | 平台订单创建时间,格式:yyyy-MM-dd HH:mm:ss |
| └ platformOrderNo | String | 平台交易号 |
| └ province | String | 省 |
| └ remark | String | 备注 |
| └ salesOrderCode | String | OMS订单编号 |
| └ salesOrderId | Long | 销售单ID |
| └ storeCode | String | 店铺编码 |
| └ storeId | Long | 店铺id |
| └ storeName | String | 店铺名称 |
| message | String | 错误信息 |
(8)响应示例:
{
"code": 0,
"data": {
"orderList": [
{
"salesOrderId": 153362640,
"platformOrderNo": "3064563540143586756",
"salesOrderCode": "SO2022120676306518",
"storeId": 3,
"storeCode": "01TM1001",
"storeName": "babycare旗舰店",
"orderStatus": 40,
"dispatchStatus": 30,
"deliveryStatus": 30,
"orderType": 0,
"country": "中国",
"province": "浙江省",
"city": "杭州市",
"district": "滨江区",
"orderExt": {
"memberId": 5034037,
"memberName": "tb5369333866",
"platformOrderStatus": "WAIT_SELLER_SEND_GOODS",
"platformPayTime": "2022-12-06 13:46:30",
"sellerMemo": "",
"postFee": 0,
"payment": 309
},
"orderDetailList": [
{
"id": 374316779,
"platformNo": "126001",
"salesOrderId": 153362640,
"productId": 11624,
"productCode": "AG2101005",
"productName": "儿童折叠滑板车",
"skuId": 46787,
"skuCode": "6941428688156",
"skuName": "蜜橙_DCW",
"qty": 2,
"detailStatus": 40,
"platformStatus": 20,
"refundStatus": 0,
"price": 400,
"totalFee": 400,
"actualPrice": 200,
"payment": 400,
"discountFee": 10,
"adjustFee": 5,
"divideOrderFee": 400,
"partMjzDiscount": 0,
"settlementPrice": 400,
"settlementFee": 400,
"platformOuterProductCode": "202104131345",
"platformOuterSkuCode": "6941428688156",
"isGift": 0,
"expressNo": "1200001",
"expressName": "中通快递",
"expressCode": "ZT",
"warehouseCode": "FLTEST01",
"warehouseName": "富勒测试华南仓",
"quantity": 2,
"imgUrl": "https://bc-oms.oss-cn-hangzhou.aliyuncs.com/prod/img/BABYCARE20221208-141057.jpg"
}
]
}
]
},
"message": null
}
# 班牛补发订单创建
(1)接口地址:/order/supply/create
(2)请求方式:POST
(3)请求数据类型:application/json
(4)响应数据类型:application/json
(5)请求参数:
| 参数名称 | 数据类型 | 是否必须 | 参数说明 |
|---|---|---|---|
| appId | String | true | 应用编号 |
| projectId | String | true | 项目id |
| taskId | String | true | taskId |
| userId | String | true | 用户id |
| address | String | false | 详细地址 |
| city | String | false | 市 |
| district | String | false | 区 |
| isAutoFillAddress | Boolean | true | 是否自动填充地址(true:取原销售订单地址信息后自动填充到该补发单中,false:不更改地址信息) |
| mobile | String | false | 手机 |
| phone | String | false | 电话 |
| platformOrderNo | String | true | 平台交易号 |
| province | String | false | 省 |
| receiverName | String | false | 收货人 |
| storeCode | String | true | 店铺编码 |
| supplyOrderDetailList | List | false | 补发订单明细 |
| └ platformNo | String | false | 平台明细编号 |
| └ qty | Integer | true | 数量 |
| └ settlementFee | BigDecimal | false | 结算金额 |
| └ settlementPrice | BigDecimal | false | 结算单价 |
| └ skuCode | String | true | SKU编码 |
| supplyOrderExt | Object | true | 补发订单扩展 |
| └ buyerMemo | String | false | 买家备注 |
| └ isAfterSale | Integer | false | 是否售后(0-否 1-是) |
| └ memberName | String | false | 会员名称 |
| └ platformPayTime | String | true | 平台支付时间,格式:yyyy-MM-dd HH:mm:ss |
| └ postFee | BigDecimal | false | 邮费 |
| └ reissueReason | String | false | 补发原因 |
| └ sellerMemo | String | false | 卖家备注 |
(6)请求示例:
{
"appId": "1",
"projectId": "1",
"taskId": "1",
"userId": "1",
"platformOrderNo": "1984595080101856930",
"storeCode": "01TM1001",
"receiverName": "收货人名称",
"isAutoFillAddress": true,
"phone": "123456",
"mobile": "654321",
"province": null,
"city": null,
"district": null,
"address": null,
"supplyOrderExt": {
"platformPayTime": "2023-01-09 17:23:45",
"memberName": "",
"isAfterSale": 0,
"postFee": 0.00,
"buyerMemo": "",
"sellerMemo": "",
"reissueReason": ""
},
"supplyOrderDetailList": [
{
"platformNo": "259333164173_25596131627",
"skuCode": "6941428610102",
"qty": 1,
"settlementPrice": 0.00,
"settlementFee": 0.00
}
]
}
(7)响应参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 0:成功 其他失败 |
| data | Object | 无返回数据 |
| message | String | 错误信息 |
(8)响应示例:
{
"code": 0,
"data": null,
"message": "操作成功"
}
# 班牛订单包裹信息查询
(1)接口地址:/order/package/list
(2)请求方式:POST
(3)请求数据类型:application/json
(4)响应数据类型:application/json
(5)请求参数:
| 参数名称 | 数据类型 | 是否必须 | 参数说明 |
|---|---|---|---|
| platformOrderNo | String | true | 平台交易号(三方平台交易单号) |
| storeCode | String | false | 店铺编码 |
| storeName | String | false | 店铺名称 |
| expressNo | String | false | 快递单号 |
(6)请求示例:
{
"platformOrderNo": "3064563540143586756",
"storeCode": "01TM1001",
"expressNo": "1200001"
}
(7)响应参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 0:成功 其他失败 |
| data | Object | 返回数据 |
| └ orderPackageList | List | 订单包裹列表 |
| └ deliveryTime | String | 发货时间,格式:yyyy-MM-dd HH:mm:ss |
| └ expressCode | String | 快递编码 |
| └ expressName | String | 快递名称 |
| └ expressNo | String | 快递单号 |
| └ imgUrl | String | 商品图片 |
| └ platformOrderNo | String | 平台交易号 |
| └ productCode | String | 商品编码 |
| └ productId | Long | 商品id |
| └ productName | String | 商品名称 |
| └ quantity | Integer | 发货数量 |
| └ skuCode | String | sku编码 |
| └ skuId | Long | 规格id |
| └ skuName | String | sku名称 |
| └ storeCode | String | 店铺编码 |
| └ storeName | String | 店铺名称 |
| └ warehouseCode | String | 仓库编码 |
| └ warehouseName | String | 仓库名称 |
| message | String | 错误信息 |
(8)响应示例:
{
"code": 0,
"data": {
"orderPackageList": [
{
"platformOrderNo": "3064563540143586756",
"storeCode": "01TM1001",
"storeName": "babycare旗舰店",
"warehouseCode": "FLTEST01",
"warehouseName": "富勒测试华南仓",
"expressNo": "1200001",
"expressName": "中通快递",
"expressCode": "ZT",
"productId": 11624,
"productCode": "AG2101005",
"productName": "儿童折叠滑板车",
"skuId": 46787,
"skuCode": "6941428688156",
"skuName": "蜜橙_DCW",
"deliveryTime": "2021-02-24 23:50:33",
"quantity": 2,
"imgUrl": "https://bc-oms.oss-cn-hangzhou.aliyuncs.com/prod/img/BABYCARE20221208-141057.jpg"
}
]
},
"message": null
}
# 班牛退货的退款申请和退货通知单创建
(1)接口地址:/order/return/create
(2)请求方式:POST
(3)请求数据类型:application/json
(4)响应数据类型:application/json
(5)请求参数:
| 参数名称 | 数据类型 | 是否必须 | 参数说明 |
|---|---|---|---|
| appId | String | true | 应用编号 |
| projectId | String | true | 项目id |
| taskId | String | true | taskId |
| userId | String | true | 用户id |
| storeCode | String | true | 店铺编码 |
| platformOrderNo | String | true | 平台交易号 |
| salesOrderId | Long | true | 销售订单id |
| platformRefundNo | String | true | 平台退款单号 |
| backExpressNo | String | true | 退入快递单号 |
| backExpressCode | String | true | 退入快递编码 |
| backExpressName | String | false | 退入快递名称 |
| returnInDetailList | List | true | 退入明细 |
| └ salesOrderDetailId | Integer | true | 明细ID |
| └ platformNo | String | true | 子单号 |
| └ skuCode | String | true | SKU编码 |
| └ qty | Integer | true | 数量 |
(6)请求示例:
{
"appId": "1",
"projectId": "1",
"taskId": "1",
"userId": "1",
"storeCode": "01TM1001",
"platformOrderNo": "123456",
"salesOrderId": 0,
"platformRefundNo": "THH1001",
"backExpressNo": "SF100101",
"backExpressCode": "shunfeng",
"backExpressName": "顺丰快递",
"returnInDetailList": [
{
"salesOrderDetailId": 0,
"platformNo": "123456",
"skuCode": "691001",
"qty": 2
}
]
}
(7)响应参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 0:成功 其他失败 |
| data | Object | 返回数据 |
| └ code | Integer | 处理结果码 |
| └ errMsg | String | 处理错误信息 |
| message | String | 错误信息 |
(8)响应示例:
{
"code": 0,
"data": {
"code": 0,
"errMsg": ""
},
"message": ""
}
# 平台交易单查询
(1)接口地址:/order/platformTrade/list
(2)请求方式:POST
(3)请求数据类型:application/json
(4)响应数据类型:application/json
(5)请求参数:
| 参数名称 | 数据类型 | 是否必须 | 参数说明 |
|---|---|---|---|
| platformTradeNos | List<String> | true | 平台交易号列表(三方平台交易单号) |
(6)请求示例:
{
"platformTradeNos": [
"p2610261564629622786"
]
}
(7)响应参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 0:成功 其他失败 |
| data | Object | 返回数据 |
| └ trades | List | 平台交易单列表 |
| └ platformCode | String | 平台编码(平台编码及说明见下方platformCode枚举说明) |
| └ storeCode | String | 店铺编码 |
| └ storeName | String | 店铺名称 |
| └ platformOrderNo | String | 平台订单号 |
| └ memberName | String | 买家会员名 |
| └ platformCreateTime | String | 下单时间,格式:yyyy-MM-dd HH:mm:ss |
| └ payTime | String | 支付时间,格式:yyyy-MM-dd HH:mm:ss |
| └ deliveryTime | String | 发货时间,格式:yyyy-MM-dd HH:mm:ss |
| └ finishTime | String | 完成时间,格式:yyyy-MM-dd HH:mm:ss |
| └ platformUpdateTime | String | 平台更新时间,格式:yyyy-MM-dd HH:mm:ss |
| └ sellerMemo | String | 卖家备注 |
| └ totalFee | BigDecimal | 总金额 |
| └ payment | BigDecimal | 实付金额 |
| └ platformOrderStatus | String | 平台订单状态(平台订单状态及说明见下方platformOrderStatus枚举说明) |
| └ details | List | 交易单明细列表 |
| └ platformSubOrderNo | String | 平台子订单号 |
| └ platformProductId | String | 平台商品ID |
| └ platformSkuId | String | 平台skuID |
| └ platformOuterSkuCode | String | 平台商家外部sku编码(69码) |
| └ platformProductName | String | 平台商品名称 |
| └ price | BigDecimal | 单价 |
| └ payment | BigDecimal | 实付金额 |
| └ qty | Integer | 数量 |
| message | String | 错误信息 |
(8)响应示例:
{
"code": 0,
"data": {
"trades": [
{
"platformCode": "TMALL",
"storeCode": "01TM1001",
"storeName": "babycare旗舰店",
"platformOrderNo": "p2610261564629622786",
"memberName": "买家昵称",
"platformCreateTime": "2026-10-20 10:00:00",
"payTime": "2026-10-20 10:00:05",
"deliveryTime": "2026-10-21 09:00:00",
"finishTime": "2026-10-25 12:00:00",
"platformUpdateTime": "2026-10-25 12:00:00",
"sellerMemo": "备注信息",
"totalFee": 200.00,
"payment": 190.00,
"platformOrderStatus": "TRADE_FINISHED",
"details": [
{
"platformSubOrderNo": "3064563540143586757",
"platformProductId": "6600001",
"platformSkuId": "6600002",
"platformOuterSkuCode": "BC-SKU-001",
"platformProductName": "babycare湿巾80抽",
"price": 100.00,
"payment": 95.00,
"qty": 2
}
]
}
]
},
"message": ""
}
platformCode枚举说明:
| 平台编码 | 平台说明 |
|---|---|
| Tmall | 天猫平台 |
| douyin | 抖音平台 |
| pdd | 拼多多平台 |
| jd | 京东平台 |
| jdvc | 京东厂直平台 |
| haiziwang | 孩子王平台 |
| youzan | 有赞平台 |
| realshark | 锐鲨平台 |
| koala | 考拉平台 |
| beibei | 贝贝平台 |
| vipmp | 唯品MP |
| dangdang | 当当平台 |
| loveStock | 爱库存平台 |
| loveStockv1 | 新爱库存平台 |
| babytree | 宝宝树平台 |
| mallMarket | 猫超商家仓 |
| mos | 喵街 |
| jitx | 唯品会jitx平台 |
| SuningTesco | 苏宁直发(易购)平台 |
| SuningSelf | 苏宁自营平台 |
| jingling | 鲸灵平台 |
| zaojiao | 私欲小程序 |
| internalbuy | 内购平台 |
| redBook | 小红书平台 |
| redbookv1 | 新小红书平台 |
| kuaishou | 快手平台 |
| txhuiju | 惠聚平台 |
| yj | 云集平台 |
| aliexpress | 速卖通平台 |
| shopee | 虾皮平台 |
| baotuan | 今日爆团平台 |
| cloudmall | 腾讯云mall平台 |
| duxiaodian | 度小店平台 |
| haoshiqi | 好食期 |
| dxy | 丁香妈妈 |
| lazada | lazada平台 |
| thirdParty | 支付宝商城 |
| weidian | 微店 |
| leyou | 乐友平台 |
| yangtao | 杨桃平台 |
| dingdang | 叮当平台 |
| tuanhaohuo | 美团团好货 |
| yunhuoYx | 云货优选 |
| bbt | 万物星选 |
| youshi | 优识 |
| hipac | 海拍客 |
| jushuitan | 聚水潭 |
| baisheng | 百胜 |
| other | 其他平台 |
| ali1688 | 阿里1688 |
| jdedi | 京东EDI |
| jdsp | 京东SP |
| bojun | 伯俊 |
| qms | qms系统 |
| tencentVideo | 腾讯视频号 |
| maichun | 麦纯 |
| mitao | 蜜淘 |
| lingxing | 领星 |
| hzwOne | 孩子王一件代发 |
| ktts | 快团团 |
| jingxiaoh5 | 经销H5 |
| yicang | 易仓erp |
| dewu | 得物 |
platformOrderStatus枚举说明:
| 平台订单状态 | 状态说明 |
|---|---|
| WAIT_BUYER_PAY | 等待买家付款 |
| SELLER_CONSIGNED_PART | 卖家部分发货 |
| WAIT_SELLER_SEND_GOODS | 等待卖家发货,即:买家已付款 |
| WAIT_BUYER_CONFIRM_GOODS | 等待买家确认收货,即:卖家已发货 |
| TRADE_BUYER_SIGNED | 买家已签收(货到付款专用) |
| TRADE_FINISHED | 交易成功 |
| TRADE_CLOSED | 付款以后用户退款成功,交易自动关闭 |
| TRADE_CLOSED_BY_TAOBAO | 付款以前,卖家或买家主动关闭交易 |
| PAY_PENDING | 国际信用卡支付付款确认中 |
| WAIT_PRE_AUTH_CONFIRM | 0元购合约中 |
| PAID_FORBID_CONSIGN | 已付款禁止发货 |
| ALL_WAIT_PAY | 所有买家未付款的交易(包含:WAIT_BUYER_PAY、TRADE_NO_CREATE_PAY) |
| ALL_CLOSED | 所有关闭的交易(包含:TRADE_CLOSED、TRADE_CLOSED_BY_TAOBAO) |
| EXCEPTION | 异常 |
# 无头件创建
(1)接口地址:/order/unValidOrder/create
(2)请求方式:POST
(3)请求数据类型:application/json
(4)响应数据类型:application/json
(5)请求参数:
| 参数名称 | 数据类型 | 是否必须 | 参数说明 |
|---|---|---|---|
| asnNo | String | true | WMS无头件单号(唯一标识,幂等键,同一单号重复提交时返回已存在单据信息,不重复创建) |
| expressName | String | true | 快递名称(如:顺丰速运) |
| expressNo | String | true | 快递单号(原面单快递单号) |
| expressCode | String | true | 快递编码(快递公司编码) |
| memberName | String | false | 寄件人 |
| mobile | String | false | 手机号 |
| signer | String | true | 签收人 |
| signTime | String | true | 签收时间,格式:yyyy-MM-dd HH:mm:ss |
| unpacker | String | true | 拆包人 |
| unpackTime | String | true | 拆包时间,格式:yyyy-MM-dd HH:mm:ss |
| inStorageTime | String | true | 入库时间,格式:yyyy-MM-dd HH:mm:ss |
| mark | String | false | 备注 |
| warehouseCode | String | true | 仓库编码 |
| warehouseName | String | true | 仓库名称 |
| addressInfo | Object | false | 地址信息 |
| └ country | String | false | 国(默认:中国) |
| └ province | String | false | 省 |
| └ city | String | false | 市 |
| └ district | String | false | 区 |
| └ town | String | false | 镇 |
| └ addressDetail | String | false | 详细地址 |
| detailList | List | true | 无头件明细集合 |
| └ skuCode | String | true | 规格编码 |
| └ skuName | String | true | 规格名称 |
| └ stockQty | Integer | true | 退入数量(注:数量必须大于0) |
| └ inventoryType | String | true | 库存属性(ZP:良品,CP:次品,注:仅允许传ZP或CP) |
(6)请求示例:
{
"asnNo": "ASN202610270001",
"expressName": "顺丰速运",
"expressNo": "SF1390012345678",
"expressCode": "SF",
"memberName": "张三",
"mobile": "13800138000",
"signer": "李四",
"signTime": "2026-10-27 09:30:00",
"unpacker": "王五",
"unpackTime": "2026-10-27 10:00:00",
"inStorageTime": "2026-10-27 10:30:00",
"mark": "面单破损,拆包后无头件入库",
"warehouseCode": "WH001",
"warehouseName": "杭州退货仓",
"addressInfo": {
"country": "中国",
"province": "浙江省",
"city": "杭州市",
"district": "余杭区",
"town": "仓前街道",
"addressDetail": "文一西路1000号"
},
"detailList": [
{
"skuCode": "SKU000001",
"skuName": "婴儿纸尿裤L码",
"stockQty": 2,
"inventoryType": "ZP"
},
{
"skuCode": "SKU000002",
"skuName": "婴儿湿巾80抽",
"stockQty": 1,
"inventoryType": "CP"
}
]
}
(7)响应参数:
| 参数名称 | 数据类型 | 参数说明 |
|---|---|---|
| code | Integer | 0:成功 其他失败 |
| message | String | 错误信息 |
(8)响应示例:
{
"code": 0,
"message": ""
}