/basicOpen/packingTask/list{
"operation": {
"method": "POST",
"path": "/basicOpen/packingTask/list"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/packingTask/list?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"wid\": [47],\n \"optUid\": [1, 128727],\n \"packingCon\": [\"2\"],\n \"relateSnType\": [\"1\", \"2\"],\n \"searchFieldTime\": \"done\",\n \"startDate\": \"2026-04-22\",\n \"endDate\": \"2026-04-28\",\n \"searchField\": \"task_sn\",\n \"searchValue\": \"\",\n \"offset\": 0,\n \"length\": 20\n}'",
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "a0d54debf93140f3b58d1ed81e8e3583",
"response_time": "2026-04-29 12:00:00",
"data": {
"list": [
{
"ptId": 250692382241271800,
"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": 250692382241271800,
"ptpiId": 250692382241353730,
"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": 231692380650336260,
"localStaName": "STA (04/21/2026 11:03 AM)",
"staInboundPlanId": "wffd8487f6-18a8-4844-859f-b7e4159e1a60"
}
]
}
]
},
"total": 1
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | wid | 仓库ID | array<any> | — | 可选 | 仓库ID |
| 2 | optUid | 装箱员UID | array<any> | — | 可选 | 装箱员UID |
| 3 | packingCon | 装箱情况 | array<any> | — | 可选 | 装箱情况 1-未装箱 2-部分装箱 3-全装箱 |
| 4 | relateSnType | 单据类型 | array<any> | — | 可选 | 单据类型 1-发货计划 2-发货单 3-FBA货件 4-海外仓备货单 |
| 5 | searchFieldTime | 时间搜索 | string | — | 可选 | 时间搜索 create-创建时间 done-完成时间 |
| 6 | startDate | 开始时间 Y-m-d | string | — | 可选 | 开始时间 Y-m-d |
| 7 | endDate | 结束时间 Y-m-d | string | — | 可选 | 结束时间 Y-m-d |
| 8 | searchField | 搜索字段 | string | — | 可选 | 搜索字段 relate_sn-关联单据单号 task_sn-任务单号 shipment_id-货件单号 local_sta_name-STA任务名称 msku-MSKU sku-SKU fnsku-FNSKU |
| 9 | searchValue | 搜索值 | string | — | 可选 | 搜索值 |
| 10 | offset | 偏移量 | integer | — | 必填 | 偏移量,默认0 |
| 11 | length | 分页大小 | integer | — | 必填 | 分页大小,默认20,最大200 |
| 12 | pickingStatus | 拣货状态 | string | — | 可选 | 拣货状态 "1"-已拣 "0"-待拣 |
| 13 | printTask | 打印单据 | string | — | 可选 | 打印单据 "1"-已打印 "0"-未打印 |
| 14 | printLabel | 打印标签 | string | — | 可选 | 打印标签 "1"-已打印 "0"-未打印 |
| 15 | seniorSearchList | 高级搜索 | array<object> | — | 可选 | 高级搜索 |
| 15.1 | searchField | 搜索字段 | string | — | 可选 | 搜索字段 relate_sn-关联单据单号 task_sn-任务单号 shipment_id-货件单号 local_sta_name-STA任务名称 msku-MSKU sku-SKU fnsku-FNSKU |
| 15.2 | searchValue | 搜索值 | array<any> | — | 可选 | 搜索值 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | 必填 | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | 必填 | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-04-29 12:00:00 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 6.1 | list | 列表数据 | array<object> | — | 必填 | 列表数据 |
| 6.1.1 | itemList | 产品信息 | array<object> | — | 必填 | 产品信息 |
| 6.1.1.1 | picUrl | 图片地址 | string | https://m.media-amazon.com/images/I/61QCCyNCYnL._SL75_.jpg | 必填 | 图片地址 |
| 6.1.1.2 | msku | msku | string | 7T-2COF-AV9I | 必填 | MSKU |
| 6.1.1.3 | fnsku | fnsku | string | B08D3MPS2V | 必填 | FNSKU |
| 6.1.1.4 | productName | 品名 | string | 222 | 必填 | 品名 |
| 6.1.1.5 | sku | sku | string | 7T-AV9I111 | 必填 | SKU |
| 6.1.1.6 | sname | 店铺名称 | string | UB-US | 必填 | 店铺名称 |
| 6.1.1.7 | sendNum | 发货数 | integer | 2 | 必填 | 发货数 |
| 6.1.1.8 | packedNum | 装箱数 | integer | 2 | 必填 | 装箱数 |
| 6.1.1.9 | ptId | 任务自增ID | integer | 250692382241271800 | 必填 | 任务自增ID |
| 6.1.1.10 | ptpiId | 商品自增ID | integer | 250692382241353730 | 必填 | 商品自增ID |
| 6.1.1.11 | sid | 商品店铺ID | integer | 54 | 必填 | 商品店铺ID |
| 6.1.1.12 | isCombo | 是否组合品 1-是 0-否 | integer | 0 | 必填 | 是否组合品 1-是 0-否 |
| 6.1.1.13 | nation | 国家 | string | 美国 | 必填 | 国家 |
| 6.1.1.14 | productKey | 产品唯一键 | string | fb6baad06915b5b4df4c395b1e852966 | 必填 | 产品唯一键 |
| 6.1.1.15 | shipmentId | 货件编号 | string | FBA19BY0NBPC | 可选 | 货件编号 |
| 6.1.1.16 | thirdPartyProductCode | 三方SKU | string | CODE001 | 可选 | 三方SKU |
| 6.1.1.17 | thirdPartyProductName | 三方品名 | string | 示例名称 | 可选 | 三方品名 |
| 6.1.1.18 | isTransparency | 是否透明计划 1-是 0-否 | integer | 1 | 必填 | 是否透明计划 1-是 0-否 |
| 6.1.2 | statusName | 状态 | string | 装箱中 | 必填 | 状态 |
| 6.1.3 | relateSnName | 单据类型 | string | FBA货件 | 必填 | 单据类型 |
| 6.1.4 | totalSendNum | 发货数量 | integer | 2 | 必填 | 发货数量 |
| 6.1.5 | totalPackedNum | 装箱数量 | integer | 2 | 必填 | 装箱数量 |
| 6.1.6 | wname | 仓库名称 | string | 仓库1改名字 | 必填 | 仓库名称 |
| 6.1.7 | taskSn | 任务单号 | string | PL260421003 | 必填 | 任务单号 |
| 6.1.8 | relateSn | 关联单号 | string | FBA19BY0NBPC | 必填 | 关联单号 |
| 6.1.9 | gmtCreate | 创建时间 | string | 2026-04-21 11:10:33 | 必填 | 创建时间 |
| 6.1.10 | finishTime | 完成时间 | string | — | 必填 | 完成时间 |
| 6.1.11 | remark | 备注 | string | — | 必填 | 备注 |
| 6.1.12 | creatorName | 创建人 | string | 超级管理员01 | 必填 | 创建人 |
| 6.1.13 | optName | 装箱员 | string | 超级管理员01 | 必填 | 装箱员 |
| 6.1.14 | boxPacked | 是否装箱过 | boolean | true | 必填 | 是否装箱过:true-是,false-否 |
| 6.1.15 | sid | 单据店铺ID | integer | 54 | 可选 | 单据店铺ID |
| 6.1.16 | ptId | 单据自增ID | integer | 250692382241271800 | 必填 | 单据自增ID |
| 6.1.17 | taskStatus | 任务状态 1-待装箱 | integer | 2 | 必填 | 任务状态 1-待装箱,2-装箱中,3-已完成 |
| 6.1.18 | relateSnType | 单据类型 1-发货计划 | integer | 3 | 必填 | 单据类型 1-发货计划,2-发货单,3-FBA货件,4-海外仓备货单 |
| 6.1.19 | wid | 仓库ID | integer | 1 | 必填 | 仓库ID |
| 6.1.20 | pickingStatus | 拣货状态 1-已拣 0-未拣 | integer | 0 | 必填 | 拣货状态 1-已拣 0-未拣 |
| 6.1.21 | printTaskNum | 打印任务数 | integer | 0 | 必填 | 打印任务数 |
| 6.1.22 | printLabelNum | 打印标签数 | integer | 0 | 必填 | 打印标签数 |
| 6.1.23 | totalBoxNum | 总箱数 | integer | 1 | 必填 | 总箱数 |
| 6.1.24 | principal | 负责人 | array<object> | — | 必填 | 负责人 |
| 6.1.24.1 | principalUid | 负责人UID | integer | 1 | 必填 | 负责人UID |
| 6.1.24.2 | name | 负责人名称 | string | 超级管理员01 | 必填 | 负责人名称 |
| 6.1.25 | productNum | 商品数 | integer | 1 | 必填 | 商品数 |
| 6.1.26 | pickingStatusName | 拣货名称 | string | 待拣货 | 必填 | 拣货名称 |
| 6.1.27 | relateShipment | 关联货件信息 | array<object> | — | 必填 | 关联货件信息 |
| 6.1.27.1 | shipmentId | 货件编号 | string | FBA19BY0NBPC | 必填 | 货件编号 |
| 6.1.27.2 | sid | 店铺ID | integer | 54 | 必填 | 店铺ID |
| 6.1.27.3 | shipmentStatus | 货件状态 | string | SHIPPED | 必填 | 货件状态 |
| 6.1.27.4 | localStaId | STA任务自增ID | integer | 231692380650336260 | 必填 | STA任务自增ID |
| 6.1.27.5 | localStaName | STA任务名称 | string | STA (04/21/2026 11:03 AM) | 必填 | STA任务名称 |
| 6.1.27.6 | staInboundPlanId | STA任务编号 | string | wffd8487f6-18a8-4844-859f-b7e4159e1a60 | 必填 | STA任务编号 |
| 7 | total | 总数 | integer | 1 | 必填 | 总数 |
领星ERP的接口:装箱任务 - 任务列表(/basicOpen/packingTask/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。