/erp/sc/routing/storage/shipment/getInboundShipmentList{
"operation": {
"method": "POST",
"path": "/erp/sc/routing/storage/shipment/getInboundShipmentList"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/erp/sc/routing/storage/shipment/getInboundShipmentList?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"search_value\": \"123\",\n \"search_field\": \"shipment_sn\",\n \"sids\": \"8\",\n \"mids\": \"1\",\n \"wid\": \"68125\",\n \"logistics_type\": [1],\n \"status\": 0,\n \"print_status\": \"1\",\n \"pick_status\": \"1\",\n \"time_type\": 2,\n \"start_date\": \"2021-03-29\",\n \"end_date\": \"2021-06-29\",\n \"offset\": 0,\n \"length\": 20,\n \"senior_search_list\": [{\n \"search_field\": \"shipment_id\",\n \"search_value\": [\"1FBA194WNZDM9\", \"1FBA194WD1DMJ\"]\n }]\n}'",
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"response_time": "2020-04-30 17:33:32",
"data": {
"list": [
{
"id": 25,
"shipment_sn": "SP180720003",
"status": 0,
"shipment_time": "",
"wname": "测试仓库",
"create_user": "",
"principal_user": [
{
"uid": 129067,
"name": "张三"
}
],
"logistics_provider_id": "",
"logistics_provider_name": "",
"logistics_channel_name": "红单",
"expected_arrival_date": "",
"actual_shipment_time": "",
"etd_date": "",
"eta_date": "",
"delivery_date": "",
"create_time": "2018-07-20",
"gmt_create": "2018-07-20 15:14:18",
"is_pick": 1,
"is_print": 0,
"pick_time": "",
"print_num": 0,
"head_fee_type": 0,
"file_id": "",
"update_time": "2018-07-20 15:14:18",
"remark": "",
"wid": 8,
"is_return_stock": 0,
"pay_status": 0,
"audit_status": 0,
"shipment_user": "",
"is_exist_declaration": 0,
"is_exist_clearance": 0,
"third_party_order_mode": 0,
"third_party_order_status": 0,
"vat_code": "",
"method_id": "",
"method_name": "",
"is_custom_shipment_time": 0,
"logistics": [
{
"logistics_list_type": 1,
"replace_tracking_number": "88803089941",
"tracking_number": "8880308989",
"tracking_no": "ta1234567",
"transport_type": 2,
"transport_type_name": "海运",
"order_type_code": 4,
"order_type_code_name": "其他",
"shippers": "emc",
"shippers_name": "长荣emc",
"remark": "这里是备注字段"
}
],
"relate_list": [
{
"mid": 318,
"destination_fulfillment_center_id": "FTW1",
"quantity_shipped": 190,
"id": 1039,
"wname": "测试仓库--吴萍",
"shipment_sn": "SP180720003",
"shipment_id": "FBA15D9PQN10",
"shipment_status": "",
"wid": 8,
"pid": 318,
"sid": 8,
"sname": "PM1:-test6-A0",
"num": 1,
"pic_url": "http://ecx.images-amafeNRPL._SL75_.jpg",
"packing_type": 1,
"fulfillment_network_sku": "xxxx",
"sku": "10 1",
"fnsku": "",
"msku": "xxxx",
"nation": "美国",
"apply_num": 1,
"product_id": 19873,
"product_name": "林xxxx",
"asin": "",
"parent_asin": "",
"remark": "",
"status": 0,
"is_combo": 1,
"create_by_mws": 1,
"whb_code_list": [],
"packing_type_name": "混装商品",
"product_valid_num": 0,
"product_qc_num": 0,
"shipment_order_list": [
{
"ispr_id": 0,
"zid": 0,
"isp_id": "",
"isim_id": "",
"isil_id": "",
"seq": "",
"shipment_plan_sn": "",
"shipment_mws_sn": "",
"shipment_list_sn": "",
"shipment_plan_quantity": 0,
"shipment_mws_quantity": 0,
"shipment_list_quantity": 0,
"gmt_create": "",
"gmt_modified": "",
"company_id": 0,
"v_uuid": ""
}
],
"seqs": "",
"shipment_plan_quantity_total": 0,
"diff_num": -1,
"sta_shipment_id": "",
"is_sta": "",
"sta_inbound_plan_id": ""
}
],
"not_relate_list": [],
"destination_fulfillment_center_id": "FTW1,BHX2,EUK5",
"status_name": "待发货",
"head_fee_type_name": "按计费重",
"head_fee_type_name_new": "产品-计费重",
"fileList": [],
"shipment_time_second": "2023-10-23 18:23:40",
"is_delete": 0
}
],
"total": 1
}
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | search_value | 搜索的值 | string | — | Optional | 搜索的值 |
| 2 | search_field | 搜索字段 | string | — | Optional | 搜索字段: sku shipment_sn 发货单号 shipment_id 货件单号 |
| 3 | sids | 店铺id | string | — | Optional | 店铺id,多个时通过英文逗号分隔,如1,2,3,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 4 | mids | 国家id | string | — | Optional | 国家id,多个时通过英文逗号分隔,如1,2,3 |
| 5 | wid | 仓库id | string | — | Optional | 仓库id,多个时通过英文逗号分隔,如1,2,3 |
| 6 | logistics_type | 物流方式id | array<any> | — | Optional | 物流方式id |
| 7 | status | 发货单状态 | integer | — | Optional | 发货单状态: -1 : 待配货, 0:待发货, 1:已发货, 3:已作废, 4:已删除 |
| 8 | print_status | 打印状态 0未打印 1 已打印 | string | — | Optional | 打印状态 0未打印 1 已打印 |
| 9 | pick_status | 拣货状态 0 未拣货 1已拣货 | string | — | Optional | 拣货状态 0 未拣货 1已拣货 |
| 10 | time_type | 时间类型 | integer | — | Optional | 时间类型: 3创建时间 (允许精确到时分秒) 2创建时间 1到货时间 0发货时间 4更新时间 (允许精确到时分秒) |
| 11 | start_date | 开始日期 | string | — | Optional | 开始日期 |
| 12 | end_date | 结束日期 | string | — | Optional | 结束日期 |
| 13 | offset | offset | integer | — | Required | 偏移量=(currentPage -1)*length |
| 14 | length | 长度 | integer | — | Required | 长度 |
| 15 | is_delete | 是否删除 | number | — | Optional | 是否删除:0 未删除【默认】 1 已删除 2 全部 |
| 16 | senior_search_list | 精准搜索 | array<object> | — | Optional | 精准搜索 |
| 16.1 | search_field | 搜索字段 | string | — | Required | 搜索字段: sku shipment_sn 发货单号 shipment_id 货件单号 |
| 16.2 | search_value | 搜索值 | array<any> | — | Required | 搜索值 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0:成功 |
| 2 | message | message | string | success | Required | |
| 3 | error_details | error_details | array<any> | — | Required | |
| 4 | response_time | response_time | string | 2020-04-30 17:33:32 | Required | |
| 5 | data | data | object | — | Required | |
| 5.1 | list | 发货单列表 | array<object> | — | Required | 发货单列表 |
| 5.1.1 | id | 发货单id | integer | 25 | Required | 发货单id |
| 5.1.2 | shipment_sn | 发货单号 | string | SP180720003 | Required | 发货单号 |
| 5.1.3 | status | 发货单状态 | integer | 0 | Required | 发货单状态, -1 : 待配货 0:待发货, 1:已发货, 2:已完成, 3:已作废 |
| 5.1.4 | shipment_time | 发货时间 | string | — | Required | 发货时间 |
| 5.1.5 | wname | 仓库名称 | string | 测试仓库 | Required | 仓库名称 |
| 5.1.6 | create_user | 创建用户 | string | — | Required | 创建用户 |
| 5.1.7 | principal_user | 负责人 | array<object> | — | Required | 负责人 |
| 5.1.7.1 | uid | 负责人UID | integer | 129067 | Required | 负责人UID |
| 5.1.7.2 | name | 负责人名称 | string | 张三 | Required | 负责人名称 |
| 5.1.8 | logistics_provider_id | 物流商ID | string | — | Required | 物流商ID |
| 5.1.9 | logistics_provider_name | 物流商名称 | string | — | Required | 物流商名称 |
| 5.1.10 | logistics_channel_name | 物流渠道名称 | string | 鸿捷--HKUPS美国红单 | Required | 物流渠道名称 |
| 5.1.11 | expected_arrival_date | 到货时间 | string | — | Required | 到货时间 |
| 5.1.12 | actual_shipment_time | 实际发货时间(已废弃) | string | — | Required | 实际发货时间(已废弃) |
| 5.1.13 | etd_date | 开船时间 | string | — | Required | 开船时间 |
| 5.1.14 | eta_date | 运输到达时间 | string | — | Required | 运输到达时间 |
| 5.1.15 | delivery_date | 实际妥投时间 | string | — | Required | 实际妥投时间 |
| 5.1.16 | create_time | 创建时间 | string | 2018-07-20 | Required | 创建时间 |
| 5.1.17 | gmt_create | 创建时间(精确到时分秒) | string | 2018-07-20 15:14:18 | Required | 创建时间(精确到时分秒) |
| 5.1.18 | is_pick | 拣货状态 0 未拣货 1已拣货 | integer | 1 | Required | 拣货状态 0 未拣货 1已拣货 |
| 5.1.19 | is_print | 是否打印 0-否 | integer | 0 | Required | 是否打印 0-否,1-是 |
| 5.1.20 | pick_time | 拣货时间 | string | — | Required | 拣货时间 |
| 5.1.21 | print_num | 打印次数 | integer | 0 | Required | 打印次数 |
| 5.1.22 | head_fee_type | 头程费分配方式 | integer | 0 | Required | 头程费分配方式, 0:按计费重; 1:按实重; 2:按体积重; 3:按SKU数量; 4:自定义; 5:按箱子体积 |
| 5.1.23 | file_id | 附件文件 | string | — | Required | 附件文件 |
| 5.1.24 | update_time | 更新时间 | string | 2018-07-20 15:14:18 | Required | 更新时间 |
| 5.1.25 | remark | 备注 | string | — | Required | 备注 |
| 5.1.26 | wid | 仓库ID | integer | 8 | Required | 仓库ID |
| 5.1.27 | is_return_stock | 是否恢复库存 | integer | 0 | Required | 是否恢复库存:0-否,1-是 |
| 5.1.28 | pay_status | 付款状态 | integer | — | Optional | 付款状态: 0:未申请, 1:已申请, 2:部分付款, 3:已付清, 4:无 |
| 5.1.29 | audit_status | 审批状态 | integer | — | Optional | 审批状态: 121:待审核, 122:驳回, 123:通过, 124:作废 |
| 5.1.30 | shipment_user | 发货人 | string | — | Optional | 发货人 |
| 5.1.31 | is_exist_declaration | 是否关联报关单 | integer | — | Optional | 是否关联报关单,0:否,1:是 |
| 5.1.32 | is_exist_clearance | 是否关联清关单 | integer | — | Optional | 是否关联清关单,0:否,1:是 |
| 5.1.33 | third_party_order_mode | 下单模式 | integer | — | Optional | 下单模式,0:无,1:系统下单,2:手工下单 |
| 5.1.34 | third_party_order_status | 第三方仓下单状态 | integer | — | Optional | 第三方仓下单状态,待发货下才有: 1:未下单, 2:已下单, 3:异常, 4:已发货 |
| 5.1.35 | vat_code | 店铺VAT税号 | string | — | Optional | 店铺VAT税号 |
| 5.1.36 | method_id | 运输方式ID | string | — | Optional | 运输方式ID |
| 5.1.37 | method_name | 运输方式名称 | string | — | Optional | 运输方式名称 |
| 5.1.38 | is_custom_shipment_time | 是否自定义发货时间 | integer | — | Optional | 是否自定义发货时间,1:是,0:否 |
| 5.1.39 | logistics_tracking_number | 物流商单号 | string | — | Optional | 物流商单号 |
| 5.1.40 | logistics | 物流轨迹列表 | array<object> | — | Required | 物流轨迹列表 |
| 5.1.40.1 | logistics_list_type | 物流轨迹样式 | integer | 1 | Required | 物流轨迹样式, 0:旧版, 1:新版 |
| 5.1.40.2 | replace_tracking_number | 跟踪单号(旧版) | string | 88803089941 | Optional | 跟踪单号(旧版) |
| 5.1.40.3 | tracking_number | 物流商号(旧版) | string | 8880308989 | Optional | 物流商号(旧版) |
| 5.1.40.4 | tracking_no | 查询单号(新版) | string | ta1234567 | Optional | 查询单号(新版) |
| 5.1.40.5 | transport_type | 运输类型(新版)编码 | integer | 2 | Optional | 运输类型(新版)编码: 1-快递, 2-海运, 3-空运, 4-其他 |
| 5.1.40.6 | transport_type_name | 运输类型(新版)名称 | string | 海运 | Optional | 运输类型(新版)名称 |
| 5.1.40.7 | order_type_code | 单号类型(新版)编码 | integer | 4 | Optional | 单号类型(新版)编码: 1-订舱号, 2-提单号, 3-箱号, 4-其他, 5-跟踪单号, 6-航班号 |
| 5.1.40.8 | order_type_code_name | 单号类型(新版)名称 | string | 其他 | Optional | 单号类型(新版)名称 |
| 5.1.40.9 | shippers | 承运商(新版)编码 | string | emc | Optional | 承运商(新版)编码 |
| 5.1.40.10 | shippers_name | 承运商(新版)名称 | string | 长荣emc | Optional | 承运商(新版)名称 |
| 5.1.40.11 | remark | 轨迹备注(新版) | string | 这里是备注字段 | Optional | 轨迹备注(新版) |
| 5.1.41 | relate_list | 关联货件列表 | array<object> | — | Required | 关联货件列表 |
| 5.1.41.1 | mid | 国家id | integer | 318 | Required | 国家id |
| 5.1.41.2 | destination_fulfillment_center_id | 物流中心编码 | string | FTW1 | Required | 物流中心编码 |
| 5.1.41.3 | quantity_shipped | 申报量 | integer | 190 | Required | 申报量 |
| 5.1.41.4 | id | 明细id | integer | 1039 | Required | 明细id |
| 5.1.41.5 | wname | 仓库名称 | string | 测试仓库--吴萍 | Required | 仓库名称 |
| 5.1.41.6 | shipment_sn | 发货单号 | string | SP180720003 | Required | 发货单号 |
| 5.1.41.7 | shipment_id | 货件id | string | FBA15D9PQN10 | Required | 货件id |
| 5.1.41.8 | shipment_status | 货件状态 | string | — | Required | 货件状态 |
| 5.1.41.9 | wid | 仓库id | integer | 8 | Required | 仓库id |
| 5.1.41.10 | pid | 货件明细ID | integer | 318 | Required | 货件明细ID |
| 5.1.41.11 | sid | 店铺id | integer | 8 | Required | 店铺id |
| 5.1.41.12 | sname | 店铺名称 | string | PM1:-test6-A0 | Required | 店铺名称 |
| 5.1.41.13 | num | 发货数量 | integer | 1 | Required | 发货数量 |
| 5.1.41.14 | pic_url | 图片url | string | http://ecx.images-amazon.com/images/I/31UvR_SL75_.jpg | Required | 图片url |
| 5.1.41.15 | packing_type | 混装类型 | integer | 1 | Required | 混装类型 1混装, 2原装 |
| 5.1.41.16 | fulfillment_network_sku | listing的fnsku | string | xxxx | Required | listing的fnsku |
| 5.1.41.17 | sku | sku | string | 10 1 | Required | sku |
| 5.1.41.18 | fnsku | 仓库fnsku | string | — | Required | 仓库fnsku |
| 5.1.41.19 | msku | msku | string | xxxx | Required | seller_sku |
| 5.1.41.20 | nation | 国家名称 | string | 美国 | Required | 国家名称 |
| 5.1.41.21 | apply_num | 关联货件量 | integer | 1 | Required | 关联货件量 |
| 5.1.41.22 | product_id | 商品id | integer | 19873 | Required | 商品id |
| 5.1.41.23 | product_name | 产品名称 | string | 林xxxx | Required | 产品名称 |
| 5.1.41.24 | asin | asin | string | — | Required | ASIN |
| 5.1.41.25 | parent_asin | 父ASIN | string | — | Required | 父ASIN |
| 5.1.41.26 | remark | 备注 | string | — | Required | 备注 |
| 5.1.41.27 | status | 发货单状态 | integer | 0 | Required | 发货单状态, -1 : 待配货 0:待发货, 1:已发货, 3:已作废 |
| 5.1.41.28 | is_combo | 是否组合商品 | integer | 1 | Required | 是否组合商品: 1-是, 0-否 |
| 5.1.41.29 | create_by_mws | 创建发货单途径 | integer | 1 | Required | 创建发货单途径: 1-货件, 0-发货计划 |
| 5.1.41.30 | whb_code_list | 仓位编码列表 | array<any> | — | Required | 仓位编码列表 |
| 5.1.41.31 | packing_type_name | 包装名称 | string | 混装商品 | Required | 包装名称 |
| 5.1.41.32 | product_valid_num | 可用量 | integer | 0 | Required | 可用量 |
| 5.1.41.33 | product_qc_num | 待检量 | integer | 0 | Required | 待检量 |
| 5.1.41.34 | shipment_order_list | 关联关系列表 | array<object> | — | Required | 关联关系列表 |
| 5.1.41.34.1 | ispr_id | 关联关系表ID | integer | — | Optional | 关联关系表ID |
| 5.1.41.34.2 | zid | zid | integer | — | Optional | |
| 5.1.41.34.3 | isp_id | 发货计划表ID | string | — | Optional | 发货计划表ID |
| 5.1.41.34.4 | isim_id | 货件详情表ID | string | — | Optional | 货件详情表ID |
| 5.1.41.34.5 | isil_id | 发货单表ID | string | — | Optional | 发货单表ID |
| 5.1.41.34.6 | seq | 发货计划批次号 | string | — | Optional | 发货计划批次号 |
| 5.1.41.34.7 | shipment_plan_sn | 发货计划单号 | string | — | Optional | 发货计划单号 |
| 5.1.41.34.8 | shipment_mws_sn | 货件编号 | string | — | Optional | 货件编号 |
| 5.1.41.34.9 | shipment_list_sn | 发货单号 | string | — | Optional | 发货单号 |
| 5.1.41.34.10 | shipment_plan_quantity | 计划发货量 | integer | — | Optional | 计划发货量 |
| 5.1.41.34.11 | shipment_mws_quantity | 货件关联量 | integer | — | Optional | 货件关联量 |
| 5.1.41.34.12 | shipment_list_quantity | 发货单关联量 | integer | — | Optional | 发货单关联量 |
| 5.1.41.34.13 | gmt_create | 关联关系创建时间 | string | — | Optional | 关联关系创建时间 |
| 5.1.41.34.14 | gmt_modified | 关联关系修改时间 | string | — | Optional | 关联关系修改时间 |
| 5.1.41.34.15 | company_id | company_id | integer | — | Optional | |
| 5.1.41.34.16 | v_uuid | v_uuid | string | — | Optional | |
| 5.1.41.35 | seqs | 发货计划批次号(多个时使用 | string | — | Optional | 发货计划批次号(多个时使用,分隔) |
| 5.1.41.36 | shipment_plan_quantity_total | 发货计划发货量合计 | integer | — | Optional | 发货计划发货量合计 |
| 5.1.41.37 | diff_num | 差额 | integer | -1 | Required | 差额 |
| 5.1.41.38 | sta_shipment_id | sta货件的shipmentId | string | sh8c22071a-b157-4846-c4a47bxx | Required | sta货件的shipmentId |
| 5.1.41.39 | is_sta | 是否sta货件 | string | — | Required | 是否sta货件, 1:是, 0:否 |
| 5.1.41.40 | sta_inbound_plan_id | sta货件所属的sta任务编号 | string | — | Required | sta货件所属的sta任务编号 |
| 5.1.42 | not_relate_list | 未关联货件列表 | array<any> | — | Required | 未关联货件列表 |
| 5.1.43 | destination_fulfillment_center_id | 物流中心编码 | string | FTW1,BHX2,EUK5 | Required | 物流中心编码 |
| 5.1.44 | status_name | 状态名称 | string | 待发货 | Required | 状态名称 |
| 5.1.45 | head_fee_type_name | 头程分摊名称 | string | 按计费重 | Required | 头程分摊名称 |
| 5.1.46 | head_fee_type_name_new | 新头程费分配名称方式 | string | 产品-计费重 | Required | 新头程费分配名称方式: 0 产品-计费重(默认) 1 产品-实重 2 产品-体积重 3 产品-数量 4 自定义 5 箱子-体积 |
| 5.1.47 | fileList | 文件列表 | array<any> | — | Required | 文件列表 |
| 5.1.48 | shipment_time_second | 发货时间(精确到时分秒) | string | 2023-10-23 18:23:40 | Required | 发货时间(精确到时分秒) |
| 5.1.49 | is_delete | 删除状态 | number | 0 | Required | 删除状态:0-未删除 1-已删除 |
| 5.2 | total | total | integer | 1 | Required |
The 查询发货单列表 API (/erp/sc/routing/storage/shipment/getInboundShipmentList) 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.