Qeasy Cloud
Get Started

领星ERP 查询货件装箱信息 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
FBA / FBA货件(STA) · POST · 请求参数 4 个(必填 1) · 响应参数 42 个 · 限流令牌桶容量 1
Updated At
2026-11-21

查询货件装箱信息

POST/amzStaServer/openapi/inbound-shipment/listShipmentBoxes
Factory
{
  "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"
            }
          ]
        }
      ]
    }
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1inboundPlanIdSTA任务编号string—OptionalSTA任务编号,对应创建STA任务接口对应字段【inboundPlanId】;使用原方式查询时需同时传入 shipmentIdList
2shipmentIdList货件idarray<any>—Optional货件id;使用原方式查询时需同时传入 inboundPlanId
3shipmentConfirmationId货件单号string—Optional货件单号;传入该字段时,不需要传 inboundPlanId 和货件 ID
4sid亚马逊店铺sidinteger—Required亚马逊店铺sid,对应查询亚马逊店铺列表接口对应字段【sid】

Response Parameters

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

The 查询货件装箱信息 API (/amzStaServer/openapi/inbound-shipment/listShipmentBoxes) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.