# Criar uma nova venda

Cria uma nova venda no sistema da Conta Azul. Ideal para registrar vendas vindas de sistemas externos diretamente no ERP da Conta Azul.

Endpoint: POST /v1/venda
Version: v1
Security: BearerAuth

## Security:

  - `BearerAuth` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id_cliente` (string, required)
    id do cliente
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `numero` (integer, required)
    Número da venda
    Example: 1001

  - `situacao` (string, required)
    Situação da venda
    Enum: "EM_ANDAMENTO", "APROVADO"

  - `data_venda` (string, required)
    Data da venda
    Example: 2023-12-31

  - `id_categoria` (string)
    id da categoria
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `id_centro_custo` (string)
    id do centro de custo
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `id_vendedor` (string)
    id do vendedor
    Example: 40bbdaa5-65c2-49e9-b892-470fd1093ed3

  - `observacoes` (string)
    Observações sobre a venda
    Example: Observações sobre a venda

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

  - `itens` (array, required)

  - `itens.descricao` (string)
    Descrição do item da venda
    Example: Produto A

  - `itens.quantidade` (number, required)
    Quantidade do item da venda
    Example: 2

  - `itens.valor` (number, required)
    Valor do item da venda
    Example: 50

  - `itens.id` (string, required)
    id do item da venda
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `itens.valor_custo` (number)
    Valor de custo do item da venda.
    Example: 40

  - `itens.itens_kit` (array)

  - `itens.itens_kit.id_produto` (string, required)
    id do produto que pertence ao kit
    Example: 568e8400-e29b-41d4-a716-446655440000

  - `itens.itens_kit.id_kit` (string, required)
    id do kit que contém o produto
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `itens.itens_kit.quantidade` (number, required)
    Quantidade dos itens do kit
    Example: 2

  - `itens.itens_kit.valor` (number, required)
    Valor dos itens do kit
    Example: 50

  - `composicao_de_valor` (object)

  - `composicao_de_valor.frete` (number)
    Valor de frete.
    Example: 100

  - `composicao_de_valor.desconto` (object)

  - `composicao_de_valor.desconto.tipo` (string, required)
    Tipo de desconto
    Enum: "PORCENTAGEM", "VALOR"

  - `composicao_de_valor.desconto.valor` (number, required)
    Valor do desconto
    Example: 5

  - `condicao_pagamento` (object, required)

  - `condicao_pagamento.tipo_pagamento` (string)
    Forma de pagamento
    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"

  - `condicao_pagamento.id_conta_financeira` (string)
    id da conta financeira
    Example: 567e8400-e29b-41d4-a716-446655440000

  - `condicao_pagamento.opcao_condicao_pagamento` (string, required)
    Deve ser em um dos três formatos: - 1º: Ex: À vista. - 2º: Ex1: 30, 60, 90. Ex2: 15, 30, 45. - 3º: Ex1: 3x. Ex2: 12x
    Example: À vista

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

  - `condicao_pagamento.parcelas` (array, required)

  - `condicao_pagamento.parcelas.data_vencimento` (string, required)
    Data de vencimento
    Example: 2023-12-31

  - `condicao_pagamento.parcelas.valor` (number, required)
    Valor da parcela
    Example: 100

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

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `id` (string)
    id único da venda
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `id_legado` (integer)
    id legado necessário para a venda
    Example: 123456

  - `id_cliente` (string)
    id do cliente associado à venda
    Example: 123e4567-e89b-12d3-a456-426614174001

  - `numero` (integer)
    Número da venda
    Example: 1001

  - `origem` (string)
    Origem da venda
    Example: Online

  - `id_categoria` (string)
    id da categoria da venda
    Example: 123e4567-e89b-12d3-a456-426614174002

  - `data_venda` (string)
    Data da venda
    Example: 2023-10-01T12:00:00Z

  - `situacao` (object)

  - `situacao.nome` (string)
    Nome da situação
    Example: Situação Exemplo

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

  - `pendencia` (object)

  - `pendencia.nome` (string)
    Nome da pendência
    Example: AGUARDANDO_CONFIRMACAO

  - `pendencia.descricao` (string)
    Descrição da pendência
    Example: Aguardando confirmação

  - `valor_composicao` (object)

  - `valor_composicao.valor_bruto` (number)
    Valor bruto da venda
    Example: 100

  - `valor_composicao.desconto` (object)

  - `valor_composicao.desconto.tipo` (string, required)
    Tipo de desconto
    Enum: "PORCENTAGEM", "VALOR"

  - `valor_composicao.desconto.valor` (number, required)
    Valor do desconto
    Example: 5

  - `valor_composicao.frete` (number)
    Valor do frete
    Example: 10

  - `valor_composicao.valor_liquido` (number)
    Valor líquido da venda
    Example: 90

  - `condicao_pagamento` (object)

  - `condicao_pagamento.id_legado` (integer)
    id legado da condição de pagamento
    Example: 123456789

  - `condicao_pagamento.tipo_pagamento` (string)
    Tipo de pagamento
    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"

  - `condicao_pagamento.id_conta_financeira` (string)
    id da conta financeira
    Example: 550e8400-e29b-41d4-a716-446655440000

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

  - `condicao_pagamento.parcelas` (array)

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

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

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

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

  - `condicao_pagamento.observacoes_pagamento` (string)
    Observações sobre o pagamento
    Example: Pagamento realizado em 3 parcelas

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

  - `condicao_pagamento.troco_total` (number)
    Troco total
    Example: 10.5

  - `observacoes` (string)
    Observações sobre a venda
    Example: Cliente solicitou entrega rápida

  - `id_vendedor` (string)
    id do vendedor responsável pela venda
    Example: 123e4567-e89b-12d3-a456-426614174003

  - `versao` (integer)
    Versão da venda
    Example: 1

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 429:

  - `429` (unknown)
    Too Many Requests

## Response 500:

  - `500` (unknown)
    Internal Server Error