轻易云
注册体验

领星ERP查询货件列表接口

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

查询货件列表

POST/erp/sc/data/fba_report/shipmentList
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/erp/sc/data/fba_report/shipmentList"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/erp/sc/data/fba_report/shipmentList?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"end_date\": \"2024-10-10\",\n    \"offset\": 0,\n    \"length\": 100,\n    \"sid\": \"10\",\n    \"start_date\": \"2024-04-01\"\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "1859414A-17D8-7475-EA63-781ED827DA57",
    "response_time": "2024-12-18 15:29:35",
    "data": {
      "list": [
        {
          "id": 494,
          "sid": 10,
          "uid": 0,
          "shipment_id": "",
          "shipment_name": "",
          "is_closed": 1,
          "shipment_status": "CLOSED",
          "gmt_modified": "2024-11-30 12:00",
          "gmt_create": "2024-10-09 15:22",
          "sync_time": "",
          "destination_fulfillment_center_id": "",
          "username": "",
          "seller": "",
          "item_list": [
            {
              "id": 147819,
              "zid": 1,
              "msku": "",
              "fnsku": "",
              "quantity_shipped": 18,
              "init_quantity_shipped": 18,
              "quantity_received": 18,
              "quantity_shipped_local": 18,
              "quantity_in_case": 0,
              "prep_details": "",
              "prep_instruction": "",
              "prep_owner": "",
              "release_date": "",
              "ware_house_storage_id": 0,
              "shipment_plan_list": [],
              "sku": ""
            }
          ],
          "is_synchronous": 1,
          "is_uploaded_box": 0,
          "working_time": "2024-10-09 15:22",
          "shipped_time": "",
          "receiving_time": "2024-10-26 19:24",
          "closed_time": "2024-11-28 04:11",
          "reference_id": "",
          "ship_from_address": {
            "name": "",
            "country_code": "",
            "state_or_province_code": "",
            "city": "",
            "region": "",
            "address_line1": "",
            "address_line2": "",
            "postal_code": "",
            "phone": ""
          },
          "ship_to_address": {
            "name": "",
            "country_code": "",
            "state_or_province_code": "",
            "city": "",
            "region": "",
            "address_line1": "",
            "address_line2": "",
            "postal_code": "",
            "doorplate": ""
          }
        }
      ]
    },
    "total": 1
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1sid店铺idstring—必填店铺id,多个以英文逗号分隔 ,对应查询亚马逊店铺列表接口对应字段【sid】
2start_date货件创建开始日期string—必填货件创建开始日期,格式:Y-m-d,左闭右开
3end_date货件创建截止日期string—必填货件创建截止日期,格式:Y-m-d,左闭右开
4offset分页偏移量integer—可选分页偏移量,默认0
5length分页长度integer—可选分页长度,默认1000
6shipment_id货件单号string—可选货件单号,多个以英文逗号隔开,仅支持精确搜索
7shipment_status货件状态string—可选货件状态,多个以英文逗号分隔: UNCONFIRMED IN_TRANSIT DELIVERED CHECKED_IN ABANDONED DELETED CLOSED CANCELLED WORKING RECEIVING SHIPPED READY_TO_SHIP
8extra_date_fieldextra_date_fieldstring—可选根据start_extra_date和end_extra_date日期范围查询: update 货件修改日期【默认值为update,目前只支持查询货件修改日期】
9start_extra_date开始日期string—可选开始日期,格式:Y-m-d,左闭右开
10end_extra_date结束日期string—可选结束日期,格式:Y-m-d,左闭右开

接口响应参数

