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

# Atualiza um pedido existente

> Atualiza parcialmente um pedido existente no sistema Agulhão. (Obs: É obrigatório informar id ou idExterno. Se ambos forem fornecidos, o id terá prioridade.)



## OpenAPI

````yaml /api-bitrix/openapi.yaml patch /pedidos
openapi: 3.1.0
info:
  title: Agulhão API - Bitrix24
  description: API do sistema Agulhão para integração com Bitrix24.
  contact:
    email: contato@softros.com.br
    url: https://agulhao.com.br
  version: 1.0.1
servers:
  - url: https://api-integracoes.agulhao.com.br
    description: Produção
security: []
tags:
  - name: filiais-bt
  - name: pessoas-bt
  - name: produtos-bt
  - name: pedidos-bt
  - name: tipos-lancamento
externalDocs:
  description: Mais sobre a API
  url: https://docs.agulhao.com.br/api
paths:
  /pedidos:
    patch:
      tags:
        - pedidos-bt
      summary: Atualiza um pedido existente
      description: >-
        Atualiza parcialmente um pedido existente no sistema Agulhão. (Obs: É
        obrigatório informar id ou idExterno. Se ambos forem fornecidos, o id
        terá prioridade.)
      operationId: patchPedidos
      requestBody:
        required: true
        description: Dados do pedido a ser atualizado
        content:
          application/json:
            schema:
              type: object
              properties:
                idExterno:
                  type: string
                  description: ID do pedido na integração (seu id)
                cancelado:
                  type: boolean
                  description: Indica se o pedido foi cancelado
                  example: false
                observacoes:
                  type: string
                  description: Observações do pedido
                  example: Observações atualizadas do pedido
            examples:
              cancelando:
                summary: Cancelando pedido
                description: Exemplo de atualização de pedido para cancelamento
                value:
                  idExterno: 4560a17a-ea59-4c4b-a2a4-78610dd04d4a
                  cancelado: true
              confirmandoPagamento:
                summary: Confirmando pagamento
                description: Exemplo de atualização de pedido para confirmar pagamento
                value:
                  idExterno: 4560a17a-ea59-4c4b-a2a4-78610dd04d4a
                  pagamentos:
                    - valor: 79.9
                      pago: true
                      gateway: PAGSEGURO
      responses:
        '200':
          description: Pedido atualizado com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  idAgulhao:
                    type: string
                    description: Identificador único do pedido criado no Agulhão
                    example: '1'
                  idExterno:
                    type: string
                    description: Identificador único do pedido na integração (seu id)
                    example: 4560a17a-ea59-4c4b-a2a4-78610dd04d4a
        '400':
          description: >-
            Parâmetros inválidos ou faltando informações necessárias para
            atualizar o pedido.
          content:
            application/json:
              schema:
                type: object
                properties:
                  mensagem:
                    type: string
                    example: Parâmetros inválidos. Verifique os dados enviados.
                  tecnico:
                    type: string
                    example: Erro ao validar os dados do pedido.
        '500':
          description: Erro interno do servidor ao tentar atualizar o pedido.
          content:
            application/json:
              schema:
                type: object
                properties:
                  mensagem:
                    type: string
                    example: Erro ao atualizar o pedido.
                  tecnico:
                    type: string
                    example: Erro ao salvar o pedido no banco de dados.
      security:
        - chaveApi: []
components:
  securitySchemes:
    chaveApi:
      description: Chave da API gerada no agulhão
      type: apiKey
      name: x-api-key
      in: header

````