一单一货打印扫码

根据扫描到的商品编码或 ISBN 条码，在指定一单一货批次中查找待打印商品。多条匹配时，调用方应让操作员选择具体库存行，再调用打印接口。

接口信息

请求方式	`GET`
接口路径	`/api/printLogic/listByScanAndPickBatch`
鉴权	`X-Nideshop-Token`

请求参数

参数	类型	必填	说明
`scanCode`	String	是	扫描内容，支持商家编码或 ISBN 条码。
`pickBatch`	String	是	一单一货拣货批次号。
`packId`	String	否	限定包裹；普通一单一货场景可不传。

curl 调用

curl -s -G \
  'https://www.8shu8.com/api/printLogic/listByScanAndPickBatch' \
  -H 'X-Nideshop-Token: YOUR_LOGIN_TOKEN' \
  --data-urlencode 'scanCode=9787560999043' \
  --data-urlencode 'pickBatch=123456'

响应示例

{
  "code": 200,
  "message": "操作成功",
  "success": true,
  "data": [
    {
      "id": 98765,
      "position": "A-01-02",
      "goodsSn": "GS20260101001",
      "barcode": "9787560999043",
      "stock": -1,
      "pickBatch": "123456",
      "pickStatus": "PICK_STATUS_WAIT_PRINT",
      "goodsName": "示例图书",
      "tradeNo": "平台订单号",
      "orderSn": "系统子订单号",
      "shippingNo": null
    }
  ]
}

主要返回字段

字段	说明
`id`	库存行 ID。打印时作为 `stockId` 传入。
`goodsSn` / `barcode`	商家编码 / ISBN 条码。
`position`	货位。
`pickStatus`	当前拣货、打印状态。
`tradeNo` / `orderSn`	平台主单号 / 系统子订单号。

返回数组为空表示批次内没有匹配商品；返回多条时不要直接打印，应先选择正确记录并将其 id 作为打印接口的 stockId。