轻易云
注册体验

领星ERP查询发货单列表接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
FBA / 发货单 · POST · 请求参数 18 个(必填 4) · 响应参数 125 个 · 限流令牌桶容量 1
更新日期
2026-11-21

查询发货单列表

POST/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&timestamp=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
    }
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1search_value搜索的值string—可选搜索的值
2search_field搜索字段string—可选搜索字段: sku shipment_sn 发货单号 shipment_id 货件单号
3sids店铺idstring—可选店铺id,多个时通过英文逗号分隔,如1,2,3,对应查询亚马逊店铺列表接口对应字段【sid】
4mids国家idstring—可选国家id,多个时通过英文逗号分隔,如1,2,3
5wid仓库idstring—可选仓库id,多个时通过英文逗号分隔,如1,2,3
6logistics_type物流方式idarray<any>—可选物流方式id
7status发货单状态integer—可选发货单状态: -1 : 待配货, 0:待发货, 1:已发货, 3:已作废, 4:已删除
8print_status打印状态 0未打印 1 已打印string—可选打印状态 0未打印 1 已打印
9pick_status拣货状态 0 未拣货 1已拣货string—可选拣货状态 0 未拣货 1已拣货
10time_type时间类型integer—可选时间类型: 3创建时间 (允许精确到时分秒) 2创建时间 1到货时间 0发货时间 4更新时间 (允许精确到时分秒)
11start_date开始日期string—可选开始日期
12end_date结束日期string—可选结束日期
13offsetoffsetinteger—必填偏移量=(currentPage -1)*length
14length长度integer—必填长度
15is_delete是否删除number—可选是否删除:0 未删除【默认】 1 已删除 2 全部
16senior_search_list精准搜索array<object>—可选精准搜索
16.1search_field搜索字段string—必填搜索字段: sku shipment_sn 发货单号 shipment_id 货件单号
16.2search_value搜索值array<any>—必填搜索值

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0:成功
2messagemessagestringsuccess必填
3error_detailserror_detailsarray<any>—必填
4response_timeresponse_timestring2020-04-30 17:33:32必填
5datadataobject—必填
5.1list发货单列表array<object>—必填发货单列表
5.1.1id发货单idinteger25必填发货单id
5.1.2shipment_sn发货单号stringSP180720003必填发货单号
5.1.3status发货单状态integer0必填发货单状态, -1 : 待配货 0:待发货, 1:已发货, 2:已完成, 3:已作废
5.1.4shipment_time发货时间string—必填发货时间
5.1.5wname仓库名称string测试仓库必填仓库名称
5.1.6create_user创建用户string—必填创建用户
5.1.7principal_user负责人array<object>—必填负责人
5.1.7.1uid负责人UIDinteger129067必填负责人UID
5.1.7.2name负责人名称string张三必填负责人名称
5.1.8logistics_provider_id物流商IDstring—必填物流商ID
5.1.9logistics_provider_name物流商名称string—必填物流商名称
5.1.10logistics_channel_name物流渠道名称string鸿捷--HKUPS美国红单必填物流渠道名称
5.1.11expected_arrival_date到货时间string—必填到货时间
5.1.12actual_shipment_time实际发货时间(已废弃)string—必填实际发货时间(已废弃)
5.1.13etd_date开船时间string—必填开船时间
5.1.14eta_date运输到达时间string—必填运输到达时间
5.1.15delivery_date实际妥投时间string—必填实际妥投时间
5.1.16create_time创建时间string2018-07-20必填创建时间
5.1.17gmt_create创建时间(精确到时分秒)string2018-07-20 15:14:18必填创建时间(精确到时分秒)
5.1.18is_pick拣货状态 0 未拣货 1已拣货integer1必填拣货状态 0 未拣货 1已拣货
5.1.19is_print是否打印 0-否integer0必填是否打印 0-否,1-是
5.1.20pick_time拣货时间string—必填拣货时间
5.1.21print_num打印次数integer0必填打印次数
5.1.22head_fee_type头程费分配方式integer0必填头程费分配方式, 0:按计费重; 1:按实重; 2:按体积重; 3:按SKU数量; 4:自定义; 5:按箱子体积
5.1.23file_id附件文件string—必填附件文件
5.1.24update_time更新时间string2018-07-20 15:14:18必填更新时间
5.1.25remark备注string—必填备注
5.1.26wid仓库IDinteger8必填仓库ID
5.1.27is_return_stock是否恢复库存integer0必填是否恢复库存:0-否,1-是
5.1.28pay_status付款状态integer—可选付款状态: 0:未申请, 1:已申请, 2:部分付款, 3:已付清, 4:无
5.1.29audit_status审批状态integer—可选审批状态: 121:待审核, 122:驳回, 123:通过, 124:作废
5.1.30shipment_user发货人string—可选发货人
5.1.31is_exist_declaration是否关联报关单integer—可选是否关联报关单,0:否,1:是
5.1.32is_exist_clearance是否关联清关单integer—可选是否关联清关单,0:否,1:是
5.1.33third_party_order_mode下单模式integer—可选下单模式,0:无,1:系统下单,2:手工下单
5.1.34third_party_order_status第三方仓下单状态integer—可选第三方仓下单状态,待发货下才有: 1:未下单, 2:已下单, 3:异常, 4:已发货
5.1.35vat_code店铺VAT税号string—可选店铺VAT税号
5.1.36method_id运输方式IDstring—可选运输方式ID
5.1.37method_name运输方式名称string—可选运输方式名称
5.1.38is_custom_shipment_time是否自定义发货时间integer—可选是否自定义发货时间,1:是,0:否
5.1.39logistics_tracking_number物流商单号string—可选物流商单号
5.1.40logistics物流轨迹列表array<object>—必填物流轨迹列表
5.1.40.1logistics_list_type物流轨迹样式integer1必填物流轨迹样式, 0:旧版, 1:新版
5.1.40.2replace_tracking_number跟踪单号(旧版)string88803089941可选跟踪单号(旧版)
5.1.40.3tracking_number物流商号(旧版)string8880308989可选物流商号(旧版)
5.1.40.4tracking_no查询单号(新版)stringta1234567可选查询单号(新版)
5.1.40.5transport_type运输类型(新版)编码integer2可选运输类型(新版)编码: 1-快递, 2-海运, 3-空运, 4-其他
5.1.40.6transport_type_name运输类型(新版)名称string海运可选运输类型(新版)名称
5.1.40.7order_type_code单号类型(新版)编码integer4可选单号类型(新版)编码: 1-订舱号, 2-提单号, 3-箱号, 4-其他, 5-跟踪单号, 6-航班号
5.1.40.8order_type_code_name单号类型(新版)名称string其他可选单号类型(新版)名称
5.1.40.9shippers承运商(新版)编码stringemc可选承运商(新版)编码
5.1.40.10shippers_name承运商(新版)名称string长荣emc可选承运商(新版)名称
5.1.40.11remark轨迹备注(新版)string这里是备注字段可选轨迹备注(新版)
5.1.41relate_list关联货件列表array<object>—必填关联货件列表
5.1.41.1mid国家idinteger318必填国家id
5.1.41.2destination_fulfillment_center_id物流中心编码stringFTW1必填物流中心编码
5.1.41.3quantity_shipped申报量integer190必填申报量
5.1.41.4id明细idinteger1039必填明细id
5.1.41.5wname仓库名称string测试仓库--吴萍必填仓库名称
5.1.41.6shipment_sn发货单号stringSP180720003必填发货单号
5.1.41.7shipment_id货件idstringFBA15D9PQN10必填货件id
5.1.41.8shipment_status货件状态string—必填货件状态
5.1.41.9wid仓库idinteger8必填仓库id
5.1.41.10pid货件明细IDinteger318必填货件明细ID
5.1.41.11sid店铺idinteger8必填店铺id
5.1.41.12sname店铺名称stringPM1:-test6-A0必填店铺名称
5.1.41.13num发货数量integer1必填发货数量
5.1.41.14pic_url图片urlstringhttp://ecx.images-amazon.com/images/I/31UvR_SL75_.jpg必填图片url
5.1.41.15packing_type混装类型integer1必填混装类型 1混装, 2原装
5.1.41.16fulfillment_network_skulisting的fnskustringxxxx必填listing的fnsku
5.1.41.17skuskustring10 1必填sku
5.1.41.18fnsku仓库fnskustring—必填仓库fnsku
5.1.41.19mskumskustringxxxx必填seller_sku
5.1.41.20nation国家名称string美国必填国家名称
5.1.41.21apply_num关联货件量integer1必填关联货件量
5.1.41.22product_id商品idinteger19873必填商品id
5.1.41.23product_name产品名称string林xxxx必填产品名称
5.1.41.24asinasinstring—必填ASIN
5.1.41.25parent_asin父ASINstring—必填父ASIN
5.1.41.26remark备注string—必填备注
5.1.41.27status发货单状态integer0必填发货单状态, -1 : 待配货 0:待发货, 1:已发货, 3:已作废
5.1.41.28is_combo是否组合商品integer1必填是否组合商品: 1-是, 0-否
5.1.41.29create_by_mws创建发货单途径integer1必填创建发货单途径: 1-货件, 0-发货计划
5.1.41.30whb_code_list仓位编码列表array<any>—必填仓位编码列表
5.1.41.31packing_type_name包装名称string混装商品必填包装名称
5.1.41.32product_valid_num可用量integer0必填可用量
5.1.41.33product_qc_num待检量integer0必填待检量
5.1.41.34shipment_order_list关联关系列表array<object>—必填关联关系列表
5.1.41.34.1ispr_id关联关系表IDinteger—可选关联关系表ID
5.1.41.34.2zidzidinteger—可选
5.1.41.34.3isp_id发货计划表IDstring—可选发货计划表ID
5.1.41.34.4isim_id货件详情表IDstring—可选货件详情表ID
5.1.41.34.5isil_id发货单表IDstring—可选发货单表ID
5.1.41.34.6seq发货计划批次号string—可选发货计划批次号
5.1.41.34.7shipment_plan_sn发货计划单号string—可选发货计划单号
5.1.41.34.8shipment_mws_sn货件编号string—可选货件编号
5.1.41.34.9shipment_list_sn发货单号string—可选发货单号
5.1.41.34.10shipment_plan_quantity计划发货量integer—可选计划发货量
5.1.41.34.11shipment_mws_quantity货件关联量integer—可选货件关联量
5.1.41.34.12shipment_list_quantity发货单关联量integer—可选发货单关联量
5.1.41.34.13gmt_create关联关系创建时间string—可选关联关系创建时间
5.1.41.34.14gmt_modified关联关系修改时间string—可选关联关系修改时间
5.1.41.34.15company_idcompany_idinteger—可选
5.1.41.34.16v_uuidv_uuidstring—可选
5.1.41.35seqs发货计划批次号(多个时使用string—可选发货计划批次号(多个时使用,分隔)
5.1.41.36shipment_plan_quantity_total发货计划发货量合计integer—可选发货计划发货量合计
5.1.41.37diff_num差额integer-1必填差额
5.1.41.38sta_shipment_idsta货件的shipmentIdstringsh8c22071a-b157-4846-c4a47bxx必填sta货件的shipmentId
5.1.41.39is_sta是否sta货件string—必填是否sta货件, 1:是, 0:否
5.1.41.40sta_inbound_plan_idsta货件所属的sta任务编号string—必填sta货件所属的sta任务编号
5.1.42not_relate_list未关联货件列表array<any>—必填未关联货件列表
5.1.43destination_fulfillment_center_id物流中心编码stringFTW1,BHX2,EUK5必填物流中心编码
5.1.44status_name状态名称string待发货必填状态名称
5.1.45head_fee_type_name头程分摊名称string按计费重必填头程分摊名称
5.1.46head_fee_type_name_new新头程费分配名称方式string产品-计费重必填新头程费分配名称方式: 0 产品-计费重(默认) 1 产品-实重 2 产品-体积重 3 产品-数量 4 自定义 5 箱子-体积
5.1.47fileList文件列表array<any>—必填文件列表
5.1.48shipment_time_second发货时间(精确到时分秒)string2023-10-23 18:23:40必填发货时间(精确到时分秒)
5.1.49is_delete删除状态number0必填删除状态:0-未删除 1-已删除
5.2totaltotalinteger1必填

领星ERP的接口:查询发货单列表(/erp/sc/routing/storage/shipment/getInboundShipmentList),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。