海星仓开放平台
  1. 入库(带箱唛)
海星仓开放平台
  • 开发指南
    • 对接必看
    • 错误码
    • 枚举
    • 授权接口
      POST
  • 基础资料
    • 店铺列表
      GET
    • 开通的仓库列表
      GET
    • 物流渠道列表
      GET
    • 国家列表
      GET
  • 商品
    • 商品修改
      POST
    • 商品删除
      POST
    • 商品新增
      POST
    • 商品列表
      POST
    • 商品详情
      POST
    • 商品分类
      GET
    • 商品品牌
      GET
    • 商品单位
      GET
  • 订单
    • 订单新增
      POST
    • 订单列表
      GET
    • 订单详情
      POST
    • 包裹列表
      GET
    • 订单拦截
      POST
  • 库存
    • 库存查询
    • 库存日志查询
  • 入库
    • 新增入库预约
    • 入库预约详情
    • 入库预约列表
    • 入库预约完结
    • 入库预约作废
  • 入库(带箱唛)
    • 新增入库预约
      POST
    • 入库预约详情
      POST
    • 入库预约列表
      POST
    • 入库预约完结
      POST
    • 入库预约作废
      POST
  • 退货
    • 退件列表
    • 退件申请详情
  • 订阅推送
    • 推送对接必看
    • 订单状态推送
    • 入库结果推送
    • 测试推送
    • 商品信息推送
  1. 入库(带箱唛)

新增入库预约

POST
/open/inboundNotice/add
新增入库预约

请求参数

Header 参数

Body 参数application/json

示例
{
    "warehouseId": "仓库ID",
    "thirdCode": "三方ERP单号",
    "expressName": "物流名称",
    "expressNo": "物流单号",
    "orderVolume": "预报体积",
    "orderWeight": "预报重量",
    "orderPieces": "预报总箱数",
    "details": [
        {
            "skuCode": "SKU1",
            "boxList": [ // 分别装100个数量
                {
                    "boxNo": "A20251111-001",
                    "quantity": 100,
                    "boxOrder": 1 // 可不传递
                    // 箱子的整型递增顺序,
                    // 和箱唛号捆绑表达第几个箱子
                },
                {
                    "boxNo": "A20251111-002",
                    "quantity": 100,
                    "boxOrder": 2
                }
            ]
        },
        {
            "skuCode": "SKU2",
            "boxList": [
                {
                    // 混装到A20251111-002
                    "boxNo": "A20251111-002",
                    "quantity": 50,
                    "boxOrder": 2
                },
                {
                    // 独立装箱100个
                    "boxNo": "A20251111-003",
                    "quantity": 100,
                    "boxOrder": 3
                }
            ]
        },
        {
            "skuCode": "SKU3",
            "boxList": [
                {
                    // 独立装箱100个
                    "boxNo": "A20251111-004",
                    "quantity": 100,
                    "boxOrder": 4
                }
            ]
        }
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/open/inboundNotice/add' \
--header 'Authorization: Bearer {{token}}' \
--header 'timestamp: {{timestamp}}' \
--header 'sign: {{sign}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "warehouseId": "仓库ID",
    "thirdCode": "三方ERP单号",
    "expressName": "物流名称",
    "expressNo": "物流单号",
    "orderVolume": "预报体积",
    "orderWeight": "预报重量",
    "orderPieces": "预报总箱数",
    "details": [
        {
            "skuCode": "SKU1",
            "boxList": [ // 分别装100个数量
                {
                    "boxNo": "A20251111-001",
                    "quantity": 100,
                    "boxOrder": 1 // 可不传递
                    // 箱子的整型递增顺序,
                    // 和箱唛号捆绑表达第几个箱子
                },
                {
                    "boxNo": "A20251111-002",
                    "quantity": 100,
                    "boxOrder": 2
                }
            ]
        },
        {
            "skuCode": "SKU2",
            "boxList": [
                {
                    // 混装到A20251111-002
                    "boxNo": "A20251111-002",
                    "quantity": 50,
                    "boxOrder": 2
                },
                {
                    // 独立装箱100个
                    "boxNo": "A20251111-003",
                    "quantity": 100,
                    "boxOrder": 3
                }
            ]
        },
        {
            "skuCode": "SKU3",
            "boxList": [
                {
                    // 独立装箱100个
                    "boxNo": "A20251111-004",
                    "quantity": 100,
                    "boxOrder": 4
                }
            ]
        }
    ]
}'

返回响应

🟢200成功
*/*
OK
Body

示例
{
    "code": 0,
    "msg": "string",
    "data": {
        "inboundNoticeCode": "string",
        "skuNotFound": [
            "string"
        ]
    },
    "trace": "string",
    "extra": {
        "property1": {},
        "property2": {}
    },
    "ok": true
}
🟠400请求有误
🟠403禁止访问
🔴500服务器错误
🟠424授权过期
🟠429限流
修改于 2025-12-08 10:24:19
上一页
入库预约作废
下一页
入库预约详情
Built with