Skip to main content

setFulfillmentIntegration

Assigns, changes, or removes the fulfillment integration on a V2 fulfillment.

Business Rules​

  • Passing integrationId assigns or changes the fulfillment integration.
  • Passing integrationId: null removes the integration override and falls back to the building default.
  • integrationId must be present so removal is always explicit.
  • The integration must belong to the fulfillment's company.
  • Integration can only be changed before fulfillment handoff.

Error Scenarios​

  • **NOT_FOUND**: the fulfillment or integration does not exist.
  • **UNPROCESSABLE_ENTITY**: the fulfillment is no longer editable for this action.
  • **UNAUTHORIZED**: missing required permissions or invalid company access.

Permissions Required​

  • orders:set_fulfillment_integration permission
setFulfillmentIntegration(
  input: SetFulfillmentIntegrationInput!
): OrderFulfillment!

Arguments​

setFulfillmentIntegration.input ● SetFulfillmentIntegrationInput! non-null input common​

Parameters for SetFulfillmentIntegration

Type​

OrderFulfillment object orders​

This type represents an order fulfillment. An order can have multiple fulfillments, each one associated with a warehouse and a party that fulfilled the order.