大数跨境

为库存发货 API 添加条形码支持

为库存发货 API 添加条形码支持 Shopify电商独立站
2026-03-23
2
导读:在 2026-04 版本中,我们新增了对库存发货条码的支持,使商家能够为发货分配条码,从而加快收货流程。

在2026-04版本中,我们向库存发货添加了条形码支持,使商家能够为发货分配条形码,从而加快收货流程。

包含以下 API 变更:

库存发货单上的新字段 InventoryShipment

  • barcode: String - barcode: String - 一个可为空的字段,表示分配给发货单的唯一条形码。

已更新inventoryShipmentCreate突变

  • InventoryShipmentCreateInput现在接受可选的barcode: String字段,以便在创建发货时分配条形码。

新的inventoryShipmentSetBarcode突变

  • 设置或清除现有发货单上的条形码。传入空字符串以清除条形码。

示例用法:

mutation { inventoryShipmentSetBarcode( inventoryShipmentId: "gid://shopify/InventoryShipment/123" barcode: "SHIP-2026-0001" ) { inventoryShipment { id barcode } userErrors { code field message } } }

需要了解的内容

  • 每个商店的条形码必须唯一。同一商店中的两个发货单不能共享相同的条形码。
  • 条形码的最大长度为255个字符。
  • 首尾空格会自动被去除。仅由空格组成的条形码被视为空值。

错误代码

  • DUPLICATE_BARCODE: 同一商店中已有其他发货单使用了此条形码。
  • SHIPMENT_NOT_FOUND: 指定的发货单不存在。
  • BARCODE_TOO_LONG:条形码超过了255个字符的最大长度。

我们做出此更改的原因目前,在不同地点(例如从仓库到零售店)之间转移库存的商家必须逐个扫描和接收发货中的每件商品。这对于大批量发货来说既缓慢又容易出错。发货条形码允许仓库系统和第三方物流(3PL)为发货附加一个可扫描的标识符(如 GS1-128 代码),从而可以通过单次扫描识别并接收整个发货。

【声明】内容源于网络
0
0
Shopify电商独立站
1234
内容 7146
粉丝 0
Shopify电商独立站 1234
总阅读87.4k
粉丝0
内容7.1k