/basicOpen/packingTask/taskDetail{
"operation": {
"method": "POST",
"path": "/basicOpen/packingTask/taskDetail"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/packingTask/taskDetail?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\"ptId\":1234567890}'",
"responseExample": "{\n\t\"code\":0,\n\t\"message\":\"success\",\n\t\"error_details\":[],\n\t\"request_id\":\"a0d54debf93140f3b58d1ed81e8e3583\",\n\t\"response_time\":\"2026-04-23 12:00:00\",\n\t\"data\":{\n\t\t\"totalBoxNum\":1,\n\t\t\"totalBoxWeight\":1,\n\t\t\"totalBoxVolume\":1,\n\t\t\"totalPackedNum\":1,\n\t\t\"relateSn\":\"RP260423001\",\n\t\t\"boxList\":[\n\t\t\t{\n\t\t\t\t\"customBoxId\":\"BOX2026042300001\",\n\t\t\t\t\"boxLength\":\"2.00\",\n\t\t\t\t\"boxWidth\":\"2.00\",\n\t\t\t\t\"boxHeight\":\"2.00\",\n\t\t\t\t\"boxWeight\":\"2.00\",\n\t\t\t\t\"boxNum\":1,\n\t\t\t\t\"boxProduct\":[\n\t\t\t\t\t{\n\t\t\t\t\t\t\"msku\":\"Black_ Head_Rope\",\n\t\t\t\t\t\t\"fnsku\":\"B09MT3989Q\",\n\t\t\t\t\t\t\"nation\":\"美国\",\n\t\t\t\t\t\t\"sname\":\"8speed-US\",\n\t\t\t\t\t\t\"picUrl\":\"https://image.distributetop.com/lingxing-erp/901182423370657792/20230323/8271e359e85940839df1a565a0bb7050.jpg\",\n\t\t\t\t\t\t\"sku\":\"SKU1991FC9\",\n\t\t\t\t\t\t\"productName\":\"[演示数据]适用于iPad的手写笔带手掌柜绝\",\n\t\t\t\t\t\t\"packedNum\":2,\n\t\t\t\t\t\t\"sendNum\":2,\n\t\t\t\t\t\t\"ptpiId\":250693129738747904,\n\t\t\t\t\t\t\"unpackedNum\":0,\n\t\t\t\t\t\t\"productKey\":\"1590\",\n\t\t\t\t\t\t\"sid\":17,\n\t\t\t\t\t\t\"isCombo\":0,\n\t\t\t\t\t\t\"productId\":1,\n\t\t\t\t\t\t\"shipmentId\":\"\",\n\t\t\t\t\t\t\"printNum\":0,\n\t\t\t\t\t\t\"thirdPartyProductCode\":\"\",\n\t\t\t\t\t\t\"thirdPartyProductName\":\"\",\n\t\t\t\t\t\t\"isTransparency\":1,\n\t\t\t\t\t\t\"quantityInCase\":1,\n\t\t\t\t\t\t\"asin\":\"B09MT3989Q\",\n\t\t\t\t\t\t\"parentAsin\":\"B09MT3989Q\",\n\t\t\t\t\t\t\"asinUrl\":\"https://www.amazon.com/dp/B09MT3989Q\"\n\t\t\t\t\t}\n\t\t\t\t],\n\t\t\t\t\"ptbId\":250693132348194816,\n\t\t\t\t\"warehouseBoxCodes\":\"BOX2026042300001\"\n\t\t\t}\n\t\t],\n\t\t\"productItems\":[\n\t\t\t{\n\t\t\t\t\"ptpiId\":250693129738747904,\n\t\t\t\t\"sid\":17,\n\t\t\t\t\"sname\":\"8speed-US\",\n\t\t\t\t\"nation\":\"美国\",\n\t\t\t\t\"picUrl\":\"https://image.distributetop.com/lingxing-erp/901182423370657792/20230323/8271e359e85940839df1a565a0bb7050.jpg\",\n\t\t\t\t\"isCombo\":0,\n\t\t\t\t\"sku\":\"SKU1991FC9\",\n\t\t\t\t\"productId\":1,\n\t\t\t\t\"productName\":\"[演示数据]适用于iPad的手写笔带手掌柜绝\",\n\t\t\t\t\"fnsku\":\"B09MT3989Q\",\n\t\t\t\t\"msku\":\"Black_ Head_Rope\",\n\t\t\t\t\"packedNum\":2,\n\t\t\t\t\"sendNum\":2,\n\t\t\t\t\"productKey\":\"1590\",\n\t\t\t\t\"shipmentId\":\"\",\n\t\t\t\t\"printNum\":0,\n\t\t\t\t\"thirdPartyProductCode\":\"\",\n\t\t\t\t\"thirdPartyProductName\":\"\",\n\t\t\t\t\"isTransparency\":1,\n\t\t\t\t\"unpackedNum\":0,\n\t\t\t\t\"asin\":\"B09MT3989Q\",\n\t\t\t\t\"parentAsin\":\"B09MT3989Q\",\n\t\t\t\t\"asinUrl\":\"https://www.amazon.com/dp/B09MT3989Q\"\n\t\t\t}\n\t\t],\n\t\t\"taskInfo\":{\n\t\t\t\"ptId\":250693129738653696,\n\t\t\t\"gmtCreate\":\"2026-04-23 13:52:07\",\n\t\t\t\"gmtModified\":\"2026-04-23 14:08:54\",\n\t\t\t\"taskSn\":\"PL260423001\",\n\t\t\t\"taskStatus\":2,\n\t\t\t\"pickingStatus\":0,\n\t\t\t\"relateSnType\":1,\n\t\t\t\"relateSn\":\"RP260423001\",\n\t\t\t\"relateBoxType\":0,\n\t\t\t\"wid\":470,\n\t\t\t\"wname\":\"wss\",\n\t\t\t\"creatorName\":\"0超级管理员1\",\n\t\t\t\"optName\":\"0超级管理员1\",\n\t\t\t\"totalSendNum\":6,\n\t\t\t\"totalPackedNum\":3,\n\t\t\t\"scanType\":1,\n\t\t\t\"editBoxType\":1,\n\t\t\t\"isCustomId\":0,\n\t\t\t\"totalBoxNum\":1,\n\t\t\t\"totalBoxWeight\":\"2.00\",\n\t\t\t\"totalBoxVolume\":\"8.00\",\n\t\t\t\"totalBoxVolumeWeight\":\"0.00\",\n\t\t\t\"finishTime\":0,\n\t\t\t\"remark\":\"\",\n\t\t\t\"sid\":0,\n\t\t\t\"printLabelNum\":0,\n\t\t\t\"printTaskNum\":0,\n\t\t\t\"fileId\":\"\",\n\t\t\t\"relateShipment\":[\n\t\t\t\t{\n\t\t\t\t\t\"shipmentId\":\"FBA12345\",\n\t\t\t\t\t\"sid\":17,\n\t\t\t\t\t\"shipmentStatus\":\"WORKING\",\n\t\t\t\t\t\"localStaId\":\"12345\",\n\t\t\t\t\t\"localStaName\":\"示例值\",\n\t\t\t\t\t\"staInboundPlanId\":\"STA12345\"\n\t\t\t\t}\n\t\t\t]\n\t\t}\n\t}\n}```"
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | ptId | 装箱任务id | integer | — | Optional | 装箱任务id,未填时 taskSn 必填 |
| 2 | taskSn | 装箱任务单号 | string | — | Optional | 装箱任务单号,未填时 ptId 必填 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | Required | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-04-23 12:00:00 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | totalBoxNum | 总箱数 | integer | 1 | Required | 总箱数 |
| 6.2 | totalBoxWeight | 总重量 | integer | 1 | Required | 总重量 |
| 6.3 | totalBoxVolume | 总体积 | integer | 1 | Required | 总体积 |
| 6.4 | totalPackedNum | 已装产品数 | integer | 1 | Required | 已装产品数 |
| 6.5 | relateSn | 关联单号 | string | RP260423001 | Required | 关联单号 |
| 6.6 | boxList | 商品列表数据 | array<object> | — | Required | 商品列表数据 |
| 6.6.1 | customBoxId | 箱号 | string | BOX2026042300001 | Required | 箱号 |
| 6.6.2 | boxLength | 箱子长度 | string | 2.00 | Required | 箱子长度 |
| 6.6.3 | boxWidth | 箱子宽度 | string | 2.00 | Required | 箱子宽度 |
| 6.6.4 | boxHeight | 箱子高度 | string | 2.00 | Required | 箱子高度 |
| 6.6.5 | boxWeight | 箱子毛重 | string | 2.00 | Required | 箱子毛重 |
| 6.6.6 | boxNum | 箱数 | integer | 1 | Required | 箱数 |
| 6.6.7 | boxProduct | 商品行数据 | array<object> | — | Required | 商品行数据 |
| 6.6.7.1 | msku | msku | string | Black_ Head_Rope | Required | MSKU |
| 6.6.7.2 | fnsku | fnsku | string | B09MT3989Q | Required | FNSKU |
| 6.6.7.3 | nation | 国家 | string | 美国 | Required | 国家 |
| 6.6.7.4 | sname | 店铺名称 | string | 8speed-US | Required | 店铺名称 |
| 6.6.7.5 | picUrl | 图片地址 | string | https://image.distributetop.com/lingxing-erp/901182423370657792/20230323/8271e359e85940839df1a565a0bb7050.jpg | Required | 图片地址 |
| 6.6.7.6 | sku | sku | string | SKU1991FC9 | Required | SKU |
| 6.6.7.7 | productName | 品名 | string | [演示数据]适用于iPad的手写笔带手掌柜绝 | Required | 品名 |
| 6.6.7.8 | packedNum | 装箱数量 | integer | 2 | Required | 装箱数量 |
| 6.6.7.9 | sendNum | 发货量 | integer | 2 | Required | 发货量 |
| 6.6.7.10 | ptpiId | 商品行分布式id | integer | 250693129738747900 | Required | 商品行分布式id |
| 6.6.7.11 | unpackedNum | 未装箱数量 | integer | 0 | Required | 未装箱数量 |
| 6.6.7.12 | productKey | 商品行唯一键 | string | 1590 | Required | 商品行唯一键 |
| 6.6.7.13 | sid | 店铺ID | integer | 17 | Required | 店铺ID |
| 6.6.7.14 | isCombo | 是否组合品 | integer | 0 | Required | 是否组合品:0-否,1-是 |
| 6.6.7.15 | productId | 产品ID | integer | 1 | Required | 产品ID |
| 6.6.7.16 | shipmentId | 货件编号 | string | — | Required | 货件编号 |
| 6.6.7.17 | printNum | 打印次数 | integer | 0 | Required | 打印次数 |
| 6.6.7.18 | thirdPartyProductCode | 三方SKU | string | — | Required | 三方SKU |
| 6.6.7.19 | thirdPartyProductName | 三方品名 | string | — | Required | 三方品名 |
| 6.6.7.20 | isTransparency | 是否透明计划商品 | integer | 1 | Required | 是否透明计划商品 |
| 6.6.7.21 | quantityInCase | 单箱数量 | integer | 1 | Required | 单箱数量 |
| 6.6.7.22 | asin | asin | string | B09MT3989Q | Required | ASIN |
| 6.6.7.23 | parentAsin | 父ASIN | string | B09MT3989Q | Required | 父ASIN |
| 6.6.7.24 | asinUrl | ASIN链接 | string | https://www.amazon.com/dp/B09MT3989Q | Required | ASIN链接 |
| 6.6.8 | ptbId | 箱子ID | integer | 250693132348194800 | Required | 箱子ID |
| 6.6.9 | warehouseBoxCodes | 仓库箱号 | string | BOX2026042300001 | Required | 仓库箱号 |
| 6.7 | productItems | 商品信息数组 | array<object> | — | Required | 商品信息数组 |
| 6.7.1 | ptpiId | 商品ID | integer | 250693129738747900 | Required | 商品ID |
| 6.7.2 | sid | 店铺ID | integer | 17 | Required | 店铺ID |
| 6.7.3 | sname | 店铺名称 | string | 8speed-US | Required | 店铺名称 |
| 6.7.4 | nation | 国家 | string | 美国 | Required | 国家 |
| 6.7.5 | picUrl | 图片 | string | https://image.distributetop.com/lingxing-erp/901182423370657792/20230323/8271e359e85940839df1a565a0bb7050.jpg | Required | 图片 |
| 6.7.6 | isCombo | 是否组合品 | integer | 0 | Required | 是否组合品:0-否,1-是 |
| 6.7.7 | sku | sku | string | SKU1991FC9 | Required | SKU |
| 6.7.8 | productId | 产品ID | integer | 1 | Required | 产品ID |
| 6.7.9 | productName | 产品名称 | string | [演示数据]适用于iPad的手写笔带手掌柜绝 | Required | 产品名称 |
| 6.7.10 | fnsku | fnsku | string | B09MT3989Q | Required | FNSKU |
| 6.7.11 | msku | msku | string | Black_ Head_Rope | Required | MSKU |
| 6.7.12 | packedNum | 已装箱量 | integer | 2 | Required | 已装箱量 |
| 6.7.13 | sendNum | 单据数量 | integer | 2 | Required | 单据数量 |
| 6.7.14 | productKey | 商品key | string | 1590 | Required | 商品key |
| 6.7.15 | shipmentId | 货件编号 | string | — | Required | 货件编号 |
| 6.7.16 | printNum | 打印次数 | integer | 0 | Required | 打印次数 |
| 6.7.17 | thirdPartyProductCode | 三方SKU | string | — | Required | 三方SKU |
| 6.7.18 | thirdPartyProductName | 三方品名 | string | — | Required | 三方品名 |
| 6.7.19 | isTransparency | 是否透明计划商品 | integer | 1 | Required | 是否透明计划商品 |
| 6.7.20 | unpackedNum | 待装箱数量 | integer | 0 | Required | 待装箱数量 |
| 6.7.21 | asin | asin | string | B09MT3989Q | Required | ASIN |
| 6.7.22 | parentAsin | 父ASIN | string | B09MT3989Q | Required | 父ASIN |
| 6.7.23 | asinUrl | ASIN链接 | string | https://www.amazon.com/dp/B09MT3989Q | Required | ASIN链接 |
| 6.8 | taskInfo | 任务信息 | object | — | Required | 任务信息 |
| 6.8.1 | ptId | 任务ID | integer | 250693129738653700 | Required | 任务ID |
| 6.8.2 | gmtCreate | 创建时间 | string | 2026-04-23 13:52:07 | Required | 创建时间 |
| 6.8.3 | gmtModified | 修改时间 | string | 2026-04-23 14:08:54 | Required | 修改时间 |
| 6.8.4 | taskSn | 任务编号 | string | PL260423001 | Required | 任务编号 |
| 6.8.5 | taskStatus | 任务状态 | integer | 2 | Required | 任务状态 |
| 6.8.6 | pickingStatus | 拣货状态 | integer | 0 | Required | 拣货状态 |
| 6.8.7 | relateSnType | 关联单据类型(1-发货计划 | integer | 1 | Required | 关联单据类型(1-发货计划,2-发货单,3-货件,4-海外仓备货单) |
| 6.8.8 | relateSn | 关联单据编号 | string | RP260423001 | Required | 关联单据编号 |
| 6.8.9 | relateBoxType | 关联单据装箱方式 | integer | 0 | Required | 关联单据装箱方式,1-每箱1款SKU,2-每箱多款SKU |
| 6.8.10 | wid | 仓库ID | integer | 470 | Required | 仓库ID |
| 6.8.11 | wname | 仓库名称 | string | wss | Required | 仓库名称 |
| 6.8.12 | creatorName | 创建人 | string | 0超级管理员1 | Required | 创建人 |
| 6.8.13 | optName | 操作人 | string | 0超级管理员1 | Required | 操作人 |
| 6.8.14 | totalSendNum | 总数量 | integer | 6 | Required | 总数量 |
| 6.8.15 | totalPackedNum | 总装箱量 | integer | 3 | Required | 总装箱量 |
| 6.8.16 | scanType | 扫码类型 | integer | 1 | Required | 扫码类型 |
| 6.8.17 | editBoxType | 扫码装箱方式 | integer | 1 | Required | 扫码装箱方式:1-逐个,2-批量 |
| 6.8.18 | isCustomId | 是否自定义箱子编号 | integer | 0 | Required | 是否自定义箱子编号:0-否,1-是 |
| 6.8.19 | totalBoxNum | 总箱数 | integer | 1 | Required | 总箱数 |
| 6.8.20 | totalBoxWeight | 总重量 | string | 2.00 | Required | 总重量 |
| 6.8.21 | totalBoxVolume | 总体积 | string | 8.00 | Required | 总体积 |
| 6.8.22 | totalBoxVolumeWeight | 总体积重 | string | 0.00 | Required | 总体积重 |
| 6.8.23 | finishTime | 单据完成时间 | integer | 0 | Required | 单据完成时间 |
| 6.8.24 | remark | 备注 | string | — | Required | 备注 |
| 6.8.25 | sid | 单据店铺 | integer | 0 | Required | 单据店铺 |
| 6.8.26 | printLabelNum | 打印标签数 | integer | 0 | Required | 打印标签数 |
| 6.8.27 | printTaskNum | 打印任务数 | integer | 0 | Required | 打印任务数 |
| 6.8.28 | fileId | 附件ID | string | — | Required | 附件ID |
| 6.8.29 | relateShipment | 关联货件信息 | array<object> | — | Required | 关联货件信息 |
| 6.8.29.1 | shipmentId | 货件编号 | string | FBA12345 | Required | 货件编号 |
| 6.8.29.2 | sid | 店铺ID | integer | 17 | Required | 店铺ID |
| 6.8.29.3 | shipmentStatus | 货件状态 | string | WORKING | Required | 货件状态 |
| 6.8.29.4 | localStaId | STA任务自增ID | string | 12345 | Required | STA任务自增ID |
| 6.8.29.5 | localStaName | STA任务名称 | string | 示例值 | Required | STA任务名称 |
| 6.8.29.6 | staInboundPlanId | STA任务计划编号 | string | STA12345 | Required | STA任务计划编号 |
The 装箱任务 - 任务详情 API (/basicOpen/packingTask/taskDetail) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.