/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×tamp=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
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | sid | 店铺id | string | — | Required | 店铺id,多个以英文逗号分隔 ,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 2 | start_date | 货件创建开始日期 | string | — | Required | 货件创建开始日期,格式:Y-m-d,左闭右开 |
| 3 | end_date | 货件创建截止日期 | string | — | Required | 货件创建截止日期,格式:Y-m-d,左闭右开 |
| 4 | offset | 分页偏移量 | integer | — | Optional | 分页偏移量,默认0 |
| 5 | length | 分页长度 | integer | — | Optional | 分页长度,默认1000 |
| 6 | shipment_id | 货件单号 | string | — | Optional | 货件单号,多个以英文逗号隔开,仅支持精确搜索 |
| 7 | shipment_status | 货件状态 | string | — | Optional | 货件状态,多个以英文逗号分隔: UNCONFIRMED IN_TRANSIT DELIVERED CHECKED_IN ABANDONED DELETED CLOSED CANCELLED WORKING RECEIVING SHIPPED READY_TO_SHIP |
| 8 | extra_date_field | extra_date_field | string | — | Optional | 根据start_extra_date和end_extra_date日期范围查询: update 货件修改日期【默认值为update,目前只支持查询货件修改日期】 |
| 9 | start_extra_date | 开始日期 | string | — | Optional | 开始日期,格式:Y-m-d,左闭右开 |
| 10 | end_extra_date | 结束日期 | string | — | Optional | 结束日期,格式:Y-m-d,左闭右开 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | int | 0 | Required | 状态码,0 成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 错误信息 | array | — | Required | 错误信息 |
| 4 | request_id | 请求链路id | string | C3D9F541-8083-E376-EB5C-606A872F5C89 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2020-05-18 11:23:47 | Required | 响应时间 |
| 6 | total | 总数 | int | 1 | Required | 总数 |
| 7 | data | 响应数据 | object | — | Required | 响应数据 |
| 7.1 | list | 数据列表 | array | — | Required | 数据列表 |
| 7.1.1 | id | 唯一记录id | int | 10407 | Required | 唯一记录id |
| 7.1.2 | sid | 店铺id | int | 2 | Required | 店铺id |
| 7.1.3 | seller | 店铺名称 | string | — | Required | 店铺名称 |
| 7.1.4 | uid | 创建人id | int | — | Required | 创建人id |
| 7.1.5 | username | 创建人姓名 | string | — | Required | 创建人姓名 |
| 7.1.6 | shipment_id | 亚马逊货件编号 | string | — | Required | 亚马逊货件编号 |
| 7.1.7 | shipment_name | 货件名称 | string | FBA (13/08/2020, 02:58) - 1 | Required | 货件名称 |
| 7.1.8 | sta_shipment_id | 亚马逊货件id(sta货件时返回) | string | — | Required | 亚马逊货件id(sta货件时返回) |
| 7.1.9 | sta_inbound_plan_id | 亚马逊货件编号(sta货件时返回) | string | — | Required | 亚马逊货件编号(sta货件时返回) |
| 7.1.10 | sta_plan_name | STA任务名称(sta货件时返回) | string | — | Required | STA任务名称(sta货件时返回) |
| 7.1.11 | is_closed | 是否是已完成状态 | int | 1 | Required | 是否是已完成状态:0 进行中,1 已完成 |
| 7.1.12 | shipment_status | 状态 | string | CLOSED | Required | 状态: WORKING:卖家已创建货件,但尚未发货 SHIPPED:承运人已取件 IN_TRANSIT:承运人已通知亚马逊配送中心,知晓货件的存在 DELIVERED:承运人已将货件配送至亚马逊配送中心 CHECK_IN:货件已在亚马逊配送中心的收货区域登记 RECEIVING:货件已到达亚马逊配送中心,但有部分商品尚未标记为已收到 CLOSED:货件已到达亚马逊配送中心,且所有商品已标记为已收到 CANCELLED:卖家在将货件发送至亚马逊配送中心后取消了货件 DELETE:卖家在将货件发送至亚马逊配送中心前取消了货件 ERROR:货件出错,但其并非亚马逊处理 |
| 7.1.13 | gmt_modified | 数据更新时间 | string | 2020-10-11 10:59 | Required | 数据更新时间 |
| 7.1.14 | gmt_create | 数据创建时间 | string | 2020-08-13 23:25 | Required | 数据创建时间 |
| 7.1.15 | sync_time | 同步时间【已废弃】 | string | 2020-10-11 10:59 | Required | 同步时间【已废弃】 |
| 7.1.16 | destination_fulfillment_center_id | 物流中心编码 | string | BHX1 | Required | 物流中心编码 |
| 7.1.17 | is_synchronous | 是否erp创建 | int | 1 | Required | 是否erp创建:0 erp创建,1 亚马逊后台同步 |
| 7.1.18 | is_uploaded_box | 是否已上传装箱信息 | int | 0 | Required | 是否已上传装箱信息:0 未上传,1 已上传 |
| 7.1.19 | is_sta | 是否sta货件 | int | 0 | Required | 是否sta货件:0 否,1 是 |
| 7.1.20 | shipping_mode | shipping_mode | string | — | Required | 货件类型(GROUND_SMALL_PARCEL 小包裹快递(SPD)、FREIGHT_LTL 汽运零担(LTL)) |
| 7.1.21 | shipping_solution | shipping_solution | string | — | Required | 承运人(USE_YOUR_OWN_CARRIER 其他承运人、AMAZON_PARTNERED_CARRIER 亚马逊合作承运人) |
| 7.1.22 | alpha_code | 承运方式编码 | string | — | Required | 承运方式编码 |
| 7.1.23 | alpha_name | 承运方式名称 | string | — | Required | 承运方式名称 |
| 7.1.24 | sta_shipment_date | 发货日期 格式 | string | — | Required | 发货日期 格式:yyyy-MM-dd |
| 7.1.25 | sta_delivery_start_date | 送达时段-开始时间 格式 | string | — | Required | 送达时段-开始时间 格式:yyyy-MM-dd HH:mm:ss |
| 7.1.26 | sta_delivery_end_date | 送达时段-结束时间 格式 | string | — | Required | 送达时段-结束时间 格式:yyyy-MM-dd HH:mm:ss |
| 7.1.27 | tracking_number_list | 追踪编号(SPD类型货件时返回) | array | — | Required | 追踪编号(SPD类型货件时返回) |
| 7.1.27.1 | box_id | 箱号 | string | — | Required | 箱号 |
| 7.1.27.2 | tractracking_numberkingNumber | 追踪编号 | string | — | Required | 追踪编号 |
| 7.1.28 | bill_of_lading_number | 提货单号(BOL) | string | — | Required | 提货单号(BOL) |
| 7.1.29 | freight_bill_number | 跟踪编号(PRO) | string | — | Required | 跟踪编号(PRO) |
| 7.1.30 | item_list | 子项数据 | array | — | Required | 子项数据 |
| 7.1.30.1 | msku | msku | string | — | Required | MSKU |
| 7.1.30.2 | fnsku | fnsku | string | — | Required | FNSKU |
| 7.1.30.3 | sku | sku | string | — | Required | SKU |
| 7.1.30.4 | quantity_shipped | 当前申报量 | int | 518 | Required | 当前申报量 |
| 7.1.30.5 | init_quantity_shipped | 货件初始申报量 | int | 518 | Required | 货件初始申报量 |
| 7.1.30.6 | quantity_received | 签收数量 | int | 511 | Required | 签收数量:亚马逊配送中心已接收的商品数量 |
| 7.1.30.7 | quantity_shipped_local | 已发货数量(本地数据) | int | — | Required | 已发货数量(本地数据) |
| 7.1.30.8 | quantity_in_case | 每个包装箱中的商品数量 | int | 37 | Required | 每个包装箱中的商品数量 |
| 7.1.30.9 | prep_details | 预处理明细 | string | — | Required | 预处理明细 |
| 7.1.30.10 | prep_instruction | 预处理操作 | string | Labeling | Required | 预处理操作:大多数为Labeling |
| 7.1.30.11 | prep_owner | 预处理拥有者 | string | AMAZON | Required | 预处理拥有者:AMAZON,SELLER,NONE;大多数为SELLER |
| 7.1.30.12 | prep_label_owner | 标签类型 | string | AMAZON | Required | 标签类型:AMAZON,SELLER,NONE |
| 7.1.30.13 | expiration | 有效期 | string | — | Required | 有效期 |
| 7.1.30.14 | prep_owner | 预处理拥有者 | string | SELLER | Required | 预处理拥有者:大多数为SELLER |
| 7.1.30.15 | release_date | 生产日期 | string | — | Required | 生产日期 |
| 7.1.30.16 | ware_house_storage_id | 库存明细id | int | — | Required | 库存明细id |
| 7.1.30.17 | shipment_plan_list | 关联的发货计划单号 | array | — | Required | 关联的发货计划单号 |
| 7.1.30.17.1 | shipment_plan_sn | 发货计划单号 | string | — | Required | 发货计划单号 |
| 7.1.31 | working_time | WORKING时间 | string | 2023-04-24 11:35 | Required | WORKING时间 |
| 7.1.32 | shipped_time | SHIPPED时间 | string | 2023-04-24 17:35 | Required | SHIPPED时间 |
| 7.1.33 | receiving_time | RECEIVING时间 | string | 2023-04-24 17:35 | Required | RECEIVING时间 |
| 7.1.34 | closed_time | CLOSED时间 | string | 2023-04-24 17:35 | Required | CLOSED时间 |
| 7.1.35 | reference_id | Reference ID | string | xxxxxx | Required | Reference ID |
| 7.1.36 | ship_from_address | 发货地址 | object | — | Required | 发货地址 |
| 7.1.36.1 | name | 名称 | string | 测试发货名称 | Required | 名称 |
| 7.1.36.2 | country_code | 国家编码 | string | CN | Required | 国家编码 |
| 7.1.36.3 | state_or_province_code | 省(州) | string | 广东省 | Required | 省(州) |
| 7.1.36.4 | city | 城市 | string | 深圳 | Required | 城市 |
| 7.1.36.5 | region | 区 | string | — | Required | 区 |
| 7.1.36.6 | address_line1 | 街道地址1 | string | 测试街道111 | Required | 街道地址1 |
| 7.1.36.7 | address_line2 | 街道地址2 | string | — | Required | 街道地址2 |
| 7.1.36.8 | postal_code | 邮编 | string | rere2222 | Required | 邮编 |
| 7.1.36.9 | phone | 联系电话 | string | 15966786622 | Required | 联系电话 |
| 7.1.37 | ship_to_address | 配送地址 | object | — | Required | 配送地址 |
| 7.1.37.1 | name | 名称 | string | FTW1名称 | Required | 名称 |
| 7.1.37.2 | country_code | 国家编码 | string | AG | Required | 国家编码 |
| 7.1.37.3 | state_or_province_code | 省(州) | string | 省1 | Required | 省(州) |
| 7.1.37.4 | city | 城市 | string | 城市1 | Required | 城市 |
| 7.1.37.5 | region | 区 | string | 区1 | Required | 区 |
| 7.1.37.6 | address_line1 | 街道地址1 | string | 地址1 | Required | 街道地址1 |
| 7.1.37.7 | address_line2 | 街道地址2 | string | 地址2 | Required | 街道地址2 |
| 7.1.37.8 | postal_code | 邮编 | string | 123456 | Required | 邮编 |
| 7.1.37.9 | doorplate | 门牌号 | string | 12 | Required | 门牌号 |
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.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.