Skip to main content

supplyCreateShipment

Creates a new supply shipment that tracks product movement from suppliers to your facilities.

Authentication​

Requires authentication and the supply:create_shipment permission.

Behavior​

  • If shipmentNumber is not provided, a unique number will be automatically generated based on your brand's configuration.
  • New shipments can be linked to an existing purchase order via purchaseOrderId.
  • When createFromPurchaseOrder is true and a purchaseOrderId is provided, shipment details will be pre-filled from the associated purchase order.
  • The shipment type (STANDARD, BLIND, RETURN, TRANSFER) classifies the shipment. Use destinationBuildingId to specify the arrival facility when the shipment is destined for a warehouse.
  • Shipment creation is processed asynchronously and returns a process ID for tracking.

Validation Rules​

  • brandId must be provided and the brand must exist.
  • shipmentType is required (STANDARD, BLIND, RETURN, TRANSFER).
  • If purchaseOrderId is provided, the purchase order must exist and belong to the specified brand.
  • If shipmentItems are provided, they must reference valid products associated with the brand.

Possible Errors​

  • Brand not found - The specified brand does not exist.
  • Purchase order not found - The specified purchase order does not exist.
  • Purchase order does not belong to this brand - The purchase order belongs to a different brand.
  • Destination building not found - The specified building ID does not exist.
supplyCreateShipment(
  input: CreateSupplyShipmentInput!
): AsynchronousActionResponse

Arguments​

supplyCreateShipment.input ● CreateSupplyShipmentInput! non-null input​

Parameters for CreateSupplyShipment

Type​

AsynchronousActionResponse object​

Asynchronous action response type