Retornar o orçamento por ID

Request

Recupera os detalhes de um orçamento específico por ID. Útil quando quiser exibir ou sincronizar todos os dados de um orçamento específico.

Security

BearerAuth

Path

idstringrequired

ID do orçamento (UUID)

curl -i -X GET \
  'https://api-v2.contaazul.com/v1/orcamentos/{id}' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json

composicao_de_valorobject(ComposicaoValorOrcamento)

Composição de valor do orçamento (frete e desconto)

data_orcamentostring

Data do orçamento (YYYY-MM-DD)

Example:"2026-05-01"

data_validadestring

Data de validade do orçamento (YYYY-MM-DD)

Example:"2026-05-01"

descricaostring

Descrição do orçamento

Example:"Este orçamento refere-se a manutenção de serviço"

idstring

ID do orçamento

Example:"aff32f2a-2904-4918-a18b-96fa39ac435c"

id_clientestring

ID do cliente do orçamento

Example:"72f07482-bfda-44b0-a2e7-d8817bf950fa"

id_vendedorstring

ID do vendedor responsável pelo orçamento

Example:"8cc4ff03-e8c6-4d7e-8c41-4245f55f8612"

itensArray of objects(ItemOrcamento)

Itens do orçamento

numerointeger

Número do orçamento

Example:1

observacoesstring

Observações gerais do orçamento

Example:"Entrega Grátis"

observacoes_pagamentostring

Observações de pagamento do orçamento

Example:"Pagamento à vista"

previsao_entregastring

Previsão de entrega do orçamento

Example:"À combinar"

situacaostring(TipoDeSituacaoOrcamento)

Situação atual do orçamento

Enum:"ORCAMENTO""ORCAMENTO_ACEITO""ORCAMENTO_RECUSADO"

Example:"ORCAMENTO"

versaointeger

Versão do orçamento

Example:1

Response

{
  "composicao_de_valor": {
    "desconto": { … },
    "frete": 5
  },
  "data_orcamento": "2026-05-01",
  "data_validade": "2026-05-01",
  "descricao": "Este orçamento refere-se a manutenção de serviço",
  "id": "aff32f2a-2904-4918-a18b-96fa39ac435c",
  "id_cliente": "72f07482-bfda-44b0-a2e7-d8817bf950fa",
  "id_vendedor": "8cc4ff03-e8c6-4d7e-8c41-4245f55f8612",
  "itens": [
    { … }
  ],
  "numero": 1,
  "observacoes": "Entrega Grátis",
  "observacoes_pagamento": "Pagamento à vista",
  "previsao_entrega": "À combinar",
  "situacao": "ORCAMENTO",
  "versao": 1
}