轻易云
注册体验

领星ERP查询货件方案接口

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

查询货件方案

POST/amzStaServer/openapi/inbound-shipment/shipmentPreView
加工厂
{
  "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": "物流中心编码"
            }
          ]
        }
      ]
    }
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1inboundPlanIdSTA任务编号string—必填STA任务编号,对应创建STA任务接口对应字段【inboundPlanId】
2sid亚马逊店铺sidinteger—必填亚马逊店铺sid,对应查询亚马逊店铺列表接口对应字段【sid】

接口响应参数

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

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

需要对接这个接口?

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