VTEX Reservations API

openapi: 3.2.0
info:
  title: VTex Logistics Reservations API
  description: "\n\n>Check the [Fulfillment onboarding guide](https://developers.vtex.com/docs/guides/fulfillment). We created this guide to improve the onboarding experience for developers at VTEX. It assembles all documentation on our Developer Portal about fulfillment and is organized by focusing on the developer's journey.\n\nLogistics or fulfillment is the module responsible for shipping calculation and inventory management. \n\nThe variable `{{environment}}` can be filled with `vtexcommercestable` or `vtexcommercebeta`, depending on the environment you want to test."
  contact: {}
  version: '1.0'
servers:
- url: https://{accountName}.{environment}.com.br
  description: VTEX server URL.
  variables:
    accountName:
      description: Name of the VTEX account. Used as part of the URL.
      default: apiexamples
    environment:
      description: Environment to use. Used as part of the URL.
      enum:
      - vtexcommercestable
      default: vtexcommercestable
security:
- appKey: []
  appToken: []
tags:
- name: Reservations
paths:
  /api/logistics/pvt/inventory/reservations:
    post:
      tags:
      - Reservations
      summary: VTex Create reservation
      description: Creates [reservation](https://help.vtex.com/en/tutorial/how-does-reservation-work--tutorials_92).
      operationId: CreateReservation
      parameters:
      - name: Accept
        in: header
        description: HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand.
        required: true
        style: simple
        schema:
          type: string
          default: application/json
      - name: Content-Type
        in: header
        description: Type of the content being sent.
        required: true
        style: simple
        schema:
          type: string
          default: application/json; charset=utf-8
      requestBody:
        content:
          application/json; charset=utf-8:
            schema:
              title: CreateReservationRequest
              required:
              - salesChannel
              - lockId
              - autorizationExpirationTTL
              - deliveryItemOptions
              type: object
              properties:
                salesChannel:
                  type: string
                lockId:
                  type:
                  - string
                  - 'null'
                autorizationExpirationTTL:
                  type: string
                deliveryItemOptions:
                  type: array
                  items:
                    title: DeliveryItemOption
                    required:
                    - item
                    - slaType
                    - slaTypeName
                    - listPrice
                    - promotionalPrice
                    - transitTime
                    - dockTime
                    - timeToDockPlusDockTime
                    - aditionalTimeBlockedDays
                    - totalTime
                    - deliveryWindows
                    - wareHouseId
                    - dockId
                    - location
                    type: object
                    properties:
                      item:
                        title: Item
                        required:
                        - id
                        - groupItemId
                        - kitItem
                        - quantity
                        - price
                        - additionalHandlingTime
                        - dimension
                        type: object
                        properties:
                          id:
                            type: string
                          groupItemId:
                            type:
                            - string
                            - 'null'
                          kitItem:
                            type: array
                            items:
                              type: string
                            description: '[Kit](https://help.vtex.com/en/tutorial/what-is-a-kit--5ov5s3eHM4AqAAgqWwoc28) item information.'
                          quantity:
                            type: integer
                            format: int32
                          price:
                            type: integer
                            format: int32
                          additionalHandlingTime:
                            type: string
                          dimension:
                            title: Dimension
                            required:
                            - weight
                            - height
                            - width
                            - length
                            type: object
                            properties:
                              weight:
                                type: integer
                                format: int32
                              height:
                                type: integer
                                format: int32
                              width:
                                type: integer
                                format: int32
                              length:
                                type: integer
                                format: int32
                            example:
                              weight: 150
                              height: 1
                              width: 1
                              length: 1
                        example:
                          id: '2390059'
                          groupItemId: null
                          kitItem: []
                          quantity: 1
                          price: 0
                          additionalHandlingTime: 00:00:00
                          dimension:
                            weight: 150
                            height: 1
                            width: 1
                            length: 1
                      slaType:
                        type: string
                      slaTypeName:
                        type: string
                      listPrice:
                        type: number
                      promotionalPrice:
                        type: number
                      transitTime:
                        type: string
                      dockTime:
                        type: string
                      timeToDockPlusDockTime:
                        type: string
                      aditionalTimeBlockedDays:
                        type: string
                      totalTime:
                        type: string
                      deliveryWindows:
                        type: array
                        items:
                          type: string
                        description: '[Delivery windows](https://help.vtex.com/en/tutorial/managing-delivery-capacity--2y217FQZCjD0I1n62yxVcz).'
                      wareHouseId:
                        type:
                        - string
                        - 'null'
                      dockId:
                        type: string
                      location:
                        title: Location
                        required:
                        - zipCode
                        - country
                        - inStore
                        type: object
                        properties:
                          zipCode:
                            type: string
                          country:
                            type: string
                          inStore:
                            title: InStore
                            required:
                            - IsCheckedIn
                            - StoreId
                            type: object
                            properties:
                              IsCheckedIn:
                                type: boolean
                              StoreId:
                                type:
                                - string
                                - 'null'
                            example:
                              IsCheckedIn: false
                              StoreId: null
                        example:
                          zipCode: '22220070'
                          country: BRA
                          inStore:
                            IsCheckedIn: false
                            StoreId: null
                    example:
                      item:
                        id: '2390059'
                        groupItemId: null
                        kitItem: []
                        quantity: 1
                        price: 0
                        additionalHandlingTime: 00:00:00
                        dimension:
                          weight: 150
                          height: 1
                          width: 1
                          length: 1
                      slaType: Expressa
                      slaTypeName: Expressa
                      listPrice: 10.5
                      promotionalPrice: 10.5
                      transitTime: 2.00:00:00
                      dockTime: 00:00:00
                      timeToDockPlusDockTime: 1.00:00:00
                      aditionalTimeBlockedDays: 00:00:00
                      totalTime: 3.00:00:00
                      deliveryWindows: []
                      wareHouseId: null
                      dockId: 1a8bce3
                      location:
                        zipCode: '22220070'
                        country: BRA
                        inStore:
                          IsCheckedIn: false
                          StoreId: null
                  description: Array of objects with delivery item options information.
              example:
                salesChannel: '1'
                lockId: null
                autorizationExpirationTTL: 00:10:00
                deliveryItemOptions:
                - item:
                    id: '2390059'
                    groupItemId: null
                    kitItem: []
                    quantity: 1
                    price: 0
                    additionalHandlingTime: 00:00:00
                    dimension:
                      weight: 150
                      height: 1
                      width: 1
                      length: 1
                  slaType: Expressa
                  slaTypeName: Expressa
                  listPrice: 10.5
                  promotionalPrice: 10.5
                  transitTime: 2.00:00:00
                  dockTime: 00:00:00
                  timeToDockPlusDockTime: 1.00:00:00
                  aditionalTimeBlockedDays: 00:00:00
                  totalTime: 3.00:00:00
                  deliveryWindows: []
                  wareHouseId: null
                  dockId: 1a8bce3
                  location:
                    zipCode: '22220070'
                    country: BRA
                    inStore:
                      IsCheckedIn: false
                      StoreId: null
            example:
              salesChannel: '1'
              lockId: null
              autorizationExpirationTTL: 00:10:00
              deliveryItemOptions:
              - item:
                  id: '2390059'
                  groupItemId: null
                  kitItem: []
                  quantity: 1
                  price: 0
                  additionalHandlingTime: 00:00:00
                  dimension:
                    weight: 150
                    height: 1
                    width: 1
                    length: 1
                slaType: Expressa
                slaTypeName: Expressa
                listPrice: 10.5
                promotionalPrice: 10.5
                transitTime: 2.00:00:00
                dockTime: 00:00:00
                timeToDockPlusDockTime: 1.00:00:00
                aditionalTimeBlockedDays: 00:00:00
                totalTime: 3.00:00:00
                deliveryWindows: []
                wareHouseId: null
                dockId: 1a8bce3
                location:
                  zipCode: '22220070'
                  country: BRA
                  inStore:
                    IsCheckedIn: false
                    StoreId: null
        required: true
      responses:
        '200':
          description: OK
          headers:
            Cache-Control:
              content:
                text/plain:
                  schema:
                    type: string
                  example: no-cache
            Connection:
              content:
                text/plain:
                  schema:
                    type: string
                  example: keep-alive
            Content-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                  example: gzip
            Content-Length:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '620'
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                  example: Fri, 15 Apr 2016 19:59:18 GMT
            Expires:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '-1'
            Pragma:
              content:
                text/plain:
                  schema:
                    type: string
                  example: no-cache
            Server:
              content:
                text/plain:
                  schema:
                    type: string
                  example: nginx
            Vary:
              content:
                text/plain:
                  schema:
                    type: string
                  example: Accept-Encoding
            X-CDNIgnore:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '1'
            X-CacheServer:
              content:
                text/plain:
                  schema:
                    type: string
                  example: janus-apicache-nginx5
            X-Powered-by-VTEX-Janus-ApiCache:
              content:
                text/plain:
                  schema:
                    type: string
                  example: v1.3.8
            X-Powered-by-VTEX-Janus-Edge:
              content:
                text/plain:
                  schema:
                    type: string
                  example: v1.26.4
            X-Powered-by-VTEX-Janus-Router:
              content:
                text/plain:
                  schema:
                    type: string
                  example: 2.1.155
            X-Track:
              content:
                text/plain:
                  schema:
                    type: string
                  example: stable
            X-VTEX-Janus-Router-Backend-App:
              content:
                text/plain:
                  schema:
                    type: string
                  example: logist-v6.2.96-stable+863
            x-vtex-operation-id:
              content:
                text/plain:
                  schema:
                    type: string
                  example: 4e3847c0-596e-4abd-a761-e711bb68bdfa
          content:
            application/json; charset=utf-8:
              schema:
                required:
                - LastUpdateDateUtc
                - SalesChannel
                - LockId
                - ReservationDateUtc
                - MaximumConfirmationDateUtc
                - Status
                - SlaRequest
                - PickupPointItemOptions
                - CanceledDateUtc
                - AuthorizedDateUtc
                - ConfirmedDateUtc
                - Errors
                - IsSucess
                type: object
                properties:
                  LastUpdateDateUtc:
                    type: string
                  SalesChannel:
                    type: string
                  LockId:
                    type: string
                  ReservationDateUtc:
                    type: string
                  MaximumConfirmationDateUtc:
                    type: string
                  Status:
                    type: integer
                    format: int32
                  SlaRequest:
                    type: array
                    items:
                      title: SlaRequest
                      required:
                      - item
                      - slaType
                      - slaTypeName
                      - freightTableName
                      - freightTableId
                      - listPrice
                      - promotionalPrice
                      - transitTime
                      - dockTime
                      - timeToDockPlusDockTime
                      - totalTime
                      - deliveryWindows
                      - wareHouseId
                      - dockId
                      - wmsEndPoint
                      - location
                      - pickupStoreInfo
                      type: object
                      properties:
                        item:
                          title: Item1
                          required:
                          - id
                          - groupItemId
                          - quantity
                          - price
                          - modal
                          - additionalHandlingTime
                          - dimension
                          - kitItem
                          - unlimitedQuantity
                          type: object
                          properties:
                            id:
                              type: string
                            groupItemId:
                              type:
                              - string
                              - 'null'
                            quantity:
                              type: integer
                              format: int32
                            price:
                              type: number
                            modal:
                              type:
                              - string
                              - 'null'
                            additionalHandlingTime:
                              type: string
                            dimension:
                              title: Dimension1
                              required:
                              - weight
                              - height
                              - width
                              - length
                              - maxSumDimension
                              type: object
                              properties:
                                weight:
                                  type: number
                                height:
                                  type: number
                                width:
                                  type: number
                                length:
                                  type: number
                                maxSumDimension:
                                  type: number
                              example:
                                weight: 800
                                height: 10
                                width: 12
                                length: 35
                                maxSumDimension: 0
                            kitItem:
                              type: array
                              items:
                                type: string
                              description: '[Kit](https://help.vtex.com/en/tutorial/what-is-a-kit--5ov5s3eHM4AqAAgqWwoc28) item information.'
                            unlimitedQuantity:
                              type: boolean
                          example:
                            id: '2390059'
                            groupItemId: null
                            quantity: 1
                            price: 0
                            modal: null
                            additionalHandlingTime: 00:00:00
                            dimension:
                              weight: 800
                              height: 10
                              width: 12
                              length: 35
                              maxSumDimension: 0
                            kitItem: []
                            unlimitedQuantity: false
                        slaType:
                          type: string
                        slaTypeName:
                          type: string
                        freightTableName:
                          type: string
                        freightTableId:
                          type: string
                        listPrice:
                          type: number
                        promotionalPrice:
                          type: number
                        transitTime:
                          type: string
                        dockTime:
                          type: string
                        timeToDockPlusDockTime:
                          type: string
                        totalTime:
                          type: string
                        deliveryWindows:
                          type:
                          - string
                          - 'null'
                        wareHouseId:
                          type: string
                        dockId:
                          type: string
                        wmsEndPoint:
                          type: string
                        location:
                          title: Location1
                          required:
                          - zipCode
                          - country
                          - deliveryPointId
                          - point
                          - inStore
                          type: object
                          properties:
                            zipCode:
                              type: string
                            country:
                              type: string
                            deliveryPointId:
                              type:
                              - string
                              - 'null'
                            point:
                              type:
                              - string
                              - 'null'
                            inStore:
                              title: InStore1
                              required:
                              - IsCheckedIn
                              - StoreId
                              type: object
                              properties:
                                IsCheckedIn:
                                  type: boolean
                                StoreId:
                                  type: string
                              example:
                                IsCheckedIn: false
                                StoreId: '180082'
                          example:
                            zipCode: '22220070'
                            country: BRA
                            deliveryPointId: null
                            point: null
                            inStore:
                              IsCheckedIn: false
                              StoreId: '180082'
                        pickupStoreInfo:
                          type:
                          - string
                          - 'null'
                      example:
                        item:
                          id: '2390059'
                          groupItemId: null
                          quantity: 1
                          price: 0
                          modal: null
                          additionalHandlingTime: 00:00:00
                          dimension:
                            weight: 800
                            height: 10
                            width: 12
                            length: 35
                            maxSumDimension: 0
                          kitItem: []
                          unlimitedQuantity: false
                        slaType: Normal
                        slaTypeName: Normal
                        freightTableName: Correios PAC
                        freightTableId: 11cc4b6
                        listPrice: 10.5
                        promotionalPrice: 10.5
                        transitTime: 2.00:00:00
                        dockTime: 00:00:00
                        timeToDockPlusDockTime: 1.00:00:00
                        totalTime: 3.00:00:00
                        deliveryWindows: null
                        wareHouseId: '1937054'
                        dockId: '1_1_1'
                        wmsEndPoint: ''
                        location:
                          zipCode: '22220070'
                          country: BRA
                          deliveryPointId: null
                          point: null
                          inStore:
                            IsCheckedIn: false
                            StoreId: '180082'
                        pickupStoreInfo: null
                    description: SLA (Service Level Agreement) information.
                  PickupPointItemOptions:
                    type:
                    - string
                    - 'null'
                  CanceledDateUtc:
                    type: string
                  AuthorizedDateUtc:
                    type: string
                  ConfirmedDateUtc:
                    type: string
                  Errors:
                    type: array
                    items:
                      type: string
                    description: Errors details.
                  IsSucess:
                    type: boolean
                example:
                  LastUpdateDateUtc: '2016-04-15T19:59:20.0397988+00:00'
                  SalesChannel: '2'
                  LockId: 3bfe679d-c0a8-475a-b315-706f84a9deb4
                  ReservationDateUtc: '2016-04-15T19:59:20.0397988+00:00'
                  MaximumConfirmationDateUtc: '2016-04-15T20:09:20.0397988+00:00'
                  Status: 1
                  SlaRequest:
                  - item:
                      id: '2390059'
                      groupItemId: null
                      quantity: 1
                      price: 0
                      modal: null
                      additionalHandlingTime: 00:00:00
                      dimension:
                        weight: 800
                        height: 10
                        width: 12
                        length: 35
                        maxSumDimension: 0
                      kitItem: []
                      unlimitedQuantity: false
                    slaType: Normal
                    slaTypeName: Normal
                    freightTableName: Correios PAC
                    freightTableId: 11cc4b6
                    listPrice: 10.5
                    promotionalPrice: 10.5
                    transitTime: 2.00:00:00
                    dockTime: 00:00:00
                    timeToDockPlusDockTime: 1.00:00:00
                    totalTime: 3.00:00:00
                    deliveryWindows: null
                    wareHouseId: '1937054'
                    dockId: '1_1_1'
                    wmsEndPoint: ''
                    location:
                      zipCode: '22220070'
                      country: BRA
                      deliveryPointId: null
                      point: null
                      inStore:
                        IsCheckedIn: false
                        StoreId: '180082'
                    pickupStoreInfo: null
                  PickupPointItemOptions: null
                  CanceledDateUtc: '0001-01-01T00:00:00+00:00'
                  AuthorizedDateUtc: '2016-04-15T19:59:20.0397988+00:00'
                  ConfirmedDateUtc: '0001-01-01T00:00:00+00:00'
                  Errors: []
                  IsSucess: true
              example:
                LastUpdateDateUtc: '2016-04-15T19:59:20.0397988+00:00'
                SalesChannel: '2'
                LockId: 3bfe679d-c0a8-475a-b315-706f84a9deb4
                ReservationDateUtc: '2016-04-15T19:59:20.0397988+00:00'
                MaximumConfirmationDateUtc: '2016-04-15T20:09:20.0397988+00:00'
                Status: 1
                SlaRequest:
                - item:
                    id: '2390059'
                    groupItemId: null
                    quantity: 1
                    price: 0
                    modal: null
                    additionalHandlingTime: 00:00:00
                    dimension:
                      weight: 800
                      height: 10
                      width: 12
                      length: 35
                      maxSumDimension: 0
                    kitItem: []
                    unlimitedQuantity: false
                  slaType: Normal
                  slaTypeName: Normal
                  freightTableName: Correios PAC
                  freightTableId: 11cc4b6
                  listPrice: 10.5
                  promotionalPrice: 10.5
                  transitTime: 2.00:00:00
                  dockTime: 00:00:00
                  timeToDockPlusDockTime: 1.00:00:00
                  totalTime: 3.00:00:00
                  deliveryWindows: null
                  wareHouseId: '1937054'
                  dockId: '1_1_1'
                  wmsEndPoint: ''
                  location:
                    zipCode: '22220070'
                    country: BRA
                    deliveryPointId: null
                    point: null
                    inStore:
                      IsCheckedIn: false
                      StoreId: '180082'
                  pickupStoreInfo: null
                PickupPointItemOptions: null
                CanceledDateUtc: '0001-01-01T00:00:00+00:00'
                AuthorizedDateUtc: '2016-04-15T19:59:20.0397988+00:00'
                ConfirmedDateUtc: '0001-01-01T00:00:00+00:00'
                Errors: []
                IsSucess: true
      deprecated: false
  /api/logistics/pvt/inventory/reservations/{reservationId}:
    get:
      tags:
      - Reservations
      summary: VTex List reservation by ID
      description: Lists reservation's information by ID.
      operationId: ReservationById
      parameters:
      - name: Content-Type
        in: header
        description: Type of the content being sent.
        required: true
        style: simple
        schema:
          type: string
          default: application/json; charset=utf-8
      - name: Accept
        in: header
        description: HTTP Client Negotiation Accept Header. Indicates the types of responses the client can understand.
        required: true
        style: simple
        schema:
          type: string
          default: application/json
      - name: reservationId
        in: path
        description: ''
        required: true
        style: simple
        schema:
          type: string
      responses:
        '200':
          description: OK
          headers:
            Cache-Control:
              content:
                text/plain:
                  schema:
                    type: string
                  example: no-cache
            Connection:
              content:
                text/plain:
                  schema:
                    type: string
                  example: keep-alive
            Content-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                  example: gzip
            Content-Length:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '621'
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                  example: Fri, 15 Apr 2016 20:00:01 GMT
            Expires:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '-1'
            Pragma:
              content:
                text/plain:
                  schema:
                    type: string
                  example: no-cache
            Server:
              content:
                text/plain:
                  schema:
                    type: string
              

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