Lingxing
切换旧版

查询发货单列表

POST/erp/sc/routing/storage/shipment/getInboundShipmentList

接口信息

API Path请求协议请求方式令牌桶容量
/erp/sc/routing/storage/shipment/getInboundShipmentListHTTPSPOST1

请求参数

search_valuestring
搜索的值
search_fieldstring
搜索字段:
sku
shipment_sn 发货单号
shipment_id 货件单号
sidsstring
店铺id,多个时通过英文逗号分隔,如1,2,3,对应查询亚马逊店铺列表接口对应字段【sid】
midsstring
国家id,多个时通过英文逗号分隔,如1,2,3
widstring
仓库id,多个时通过英文逗号分隔,如1,2,3
logistics_typearray<any>
物流方式id
statusinteger
发货单状态:
-1 : 待配货,
0:待发货,
1:已发货,
3:已作废,
4:已删除
print_statusstring
打印状态 0未打印 1 已打印
pick_statusstring
拣货状态 0 未拣货 1已拣货
time_typeinteger
时间类型:
3创建时间 (允许精确到时分秒)
2创建时间
1到货时间
0发货时间
4更新时间 (允许精确到时分秒)
start_datestring
开始日期
end_datestring
结束日期
offsetinteger必填
偏移量=(currentPage -1)*length
lengthinteger必填
长度
is_deletenumber
是否删除:0 未删除【默认】 1 已删除 2 全部
senior_search_listarray<object>
精准搜索
隐藏子属性
search_fieldstring必填
搜索字段:
sku
shipment_sn 发货单号
shipment_id 货件单号
search_valuearray<any>必填
搜索值

请求cURL示例

curl --location 'https://openapi.lingxing.com/erp/sc/routing/storage/shipment/getInboundShipmentList?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "search_value": "123",
    "search_field": "shipment_sn",
    "sids": "8",
    "mids": "1",
    "wid": "68125",
    "logistics_type": [1],
    "status": 0,
    "print_status": "1",
    "pick_status": "1",
    "time_type": 2,
    "start_date": "2021-03-29",
    "end_date": "2021-06-29",
    "offset": 0,
    "length": 20,
    "senior_search_list": [{
        "search_field": "shipment_id",
        "search_value": ["1FBA194WNZDM9", "1FBA194WD1DMJ"]
    }]
}'

返回结果

