# 订单中心模块

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": ""
}