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 · 请求参数 2 个(必填 2) · 响应参数 43 个 · 限流令牌桶容量 1
Updated At
2026-11-21

查询货件方案

POST/amzStaServer/openapi/inbound-shipment/shipmentPreView
Factory
{
  "operation": {
    "method": "POST",
    "path": "/amzStaServer/openapi/inbound-shipment/shipmentPreView"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/amzStaServer/openapi/inbound-shipment/shipmentPreView?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"inboundPlanId\": \"wf0a914e89-d126-4ed9-a093-2078289fed05\",\n    \"sid\": 1\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "574FB0B8-FD6E-8D29-91FD-295B55CF5398",
    "response_time": "2024-07-31 14:41:25",
    "data": {
      "inboundPlanId": "wf0a914e89-d126-4ed9-a093-2078289fed05",
      "placementOptionList": [
        {
          "feeCount": "费用",
          "fees": [
            {
              "amount": "金额",
              "code": "货币类型:详见ISO 4217标准里的货币编码,例如USD、CNY等",
              "target": "费用项:例如'Placement Services', 'Fulfillment Fee Discount'等",
              "type": "费用类型:FEE, DISCOUNT等"
            }
          ],
          "placementOptionId": "货件方案id",
          "placementStatus": "状态:含OFFERED、ACCEPTED、EXPIRED",
          "shipmentInformationList": [
            {
              "address": {
                "addressLine1": "详细街道地址1",
                "addressLine2": "详细街道地址2",
                "city": "城市",
                "companyName": "公司名称",
                "countryCode": "国家(地区)",
                "email": "邮箱",
                "name": "收货方名称",
                "phoneNumber": "电话",
                "postalCode": "邮政编码",
                "stateOrProvinceCode": "州/省/地区"
              },
              "itemCount": "商品总数",
              "itemList": [
                {
                  "asin": "asin",
                  "fnsku": "fnsku",
                  "msku": "msku",
                  "parentAsin": "父asin",
                  "productName": "品名:【产品管理】中的品名",
                  "sku": "sku:【产品管理】中的sku",
                  "title": "标题",
                  "url": "图片url"
                }
              ],
              "postalCodeMark": "入库区域(美国站专属)",
              "shipmentId": "货件单号",
              "shipmentName": "货件名称",
              "wareHouseId": "物流中心编码"
            }
          ]
        }
      ]
    }
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1inboundPlanIdSTA任务编号string—RequiredSTA任务编号,对应创建STA任务接口对应字段【inboundPlanId】
2sid亚马逊店铺sidinteger—Required亚马逊店铺sid,对应查询亚马逊店铺列表接口对应字段【sid】

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码int0Required状态码,0 成功
2message消息提示stringsuccessRequired消息提示
3errorDetails错误信息array—Required错误信息
4requestId请求链路idstring—Required请求链路id
5responseTime响应时间string2020-05-18 11:23:47Required响应时间
6data响应数据object—Required响应数据
6.1inboundPlanIdSTA任务编号string—RequiredSTA任务编号
6.2placementOptionList货件方案array—Required货件方案
6.2.1feeCount费用number—Required费用
6.2.2fees费用明细array—Required费用明细:array
6.2.2.1amount金额number—Required金额
6.2.2.2code货币类型string—Required货币类型:详见ISO 4217标准里的货币编码,例如USD、CNY等
6.2.2.3target费用项string—Required费用项:例如'Placement Services', 'Fulfillment Fee Discount'等
6.2.2.4type费用类型string—Required费用类型:FEE, DISCOUNT等
6.2.3placementOptionId货件方案idstring—Required货件方案id
6.2.4placementStatus状态string—Required状态:含OFFERED、ACCEPTED、EXPIRED
6.2.5shipmentInformationList货件信息array—Required货件信息
6.2.5.1addressaddressobject—Required
6.2.5.1.1addressLine1详细街道地址1string—Required详细街道地址1
6.2.5.1.2addressLine2详细街道地址2string—Required详细街道地址2
6.2.5.1.3city城市string—Required城市
6.2.5.1.4companyName公司名称string—Required公司名称
6.2.5.1.5countryCode国家(地区)string—Required国家(地区)
6.2.5.1.6email邮箱string—Required邮箱
6.2.5.1.7name收货方名称string—Required收货方名称
6.2.5.1.8phoneNumber电话string—Required电话
6.2.5.1.9postalCode邮政编码string—Required邮政编码
6.2.5.1.10stateOrProvinceCode州/省/地区string—Required州/省/地区
6.2.5.2itemCount商品总数int—Required商品总数
6.2.5.3itemList商品信息array—Required商品信息
6.2.5.3.1asinasinstring—Requiredasin
6.2.5.3.2fnskufnskustring—Requiredfnsku
6.2.5.3.3mskumskustring—Requiredmsku
6.2.5.3.4parentAsin父asinstring—Required父asin
6.2.5.3.5productName品名string—Required品名:【产品管理】中的品名
6.2.5.3.6skuskustring—Requiredsku:【产品管理】中的sku
6.2.5.3.7title标题string—Required标题
6.2.5.3.8url图片urlstring—Required图片url
6.2.5.4postalCodeMark入库区域(美国站专属)string—Required入库区域(美国站专属)
6.2.5.5shipmentId货件单号string—Required货件单号
6.2.5.6shipmentName货件名称string—Optional货件名称, 当placementStatus=ACCEPTED时才有数据返回
6.2.5.7wareHouseId物流中心编码string—Required物流中心编码
6.2.5.8quantity商品总申报量int—Required商品总申报量

The 查询货件方案 API (/amzStaServer/openapi/inbound-shipment/shipmentPreView) 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.