codeinteger必填
状态码,0:成功
示例 0
messagestring必填
示例 success
error_detailsarray<any>必填
response_timestring必填
示例 2020-04-30 17:33:32
dataobject必填
隐藏子属性
listarray<object>必填
发货单列表
隐藏子属性
idinteger必填
发货单id
示例 25
shipment_snstring必填
发货单号
示例 SP180720003
statusinteger必填
发货单状态,
-1 : 待配货
0:待发货,
1:已发货,
2:已完成,
3:已作废
示例 0
shipment_timestring必填
发货时间
wnamestring必填
仓库名称
示例 测试仓库
create_userstring必填
创建用户
principal_userarray<object>必填
负责人
隐藏子属性
uidinteger必填
负责人UID
示例 129067
namestring必填
负责人名称
示例 张三
logistics_provider_idstring必填
物流商ID
logistics_provider_namestring必填
物流商名称
logistics_channel_namestring必填
物流渠道名称
示例 鸿捷--HKUPS美国红单
expected_arrival_datestring必填
到货时间
actual_shipment_timestring必填
实际发货时间(已废弃)
etd_datestring必填
开船时间
eta_datestring必填
运输到达时间
delivery_datestring必填
实际妥投时间
create_timestring必填
创建时间
示例 2018-07-20
gmt_createstring必填
创建时间(精确到时分秒)
示例 2018-07-20 15:14:18
is_pickinteger必填
拣货状态 0 未拣货 1已拣货
示例 1
is_printinteger必填
是否打印 0-否,1-是
示例 0
pick_timestring必填
拣货时间
print_numinteger必填
打印次数
示例 0
head_fee_typeinteger必填
头程费分配方式,
0:按计费重;
1:按实重;
2:按体积重;
3:按SKU数量;
4:自定义;
5:按箱子体积
示例 0
file_idstring必填
附件文件
update_timestring必填
更新时间
示例 2018-07-20 15:14:18
remarkstring必填
备注
widinteger必填
仓库ID
示例 8
is_return_stockinteger必填
是否恢复库存:0-否,1-是
示例 0
pay_statusinteger
付款状态:
0:未申请,
1:已申请,
2:部分付款,
3:已付清,
4:无
audit_statusinteger
审批状态:
121:待审核,
122:驳回,
123:通过,
124:作废
shipment_userstring
发货人
is_exist_declarationinteger
是否关联报关单,0:否,1:是
is_exist_clearanceinteger
是否关联清关单,0:否,1:是
third_party_order_modeinteger
下单模式,0:无,1:系统下单,2:手工下单
third_party_order_statusinteger
第三方仓下单状态,待发货下才有:
1:未下单,
2:已下单,
3:异常,
4:已发货
vat_codestring
店铺VAT税号
method_idstring
运输方式ID
method_namestring
运输方式名称
is_custom_shipment_timeinteger
是否自定义发货时间,1:是,0:否
logistics_tracking_numberstring
物流商单号
logisticsarray<object>必填
物流轨迹列表
隐藏子属性
logistics_list_typeinteger必填
物流轨迹样式,
0:旧版,
1:新版
示例 1
replace_tracking_numberstring
跟踪单号(旧版)
示例 88803089941
tracking_numberstring
物流商号(旧版)
示例 8880308989
tracking_nostring
查询单号(新版)
示例 ta1234567
transport_typeinteger
运输类型(新版)编码:
1-快递,
2-海运,
3-空运,
4-其他
示例 2
transport_type_namestring
运输类型(新版)名称
示例 海运
order_type_codeinteger
单号类型(新版)编码:
1-订舱号,
2-提单号,
3-箱号,
4-其他,
5-跟踪单号,
6-航班号
示例 4
order_type_code_namestring
单号类型(新版)名称
示例 其他
shippersstring
承运商(新版)编码
示例 emc
shippers_namestring
承运商(新版)名称
示例 长荣emc
remarkstring
轨迹备注(新版)
示例 这里是备注字段
relate_listarray<object>必填
关联货件列表
隐藏子属性
midinteger必填
国家id
示例 318
destination_fulfillment_center_idstring必填
物流中心编码
示例 FTW1
quantity_shippedinteger必填
申报量
示例 190
idinteger必填
明细id
示例 1039
wnamestring必填
仓库名称
示例 测试仓库--吴萍
shipment_snstring必填
发货单号
示例 SP180720003
shipment_idstring必填
货件id
示例 FBA15D9PQN10
shipment_statusstring必填
货件状态
widinteger必填
仓库id
示例 8
pidinteger必填
货件明细ID
示例 318
sidinteger必填
店铺id
示例 8
snamestring必填
店铺名称
示例 PM1:-test6-A0
numinteger必填
发货数量
示例 1
pic_urlstring必填
图片url
示例 http://ecx.images-amazon.com/images/I/31UvR_SL75_.jpg
packing_typeinteger必填
混装类型
1混装,
2原装
示例 1
fulfillment_network_skustring必填
listing的fnsku
示例 xxxx
skustring必填
sku
示例 10 1
fnskustring必填
仓库fnsku
mskustring必填
seller_sku
示例 xxxx
nationstring必填
国家名称
示例 美国
apply_numinteger必填
关联货件量
示例 1
product_idinteger必填
商品id
示例 19873
product_namestring必填
产品名称
示例 林xxxx
asinstring必填
ASIN
parent_asinstring必填
父ASIN
remarkstring必填
备注
statusinteger必填
发货单状态,
-1 : 待配货
0:待发货,
1:已发货,
3:已作废
示例 0
is_combointeger必填
是否组合商品:
1-是,
0-否
示例 1
create_by_mwsinteger必填
创建发货单途径:
1-货件,
0-发货计划
示例 1
whb_code_listarray<any>必填
仓位编码列表
packing_type_namestring必填
包装名称
示例 混装商品
product_valid_numinteger必填
可用量
示例 0
product_qc_numinteger必填
待检量
示例 0
shipment_order_listarray<object>必填
关联关系列表
隐藏子属性
ispr_idinteger
关联关系表ID
zidinteger
isp_idstring
发货计划表ID
isim_idstring
货件详情表ID
isil_idstring
发货单表ID
seqstring
发货计划批次号
shipment_plan_snstring
发货计划单号
shipment_mws_snstring
货件编号
shipment_list_snstring
发货单号
shipment_plan_quantityinteger
计划发货量
shipment_mws_quantityinteger
货件关联量
shipment_list_quantityinteger
发货单关联量
gmt_createstring
关联关系创建时间
gmt_modifiedstring
关联关系修改时间
company_idinteger
v_uuidstring
seqsstring
发货计划批次号(多个时使用,分隔)
shipment_plan_quantity_totalinteger
发货计划发货量合计
diff_numinteger必填
差额
示例 -1
sta_shipment_idstring必填
sta货件的shipmentId
示例 sh8c22071a-b157-4846-c4a47bxx
is_stastring必填
是否sta货件,
1:是,
0:否
sta_inbound_plan_idstring必填
sta货件所属的sta任务编号
not_relate_listarray<any>必填
未关联货件列表
destination_fulfillment_center_idstring必填
物流中心编码
示例 FTW1,BHX2,EUK5
status_namestring必填
状态名称
示例 待发货
head_fee_type_namestring必填
头程分摊名称
示例 按计费重
head_fee_type_name_newstring必填
新头程费分配名称方式:
0 产品-计费重(默认)
1 产品-实重
2 产品-体积重
3 产品-数量
4 自定义
5 箱子-体积
示例 产品-计费重
fileListarray<any>必填
文件列表
shipment_time_secondstring必填
发货时间(精确到时分秒)
示例 2023-10-23 18:23:40
is_deletenumber必填
删除状态:0-未删除 1-已删除
示例 0
totalinteger必填
示例 1

返回成功示例

{
    "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
    }
}