易达优送开放平台
  1. 订单
易达优送开放平台
  • WMS海外仓开放平台
    • 开发者必读
      • 对接说明
      • 枚举描述
    • 基础资料
      • 国家
      • 仓库可发渠道
      • 商品分类列表
      • 仓库
    • 商品
      • 新增商品
      • 编辑商品
      • 取消商品
      • 商品详情
      • 标签(面单)
      • 获取客户所有商品
    • 入库
      • 新增入库单
      • 确认入库单
      • 取消入库单
      • 入库详情
    • 订单
      • 新增订单
        POST
      • 取消订单
        POST
      • 订单详情
        POST
      • 标签(面单)
        POST
      • 拦截订单
        POST
      • 更新订单快递标和物流追踪号
        POST
      • 上传订单附件
        POST
    • 库存
      • 商品库存
    • 退货
      • 新增退货单
      • 取消退货单
      • 退货单列表
  • 数据模型
    • 示例数据模型
    • WMS常用数据模型
      • 商品Vo
      • 分页响应
      • 响应体数据结构
      • 国家
      • 新增或编辑商品
      • 客户参考号-入库
  1. 订单

新增订单

POST
/api/customer/operation/createOrder

请求参数

Header 参数

Body 参数application/json

示例
{
    "isMultiPack": "N",// 是否一单多包
    "warehouseCode": "wh",// 仓库编码
    "channelCode": "US-POSTAL-S",// 渠道编码
    "frtTrackNumber": "FRT1122",// 物流追踪号
    "customerOrderNo": "CUS20240601-1",// 客户订单号
    "platform": "",// 销售平台
    "platformOrderId": "",//平台订单号
    "remark": "zheshibeizhu",
    "insuranceAmount": "",
    "consignee": "jack",
    "consigneeCCode": "US",// 收件人国家简码
    "consigneeProvince": "CA",//收件人省州
    "consigneeCity": "San Francisco",//收件人城市
    "consigneeZipcode": "94102",// 收件人邮编
    "consigneeAddress": "San",// 收件人详细地址
    "consigneeTelephone": "13822222323",// 收件人联系电话
    "onlineLabelUrl":"http://labelurl2334455667", //面单URL地址
    "carrier":"UPS",//物流承运商
    "signatureService":"",//签名服务
    "tWmsOrderHscodeList": [// SKU信息
        {
            "skuCode": "4580796976186",// SKU编码
            "tradeNameCn": "便携式电子烟",// 中文品名
            "tradeNameEn": "ROO POD(3 PODS)",// 英文品名
            "quantity": "1",// 数量
            "price": 20 // 申报单价
        }
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://192.168.8.18:3080/api/customer/operation/createOrder' \
--header 'apiKey: 5ff6e6a70376ba11a42e277086598d4a' \
--header 'signature: 4590A48221F34CE299EA2D74036246F5' \
--header 'timestamp: 1717381423' \
--header 'sourceFrom: lingxing' \
--header 'Content-Type: application/json' \
--data-raw '{
    "isMultiPack": "N",// 是否一单多包
    "warehouseCode": "wh",// 仓库编码
    "channelCode": "US-POSTAL-S",// 渠道编码
    "frtTrackNumber": "FRT1122",// 物流追踪号
    "customerOrderNo": "CUS20240601-1",// 客户订单号
    "platform": "",// 销售平台
    "platformOrderId": "",//平台订单号
    "remark": "zheshibeizhu",
    "insuranceAmount": "",
    "consignee": "jack",
    "consigneeCCode": "US",// 收件人国家简码
    "consigneeProvince": "CA",//收件人省州
    "consigneeCity": "San Francisco",//收件人城市
    "consigneeZipcode": "94102",// 收件人邮编
    "consigneeAddress": "San",// 收件人详细地址
    "consigneeTelephone": "13822222323",// 收件人联系电话
    "onlineLabelUrl":"http://labelurl2334455667", //面单URL地址
    "carrier":"UPS",//物流承运商
    "signatureService":"",//签名服务
    "tWmsOrderHscodeList": [// SKU信息
        {
            "skuCode": "4580796976186",// SKU编码
            "tradeNameCn": "便携式电子烟",// 中文品名
            "tradeNameEn": "ROO POD(3 PODS)",// 英文品名
            "quantity": "1",// 数量
            "price": 20 // 申报单价
        }
    ]
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "success": true,
    "message": "操作成功!",
    "code": 200,
    "result": {
        "data": {
            "trackNumber": "WTSUS0000940384YQ",
            "frtTrackNumber": "6AH00191847323",
            "preShippingFee": "6.66",
            "preShippingFeeRemark":"计费明细:包裹1的计费重量=1.500KG(转换到报价计费重量=3.3069 LB), 计费币种 USD ,报价分区码 4,计费过程: 【总价】计费模式的费用:6.6600;",
            "preShippingFeeCurrency":"USD",
            "carrier": "USPS",
            "channelCode": "ABX",
            "packageList": [ //一单多包返回
                {
                    "skuQuantity": 1,
                    "frtTrackNumber": "6AH00191847323",
                    "skuCode": "MKD2024040005"
                },
                {
                    "skuQuantity": 1,
                    "frtTrackNumber": "FA562235042RP",
                    "skuCode": "AMKD2024060003"
                }
            ]
        }
    },
    "timestamp": 1717125145449
}
🟢200成功(重复推送订单)
🟢200失败(但会创建草稿订单)
修改于 2025-11-13 11:16:47
上一页
入库详情
下一页
取消订单
Built with