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