Qeasy Cloud
Get Started

领星ERP 装箱任务 - 任务详情 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
仓库 / 装箱管理 · POST · 请求参数 2 个(必填 0) · 响应参数 105 个 · 限流令牌桶容量 1
Updated At
2026-11-21

装箱任务 - 任务详情

POST/basicOpen/packingTask/taskDetail
Factory
{
  "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}```"
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1ptId装箱任务idinteger—Optional装箱任务id,未填时 taskSn 必填
2taskSn装箱任务单号string—Optional装箱任务单号,未填时 ptId 必填

Response Parameters

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

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.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.