Fortellis Booking Sessions

naftiko: 1.0.0-alpha2
info:
  label: Fortellis Booking Sessions
  description: >-
    Fortellis Booking Sessions capability. Create and manage multi-step service-booking sessions
    including item selection, store availability lookup, and slot reservation. Self-contained
    Naftiko capability covering one Fortellis business surface.
  tags:
    - Fortellis
    - CDK Global
    - Booking
    - Sessions
    - Service
    - Scheduling
  created: '2026-05-23'
  modified: '2026-05-23'
binds:
  - namespace: env
    keys:
      FORTELLIS_ACCESS_TOKEN: FORTELLIS_ACCESS_TOKEN
      FORTELLIS_SUBSCRIPTION_ID: FORTELLIS_SUBSCRIPTION_ID
capability:
  consumes:
    - type: http
      namespace: fortellis-booking-sessions
      baseUri: https://api.fortellis.io/service/sessions/v4
      description: Fortellis service-scheduling booking-session workflow.
      resources:
        - name: booking-sessions
          path: /booking-sessions
          operations:
            - name: createBookingSession
              method: POST
              description: Create a new service booking session
            - name: listBookingSessions
              method: GET
              description: List existing booking sessions
        - name: booking-session-items
          path: /booking-sessions/{bookingSessionId}/items
          operations:
            - name: addItem
              method: POST
              description: Add a service item to a booking session
              inputParameters:
                - name: bookingSessionId
                  in: path
                  type: string
                  required: true
            - name: removeItem
              method: DELETE
              description: Remove a service item from a booking session
              inputParameters:
                - name: bookingSessionId
                  in: path
                  type: string
                  required: true
                - name: itemId
                  in: path
                  type: string
                  required: true
        - name: available-stores
          path: /booking-sessions/{bookingSessionId}/available-stores
          operations:
            - name: listAvailableStores
              method: GET
              description: List stores with availability for the booking session
              inputParameters:
                - name: bookingSessionId
                  in: path
                  type: string
                  required: true
        - name: store-slots
          path: /booking-sessions/{bookingSessionId}/available-stores/{storeId}/slots
          operations:
            - name: listSlots
              method: GET
              description: List available service slots at a specific store
              inputParameters:
                - name: bookingSessionId
                  in: path
                  type: string
                  required: true
                - name: storeId
                  in: path
                  type: string
                  required: true
            - name: reserveSlot
              method: POST
              description: Reserve a service slot at a store for the booking session
              inputParameters:
                - name: bookingSessionId
                  in: path
                  type: string
                  required: true
                - name: storeId
                  in: path
                  type: string
                  required: true
                - name: slotId
                  in: path
                  type: string
                  required: true