Skip to content
API/
Vendas
/
/
Retornar a venda por id

Retornar a venda por id

Request

Recupera os detalhes de uma venda específica por ID (pode ser UUID ou id legado). Útil quando quiser exibir ou sincronizar todos os dados de uma venda específica.

Security
BearerAuth
Path
idstringrequired

O legacy id ou uuid da venda a ser obtida

Example:123e4567-e89b-12d3-a456-426614174000
curl -i -X GET \
  https://api-v2.contaazul.com/v1/venda/123e4567-e89b-12d3-a456-426614174000 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

OK

Bodyapplication/json
clienteobject(ClientePegarVendaPorId)
evento_financeiroobject
notificacaoobject(Notificacao)
natureza_operacaoobject(NaturezaOperacao)
vendaobject(Negociacao)
vendedorobject(Vendedor)
contratoobject(Contrato)
Response
{
  "cliente": {
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "tipo_pessoa": "Física",
    "documento": "12345678901",
    "nome": "João da Silva"
  },
  "evento_financeiro": {
    "id": "123e4567-e89b-12d3-a456-426614174000"
  },
  "notificacao": {
    "id_referencia": "notificacao-123456",
    "enviado_para": "exemplo@email.com",
    "enviado_em": "2023-12-31T12:00:00Z",
    "aberto_em": "2023-12-31T12:00:00Z",
    "status": "ENVIADO"
  },
  "natureza_operacao": {
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "tipo_operacao": "VENDA",
    "template_operacao": "VENDA_MERCADORIAS",
    "label": "Venda a Não Contribuinte",
    "mudanca_financeira": true,
    "mudanca_estoque": "ENTRADA_ESTOQUE"
  },
  "venda": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "status": "EM_ANDAMENTO",
    "id_legado": 123456,
    "tipo_negociacao": "VENDA",
    "numero": 1001,
    "id_categoria": "123e4567-e89b-12d3-a456-426614174000",
    "data_compromisso": "2023-12-31",
    "configuracao_de_desconto": { … },
    "composicao_valor": { … },
    "condicao_pagamento": { … },
    "total_itens": { … },
    "observacoes": "Cliente confirmou o prazo de pagamento",
    "id_cliente": "123e4567-e89b-12d3-a456-426614174000",
    "versao": 1,
    "tipo_pendencia": { … },
    "situacao": { … },
    "id_natureza_operacao": "123e4567-e89b-12d3-a456-426614174000",
    "id_centro_custo": "123e4567-e89b-12d3-a456-426614174000",
    "introducao": "Orçamento do produto 1 e serviço 1",
    "origem": "API"
  },
  "vendedor": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "nome": "João da Silva",
    "id_legado": 123456
  },
  "contrato": {
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "data_inicio": "2023-12-31",
    "data_fim": "2024-12-31",
    "dia_vencimento": 10,
    "periodo": "MENSAL",
    "periodicidade": 1
  }
}