轻易云
注册体验

领星ERP装箱任务 - 任务详情接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
仓库 / 装箱管理 · POST · 请求参数 2 个(必填 0) · 响应参数 105 个 · 限流令牌桶容量 1
更新日期
2026-11-21

装箱任务 - 任务详情

POST/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&timestamp=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}```"
}

接口请求参数

序号字段名称类型默认值必填描述
1ptId装箱任务idinteger—可选装箱任务id,未填时 taskSn 必填
2taskSn装箱任务单号string—可选装箱任务单号,未填时 ptId 必填

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array<any>—必填数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583必填请求链路id
5response_time响应时间string2026-04-23 12:00:00必填响应时间
6data响应数据object—必填响应数据
6.1totalBoxNum总箱数integer1必填总箱数
6.2totalBoxWeight总重量integer1必填总重量
6.3totalBoxVolume总体积integer1必填总体积
6.4totalPackedNum已装产品数integer1必填已装产品数
6.5relateSn关联单号stringRP260423001必填关联单号
6.6boxList商品列表数据array<object>—必填商品列表数据
6.6.1customBoxId箱号stringBOX2026042300001必填箱号
6.6.2boxLength箱子长度string2.00必填箱子长度
6.6.3boxWidth箱子宽度string2.00必填箱子宽度
6.6.4boxHeight箱子高度string2.00必填箱子高度
6.6.5boxWeight箱子毛重string2.00必填箱子毛重
6.6.6boxNum箱数integer1必填箱数
6.6.7boxProduct商品行数据array<object>—必填商品行数据
6.6.7.1mskumskustringBlack_ Head_Rope必填MSKU
6.6.7.2fnskufnskustringB09MT3989Q必填FNSKU
6.6.7.3nation国家string美国必填国家
6.6.7.4sname店铺名称string8speed-US必填店铺名称
6.6.7.5picUrl图片地址stringhttps://image.distributetop.com/lingxing-erp/901182423370657792/20230323/8271e359e85940839df1a565a0bb7050.jpg必填图片地址
6.6.7.6skuskustringSKU1991FC9必填SKU
6.6.7.7productName品名string[演示数据]适用于iPad的手写笔带手掌柜绝必填品名
6.6.7.8packedNum装箱数量integer2必填装箱数量
6.6.7.9sendNum发货量integer2必填发货量
6.6.7.10ptpiId商品行分布式idinteger250693129738747900必填商品行分布式id
6.6.7.11unpackedNum未装箱数量integer0必填未装箱数量
6.6.7.12productKey商品行唯一键string1590必填商品行唯一键
6.6.7.13sid店铺IDinteger17必填店铺ID
6.6.7.14isCombo是否组合品integer0必填是否组合品:0-否,1-是
6.6.7.15productId产品IDinteger1必填产品ID
6.6.7.16shipmentId货件编号string—必填货件编号
6.6.7.17printNum打印次数integer0必填打印次数
6.6.7.18thirdPartyProductCode三方SKUstring—必填三方SKU
6.6.7.19thirdPartyProductName三方品名string—必填三方品名
6.6.7.20isTransparency是否透明计划商品integer1必填是否透明计划商品
6.6.7.21quantityInCase单箱数量integer1必填单箱数量
6.6.7.22asinasinstringB09MT3989Q必填ASIN
6.6.7.23parentAsin父ASINstringB09MT3989Q必填父ASIN
6.6.7.24asinUrlASIN链接stringhttps://www.amazon.com/dp/B09MT3989Q必填ASIN链接
6.6.8ptbId箱子IDinteger250693132348194800必填箱子ID
6.6.9warehouseBoxCodes仓库箱号stringBOX2026042300001必填仓库箱号
6.7productItems商品信息数组array<object>—必填商品信息数组
6.7.1ptpiId商品IDinteger250693129738747900必填商品ID
6.7.2sid店铺IDinteger17必填店铺ID
6.7.3sname店铺名称string8speed-US必填店铺名称
6.7.4nation国家string美国必填国家
6.7.5picUrl图片stringhttps://image.distributetop.com/lingxing-erp/901182423370657792/20230323/8271e359e85940839df1a565a0bb7050.jpg必填图片
6.7.6isCombo是否组合品integer0必填是否组合品:0-否,1-是
6.7.7skuskustringSKU1991FC9必填SKU
6.7.8productId产品IDinteger1必填产品ID
6.7.9productName产品名称string[演示数据]适用于iPad的手写笔带手掌柜绝必填产品名称
6.7.10fnskufnskustringB09MT3989Q必填FNSKU
6.7.11mskumskustringBlack_ Head_Rope必填MSKU
6.7.12packedNum已装箱量integer2必填已装箱量
6.7.13sendNum单据数量integer2必填单据数量
6.7.14productKey商品keystring1590必填商品key
6.7.15shipmentId货件编号string—必填货件编号
6.7.16printNum打印次数integer0必填打印次数
6.7.17thirdPartyProductCode三方SKUstring—必填三方SKU
6.7.18thirdPartyProductName三方品名string—必填三方品名
6.7.19isTransparency是否透明计划商品integer1必填是否透明计划商品
6.7.20unpackedNum待装箱数量integer0必填待装箱数量
6.7.21asinasinstringB09MT3989Q必填ASIN
6.7.22parentAsin父ASINstringB09MT3989Q必填父ASIN
6.7.23asinUrlASIN链接stringhttps://www.amazon.com/dp/B09MT3989Q必填ASIN链接
6.8taskInfo任务信息object—必填任务信息
6.8.1ptId任务IDinteger250693129738653700必填任务ID
6.8.2gmtCreate创建时间string2026-04-23 13:52:07必填创建时间
6.8.3gmtModified修改时间string2026-04-23 14:08:54必填修改时间
6.8.4taskSn任务编号stringPL260423001必填任务编号
6.8.5taskStatus任务状态integer2必填任务状态
6.8.6pickingStatus拣货状态integer0必填拣货状态
6.8.7relateSnType关联单据类型(1-发货计划integer1必填关联单据类型(1-发货计划,2-发货单,3-货件,4-海外仓备货单)
6.8.8relateSn关联单据编号stringRP260423001必填关联单据编号
6.8.9relateBoxType关联单据装箱方式integer0必填关联单据装箱方式,1-每箱1款SKU,2-每箱多款SKU
6.8.10wid仓库IDinteger470必填仓库ID
6.8.11wname仓库名称stringwss必填仓库名称
6.8.12creatorName创建人string0超级管理员1必填创建人
6.8.13optName操作人string0超级管理员1必填操作人
6.8.14totalSendNum总数量integer6必填总数量
6.8.15totalPackedNum总装箱量integer3必填总装箱量
6.8.16scanType扫码类型integer1必填扫码类型
6.8.17editBoxType扫码装箱方式integer1必填扫码装箱方式:1-逐个,2-批量
6.8.18isCustomId是否自定义箱子编号integer0必填是否自定义箱子编号:0-否,1-是
6.8.19totalBoxNum总箱数integer1必填总箱数
6.8.20totalBoxWeight总重量string2.00必填总重量
6.8.21totalBoxVolume总体积string8.00必填总体积
6.8.22totalBoxVolumeWeight总体积重string0.00必填总体积重
6.8.23finishTime单据完成时间integer0必填单据完成时间
6.8.24remark备注string—必填备注
6.8.25sid单据店铺integer0必填单据店铺
6.8.26printLabelNum打印标签数integer0必填打印标签数
6.8.27printTaskNum打印任务数integer0必填打印任务数
6.8.28fileId附件IDstring—必填附件ID
6.8.29relateShipment关联货件信息array<object>—必填关联货件信息
6.8.29.1shipmentId货件编号stringFBA12345必填货件编号
6.8.29.2sid店铺IDinteger17必填店铺ID
6.8.29.3shipmentStatus货件状态stringWORKING必填货件状态
6.8.29.4localStaIdSTA任务自增IDstring12345必填STA任务自增ID
6.8.29.5localStaNameSTA任务名称string示例值必填STA任务名称
6.8.29.6staInboundPlanIdSTA任务计划编号stringSTA12345必填STA任务计划编号

领星ERP的接口:装箱任务 - 任务详情(/basicOpen/packingTask/taskDetail),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。