订单新增

POST

/open/order/add

建议参考下方右侧示例值来传递数据。
为更好的支持海外仓处理订单的时效，请各大ERP尽可能的传递 outPromisedShippingTime 参数（即最晚履约时间、SLA时间、剩余发货时间等意思）

支持已作废的订单，使用旧单号重复下发。

请求参数

Header 参数

Body 参数application/json

示例

{
    "erpOrderCode": "S123456789",
    "warehouseId": 1000,
    "shipmentProvider": "JT EXPRESS",
    "expressNo": "123456",
    "waybillPdfUrl": "string",
    "waybillPdfBase64": "string",
    "countryCode": "MYS",
    "country": "Malaysia",
    "city": "Bandar Baharu",
    "district": "Bandar Baharu",
    "province": "Bandar Baharu",
    "address": "Bandar Baharu",
    "zipcode": "123456",
    "contact": "bob",
    "mobile": "15454125412",
    "currency": "MYR",
    "details": [
        {
            "quantity": 1,
            "actualPrice": 18.8,
            "skuCode": "test-123"
        }
    ],
    "payAmount": 150,
    "paidTime": "2019-08-24T14:15:22Z",
    "outPromisedShippingTime": "2019-08-24T14:15:22Z",
    "outCreateTime": "2019-08-24T14:15:22Z",
    "outSalesOrderCode": "47888888888",
    "shippingFee": 8,
    "storeId": 0,
    "isCod": "1",
    "sellerRemark": "卖家备注",
    "cusRemark": "123",
    "isAutoAudit": true,
    "packageType": "box"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/open/order/add' \
--header 'Authorization: Bearer {{token}}' \
--header 'timestamp: {{timestamp}}' \
--header 'sign: {{sign}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "erpOrderCode": "S123456789",
    "warehouseId": 1000,
    "shipmentProvider": "JT EXPRESS",
    "expressNo": "123456",
    "waybillPdfUrl": "string",
    "waybillPdfBase64": "string",
    "countryCode": "MYS",
    "country": "Malaysia",
    "city": "Bandar Baharu",
    "district": "Bandar Baharu",
    "province": "Bandar Baharu",
    "address": "Bandar Baharu",
    "zipcode": "123456",
    "contact": "bob",
    "mobile": "15454125412",
    "currency": "MYR",
    "details": [
        {
            "quantity": 1,
            "actualPrice": 18.8,
            "skuCode": "test-123"
        }
    ],
    "payAmount": 150,
    "paidTime": "2019-08-24T14:15:22Z",
    "outPromisedShippingTime": "2019-08-24T14:15:22Z",
    "outCreateTime": "2019-08-24T14:15:22Z",
    "outSalesOrderCode": "47888888888",
    "shippingFee": 8,
    "storeId": 0,
    "isCod": "1",
    "sellerRemark": "卖家备注",
    "cusRemark": "123",
    "isAutoAudit": true,
    "packageType": "box"
}'

返回响应

🟢200OK

application/json

code错误码：
20000 参数有误
20001 订单重复
20003 查询日期范围过大
20004 明细商品SKU不存在

Body

示例

{
    "code": 0,
    "msg": "string",
    "data": {
        "salesOrderCode": "string"
    },
    "trace": "string",
    "extra": {
        "property1": {},
        "property2": {}
    },
    "ok": true
}

🟠400Bad Request

🟠403Forbidden

🔴500Internal Server Error

🟠424授权过期

🟠429限流

修改于 2025-11-13 02:47:37

商品单位

订单列表