# Retornar a venda por id

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.

Endpoint: GET /v1/venda/{id}
Version: v1
Security: BearerAuth

## Security:

  - `BearerAuth` (unknown)
    http bearer JWT

## Path parameters:

  - `id` (string, required)
    O legacy id ou uuid da venda a ser obtida

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `cliente` (object)

  - `cliente.uuid` (string)
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `cliente.tipo_pessoa` (string)
    Tipo de pessoa
    Example: Física

  - `cliente.documento` (string)
    Documento
    Example: 12345678901

  - `cliente.nome` (string)
    Nome
    Example: João da Silva

  - `evento_financeiro` (object)

  - `evento_financeiro.id` (string)
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `notificacao` (object)

  - `notificacao.id_referencia` (string)
    id de referência da notificação
    Example: notificacao-123456

  - `notificacao.enviado_para` (string)
    Enviado para
    Example: exemplo@email.com

  - `notificacao.enviado_em` (string)
    Data e hora de envio
    Example: 2023-12-31T12:00:00Z

  - `notificacao.aberto_em` (string)
    Data e hora de abertura
    Example: 2023-12-31T12:00:00Z

  - `notificacao.status` (string)
    Enum: "ENVIADO", "LIDO"

  - `natureza_operacao` (object)

  - `natureza_operacao.uuid` (string)
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `natureza_operacao.tipo_operacao` (string)
    Enum: "VENDA", "REMESSA", "COMPRA", "DEVOLUCAO"

  - `natureza_operacao.template_operacao` (string)
    Enum: "VENDA_MERCADORIAS", "VENDA_SUFRAMA", "VENDA_ENTREGA_FUTURA", "VENDA_CONSIGNADA", "VENDA_NAO_CONTRIBUINTE", "VENDA_EXPORTACAO", "VENDA_ORDEM", "VENDA_INDUSTRIALIZACAO", "PRESTACAO_SERVICO"

  - `natureza_operacao.label` (string)
    Label
    Example: Venda a Não Contribuinte

  - `natureza_operacao.mudanca_financeira` (boolean)
    Example: true

  - `natureza_operacao.mudanca_estoque` (string)
    Enum: "ENTRADA_ESTOQUE", "SAIDA_ESTOQUE", "NAO_ALTERA_ESTOQUE"

  - `venda` (object)

  - `venda.id` (string)
    id da negociação
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `venda.status` (string)
    Enum: "REVISAO_PENDENTE", "EM_ORCAMENTO", "ORCAMENTO_ACEITO", "ORCAMENTO_RECUSADO", "EM_ANDAMENTO", "CONTRATO", "CANCELADO", "PREVISAO", "INCOMPLETA"

  - `venda.id_legado` (integer)
    Example: 123456

  - `venda.tipo_negociacao` (string)
    Enum: "VENDA", "COMPRA"

  - `venda.numero` (integer)
    Example: 1001

  - `venda.id_categoria` (string)
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `venda.data_compromisso` (any)
    Example: 2023-12-31

  - `venda.configuracao_de_desconto` (object)

  - `venda.configuracao_de_desconto.tipo_desconto` (string)
    Enum: "PORCENTAGEM", "VALOR"

  - `venda.configuracao_de_desconto.taxa_desconto` (number)
    Example: 10

  - `venda.composicao_valor` (object)

  - `venda.composicao_valor.valor_bruto` (number)
    Example: 1000

  - `venda.composicao_valor.desconto` (number)
    Example: 100

  - `venda.composicao_valor.frete` (number)
    Example: 50

  - `venda.composicao_valor.impostos` (number)
    Example: 50

  - `venda.composicao_valor.impostos_deduzidos` (number)
    Example: 20

  - `venda.composicao_valor.seguro` (number)
    Example: 30

  - `venda.composicao_valor.despesas_incidentais` (number)
    Example: 20

  - `venda.composicao_valor.valor_liquido` (number)
    Example: 900

  - `venda.condicao_pagamento` (object)

  - `venda.condicao_pagamento.tipo_pagamento` (string)
    Enum: "BOLETO_BANCARIO", "CARTAO_CREDITO", "CARTAO_DEBITO", "CARTEIRA_DIGITAL", "CASHBACK", "CHEQUE", "CREDITO_LOJA", "CREDITO_VIRTUAL", "DEPOSITO_BANCARIO", "DINHEIRO", "OUTRO", "DEBITO_AUTOMATICO", "LINK_PAGAMENTO", "PIX_PAGAMENTO_INSTANTANEO", "COBRANCA_PIX", "PROGRAMA_FIDELIDADE", "SEM_PAGAMENTO", "TRANSFERENCIA_BANCARIA", "VALE_ALIMENTACAO", "VALE_COMBUSTIVEL", "VALE_PRESENTE", "VALE_REFEICAO"

  - `venda.condicao_pagamento.id_conta_financeira` (string)
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `venda.condicao_pagamento.pagamento_a_vista` (boolean)
    Example: false

  - `venda.condicao_pagamento.parcelas` (array)

  - `venda.condicao_pagamento.parcelas.id` (string)
    id da parcela
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `venda.condicao_pagamento.parcelas.numero` (integer)
    Número da parcela
    Example: 1

  - `venda.condicao_pagamento.parcelas.data_vencimento` (any)
    Data de vencimento
    Example: 2023-12-31

  - `venda.condicao_pagamento.parcelas.valor` (number)
    Valor da parcela
    Example: 26.99

  - `venda.condicao_pagamento.parcelas.descricao` (string)
    Descrição da parcela
    Example: Parcela 1

  - `venda.condicao_pagamento.observacoes_pagamento` (string)
    Observações sobre o pagamento
    Example: Observações sobre o pagamento

  - `venda.condicao_pagamento.opcao_condicao_pagamento` (string)
    Opção de condição de pagamento
    Example: À vista

  - `venda.condicao_pagamento.nsu` (string)
    Example: 1234567890

  - `venda.condicao_pagamento.pagamento_cartao` (object)

  - `venda.condicao_pagamento.pagamento_cartao.tipo_bandeira` (string)
    Enum: "VISA", "MASTERCARD", "AMERICAN_EXPRESS", "SOROCRED", "DINERS_CLUB", "ELO", "HIPERCARD", "AURA", "CABAL", "ALELO", "BANES_CARD", "CALCARDS", "CREDZ", "DISCOVER", "GOODCARD", "GREENCARD", "HIPER", "JCB", "MAIS", "MAXVAN", "POLICARD", "REDECOMPRAS", "SODEXO", "VALECARD", "VEROCHEQUE", "VR", "TICKET", "OUTROS"

  - `venda.condicao_pagamento.pagamento_cartao.codigo_transacao` (string)
    Example: ABC123XYZ789

  - `venda.condicao_pagamento.pagamento_cartao.id_adquirente` (integer)
    Example: 123456789

  - `venda.total_itens` (object)

  - `venda.total_itens.contagem_produtos` (integer)
    Example: 1

  - `venda.total_itens.contagem_servicos` (integer)
    Example: 1

  - `venda.total_itens.contagem_nao_conciliados` (integer)
    Example: 1

  - `venda.observacoes` (string)
    Example: Cliente confirmou o prazo de pagamento

  - `venda.id_cliente` (string)
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `venda.versao` (integer)
    Example: 1

  - `venda.tipo_pendencia` (object)

  - `venda.tipo_pendencia.nome` (string)
    Nome da pendência
    Enum: "NENHUMA", "RESERVA_DE_ESTOQUE", "CONCILIACAO_ITENS", "PROCESSAMENTO_RESERVA_DE_ESTOQUE", "ESPERANDO_CONFIRMACAO", "AGUARDANDO_GERACAO_NOTA_FISCAL"

  - `venda.tipo_pendencia.descricao` (string)
    Descrição da pendência
    Example: Nenhuma

  - `venda.situacao` (object)

  - `venda.situacao.nome` (string)
    Nome da situação
    Enum: "EM_ANDAMENTO", "APROVADO", "FATURADO", "CANCELADO", "ORCAMENTO", "ORCAMENTO_ACEITO", "ORCAMENTO_RECUSADO", "CONTRATO", "VENDA"

  - `venda.situacao.descricao` (string)
    Descrição da situação
    Example: Aprovado

  - `venda.situacao.ativado` (boolean)
    Ativado ou não
    Example: true

  - `venda.id_natureza_operacao` (string)
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `venda.id_centro_custo` (string)
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `venda.introducao` (string)
    Introdução da venda em orçamento
    Example: Orçamento do produto 1 e serviço 1

  - `venda.origem` (string)
    Origem da venda
    Example: API

  - `vendedor` (object)

  - `vendedor.id` (string)
    id do vendedor
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `vendedor.nome` (string)
    Nome do vendedor
    Example: João da Silva

  - `vendedor.id_legado` (integer)
    id legado do vendedor
    Example: 123456

  - `contrato` (object)

  - `contrato.uuid` (string)
    id do contrato
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `contrato.data_inicio` (string)
    Data de início do contrato
    Example: 2023-12-31

  - `contrato.data_fim` (string)
    Data final do contrato
    Example: 2024-12-31

  - `contrato.dia_vencimento` (integer)
    Dia do vencimento de cada fatura gerada pelo contrato
    Example: 10

  - `contrato.periodo` (string)
    Período de faturamento do contrato
    Enum: "MENSAL", "SEMANAL", "ANUAL"

  - `contrato.periodicidade` (integer)
    Periodicidade do contrato, ou seja, a cada quantos períodos será gerada uma fatura. Exemplo: periodicidade 2 e período MENSAL significa que a fatura será gerada a cada 2 meses.
    Example: 1

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 404:

  - `404` (unknown)
    Not Found

## Response 429:

  - `429` (unknown)
    Too Many Requests

## Response 500:

  - `500` (unknown)
    Internal Server Error