Lingxing
切换旧版

装箱任务 - 任务列表

POST/basicOpen/packingTask/list

查询装箱任务列表,支持按仓库、装箱员、装箱情况、单据类型等条件筛选

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/packingTask/listHTTPSPOST1

请求参数

widarray<any>
仓库ID
optUidarray<any>
装箱员UID
packingConarray<any>
装箱情况
1-未装箱
2-部分装箱
3-全装箱
relateSnTypearray<any>
单据类型
1-发货计划
2-发货单
3-FBA货件
4-海外仓备货单
searchFieldTimestring
时间搜索
create-创建时间
done-完成时间
startDatestring
开始时间 Y-m-d
endDatestring
结束时间 Y-m-d
searchFieldstring
搜索字段
relate_sn-关联单据单号
task_sn-任务单号
shipment_id-货件单号
local_sta_name-STA任务名称
msku-MSKU
sku-SKU
fnsku-FNSKU
searchValuestring
搜索值
offsetinteger必填
偏移量,默认0
lengthinteger必填
分页大小,默认20,最大200
pickingStatusstring
拣货状态
"1"-已拣
"0"-待拣
printTaskstring
打印单据
"1"-已打印
"0"-未打印
printLabelstring
打印标签
"1"-已打印
"0"-未打印
seniorSearchListarray<object>
高级搜索
隐藏子属性
searchFieldstring
搜索字段
relate_sn-关联单据单号
task_sn-任务单号
shipment_id-货件单号
local_sta_name-STA任务名称
msku-MSKU
sku-SKU
fnsku-FNSKU
searchValuearray<any>
搜索值

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/packingTask/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "wid": [47],
    "optUid": [1, 128727],
    "packingCon": ["2"],
    "relateSnType": ["1", "2"],
    "searchFieldTime": "done",
    "startDate": "2026-04-22",
    "endDate": "2026-04-28",
    "searchField": "task_sn",
    "searchValue": "",
    "offset": 0,
    "length": 20
}'

返回结果

Json Object

