在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 代码),从而可以通过单次扫描识别并接收整个发货。

