创建出库单

POST

/api/v1/outboundOrder

OutboundOrder

创建出库单。

入参要求： toCountry 仅支持 ISO 3166-1 alpha-2 两位大写字母国家码（如 US、CN），不支持三位国家码或国家名称。

返回数据： data 为已创建的出库单信息，结构与查询接口的 OrderQueryVo 一致。

wmsOrderNo 为系统生成的 WMS 单号，platformOrderNo 对应请求的平台单号。

orderState 与查询接口使用相同枚举：DRAFT（草稿）、NOT_OUT（未出库）、OUTED（已出库）、ERROR（异常）、CANCEL（已取消）。

创建成功后会异步审核订单；创建响应通常为 DRAFT，不代表已完成审核或出库，请通过查询接口获取最新状态。

trackingNo、outTime 等尚未产生的信息可能为空；创建响应不填充 charges 和 details，应通过查询接口获取。

所需权限： outbound:write

使用场景：

电商平台创建发货订单

ERP系统推送出库指令

订单系统同步出库需求

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

Body 参数application/json必填

示例

MTW 渠道 - 手动传入 boxesMTW 渠道 - 不传 boxes，由系统自动生成

显式指定两箱，每箱包含一个 SKU；所有箱内同一 SKU 的数量合计须与 details 中的数量一致。

{
    "params": null,
    "orderType": "DROP_SHIPPING",
    "expressChannelsCode": "FEDEX_GROUND_MTW",
    "labelUrl": null,
    "packingListUrls": null,
    "trackingNo": null,
    "signatureService": null,
    "platformOrderNo": "a31",
    "referenceNo": null,
    "warehouseCode": "LASP",
    "toFullName": "AAAA",
    "toNumber": "1234567890",
    "toCountry": "US",
    "toProvince": "CA",
    "toCity": "Los Angeles",
    "toAddressLine1": "123 Test Street",
    "toAddressLine2": "",
    "toZipCode": "90001",
    "details": [
        {
            "params": null,
            "sku": "EC-TEST1",
            "quantity": 1
        },
        {
            "params": null,
            "sku": "EC-TEST2",
            "quantity": 1
        }
    ],
    "boxes": [
        {
            "boxNo": 1,
            "items": [
                {
                    "sku": "EC-TEST1",
                    "quantity": 1
                }
            ]
        },
        {
            "boxNo": 2,
            "items": [
                {
                    "sku": "EC-TEST2",
                    "quantity": 1
                }
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

MTW 渠道 - 手动传入 boxesMTW 渠道 - 不传 boxes，由系统自动生成

curl --location 'https://gwms.jmalltech.com/api-gateway/api/v1/outboundOrder' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "params": null,
    "orderType": "DROP_SHIPPING",
    "expressChannelsCode": "FEDEX_GROUND_MTW",
    "labelUrl": null,
    "packingListUrls": null,
    "trackingNo": null,
    "signatureService": null,
    "platformOrderNo": "a31",
    "referenceNo": null,
    "warehouseCode": "LASP",
    "toFullName": "AAAA",
    "toNumber": "1234567890",
    "toCountry": "US",
    "toProvince": "CA",
    "toCity": "Los Angeles",
    "toAddressLine1": "123 Test Street",
    "toAddressLine2": "",
    "toZipCode": "90001",
    "details": [
        {
            "params": null,
            "sku": "EC-TEST1",
            "quantity": 1
        },
        {
            "params": null,
            "sku": "EC-TEST2",
            "quantity": 1
        }
    ],
    "boxes": [
        {
            "boxNo": 1,
            "items": [
                {
                    "sku": "EC-TEST1",
                    "quantity": 1
                }
            ]
        },
        {
            "boxNo": 2,
            "items": [
                {
                    "sku": "EC-TEST2",
                    "quantity": 1
                }
            ]
        }
    ]
}'

返回响应

🟢201已创建

application/json

出库单已成功创建

Bodyapplication/json

示例

{
    "success": true,
    "code": "201",
    "message": "创建成功",
    "timestamp": "2026-10-19T02:30:00Z",
    "data": {
        "wmsOrderNo": "OUT202610190001",
        "platformOrderNo": "SHOP202610190001",
        "orderType": "DROP_SHIPPING",
        "orderState": "DRAFT",
        "customerCode": "CUSTOMER001",
        "warehouseCode": "US01",
        "expressChannelCode": "FEDEX_GROUND",
        "toFullName": "Jane Smith",
        "toNumber": "+12025550123",
        "toCountry": "US",
        "toProvince": "CA",
        "toCity": "Los Angeles",
        "toAddressLine1": "123 Main St",
        "toZipCode": "90001",
        "createTime": "2026-10-19T02:30:00Z"
    }
}

🟠400权限不足

🟠401冲突

🟠403无法处理的实体

🟠409请求有误

🟠422未认证

🔴500服务器内部错误

修改于 2026-10-19 09:43:20

更新入库单状态

取消出库单