轻易云
注册体验

领星ERP查询货件装箱信息接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
FBA / FBA货件(STA) · POST · 请求参数 4 个(必填 1) · 响应参数 42 个 · 限流令牌桶容量 1
更新日期
2026-11-21

查询货件装箱信息

POST/amzStaServer/openapi/inbound-shipment/listShipmentBoxes
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/amzStaServer/openapi/inbound-shipment/listShipmentBoxes"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/amzStaServer/openapi/inbound-shipment/listShipmentBoxes?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"sid\": 123456,\n    \"shipmentConfirmationId\": \"FBA190XXXXXK\"\n}'",
  "responseExample": {
    "code": 0,
    "message": "操作成功",
    "errorDetails": null,
    "requestId": "4848b0c49fa64012a381c81bdf826d30.1733129764446",
    "responseTime": "2024-12-02T16:56:04.446",
    "data": {
      "inboundPlanId": "wf99cc1a5d-b08d-4237-8419-bd63ce084f7d",
      "shipmentList": [
        {
          "shipmentId": "sh58020432-5479-48f7-b730-5786820eed44",
          "shipmentPackingList": [
            {
              "localBoxId": "1",
              "packageId": null,
              "boxId": null,
              "total": 1,
              "weight": 12.32,
              "weightUnit": "KG",
              "length": 12,
              "width": 3,
              "height": 4,
              "lengthUnit": "CM",
              "productList": [
                {
                  "msku": "20240122-GM",
                  "fnsku": "X0047Z5K5Z",
                  "asin": "B0CM59V6Y8",
                  "parentAsin": "B0CPSY8HFP",
                  "productName": "饭饭饭",
                  "sku": "ggggasda",
                  "title": "Note Grid, Note Paper, Minimalist and Creative, Cute Note Book, Non Sticky-GM",
                  "url": "https://m.media-amazon.com/images/I/61-v2WaQOhL._SL75_.jpg",
                  "expiration": "2025-11-01",
                  "quantityInBox": 1,
                  "prepOwner": "SELLER",
                  "labelOwner": "SELLER"
                }
              ]
            },
            {
              "localBoxId": "2",
              "packageId": null,
              "boxId": null,
              "total": 1,
              "weight": 5.33,
              "weightUnit": "KG",
              "length": 2,
              "width": 13,
              "height": 4,
              "lengthUnit": "CM",
              "productList": [
                {
                  "msku": "CN0002",
                  "fnsku": "X00489S3FJ",
                  "asin": "B0D3F2W56C",
                  "parentAsin": "B0D3F2W56C",
                  "productName": "随便spu-3",
                  "sku": "asdkpasdk",
                  "title": "Notes,Creative Cartoon,Students,Can Post It,Can Tear Messages N Times Paste",
                  "url": "https://m.media-amazon.com/images/I/51YvC-1dvXL._SL75_.jpg",
                  "expiration": "2025-11-01",
                  "quantityInBox": 1,
                  "prepOwner": "SELLER",
                  "labelOwner": "SELLER"
                }
              ]
            },
            {
              "localBoxId": "3",
              "packageId": null,
              "boxId": null,
              "total": 1,
              "weight": 5.33,
              "weightUnit": "KG",
              "length": 2,
              "width": 13,
              "height": 4,
              "lengthUnit": "CM",
              "productList": [
                {
                  "msku": "CN0002",
                  "fnsku": "X00489S3FJ",
                  "asin": "B0D3F2W56C",
                  "parentAsin": "B0D3F2W56C",
                  "productName": "随便spu-3",
                  "sku": "asdkpasdk",
                  "title": "Notes,Creative Cartoon,Students,Can Post It,Can Tear Messages N Times Paste",
                  "url": "https://m.media-amazon.com/images/I/51YvC-1dvXL._SL75_.jpg",
                  "expiration": "2025-11-01",
                  "quantityInBox": 1,
                  "prepOwner": "SELLER",
                  "labelOwner": "SELLER"
                }
              ]
            },
            {
              "localBoxId": "4",
              "packageId": null,
              "boxId": null,
              "total": 2,
              "weight": 7.55,
              "weightUnit": "KG",
              "length": 2.99,
              "width": 3.22,
              "height": 4.33,
              "lengthUnit": "CM",
              "productList": [
                {
                  "msku": "STN0002",
                  "fnsku": "X00489S34P",
                  "asin": "B0D3F37ZPB",
                  "parentAsin": "B0D3F37ZPB",
                  "productName": "成本",
                  "sku": "117009ZZ",
                  "title": "Note Grid, Note Paper, Minimalist and Creative, Cute Note Book, Non Sticky",
                  "url": "https://m.media-amazon.com/images/I/61FW9bR5rKL._SL75_.jpg",
                  "expiration": "2025-11-01",
                  "quantityInBox": 2,
                  "prepOwner": "SELLER",
                  "labelOwner": "SELLER"
                }
              ]
            }
          ],
          "palletList": []
        },
        {
          "shipmentId": "sh3c90571c-5655-44cc-a18f-3d7479623816",
          "shipmentPackingList": [
            {
              "localBoxId": "1",
              "packageId": null,
              "boxId": null,
              "total": 3,
              "weight": 12.33,
              "weightUnit": "KG",
              "length": 12.22,
              "width": 5.66,
              "height": 7.55,
              "lengthUnit": "CM",
              "productList": [
                {
                  "msku": "20240122-GM",
                  "fnsku": "X0047Z5K5Z",
                  "asin": "B0CM59V6Y8",
                  "parentAsin": "B0CPSY8HFP",
                  "productName": "饭饭饭",
                  "sku": "ggggasda",
                  "title": "Note Grid, Note Paper, Minimalist and Creative, Cute Note Book, Non Sticky-GM",
                  "url": "https://m.media-amazon.com/images/I/61-v2WaQOhL._SL75_.jpg",
                  "expiration": "2025-11-01",
                  "quantityInBox": 1,
                  "prepOwner": "SELLER",
                  "labelOwner": "SELLER"
                },
                {
                  "msku": "CN0002",
                  "fnsku": "X00489S3FJ",
                  "asin": "B0D3F2W56C",
                  "parentAsin": "B0D3F2W56C",
                  "productName": "随便spu-3",
                  "sku": "asdkpasdk",
                  "title": "Notes,Creative Cartoon,Students,Can Post It,Can Tear Messages N Times Paste",
                  "url": "https://m.media-amazon.com/images/I/51YvC-1dvXL._SL75_.jpg",
                  "expiration": "2025-11-01",
                  "quantityInBox": 1,
                  "prepOwner": "SELLER",
                  "labelOwner": "SELLER"
                },
                {
                  "msku": "STN0002",
                  "fnsku": "X00489S34P",
                  "asin": "B0D3F37ZPB",
                  "parentAsin": "B0D3F37ZPB",
                  "productName": "成本",
                  "sku": "117009ZZ",
                  "title": "Note Grid, Note Paper, Minimalist and Creative, Cute Note Book, Non Sticky",
                  "url": "https://m.media-amazon.com/images/I/61FW9bR5rKL._SL75_.jpg",
                  "expiration": "2025-11-01",
                  "quantityInBox": 1,
                  "prepOwner": "SELLER",
                  "labelOwner": "SELLER"
                }
              ]
            },
            {
              "localBoxId": "2",
              "packageId": null,
              "boxId": null,
              "total": 2,
              "weight": 8.36,
              "weightUnit": "KG",
              "length": 4.22,
              "width": 5.33,
              "height": 1.22,
              "lengthUnit": "CM",
              "productList": [
                {
                  "msku": "20240122-GM",
                  "fnsku": "X0047Z5K5Z",
                  "asin": "B0CM59V6Y8",
                  "parentAsin": "B0CPSY8HFP",
                  "productName": "饭饭饭",
                  "sku": "ggggasda",
                  "title": "Note Grid, Note Paper, Minimalist and Creative, Cute Note Book, Non Sticky-GM",
                  "url": "https://m.media-amazon.com/images/I/61-v2WaQOhL._SL75_.jpg",
                  "expiration": "2025-11-01",
                  "quantityInBox": 1,
                  "prepOwner": "SELLER",
                  "labelOwner": "SELLER"
                },
                {
                  "msku": "CN0002",
                  "fnsku": "X00489S3FJ",
                  "asin": "B0D3F2W56C",
                  "parentAsin": "B0D3F2W56C",
                  "productName": "随便spu-3",
                  "sku": "asdkpasdk",
                  "title": "Notes,Creative Cartoon,Students,Can Post It,Can Tear Messages N Times Paste",
                  "url": "https://m.media-amazon.com/images/I/51YvC-1dvXL._SL75_.jpg",
                  "expiration": "2025-11-01",
                  "quantityInBox": 1,
                  "prepOwner": "SELLER",
                  "labelOwner": "SELLER"
                }
              ]
            }
          ],
          "palletList": [
            {
              "weight": 13,
              "weightUnit": "LB",
              "length": 12,
              "width": 9,
              "height": 5,
              "lengthUnit": "IN",
              "quantity": 3,
              "stackability": "STACKABLE"
            }
          ]
        }
      ]
    }
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1inboundPlanIdSTA任务编号string—可选STA任务编号,对应创建STA任务接口对应字段【inboundPlanId】;使用原方式查询时需同时传入 shipmentIdList
2shipmentIdList货件idarray<any>—可选货件id;使用原方式查询时需同时传入 inboundPlanId
3shipmentConfirmationId货件单号string—可选货件单号;传入该字段时,不需要传 inboundPlanId 和货件 ID
4sid亚马逊店铺sidinteger—必填亚马逊店铺sid,对应查询亚马逊店铺列表接口对应字段【sid】

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message消息提示stringsuccess必填消息提示
3errorDetails错误信息array<any>—必填错误信息
4requestId请求链路idstring—必填请求链路id
5responseTime响应时间string2020-05-18 11:23:47必填响应时间
6data响应数据object—必填响应数据
6.1inboundPlanIdSTA任务编号string—必填STA任务编号
6.2shipmentList货件装箱信息array<object>—必填货件装箱信息
6.2.1palletList托帕明细array<object>—必填托帕明细
6.2.1.1height托帕高度number—必填托帕高度
6.2.1.2length托帕长度number—必填托帕长度
6.2.1.3lengthUnit长度单位(IN-英制string—必填长度单位(IN-英制,CM-公制)
6.2.1.4quantity托帕数量integer—必填托帕数量
6.2.1.5stackability是是可堆叠string—必填是是可堆叠
6.2.1.6weight托帕重量number—必填托帕重量
6.2.1.7weightUnit重量单位(LB-磅string—必填重量单位(LB-磅,KG-千克)
6.2.1.8width托帕宽度number—必填托帕宽度
6.2.2shipmentId货件idstring—必填货件id
6.2.3shipmentPackingList装箱明细array<object>—必填装箱明细
6.2.3.1boxId箱子idstring—必填箱子id
6.2.3.2height箱子高度number—必填箱子高度
6.2.3.3length箱子长度number—必填箱子长度
6.2.3.4lengthUnit长度单位string—必填长度单位:含IN、CM
6.2.3.5packageId包裹idstring—必填包裹id
6.2.3.6productList商品明细array<object>—必填商品明细
6.2.3.6.1asinasinstring—必填asin
6.2.3.6.2expiration有效期string—必填有效期
6.2.3.6.3fnskufnskustring—必填fnsku
6.2.3.6.4labelOwner标签类型(AMAZONstring—必填标签类型(AMAZON,SELLER,NONE)
6.2.3.6.5mskumskustring—必填msku
6.2.3.6.6parentAsin父asinstring—必填父asin
6.2.3.6.7prepOwner预处理提供方(AMAZONstring—必填预处理提供方(AMAZON,SELLER,NONE)
6.2.3.6.8productName品名string—必填品名
6.2.3.6.9quantityInBox单箱数量integer—必填单箱数量
6.2.3.6.10skuskustring—必填sku
6.2.3.6.11title标题string—必填标题
6.2.3.6.12url图片urlstring—必填图片url
6.2.3.7total商品总数量integer—必填商品总数量
6.2.3.8weight箱子重量number—必填箱子重量
6.2.3.9weightUnit重量单位string—必填重量单位:含LB、KG
6.2.3.10width箱子宽度number—必填箱子宽度
6.2.3.11box_name箱名string先装箱再分仓时:P1-B1 <br>先分仓再装箱时:FBA18QJFDCWJ - B11必填箱名 先装箱再分仓时box_name格式为【Px-By】,表示包装x组第y箱; 先分仓再装箱时box_name格式为【货件单号-Bx】,表示货件第x箱

领星ERP的接口:查询货件装箱信息(/amzStaServer/openapi/inbound-shipment/listShipmentBoxes),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。