> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cardapioweb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Finalizar pedido

> Finaliza o pedido especificado pelo order_id.

O status de finalizado é um status final, não permitindo a transição para outros status.



## OpenAPI

````yaml /reference/api-pedidos.json post /api/partner/v1/orders/{order_id}/finalize
openapi: 3.1.0
info:
  title: API Pedidos
  version: '1.0'
  contact:
    email: integracao@cardapioweb.com
    name: Cardápio Web
    url: https://cardapioweb.com
  description: >-
    A API de pedidos é responsável pelo acompanhamento dos pedidos de um
    estabelecimento e pelas mudanças de status deles.
servers:
  - url: https://integracao.sandbox.cardapioweb.com
    description: Sandbox
  - url: https://integracao.cardapioweb.com
    description: Produção
security:
  - apiKey: []
paths:
  /api/partner/v1/orders/{order_id}/finalize:
    parameters:
      - $ref: '#/components/parameters/order_id'
    post:
      summary: Finalizar pedido
      description: >-
        Finaliza o pedido especificado pelo order_id.


        O status de finalizado é um status final, não permitindo a transição
        para outros status.
      operationId: 8-finalize-order
      responses:
        '204':
          $ref: '#/components/responses/StatusUpdatedSuccessfully'
        '400':
          $ref: '#/components/responses/StatusUpdateError'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/OrderNotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  parameters:
    order_id:
      name: order_id
      in: path
      required: true
      schema:
        type: string
      description: ID do pedido
  responses:
    StatusUpdatedSuccessfully:
      description: Alteração de status feita com sucesso!
      content: {}
    StatusUpdateError:
      description: >-
        Não foi possível alterar o status. Veja os detalhes do erro retornado
        para mais informações.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/StatusUpdateError'
    Unauthorized:
      description: >-
        Não autorizado. Não foi enviado o token no header "X-API-KEY" ou ele é
        inválido.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Unauthorized'
    OrderNotFound:
      description: Pedido não encontrado.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/NotFound'
    TooManyRequests:
      description: >-
        Muitas requisições foram feitas em um curto período. Verifique nossas
        regras de rate limit.
      content: {}
  schemas:
    StatusUpdateError:
      type: object
      x-stoplight:
        id: xjq8zt69xjhzj
      examples:
        - code: 4002
          message: Não foi possível alterar o status do pedido
          details: Pedido finalizado, não é possível alterar o status.
        - code: 4003
          message: Essa transição de status não é permitida para esse pedido.
          details: O status desejado não é compatível com o pedido.
      properties:
        code:
          type: integer
          description: Código interno de identificação do erro
        message:
          type: string
          description: Mensagem de resumo do erro
        details:
          type: string
          description: Informações adicionais sobre o erro
      required:
        - code
        - message
      title: StatusUpdateError
      x-internal: false
    Unauthorized:
      type: object
      x-stoplight:
        id: 5cdf37ldhxqd8
      examples:
        - code: 4010
          message: Token inválido
      title: Unauthorized
      x-internal: false
      properties:
        code:
          type: integer
          description: Código interno de identificação do erro
        message:
          type: string
          description: Mensagem de resumo do erro
      required:
        - code
        - message
    NotFound:
      type: object
      x-stoplight:
        id: 8bgbn7m3rrved
      examples:
        - code: 4041
          message: Recurso não encontrado
          details: >-
            Couldn't find Order with 'id'=1523 [WHERE "orders"."company_id" =
            $1]
      properties:
        code:
          type: integer
          description: Código interno de identificação do erro
        message:
          type: string
          description: Mensagem de resumo do erro
        details:
          type: string
          description: Informações adicionais sobre o erro
      required:
        - code
        - message
      title: NotFound
      x-internal: false
  securitySchemes:
    apiKey:
      name: X-API-KEY
      type: apiKey
      in: header
      description: >-
        Token específico do estabelecimento integrado. Disponível na seção de
        integrações do Portal do estabelecimento.

````