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 · 请求参数 17 个(必填 2) · 响应参数 61 个 · 限流令牌桶容量 1
Updated At
2026-11-21

装箱任务 - 任务列表

POST/basicOpen/packingTask/list
Factory
{
  "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&timestamp=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
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1wid仓库IDarray<any>—Optional仓库ID
2optUid装箱员UIDarray<any>—Optional装箱员UID
3packingCon装箱情况array<any>—Optional装箱情况 1-未装箱 2-部分装箱 3-全装箱
4relateSnType单据类型array<any>—Optional单据类型 1-发货计划 2-发货单 3-FBA货件 4-海外仓备货单
5searchFieldTime时间搜索string—Optional时间搜索 create-创建时间 done-完成时间
6startDate开始时间 Y-m-dstring—Optional开始时间 Y-m-d
7endDate结束时间 Y-m-dstring—Optional结束时间 Y-m-d
8searchField搜索字段string—Optional搜索字段 relate_sn-关联单据单号 task_sn-任务单号 shipment_id-货件单号 local_sta_name-STA任务名称 msku-MSKU sku-SKU fnsku-FNSKU
9searchValue搜索值string—Optional搜索值
10offset偏移量integer—Required偏移量,默认0
11length分页大小integer—Required分页大小,默认20,最大200
12pickingStatus拣货状态string—Optional拣货状态 "1"-已拣 "0"-待拣
13printTask打印单据string—Optional打印单据 "1"-已打印 "0"-未打印
14printLabel打印标签string—Optional打印标签 "1"-已打印 "0"-未打印
15seniorSearchList高级搜索array<object>—Optional高级搜索
15.1searchField搜索字段string—Optional搜索字段 relate_sn-关联单据单号 task_sn-任务单号 shipment_id-货件单号 local_sta_name-STA任务名称 msku-MSKU sku-SKU fnsku-FNSKU
15.2searchValue搜索值array<any>—Optional搜索值

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0:成功
2message消息提示stringsuccessRequired消息提示
3error_details数据校验失败时的错误详情array<any>—Required数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583Required请求链路id
5response_time响应时间string2026-04-29 12:00:00Required响应时间
6data响应数据object—Required响应数据
6.1list列表数据array<object>—Required列表数据
6.1.1itemList产品信息array<object>—Required产品信息
6.1.1.1picUrl图片地址stringhttps://m.media-amazon.com/images/I/61QCCyNCYnL._SL75_.jpgRequired图片地址
6.1.1.2mskumskustring7T-2COF-AV9IRequiredMSKU
6.1.1.3fnskufnskustringB08D3MPS2VRequiredFNSKU
6.1.1.4productName品名string222Required品名
6.1.1.5skuskustring7T-AV9I111RequiredSKU
6.1.1.6sname店铺名称stringUB-USRequired店铺名称
6.1.1.7sendNum发货数integer2Required发货数
6.1.1.8packedNum装箱数integer2Required装箱数
6.1.1.9ptId任务自增IDinteger250692382241271800Required任务自增ID
6.1.1.10ptpiId商品自增IDinteger250692382241353730Required商品自增ID
6.1.1.11sid商品店铺IDinteger54Required商品店铺ID
6.1.1.12isCombo是否组合品 1-是 0-否integer0Required是否组合品 1-是 0-否
6.1.1.13nation国家string美国Required国家
6.1.1.14productKey产品唯一键stringfb6baad06915b5b4df4c395b1e852966Required产品唯一键
6.1.1.15shipmentId货件编号stringFBA19BY0NBPCOptional货件编号
6.1.1.16thirdPartyProductCode三方SKUstringCODE001Optional三方SKU
6.1.1.17thirdPartyProductName三方品名string示例名称Optional三方品名
6.1.1.18isTransparency是否透明计划 1-是 0-否integer1Required是否透明计划 1-是 0-否
6.1.2statusName状态string装箱中Required状态
6.1.3relateSnName单据类型stringFBA货件Required单据类型
6.1.4totalSendNum发货数量integer2Required发货数量
6.1.5totalPackedNum装箱数量integer2Required装箱数量
6.1.6wname仓库名称string仓库1改名字Required仓库名称
6.1.7taskSn任务单号stringPL260421003Required任务单号
6.1.8relateSn关联单号stringFBA19BY0NBPCRequired关联单号
6.1.9gmtCreate创建时间string2026-04-21 11:10:33Required创建时间
6.1.10finishTime完成时间string—Required完成时间
6.1.11remark备注string—Required备注
6.1.12creatorName创建人string超级管理员01Required创建人
6.1.13optName装箱员string超级管理员01Required装箱员
6.1.14boxPacked是否装箱过booleantrueRequired是否装箱过:true-是,false-否
6.1.15sid单据店铺IDinteger54Optional单据店铺ID
6.1.16ptId单据自增IDinteger250692382241271800Required单据自增ID
6.1.17taskStatus任务状态 1-待装箱integer2Required任务状态 1-待装箱,2-装箱中,3-已完成
6.1.18relateSnType单据类型 1-发货计划integer3Required单据类型 1-发货计划,2-发货单,3-FBA货件,4-海外仓备货单
6.1.19wid仓库IDinteger1Required仓库ID
6.1.20pickingStatus拣货状态 1-已拣 0-未拣integer0Required拣货状态 1-已拣 0-未拣
6.1.21printTaskNum打印任务数integer0Required打印任务数
6.1.22printLabelNum打印标签数integer0Required打印标签数
6.1.23totalBoxNum总箱数integer1Required总箱数
6.1.24principal负责人array<object>—Required负责人
6.1.24.1principalUid负责人UIDinteger1Required负责人UID
6.1.24.2name负责人名称string超级管理员01Required负责人名称
6.1.25productNum商品数integer1Required商品数
6.1.26pickingStatusName拣货名称string待拣货Required拣货名称
6.1.27relateShipment关联货件信息array<object>—Required关联货件信息
6.1.27.1shipmentId货件编号stringFBA19BY0NBPCRequired货件编号
6.1.27.2sid店铺IDinteger54Required店铺ID
6.1.27.3shipmentStatus货件状态stringSHIPPEDRequired货件状态
6.1.27.4localStaIdSTA任务自增IDinteger231692380650336260RequiredSTA任务自增ID
6.1.27.5localStaNameSTA任务名称stringSTA (04/21/2026 11:03 AM)RequiredSTA任务名称
6.1.27.6staInboundPlanIdSTA任务编号stringwffd8487f6-18a8-4844-859f-b7e4159e1a60RequiredSTA任务编号
7total总数integer1Required总数

The 装箱任务 - 任务列表 API (/basicOpen/packingTask/list) 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.