Flipdish FulfillmentStateConfiguration API

openapi: 3.0.3
info:
  title: Flipdish API - Apps Accounts FulfillmentStateConfiguration API
  version: v1.0
  description: Flipdish Open API v1.0 — Apps operations. Flipdish is an online ordering and branded-app platform for restaurants and takeaways. This specification was derived from the official Flipdish Swagger document and grouped by resource domain.
  contact:
    name: Flipdish Support
    email: help@flipdish.com
    url: https://help.flipdish.com
  x-generated-from: https://api.flipdish.co/swagger/docs/v1.0
  x-last-validated: '2026-06-02'
servers:
- url: https://api.flipdish.co
  description: Flipdish production API
security:
- oauth2:
  - api
tags:
- name: FulfillmentStateConfiguration
  description: Operations for Fulfillment State Configuration.
paths:
  /api/v1.0/{appId}/fulfillment/configuration/states:
    get:
      tags:
      - FulfillmentStateConfiguration
      operationId: SearchFulfillmentStatesConfigurations
      parameters:
      - name: appId
        in: path
        required: true
        schema:
          type: string
        description: The app id path parameter.
        example: '500123'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestApiArrayResult_FulfillmentStatesConfigurationSummary_'
              examples:
                SearchFulfillmentStatesConfigurations200Example:
                  summary: Default SearchFulfillmentStatesConfigurations 200 response
                  x-microcks-default: true
                  value:
                    Data: []
        '400':
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                SearchFulfillmentStatesConfigurations400Example:
                  summary: Default SearchFulfillmentStatesConfigurations 400 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '401':
          description: Authentication has been denied for this request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                SearchFulfillmentStatesConfigurations401Example:
                  summary: Default SearchFulfillmentStatesConfigurations 401 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '403':
          description: Successful authentication, but authorization has been denied for this request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                SearchFulfillmentStatesConfigurations403Example:
                  summary: Default SearchFulfillmentStatesConfigurations 403 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                SearchFulfillmentStatesConfigurations500Example:
                  summary: Default SearchFulfillmentStatesConfigurations 500 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
      security:
      - oauth2:
        - api
      summary: Flipdish Search Fulfillment States Configurations
      description: Search Fulfillment States Configurations via the Flipdish Open API v1.0 (GET /api/v1.0/{appId}/fulfillment/configuration/states).
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      tags:
      - FulfillmentStateConfiguration
      operationId: CreateFulfillmentStatesConfig
      parameters:
      - name: appId
        in: path
        required: true
        schema:
          type: string
        description: The app id path parameter.
        example: '500123'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateFulfillmentStatesConfiguration'
            examples:
              CreateFulfillmentStatesConfigRequestExample:
                summary: Default CreateFulfillmentStatesConfig request
                x-microcks-default: true
                value:
                  StoreIds:
                  - 1
                  StoreSelectorType: None
                  States: []
                  AutomaticTransitionsEnabled: true
                  Name: Example Name
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestApiResult_FulfillmentStatesConfiguration_'
              examples:
                CreateFulfillmentStatesConfig200Example:
                  summary: Default CreateFulfillmentStatesConfig 200 response
                  x-microcks-default: true
                  value:
                    Data:
                      States: []
                      AutomaticTransitionsEnabled: true
                      AppId: '500123'
                      ConfigurationUid: '500123'
                      StoreSelectorType: None
                      StoreIds:
                      - 1
                      Name: Example Name
        '400':
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                CreateFulfillmentStatesConfig400Example:
                  summary: Default CreateFulfillmentStatesConfig 400 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '401':
          description: Authentication has been denied for this request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                CreateFulfillmentStatesConfig401Example:
                  summary: Default CreateFulfillmentStatesConfig 401 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '403':
          description: Successful authentication, but authorization has been denied for this request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                CreateFulfillmentStatesConfig403Example:
                  summary: Default CreateFulfillmentStatesConfig 403 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '404':
          description: NotFound
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                CreateFulfillmentStatesConfig404Example:
                  summary: Default CreateFulfillmentStatesConfig 404 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                CreateFulfillmentStatesConfig500Example:
                  summary: Default CreateFulfillmentStatesConfig 500 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
      security:
      - oauth2:
        - api
      summary: Flipdish Create Fulfillment States Config
      description: Create Fulfillment States Config via the Flipdish Open API v1.0 (POST /api/v1.0/{appId}/fulfillment/configuration/states).
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /api/v1.0/{appId}/fulfillment/configuration/states_template:
    get:
      tags:
      - FulfillmentStateConfiguration
      operationId: GetFulfillmentStatesConfigurationTemplate
      parameters:
      - name: appId
        in: path
        required: true
        schema:
          type: string
        description: The app id path parameter.
        example: '500123'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FulfillmentStatesConfiguration'
              examples:
                GetFulfillmentStatesConfigurationTemplate200Example:
                  summary: Default GetFulfillmentStatesConfigurationTemplate 200 response
                  x-microcks-default: true
                  value:
                    States: []
                    AutomaticTransitionsEnabled: true
                    AppId: '500123'
                    ConfigurationUid: '500123'
                    StoreSelectorType: None
                    StoreIds:
                    - 1
                    Name: Example Name
        '400':
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                GetFulfillmentStatesConfigurationTemplate400Example:
                  summary: Default GetFulfillmentStatesConfigurationTemplate 400 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '401':
          description: Authentication has been denied for this request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                GetFulfillmentStatesConfigurationTemplate401Example:
                  summary: Default GetFulfillmentStatesConfigurationTemplate 401 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '403':
          description: Successful authentication, but authorization has been denied for this request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                GetFulfillmentStatesConfigurationTemplate403Example:
                  summary: Default GetFulfillmentStatesConfigurationTemplate 403 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '404':
          description: NotFound
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                GetFulfillmentStatesConfigurationTemplate404Example:
                  summary: Default GetFulfillmentStatesConfigurationTemplate 404 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                GetFulfillmentStatesConfigurationTemplate500Example:
                  summary: Default GetFulfillmentStatesConfigurationTemplate 500 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
      security:
      - oauth2:
        - api
      summary: Flipdish Get Fulfillment States Configuration Template
      description: Get Fulfillment States Configuration Template via the Flipdish Open API v1.0 (GET /api/v1.0/{appId}/fulfillment/configuration/states_template).
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /api/v1.0/{appId}/fulfillment/configuration/states/{configId}:
    get:
      tags:
      - FulfillmentStateConfiguration
      operationId: GetFulfillmentStatesConfiguration
      parameters:
      - name: appId
        in: path
        required: true
        schema:
          type: string
        description: The app id path parameter.
        example: '500123'
      - name: configId
        in: path
        required: true
        schema:
          type: string
        description: The config id path parameter.
        example: '500123'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FulfillmentStatesConfiguration'
              examples:
                GetFulfillmentStatesConfiguration200Example:
                  summary: Default GetFulfillmentStatesConfiguration 200 response
                  x-microcks-default: true
                  value:
                    States: []
                    AutomaticTransitionsEnabled: true
                    AppId: '500123'
                    ConfigurationUid: '500123'
                    StoreSelectorType: None
                    StoreIds:
                    - 1
                    Name: Example Name
        '400':
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                GetFulfillmentStatesConfiguration400Example:
                  summary: Default GetFulfillmentStatesConfiguration 400 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '401':
          description: Authentication has been denied for this request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                GetFulfillmentStatesConfiguration401Example:
                  summary: Default GetFulfillmentStatesConfiguration 401 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '403':
          description: Successful authentication, but authorization has been denied for this request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                GetFulfillmentStatesConfiguration403Example:
                  summary: Default GetFulfillmentStatesConfiguration 403 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '404':
          description: NotFound
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                GetFulfillmentStatesConfiguration404Example:
                  summary: Default GetFulfillmentStatesConfiguration 404 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                GetFulfillmentStatesConfiguration500Example:
                  summary: Default GetFulfillmentStatesConfiguration 500 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
      security:
      - oauth2:
        - api
      summary: Flipdish Get Fulfillment States Configuration
      description: Get Fulfillment States Configuration via the Flipdish Open API v1.0 (GET /api/v1.0/{appId}/fulfillment/configuration/states/{configId}).
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      tags:
      - FulfillmentStateConfiguration
      operationId: UpdateFulfillmentStatesConfig
      parameters:
      - name: appId
        in: path
        required: true
        schema:
          type: string
        description: The app id path parameter.
        example: '500123'
      - name: configId
        in: path
        required: true
        schema:
          type: string
        description: The config id path parameter.
        example: '500123'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateFulfillmentStatesConfiguration'
            examples:
              UpdateFulfillmentStatesConfigRequestExample:
                summary: Default UpdateFulfillmentStatesConfig request
                x-microcks-default: true
                value:
                  OverwriteSystemTemplate: true
                  StoreIds:
                  - 1
                  StoreSelectorType: None
                  States: []
                  AutomaticTransitionsEnabled: true
                  Name: Example Name
      responses:
        '200':
          description: OK
        '400':
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                UpdateFulfillmentStatesConfig400Example:
                  summary: Default UpdateFulfillmentStatesConfig 400 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '401':
          description: Authentication has been denied for this request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                UpdateFulfillmentStatesConfig401Example:
                  summary: Default UpdateFulfillmentStatesConfig 401 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '403':
          description: Successful authentication, but authorization has been denied for this request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                UpdateFulfillmentStatesConfig403Example:
                  summary: Default UpdateFulfillmentStatesConfig 403 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '404':
          description: NotFound
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                UpdateFulfillmentStatesConfig404Example:
                  summary: Default UpdateFulfillmentStatesConfig 404 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                UpdateFulfillmentStatesConfig500Example:
                  summary: Default UpdateFulfillmentStatesConfig 500 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
      security:
      - oauth2:
        - api
      summary: Flipdish Update Fulfillment States Config
      description: Update Fulfillment States Config via the Flipdish Open API v1.0 (POST /api/v1.0/{appId}/fulfillment/configuration/states/{configId}).
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      tags:
      - FulfillmentStateConfiguration
      operationId: DeleteFulfillmentStatesConfig
      parameters:
      - name: appId
        in: path
        required: true
        schema:
          type: string
        description: The app id path parameter.
        example: '500123'
      - name: configId
        in: path
        required: true
        schema:
          type: string
        description: The config id path parameter.
        example: '500123'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestApiStringResult'
              examples:
                DeleteFulfillmentStatesConfig200Example:
                  summary: Default DeleteFulfillmentStatesConfig 200 response
                  x-microcks-default: true
                  value:
                    Data: string
        '400':
          description: BadRequest
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                DeleteFulfillmentStatesConfig400Example:
                  summary: Default DeleteFulfillmentStatesConfig 400 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '401':
          description: Authentication has been denied for this request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                DeleteFulfillmentStatesConfig401Example:
                  summary: Default DeleteFulfillmentStatesConfig 401 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '403':
          description: Successful authentication, but authorization has been denied for this request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                DeleteFulfillmentStatesConfig403Example:
                  summary: Default DeleteFulfillmentStatesConfig 403 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '404':
          description: NotFound
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                DeleteFulfillmentStatesConfig404Example:
                  summary: Default DeleteFulfillmentStatesConfig 404 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FlipdishError'
              examples:
                DeleteFulfillmentStatesConfig500Example:
                  summary: Default DeleteFulfillmentStatesConfig 500 response
                  x-microcks-default: true
                  value:
                    error:
                      errorMessage: Invalid or missing parameters.
                      errorCode: BadRequest
                      details: Validation failed for field 'storeId'.
      security:
      - oauth2:
        - api
      summary: Flipdish Delete Fulfillment States Config
      description: Delete Fulfillment States Config via the Flipdish Open API v1.0 (DELETE /api/v1.0/{appId}/fulfillment/configuration/states/{configId}).
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    FulfillmentStatesConfigurationSummary:
      description: Fulfillment configuration header information
      required:
      - AppId
      type: object
      properties:
        AppId:
          description: AppId
          type: string
          example: '500123'
        ConfigurationUid:
          description: Configuration Uid
          type: string
          example: '500123'
        Name:
          description: Name
          type: string
          example: Example Name
        StoreSelectorType:
          description: Store selector type
          enum:
          - None
          - Single
          - Multiple
          type: string
          example: None
        Stores:
          description: Stores
          type: array
          items:
            $ref: '#/components/schemas/FulfillmentStatesConfiguredStore'
          example: []
    FulfillmentStatesConfiguredStore:
      description: Configured stores
      type: object
      properties:
        StoreId:
          format: int32
          description: Store id
          type: integer
          example: 500123
        Name:
          description: Name of store
          type: string
          example: Example Name
    CreateFulfillmentStatesConfiguration:
      description: Create fulfillment states configuration
      type: object
      properties:
        StoreIds:
          description: Stores id's
          type: array
          items:
            format: int32
            type: integer
          example:
          - 1
        StoreSelectorType:
          description: Store Selector Type
          enum:
          - None
          - Single
          - Multiple
          type: string
          example: None
        States:
          description: Settings
          type: array
          items:
            $ref: '#/components/schemas/FulfillmentStatusConfigurationItem'
          example: []
        AutomaticTransitionsEnabled:
          description: Enable automatic transitions
          type: boolean
          nullable: true
          example: true
        Name:
          description: Name
          type: string
          example: Example Name
    RestApiResult_FulfillmentStatesConfiguration_:
      description: Rest api result
      required:
      - Data
      type: object
      properties:
        Data:
          $ref: '#/components/schemas/FulfillmentStatesConfiguration'
    RestApiStringResult:
      description: Rest api string result
      required:
      - Data
      type: object
      properties:
        Data:
          description: Data string
          type: string
          example: string
    NextStatusWithOrderType:
      description: Next status by order type
      type: object
      properties:
        OrderType:
          description: Order type
          enum:
          - All
          - Delivery
          - Collection
          - DineIn
          type: string
          example: All
        NextStatus:
          description: Next status id
          type: string
          example: Active
    RestApiArrayResult_FulfillmentStatesConfigurationSummary_:
      description: Rest api array result
      required:
      - Data
      type: object
      properties:
        Data:
          description: Generic data object.
          type: array
          items:
            $ref: '#/components/schemas/FulfillmentStatesConfigurationSummary'
          example: []
    FlipdishError:
      type: object
      description: Standard Flipdish API error response. Errors are returned as a JSON object with a human-readable message and a programmatic error code (see https://developers.flipdish.com/docs/error-handling).
      properties:
        error:
          type: object
          description: Error detail object.
          properties:
            errorMessage:
              type: string
              description: Descriptive explanation of the issue.
              example: Invalid or missing parameters.
            errorCode:
              type: string
              description: Unique identifier for programmatic error handling.
              example: BadRequest
       

# --- truncated at 32 KB (37 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/flipdish/refs/heads/main/openapi/flipdish-fulfillmentstateconfiguration-api-openapi.yml