打印接口

一单一货场景下，根据扫码商品和批次获取电子面单打印数据，并同步完成平台发货。

实际接口名称为 wayBillGetAndSend。该接口会取面单并发货，不是单纯预览；同一库存行请勿并发或重复调用。

接口信息

请求方式	`POST`
接口路径	`/api/printLogic/wayBillGetAndSend`
Content-Type	`application/json`
鉴权	`X-Nideshop-Token`

请求字段

字段	类型	必填	说明
`goodsSn`	String	是	扫码内容，支持商品编码或 ISBN 条码。
`pickBatch`	String	是	一单一货拣货批次号。
`postId`	String	是	电子面单配置 ID；传 `AUTO` 或 `SMART` 可使用智能选面单。
`stockId`	Integer	否	库存行 ID。扫码接口返回多条时必须传选中记录的 `id`。

curl 调用

curl -s -X POST \
  'https://www.8shu8.com/api/printLogic/wayBillGetAndSend' \
  -H 'Content-Type: application/json' \
  -H 'X-Nideshop-Token: YOUR_LOGIN_TOKEN' \
  -d '{
    "goodsSn": "GS20260101001",
    "pickBatch": "123456",
    "postId": "AUTO",
    "stockId": 98765
  }'

响应示例

{
  "code": 200,
  "message": "操作成功",
  "success": true,
  "data": {
    "tb": [
      {
        "cmd": "print",
        "requestID": "打印请求ID",
        "version": "1.0",
        "postId": "电子面单配置ID",
        "task": {
          "taskID": "打印任务ID",
          "preview": false,
          "documents": []
        }
      }
    ],
    "pdd": [],
    "err": null
  }
}

返回字段

字段	说明
`tb`	菜鸟、淘宝体系打印任务数组。
`pdd`	拼多多打印任务数组。
`postId`	每个打印任务对应的电子面单配置 ID，可据此分发到打印机。
`err`	可选错误信息。

调用结果

系统根据 stockId 或扫码内容匹配待打印库存行。
获取电子面单并返回打印任务。
将该商品更新为已打印状态。
向订单所属平台回传物流单号并发货。

同一 stockId 同时只能有一个请求执行；重复并发时会返回“该商品正在打单发货，请勿重复操作”。