序号字段名称类型默认值必填描述
1code状态码int0必填状态码,0 成功
2message消息提示stringsuccess必填消息提示
3error_details错误信息array—必填错误信息
4request_id请求链路idstringC3D9F541-8083-E376-EB5C-606A872F5C89必填请求链路id
5response_time响应时间string2020-05-18 11:23:47必填响应时间
6total总数int1必填总数
7data响应数据object—必填响应数据
7.1list数据列表array—必填数据列表
7.1.1id唯一记录idint10407必填唯一记录id
7.1.2sid店铺idint2必填店铺id
7.1.3seller店铺名称string—必填店铺名称
7.1.4uid创建人idint—必填创建人id
7.1.5username创建人姓名string—必填创建人姓名
7.1.6shipment_id亚马逊货件编号string—必填亚马逊货件编号
7.1.7shipment_name货件名称stringFBA (13/08/2020, 02:58) - 1必填货件名称
7.1.8sta_shipment_id亚马逊货件id(sta货件时返回)string—必填亚马逊货件id(sta货件时返回)
7.1.9sta_inbound_plan_id亚马逊货件编号(sta货件时返回)string—必填亚马逊货件编号(sta货件时返回)
7.1.10sta_plan_nameSTA任务名称(sta货件时返回)string—必填STA任务名称(sta货件时返回)
7.1.11is_closed是否是已完成状态int1必填是否是已完成状态:0 进行中,1 已完成
7.1.12shipment_status状态stringCLOSED必填状态: WORKING:卖家已创建货件,但尚未发货 SHIPPED:承运人已取件 IN_TRANSIT:承运人已通知亚马逊配送中心,知晓货件的存在 DELIVERED:承运人已将货件配送至亚马逊配送中心 CHECK_IN:货件已在亚马逊配送中心的收货区域登记 RECEIVING:货件已到达亚马逊配送中心,但有部分商品尚未标记为已收到 CLOSED:货件已到达亚马逊配送中心,且所有商品已标记为已收到 CANCELLED:卖家在将货件发送至亚马逊配送中心后取消了货件 DELETE:卖家在将货件发送至亚马逊配送中心前取消了货件 ERROR:货件出错,但其并非亚马逊处理
7.1.13gmt_modified数据更新时间string2020-10-11 10:59必填数据更新时间
7.1.14gmt_create数据创建时间string2020-08-13 23:25必填数据创建时间
7.1.15sync_time同步时间【已废弃】string2020-10-11 10:59必填同步时间【已废弃】
7.1.16destination_fulfillment_center_id物流中心编码stringBHX1必填物流中心编码
7.1.17is_synchronous是否erp创建int1必填是否erp创建:0 erp创建,1 亚马逊后台同步
7.1.18is_uploaded_box是否已上传装箱信息int0必填是否已上传装箱信息:0 未上传,1 已上传
7.1.19is_sta是否sta货件int0必填是否sta货件:0 否,1 是
7.1.20shipping_modeshipping_modestring—必填货件类型(GROUND_SMALL_PARCEL 小包裹快递(SPD)、FREIGHT_LTL 汽运零担(LTL))
7.1.21shipping_solutionshipping_solutionstring—必填承运人(USE_YOUR_OWN_CARRIER 其他承运人、AMAZON_PARTNERED_CARRIER 亚马逊合作承运人)
7.1.22alpha_code承运方式编码string—必填承运方式编码
7.1.23alpha_name承运方式名称string—必填承运方式名称
7.1.24sta_shipment_date发货日期 格式string—必填发货日期 格式:yyyy-MM-dd
7.1.25sta_delivery_start_date送达时段-开始时间 格式string—必填送达时段-开始时间 格式:yyyy-MM-dd HH:mm:ss
7.1.26sta_delivery_end_date送达时段-结束时间 格式string—必填送达时段-结束时间 格式:yyyy-MM-dd HH:mm:ss
7.1.27tracking_number_list追踪编号(SPD类型货件时返回)array—必填追踪编号(SPD类型货件时返回)
7.1.27.1box_id箱号string—必填箱号
7.1.27.2tractracking_numberkingNumber追踪编号string—必填追踪编号
7.1.28bill_of_lading_number提货单号(BOL)string—必填提货单号(BOL)
7.1.29freight_bill_number跟踪编号(PRO)string—必填跟踪编号(PRO)
7.1.30item_list子项数据array—必填子项数据
7.1.30.1mskumskustring—必填MSKU
7.1.30.2fnskufnskustring—必填FNSKU
7.1.30.3skuskustring—必填SKU
7.1.30.4quantity_shipped当前申报量int518必填当前申报量
7.1.30.5init_quantity_shipped货件初始申报量int518必填货件初始申报量
7.1.30.6quantity_received签收数量int511必填签收数量:亚马逊配送中心已接收的商品数量
7.1.30.7quantity_shipped_local已发货数量(本地数据)int—必填已发货数量(本地数据)
7.1.30.8quantity_in_case每个包装箱中的商品数量int37必填每个包装箱中的商品数量
7.1.30.9prep_details预处理明细string—必填预处理明细
7.1.30.10prep_instruction预处理操作stringLabeling必填预处理操作:大多数为Labeling
7.1.30.11prep_owner预处理拥有者stringAMAZON必填预处理拥有者:AMAZON,SELLER,NONE;大多数为SELLER
7.1.30.12prep_label_owner标签类型stringAMAZON必填标签类型:AMAZON,SELLER,NONE
7.1.30.13expiration有效期string—必填有效期
7.1.30.14prep_owner预处理拥有者stringSELLER必填预处理拥有者:大多数为SELLER
7.1.30.15release_date生产日期string—必填生产日期
7.1.30.16ware_house_storage_id库存明细idint—必填库存明细id
7.1.30.17shipment_plan_list关联的发货计划单号array—必填关联的发货计划单号
7.1.30.17.1shipment_plan_sn发货计划单号string—必填发货计划单号
7.1.31working_timeWORKING时间string2023-04-24 11:35必填WORKING时间
7.1.32shipped_timeSHIPPED时间string2023-04-24 17:35必填SHIPPED时间
7.1.33receiving_timeRECEIVING时间string2023-04-24 17:35必填RECEIVING时间
7.1.34closed_timeCLOSED时间string2023-04-24 17:35必填CLOSED时间
7.1.35reference_idReference IDstringxxxxxx必填Reference ID
7.1.36ship_from_address发货地址object—必填发货地址
7.1.36.1name名称string测试发货名称必填名称
7.1.36.2country_code国家编码stringCN必填国家编码
7.1.36.3state_or_province_code省(州)string广东省必填省(州)
7.1.36.4city城市string深圳必填城市
7.1.36.5region区string—必填区
7.1.36.6address_line1街道地址1string测试街道111必填街道地址1
7.1.36.7address_line2街道地址2string—必填街道地址2
7.1.36.8postal_code邮编stringrere2222必填邮编
7.1.36.9phone联系电话string15966786622必填联系电话
7.1.37ship_to_address配送地址object—必填配送地址
7.1.37.1name名称stringFTW1名称必填名称
7.1.37.2country_code国家编码stringAG必填国家编码
7.1.37.3state_or_province_code省(州)string省1必填省(州)
7.1.37.4city城市string城市1必填城市
7.1.37.5region区string区1必填区
7.1.37.6address_line1街道地址1string地址1必填街道地址1
7.1.37.7address_line2街道地址2string地址2必填街道地址2
7.1.37.8postal_code邮编string123456必填邮编
7.1.37.9doorplate门牌号string12必填门牌号

领星ERP的接口:查询货件列表(/erp/sc/data/fba_report/shipmentList),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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