轻易云
注册体验

领星ERP装箱任务 - 任务列表接口

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

装箱任务 - 任务列表

POST/basicOpen/packingTask/list
加工厂
{
  "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
  }
}

接口请求参数

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

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array<any>—必填数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583必填请求链路id
5response_time响应时间string2026-04-29 12:00:00必填响应时间
6data响应数据object—必填响应数据
6.1list列表数据array<object>—必填列表数据
6.1.1itemList产品信息array<object>—必填产品信息
6.1.1.1picUrl图片地址stringhttps://m.media-amazon.com/images/I/61QCCyNCYnL._SL75_.jpg必填图片地址
6.1.1.2mskumskustring7T-2COF-AV9I必填MSKU
6.1.1.3fnskufnskustringB08D3MPS2V必填FNSKU
6.1.1.4productName品名string222必填品名
6.1.1.5skuskustring7T-AV9I111必填SKU
6.1.1.6sname店铺名称stringUB-US必填店铺名称
6.1.1.7sendNum发货数integer2必填发货数
6.1.1.8packedNum装箱数integer2必填装箱数
6.1.1.9ptId任务自增IDinteger250692382241271800必填任务自增ID
6.1.1.10ptpiId商品自增IDinteger250692382241353730必填商品自增ID
6.1.1.11sid商品店铺IDinteger54必填商品店铺ID
6.1.1.12isCombo是否组合品 1-是 0-否integer0必填是否组合品 1-是 0-否
6.1.1.13nation国家string美国必填国家
6.1.1.14productKey产品唯一键stringfb6baad06915b5b4df4c395b1e852966必填产品唯一键
6.1.1.15shipmentId货件编号stringFBA19BY0NBPC可选货件编号
6.1.1.16thirdPartyProductCode三方SKUstringCODE001可选三方SKU
6.1.1.17thirdPartyProductName三方品名string示例名称可选三方品名
6.1.1.18isTransparency是否透明计划 1-是 0-否integer1必填是否透明计划 1-是 0-否
6.1.2statusName状态string装箱中必填状态
6.1.3relateSnName单据类型stringFBA货件必填单据类型
6.1.4totalSendNum发货数量integer2必填发货数量
6.1.5totalPackedNum装箱数量integer2必填装箱数量
6.1.6wname仓库名称string仓库1改名字必填仓库名称
6.1.7taskSn任务单号stringPL260421003必填任务单号
6.1.8relateSn关联单号stringFBA19BY0NBPC必填关联单号
6.1.9gmtCreate创建时间string2026-04-21 11:10:33必填创建时间
6.1.10finishTime完成时间string—必填完成时间
6.1.11remark备注string—必填备注
6.1.12creatorName创建人string超级管理员01必填创建人
6.1.13optName装箱员string超级管理员01必填装箱员
6.1.14boxPacked是否装箱过booleantrue必填是否装箱过:true-是,false-否
6.1.15sid单据店铺IDinteger54可选单据店铺ID
6.1.16ptId单据自增IDinteger250692382241271800必填单据自增ID
6.1.17taskStatus任务状态 1-待装箱integer2必填任务状态 1-待装箱,2-装箱中,3-已完成
6.1.18relateSnType单据类型 1-发货计划integer3必填单据类型 1-发货计划,2-发货单,3-FBA货件,4-海外仓备货单
6.1.19wid仓库IDinteger1必填仓库ID
6.1.20pickingStatus拣货状态 1-已拣 0-未拣integer0必填拣货状态 1-已拣 0-未拣
6.1.21printTaskNum打印任务数integer0必填打印任务数
6.1.22printLabelNum打印标签数integer0必填打印标签数
6.1.23totalBoxNum总箱数integer1必填总箱数
6.1.24principal负责人array<object>—必填负责人
6.1.24.1principalUid负责人UIDinteger1必填负责人UID
6.1.24.2name负责人名称string超级管理员01必填负责人名称
6.1.25productNum商品数integer1必填商品数
6.1.26pickingStatusName拣货名称string待拣货必填拣货名称
6.1.27relateShipment关联货件信息array<object>—必填关联货件信息
6.1.27.1shipmentId货件编号stringFBA19BY0NBPC必填货件编号
6.1.27.2sid店铺IDinteger54必填店铺ID
6.1.27.3shipmentStatus货件状态stringSHIPPED必填货件状态
6.1.27.4localStaIdSTA任务自增IDinteger231692380650336260必填STA任务自增ID
6.1.27.5localStaNameSTA任务名称stringSTA (04/21/2026 11:03 AM)必填STA任务名称
6.1.27.6staInboundPlanIdSTA任务编号stringwffd8487f6-18a8-4844-859f-b7e4159e1a60必填STA任务编号
7total总数integer1必填总数

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

需要对接这个接口?

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