Skip to main content

saveTransitionValidation

Saves a transition validation rule for order fulfillment state transitions.

Overview​

Creates or updates a transition validation rule that defines conditions for when an order fulfillment can transition between states.

Behavior​

  • If id is provided and exists, updates the existing validation
  • If id is not provided or doesn't exist, creates a new validation

Expression Format​

The expression should follow the format:

{
  "version": 1,
  "base_schema": "Orders::V2::TransitionValidations::Types::OrderFulfillmentContext",
  "rules": {
    "key": "order.financial_status",
    "predicate": "eql?",
    "value": "paid"
  }
}

Rules can be composed using AND/OR logic:

{
  "and": [
    { "key": "order.financial_status", "predicate": "eql?", "value": "paid" },
    { "key": "order.total_price", "predicate": "gt?", "value": 0 }
  ]
}

Permissions​

Requires update_sales_channel permission for the target brand.

saveTransitionValidation(
  input: SaveTransitionValidationInput!
): TransitionValidation

Arguments​

saveTransitionValidation.input ● SaveTransitionValidationInput! non-null input​

Parameters for SaveTransitionValidation

Type​

TransitionValidation object​

Transition Validation​

Represents a validation rule for order fulfillment state transitions. These rules define conditions that must be met (or automatically trigger transitions) when transitioning between fulfillment states (e.g., allocated -> sent).