Add inventoryShipmentSetBarcode mutation and barcode fields

1/28/2026, 12:00:23 AM

Shopify now exposes the inventoryShipmentSetBarcode mutation, allowing clients to assign a unique barcode to an existing InventoryShipment by supplying its ID and a barcode string. The mutation returns an InventoryShipmentSetBarcodePayload containing the updated InventoryShipment (now with a new barcode field) and a list of user errors. New error codes include INVENTORYSHIPMENTSETBARCODEUSERERRORCODE.BARCODE_DUPLICATE and INVENTORYSHIPMENTSETBARCODEUSERERRORCODE.SHIPMENT_NOT_FOUND. The InventoryShipment type now includes a nullable String field called barcode, and the InventoryShipmentCreateUserErrorCode enum gains BARCODE_DUPLICATE. A new field remainingLineItemsWeight (type Weight) was added to FulfillmentOrder, representing the weight of unfulfilled line items. The OrderTransactionErrorCode enum omitted the INCORRECT_NAME value, and SubscriptionBillingAttemptErrorCode and SubscriptionBillingAttemptPaymentErrorCode enums received numerous new payment‑related codes reflecting detailed card decline and processing errors. Developers must update error handling for these new codes and consider setting or reading the barcode field in shipments, ensuring barcodes are unique across the system.

Mutation Changes

➕ Added Mutations (1)

inventoryShipmentSetBarcode

Sets the barcode on an inventory shipment.

Type Changes

➕ Added Types (3)

🏗️InventoryShipmentSetBarcodePayload➕ AddedOBJECT

Return type for inventoryShipmentSetBarcode mutation.

Fields: inventoryShipment, userErrors
🏗️InventoryShipmentSetBarcodeUserError➕ AddedOBJECT

An error that occurs during the execution of InventoryShipmentSetBarcode.

Fields: code, field, message
📋InventoryShipmentSetBarcodeUserErrorCode➕ AddedENUM

Possible error codes that can be returned by InventoryShipmentSetBarcodeUserError.

Values: SHIPMENT_NOT_FOUND, BARCODE_DUPLICATE

🔄 Modified Types (6)

🏗️FulfillmentOrder🔄 Modified
Field added: remainingLineItemsWeight

The total weight of all line items in the fulfillment order that aren't yet fulfilled.

🏗️InventoryShipment🔄 Modified
Field added: barcode

A unique barcode for the shipment.

🏗️InventoryShipmentCreateUserErrorCode🔄 Modified
Enum value added: BARCODE_DUPLICATE
🏗️OrderTransactionErrorCode🔄 Modified
Enum value removed: INCORRECT_NAME
🏗️SubscriptionBillingAttemptErrorCode🔄 Modified
Enum value added: AUTHENTICATION_FAILED
Enum value added: AUTHENTICATION_REQUIRED
Enum value added: CALL_ISSUER
Enum value added: CARD_DECLINED
Enum value added: CONFIRMATION_REJECTED
Enum value added: DO_NOT_HONOR
Enum value added: MERCHANT_RULE
Enum value added: OFF_SESSION_REJECTED
Enum value added: RETRY_DECLINED
Enum value added: TRANSACTION_LIMIT_EXCEEDED
Enum value added: INCORRECT_ZIP
Enum value added: INVALID_CURRENCY
Enum value added: INVALID_NUMBER
Enum value added: INVALID_PAYMENT_ERROR
Enum value added: PAYMENT_METHOD_UNSUPPORTED
Enum value added: INCORRECT_ADDRESS
Enum value added: INCORRECT_NUMBER
Enum value added: EXPIRED_CARD
Enum value added: INVALID_EXPIRY_DATE
Enum value added: EXPIRED_BUYER_ACTION
Enum value added: PROCESSING_ERROR
Enum value added: PAYMENT_PROVIDER_ERROR
Enum value added: GENERIC_ERROR
Enum value added: CANCELLED_PAYMENT
Enum value added: INVALID_PURCHASE_TYPE
🏗️SubscriptionBillingAttemptPaymentErrorCode🔄 Modified
Enum value added: AUTHENTICATION_FAILED
Enum value added: AUTHENTICATION_REQUIRED
Enum value added: CALL_ISSUER
Enum value added: CARD_DECLINED
Enum value added: CONFIRMATION_REJECTED
Enum value added: DO_NOT_HONOR
Enum value added: MERCHANT_RULE
Enum value added: OFF_SESSION_REJECTED
Enum value added: RETRY_DECLINED
Enum value added: TRANSACTION_LIMIT_EXCEEDED
Enum value added: INCORRECT_ZIP
Enum value added: INVALID_CURRENCY
Enum value added: INVALID_NUMBER
Enum value added: INVALID_PAYMENT_ERROR
Enum value added: PAYMENT_METHOD_UNSUPPORTED
Enum value added: PAYMENT_PROVIDER_ERROR
Enum value added: INCORRECT_ADDRESS
Enum value added: INCORRECT_NUMBER
Enum value added: EXPIRED_CARD
Enum value added: INVALID_EXPIRY_DATE
Enum value added: EXPIRED_BUYER_ACTION
Enum value added: PROCESSING_ERROR
Enum value added: GENERIC_ERROR
Enum value added: CANCELLED_PAYMENT
Enum value added: INVALID_PURCHASE_TYPE