/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}```"
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | ptId | 装箱任务id | integer | — | 可选 | 装箱任务id,未填时 taskSn 必填 |
| 2 | taskSn | 装箱任务单号 | string | — | 可选 | 装箱任务单号,未填时 ptId 必填 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 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-23 12:00:00 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 6.1 | totalBoxNum | 总箱数 | integer | 1 | 必填 | 总箱数 |
| 6.2 | totalBoxWeight | 总重量 | integer | 1 | 必填 | 总重量 |
| 6.3 | totalBoxVolume | 总体积 | integer | 1 | 必填 | 总体积 |
| 6.4 | totalPackedNum | 已装产品数 | integer | 1 | 必填 | 已装产品数 |
| 6.5 | relateSn | 关联单号 | string | RP260423001 | 必填 | 关联单号 |
| 6.6 | boxList | 商品列表数据 | array<object> | — | 必填 | 商品列表数据 |
| 6.6.1 | customBoxId | 箱号 | string | BOX2026042300001 | 必填 | 箱号 |
| 6.6.2 | boxLength | 箱子长度 | string | 2.00 | 必填 | 箱子长度 |
| 6.6.3 | boxWidth | 箱子宽度 | string | 2.00 | 必填 | 箱子宽度 |
| 6.6.4 | boxHeight | 箱子高度 | string | 2.00 | 必填 | 箱子高度 |
| 6.6.5 | boxWeight | 箱子毛重 | string | 2.00 | 必填 | 箱子毛重 |
| 6.6.6 | boxNum | 箱数 | integer | 1 | 必填 | 箱数 |
| 6.6.7 | boxProduct | 商品行数据 | array<object> | — | 必填 | 商品行数据 |
| 6.6.7.1 | msku | msku | string | Black_ Head_Rope | 必填 | MSKU |
| 6.6.7.2 | fnsku | fnsku | string | B09MT3989Q | 必填 | FNSKU |
| 6.6.7.3 | nation | 国家 | string | 美国 | 必填 | 国家 |
| 6.6.7.4 | sname | 店铺名称 | string | 8speed-US | 必填 | 店铺名称 |
| 6.6.7.5 | picUrl | 图片地址 | string | https://image.distributetop.com/lingxing-erp/901182423370657792/20230323/8271e359e85940839df1a565a0bb7050.jpg | 必填 | 图片地址 |
| 6.6.7.6 | sku | sku | string | SKU1991FC9 | 必填 | SKU |
| 6.6.7.7 | productName | 品名 | string | [演示数据]适用于iPad的手写笔带手掌柜绝 | 必填 | 品名 |
| 6.6.7.8 | packedNum | 装箱数量 | integer | 2 | 必填 | 装箱数量 |
| 6.6.7.9 | sendNum | 发货量 | integer | 2 | 必填 | 发货量 |
| 6.6.7.10 | ptpiId | 商品行分布式id | integer | 250693129738747900 | 必填 | 商品行分布式id |
| 6.6.7.11 | unpackedNum | 未装箱数量 | integer | 0 | 必填 | 未装箱数量 |
| 6.6.7.12 | productKey | 商品行唯一键 | string | 1590 | 必填 | 商品行唯一键 |
| 6.6.7.13 | sid | 店铺ID | integer | 17 | 必填 | 店铺ID |
| 6.6.7.14 | isCombo | 是否组合品 | integer | 0 | 必填 | 是否组合品:0-否,1-是 |
| 6.6.7.15 | productId | 产品ID | integer | 1 | 必填 | 产品ID |
| 6.6.7.16 | shipmentId | 货件编号 | string | — | 必填 | 货件编号 |
| 6.6.7.17 | printNum | 打印次数 | integer | 0 | 必填 | 打印次数 |
| 6.6.7.18 | thirdPartyProductCode | 三方SKU | string | — | 必填 | 三方SKU |
| 6.6.7.19 | thirdPartyProductName | 三方品名 | string | — | 必填 | 三方品名 |
| 6.6.7.20 | isTransparency | 是否透明计划商品 | integer | 1 | 必填 | 是否透明计划商品 |
| 6.6.7.21 | quantityInCase | 单箱数量 | integer | 1 | 必填 | 单箱数量 |
| 6.6.7.22 | asin | asin | string | B09MT3989Q | 必填 | ASIN |
| 6.6.7.23 | parentAsin | 父ASIN | string | B09MT3989Q | 必填 | 父ASIN |
| 6.6.7.24 | asinUrl | ASIN链接 | string | https://www.amazon.com/dp/B09MT3989Q | 必填 | ASIN链接 |
| 6.6.8 | ptbId | 箱子ID | integer | 250693132348194800 | 必填 | 箱子ID |
| 6.6.9 | warehouseBoxCodes | 仓库箱号 | string | BOX2026042300001 | 必填 | 仓库箱号 |
| 6.7 | productItems | 商品信息数组 | array<object> | — | 必填 | 商品信息数组 |
| 6.7.1 | ptpiId | 商品ID | integer | 250693129738747900 | 必填 | 商品ID |
| 6.7.2 | sid | 店铺ID | integer | 17 | 必填 | 店铺ID |
| 6.7.3 | sname | 店铺名称 | string | 8speed-US | 必填 | 店铺名称 |
| 6.7.4 | nation | 国家 | string | 美国 | 必填 | 国家 |
| 6.7.5 | picUrl | 图片 | string | https://image.distributetop.com/lingxing-erp/901182423370657792/20230323/8271e359e85940839df1a565a0bb7050.jpg | 必填 | 图片 |
| 6.7.6 | isCombo | 是否组合品 | integer | 0 | 必填 | 是否组合品:0-否,1-是 |
| 6.7.7 | sku | sku | string | SKU1991FC9 | 必填 | SKU |
| 6.7.8 | productId | 产品ID | integer | 1 | 必填 | 产品ID |
| 6.7.9 | productName | 产品名称 | string | [演示数据]适用于iPad的手写笔带手掌柜绝 | 必填 | 产品名称 |
| 6.7.10 | fnsku | fnsku | string | B09MT3989Q | 必填 | FNSKU |
| 6.7.11 | msku | msku | string | Black_ Head_Rope | 必填 | MSKU |
| 6.7.12 | packedNum | 已装箱量 | integer | 2 | 必填 | 已装箱量 |
| 6.7.13 | sendNum | 单据数量 | integer | 2 | 必填 | 单据数量 |
| 6.7.14 | productKey | 商品key | string | 1590 | 必填 | 商品key |
| 6.7.15 | shipmentId | 货件编号 | string | — | 必填 | 货件编号 |
| 6.7.16 | printNum | 打印次数 | integer | 0 | 必填 | 打印次数 |
| 6.7.17 | thirdPartyProductCode | 三方SKU | string | — | 必填 | 三方SKU |
| 6.7.18 | thirdPartyProductName | 三方品名 | string | — | 必填 | 三方品名 |
| 6.7.19 | isTransparency | 是否透明计划商品 | integer | 1 | 必填 | 是否透明计划商品 |
| 6.7.20 | unpackedNum | 待装箱数量 | integer | 0 | 必填 | 待装箱数量 |
| 6.7.21 | asin | asin | string | B09MT3989Q | 必填 | ASIN |
| 6.7.22 | parentAsin | 父ASIN | string | B09MT3989Q | 必填 | 父ASIN |
| 6.7.23 | asinUrl | ASIN链接 | string | https://www.amazon.com/dp/B09MT3989Q | 必填 | ASIN链接 |
| 6.8 | taskInfo | 任务信息 | object | — | 必填 | 任务信息 |
| 6.8.1 | ptId | 任务ID | integer | 250693129738653700 | 必填 | 任务ID |
| 6.8.2 | gmtCreate | 创建时间 | string | 2026-04-23 13:52:07 | 必填 | 创建时间 |
| 6.8.3 | gmtModified | 修改时间 | string | 2026-04-23 14:08:54 | 必填 | 修改时间 |
| 6.8.4 | taskSn | 任务编号 | string | PL260423001 | 必填 | 任务编号 |
| 6.8.5 | taskStatus | 任务状态 | integer | 2 | 必填 | 任务状态 |
| 6.8.6 | pickingStatus | 拣货状态 | integer | 0 | 必填 | 拣货状态 |
| 6.8.7 | relateSnType | 关联单据类型(1-发货计划 | integer | 1 | 必填 | 关联单据类型(1-发货计划,2-发货单,3-货件,4-海外仓备货单) |
| 6.8.8 | relateSn | 关联单据编号 | string | RP260423001 | 必填 | 关联单据编号 |
| 6.8.9 | relateBoxType | 关联单据装箱方式 | integer | 0 | 必填 | 关联单据装箱方式,1-每箱1款SKU,2-每箱多款SKU |
| 6.8.10 | wid | 仓库ID | integer | 470 | 必填 | 仓库ID |
| 6.8.11 | wname | 仓库名称 | string | wss | 必填 | 仓库名称 |
| 6.8.12 | creatorName | 创建人 | string | 0超级管理员1 | 必填 | 创建人 |
| 6.8.13 | optName | 操作人 | string | 0超级管理员1 | 必填 | 操作人 |
| 6.8.14 | totalSendNum | 总数量 | integer | 6 | 必填 | 总数量 |
| 6.8.15 | totalPackedNum | 总装箱量 | integer | 3 | 必填 | 总装箱量 |
| 6.8.16 | scanType | 扫码类型 | integer | 1 | 必填 | 扫码类型 |
| 6.8.17 | editBoxType | 扫码装箱方式 | integer | 1 | 必填 | 扫码装箱方式:1-逐个,2-批量 |
| 6.8.18 | isCustomId | 是否自定义箱子编号 | integer | 0 | 必填 | 是否自定义箱子编号:0-否,1-是 |
| 6.8.19 | totalBoxNum | 总箱数 | integer | 1 | 必填 | 总箱数 |
| 6.8.20 | totalBoxWeight | 总重量 | string | 2.00 | 必填 | 总重量 |
| 6.8.21 | totalBoxVolume | 总体积 | string | 8.00 | 必填 | 总体积 |
| 6.8.22 | totalBoxVolumeWeight | 总体积重 | string | 0.00 | 必填 | 总体积重 |
| 6.8.23 | finishTime | 单据完成时间 | integer | 0 | 必填 | 单据完成时间 |
| 6.8.24 | remark | 备注 | string | — | 必填 | 备注 |
| 6.8.25 | sid | 单据店铺 | integer | 0 | 必填 | 单据店铺 |
| 6.8.26 | printLabelNum | 打印标签数 | integer | 0 | 必填 | 打印标签数 |
| 6.8.27 | printTaskNum | 打印任务数 | integer | 0 | 必填 | 打印任务数 |
| 6.8.28 | fileId | 附件ID | string | — | 必填 | 附件ID |
| 6.8.29 | relateShipment | 关联货件信息 | array<object> | — | 必填 | 关联货件信息 |
| 6.8.29.1 | shipmentId | 货件编号 | string | FBA12345 | 必填 | 货件编号 |
| 6.8.29.2 | sid | 店铺ID | integer | 17 | 必填 | 店铺ID |
| 6.8.29.3 | shipmentStatus | 货件状态 | string | WORKING | 必填 | 货件状态 |
| 6.8.29.4 | localStaId | STA任务自增ID | string | 12345 | 必填 | STA任务自增ID |
| 6.8.29.5 | localStaName | STA任务名称 | string | 示例值 | 必填 | STA任务名称 |
| 6.8.29.6 | staInboundPlanId | STA任务计划编号 | string | STA12345 | 必填 | STA任务计划编号 |
领星ERP的接口:装箱任务 - 任务详情(/basicOpen/packingTask/taskDetail),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。