Skip to content
API/
Vendas
/
/
Criar uma nova venda

Criar uma nova venda

Request

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

Security
BearerAuth
Bodyapplication/jsonrequired
id_clientestring, (uuid)required

id do cliente

Example:"123e4567-e89b-12d3-a456-426614174000"
numerointeger, (int64)required

Número da venda

Example:1001
situacaostringrequired

Situação da venda

Enum:"EM_ANDAMENTO""APROVADO"
Example:"EM_ANDAMENTO"
data_vendastring, (date)required

Data da venda

Example:"2023-12-31"
id_categoriastring, (uuid)

id da categoria

Example:"123e4567-e89b-12d3-a456-426614174000"
id_centro_custostring, (uuid)

id do centro de custo

Example:"123e4567-e89b-12d3-a456-426614174000"
id_vendedorstring, (uuid)

id do vendedor

Example:"40bbdaa5-65c2-49e9-b892-470fd1093ed3"
observacoesstring

Observações sobre a venda

Example:"Observações sobre a venda"
observacoes_pagamentostring

Observações sobre o pagamento

Example:"Observações sobre o pagamento"
itensArray of objects(ItemVendaRequest)required
composicao_de_valorobject(ValorComposicaoRequest)
condicao_pagamentoobject(CondicaoPagamentoRequest)required
curl -i -X POST \
  https://api-v2.contaazul.com/v1/venda \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id_cliente": "123e4567-e89b-12d3-a456-426614174000",
    "numero": 1001,
    "situacao": "EM_ANDAMENTO",
    "data_venda": "2023-12-31",
    "id_categoria": "123e4567-e89b-12d3-a456-426614174000",
    "id_centro_custo": "123e4567-e89b-12d3-a456-426614174000",
    "id_vendedor": "40bbdaa5-65c2-49e9-b892-470fd1093ed3",
    "observacoes": "Observações sobre a venda",
    "observacoes_pagamento": "Observações sobre o pagamento",
    "itens": [
      {
        "descricao": "Produto A",
        "quantidade": 2,
        "valor": 50,
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "valor_custo": 40,
        "itens_kit": [
          {
            "id_produto": "568e8400-e29b-41d4-a716-446655440000",
            "id_kit": "550e8400-e29b-41d4-a716-446655440000",
            "quantidade": 2,
            "valor": 50
          }
        ]
      }
    ],
    "composicao_de_valor": {
      "frete": 100,
      "desconto": {
        "tipo": "VALOR",
        "valor": 5
      }
    },
    "condicao_pagamento": {
      "tipo_pagamento": "CARTAO_CREDITO",
      "id_conta_financeira": "567e8400-e29b-41d4-a716-446655440000",
      "opcao_condicao_pagamento": "À vista",
      "nsu": "1234567890",
      "parcelas": [
        {
          "data_vencimento": "2023-12-31",
          "valor": 100,
          "descricao": "Parcela 1"
        }
      ]
    }
  }'

Responses

OK

Bodyapplication/json
idstring, (uuid)

id único da venda

Example:"123e4567-e89b-12d3-a456-426614174000"
id_legadointeger, (int64)

id legado necessário para a venda

Example:123456
id_clientestring, (uuid)

id do cliente associado à venda

Example:"123e4567-e89b-12d3-a456-426614174001"
numerointeger, (int64)

Número da venda

Example:1001
origemstring

Origem da venda

Example:"Online"
id_categoriastring, (uuid)

id da categoria da venda

Example:"123e4567-e89b-12d3-a456-426614174002"
data_vendastring, (date-time)

Data da venda

Example:"2023-10-01T12:00:00Z"
situacaoobject(SituacaoResponse)
pendenciaobject(TipoPendenciaResponse)
valor_composicaoobject(ComposicaoValorResponse)
condicao_pagamentoobject(CondicaoPagamentoResponse)
observacoesstring

Observações sobre a venda

Example:"Cliente solicitou entrega rápida"
id_vendedorstring, (uuid)

id do vendedor responsável pela venda

Example:"123e4567-e89b-12d3-a456-426614174003"
versaointeger, (int64)

Versão da venda

Example:1
Response
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "id_legado": 123456,
  "id_cliente": "123e4567-e89b-12d3-a456-426614174001",
  "numero": 1001,
  "origem": "Online",
  "id_categoria": "123e4567-e89b-12d3-a456-426614174002",
  "data_venda": "2023-10-01T12:00:00Z",
  "situacao": {
    "nome": "Situação Exemplo",
    "descricao": "Descrição da situação exemplo"
  },
  "pendencia": {
    "nome": "AGUARDANDO_CONFIRMACAO",
    "descricao": "Aguardando confirmação"
  },
  "valor_composicao": {
    "valor_bruto": 100,
    "desconto": { … },
    "frete": 10,
    "valor_liquido": 90
  },
  "condicao_pagamento": {
    "id_legado": 123456789,
    "tipo_pagamento": "CARTAO_CREDITO",
    "id_conta_financeira": "550e8400-e29b-41d4-a716-446655440000",
    "opcao_condicao_pagamento": "Parcelado",
    "parcelas": [ … ],
    "observacoes_pagamento": "Pagamento realizado em 3 parcelas",
    "nsu": "1234567890",
    "troco_total": 10.5
  },
  "observacoes": "Cliente solicitou entrega rápida",
  "id_vendedor": "123e4567-e89b-12d3-a456-426614174003",
  "versao": 1
}