codeinteger必填
状态码,0:成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-04-29 12:00:00
dataobject必填
响应数据
隐藏子属性
listarray<object>必填
列表数据
隐藏子属性
itemListarray<object>必填
产品信息
隐藏子属性
picUrlstring必填
图片地址
示例 https://m.media-amazon.com/images/I/61QCCyNCYnL._SL75_.jpg
mskustring必填
MSKU
示例 7T-2COF-AV9I
fnskustring必填
FNSKU
示例 B08D3MPS2V
productNamestring必填
品名
示例 222
skustring必填
SKU
示例 7T-AV9I111
snamestring必填
店铺名称
示例 UB-US
sendNuminteger必填
发货数
示例 2
packedNuminteger必填
装箱数
示例 2
ptIdinteger必填
任务自增ID
示例 250692382241271800
ptpiIdinteger必填
商品自增ID
示例 250692382241353730
sidinteger必填
商品店铺ID
示例 54
isCombointeger必填
是否组合品 1-是 0-否
示例 0
nationstring必填
国家
示例 美国
productKeystring必填
产品唯一键
示例 fb6baad06915b5b4df4c395b1e852966
shipmentIdstring
货件编号
示例 FBA19BY0NBPC
thirdPartyProductCodestring
三方SKU
示例 CODE001
thirdPartyProductNamestring
三方品名
示例 示例名称
isTransparencyinteger必填
是否透明计划 1-是 0-否
示例 1
statusNamestring必填
状态
示例 装箱中
relateSnNamestring必填
单据类型
示例 FBA货件
totalSendNuminteger必填
发货数量
示例 2
totalPackedNuminteger必填
装箱数量
示例 2
wnamestring必填
仓库名称
示例 仓库1改名字
taskSnstring必填
任务单号
示例 PL260421003
relateSnstring必填
关联单号
示例 FBA19BY0NBPC
gmtCreatestring必填
创建时间
示例 2026-04-21 11:10:33
finishTimestring必填
完成时间
remarkstring必填
备注
creatorNamestring必填
创建人
示例 超级管理员01
optNamestring必填
装箱员
示例 超级管理员01
boxPackedboolean必填
是否装箱过:true-是,false-否
示例 true
sidinteger
单据店铺ID
示例 54
ptIdinteger必填
单据自增ID
示例 250692382241271800
taskStatusinteger必填
任务状态 1-待装箱,2-装箱中,3-已完成
示例 2
relateSnTypeinteger必填
单据类型 1-发货计划,2-发货单,3-FBA货件,4-海外仓备货单
示例 3
widinteger必填
仓库ID
示例 1
pickingStatusinteger必填
拣货状态 1-已拣 0-未拣
示例 0
printTaskNuminteger必填
打印任务数
示例 0
printLabelNuminteger必填
打印标签数
示例 0
totalBoxNuminteger必填
总箱数
示例 1
principalarray<object>必填
负责人
隐藏子属性
principalUidinteger必填
负责人UID
示例 1
namestring必填
负责人名称
示例 超级管理员01
productNuminteger必填
商品数
示例 1
pickingStatusNamestring必填
拣货名称
示例 待拣货
relateShipmentarray<object>必填
关联货件信息
隐藏子属性
shipmentIdstring必填
货件编号
示例 FBA19BY0NBPC
sidinteger必填
店铺ID
示例 54
shipmentStatusstring必填
货件状态
示例 SHIPPED
localStaIdinteger必填
STA任务自增ID
示例 231692380650336260
localStaNamestring必填
STA任务名称
示例 STA (04/21/2026 11:03 AM)
staInboundPlanIdstring必填
STA任务编号
示例 wffd8487f6-18a8-4844-859f-b7e4159e1a60
totalinteger必填
总数
示例 1

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-04-29 12:00:00",
    "data": {
        "list": [
            {
                "ptId": 250692382241271808,
                "gmtCreate": "2026-04-21 11:10:33",
                "taskSn": "PL260421003",
                "taskStatus": 2,
                "relateSnType": 3,
                "relateSn": "FBA19BY0NBPC",
                "wid": 1,
                "wname": "仓库1改名字",
                "creatorName": "超级管理员01",
                "optName": "超级管理员01",
                "totalSendNum": 2,
                "totalPackedNum": 2,
                "finishTime": "",
                "remark": "",
                "pickingStatus": 0,
                "printTaskNum": 0,
                "printLabelNum": 0,
                "totalBoxNum": 1,
                "principal": [
                    {
                        "principalUid": 1,
                        "name": "超级管理员01"
                    }
                ],
                "itemList": [
                    {
                        "ptId": 250692382241271808,
                        "ptpiId": 250692382241353728,
                        "sid": 54,
                        "picUrl": "https://m.media-amazon.com/images/I/61QCCyNCYnL._SL75_.jpg",
                        "isCombo": 0,
                        "msku": "7T-2COF-AV9I",
                        "fnsku": "B08D3MPS2V",
                        "productName": "222",
                        "sku": "7T-AV9I111",
                        "sname": "UB-US",
                        "nation": "美国",
                        "sendNum": 2,
                        "packedNum": 2,
                        "productKey": "fb6baad06915b5b4df4c395b1e852966",
                        "shipmentId": "FBA19BY0NBPC",
                        "thirdPartyProductCode": "",
                        "thirdPartyProductName": "",
                        "isTransparency": 1
                    }
                ],
                "productNum": 1,
                "statusName": "装箱中",
                "relateSnName": "FBA货件",
                "pickingStatusName": "待拣货",
                "boxPacked": true,
                "sid": 54,
                "relateShipment": [
                    {
                        "shipmentId": "FBA19BY0NBPC",
                        "sid": 54,
                        "shipmentStatus": "SHIPPED",
                        "localStaId": 231692380650336256,
                        "localStaName": "STA (04/21/2026 11:03 AM)",
                        "staInboundPlanId": "wffd8487f6-18a8-4844-859f-b7e4159e1a60"
                    }
                ]
            }
        ]
    },
    "total": 1
}