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

查询货件列表

POST/erp/sc/data/fba_report/shipmentList
Factory
{
  "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
  }
}

Request Parameters

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

Response Parameters

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

The 查询货件列表 API (/erp/sc/data/fba_report/shipmentList) 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.