Skip to main content

supplyAddReceivingItems

Adds items to a shipment during the receiving process. This mutation allows you to register products as they are being received at the destination facility.

This is an asynchronous operation that returns immediately with a process_id that can be used to track the operation status.

Authentication and Authorization​

Requires the supply:add_in_receiving_items permission for the shipment's brand.

Business Rules​

  • The shipment must be in IN_RECEIVING status
  • At least one item must be provided
  • Each item must have either a sku or a productId
  • If a productId is provided, the product must exist in the brand's catalog

Possible Errors​

  • **Shipment not found**: The specified shipment does not exist
  • **Invalid status**: The shipment is not in IN_RECEIVING status
  • **Empty items list**: No items were provided
  • **Missing identifier**: An item lacks both sku and productId
  • **Product not found**: The specified product does not exist in the brand's catalog
  • **Authorization error**: User lacks required permissions
supplyAddReceivingItems(
  input: AddInReceivingItemsInput!
): AsynchronousActionResponse!

Arguments​

supplyAddReceivingItems.input ● AddInReceivingItemsInput! non-null input​

Parameters for AddInReceivingItems

Type​

AsynchronousActionResponse object​

Asynchronous action response type