写入入库单序列号

POST

/api/v1/inbound/orders/{inboundNo}/serial-numbers

Serial Numbers

按SKU写入入库单的序列号，支持追加（APPEND，默认）和整组覆盖（REPLACE）。 - 入库单状态需为草稿、待审核、待上架、已收货或已完成 - 只能写入本单已开启序列号管理的SKU；每个SKU的序列号总数（含已出库）不能超过可录入上限 - 同一序列号不能出现在其他入库单或本单其他SKU下 - 校验失败时整个请求不生效 - 删除或修改序列号请用 REPLACE 提交该SKU的完整列表（一删一增会作为“修改”同步到代理仓）

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Path 参数

Body 参数application/json必填

示例

{
    "mode": "APPEND",
    "items": [
        {
            "skuCode": "string",
            "serialNos": [
                "string"
            ]
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://gwms.jmalltech.com/api-gateway/api/v1/inbound/orders//serial-numbers' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "mode": "APPEND",
    "items": [
        {
            "skuCode": "string",
            "serialNos": [
                "string"
            ]
        }
    ]
}'

返回响应

🟢200

application/json

写入成功，返回写入后的入库单序列号

Bodyapplication/json

示例

{
    "success": true,
    "message": "操作成功",
    "code": "200",
    "timestamp": "2024-01-01T00:00:00Z",
    "data": {
        "inboundNo": "string",
        "items": [
            {
                "skuCode": "string",
                "gsku": "string",
                "skuName": "string",
                "expectedQuantity": 0,
                "receivedQuantity": 0,
                "serialNoLimitQuantity": 0,
                "serialNos": [
                    "string"
                ],
                "outboundSerialNos": [
                    "string"
                ]
            }
        ]
    }
}

🟠400

🟠401

🟠403

🟠404

🟠409

🔴500

修改于 2026-11-04 08:49:12

查看入库单序列号

查询序列号