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