Skip to content
/
Criar um novo evento fina...

Novo · use este
Criar um novo evento financeiro de contas a receber

Request

Permite criar um novo evento financeiro de contas a receber, passando dados como data de competência, valor, descrição, cliente, conta financeira, rateio e condições de pagamento. Facilita o registro de receitas previstas ou realizadas.

Criação síncrona, sem protocolo. A resposta 201 já traz a conta criada, com o id e as parcelas. Se algum dado estiver inválido, o erro volta na própria resposta, com HTTP 400.

Substitui o retorno com protocolo do POST /v1/financeiro/eventos-financeiros/contas-a-receber.

Security
BearerAuth
Bodyapplication/jsonrequired

Dados do evento financeiro de contas a receber

descricaostringrequired

Descrição do evento financeiro

Example:"Venda de consultoria"
data_competenciastring, (date)required

Data de competência do evento financeiro

Example:"2026-10-01"
valornumber, (decimal)required

Valor do evento financeiro. Deve ser maior que zero e igual à soma do rateio

Example:1200
conta_financeirastring, (uuid)required

Identificador da conta financeira

Example:"c89475a2-bdf9-4e6b-ae5b-5a8e96cab946"
id_clientestring, (uuid)required

Identificador do cliente

Example:"f91047eb-2cff-4546-80e3-0f2b54d2cce0"
observacaostring

Observação do evento financeiro

Example:"Contrato 2026/014"
referencia_externastring

Identificador do evento financeiro no seu sistema

Example:"ERP-REC-000123"
rateioArray of objects(RateioCategoriaCriacao)required

Rateio do valor entre categorias. A soma deve ser igual ao valor do evento e as categorias não podem se repetir

condicao_pagamentoobject(CondicaoPagamentoCriacao)required
curl -i -X POST \
  https://api-v2.contaazul.com/v1/financeiro/contas-a-receber \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "descricao": "Venda de consultoria",
    "data_competencia": "2026-10-01",
    "valor": 1200,
    "conta_financeira": "c89475a2-bdf9-4e6b-ae5b-5a8e96cab946",
    "id_cliente": "f91047eb-2cff-4546-80e3-0f2b54d2cce0",
    "observacao": "Contrato 2026/014",
    "referencia_externa": "ERP-REC-000123",
    "rateio": [
      {
        "id_categoria": "23545d79-3c6a-4ec3-b805-5912736a3e00",
        "valor": 1200,
        "rateio_centro_custo": [
          {
            "id_centro_custo": "bbe8049e-71df-4bf7-91f8-3b14ac5a6cdc",
            "valor": 1200
          }
        ]
      }
    ],
    "condicao_pagamento": {
      "parcelas": [
        {
          "descricao": "Parcela 1/2",
          "data_vencimento": "2026-10-15",
          "conta_financeira": "c89475a2-bdf9-4e6b-ae5b-5a8e96cab946",
          "metodo_pagamento": "PIX_PAGAMENTO_INSTANTANEO",
          "detalhe_valor": {
            "valor_bruto": 600
          }
        },
        {
          "descricao": "Parcela 2/2",
          "data_vencimento": "2026-11-15",
          "conta_financeira": "c89475a2-bdf9-4e6b-ae5b-5a8e96cab946",
          "metodo_pagamento": "PIX_PAGAMENTO_INSTANTANEO",
          "detalhe_valor": {
            "valor_bruto": 600
          }
        }
      ]
    }
  }'

Responses

Evento financeiro de contas a receber criado com sucesso

Bodyapplication/json
idstring, (uuid)

Identificador do evento financeiro criado

Example:"9e4bb72d-f6f6-4fbf-9ca9-5e444e0c2e39"
versaointeger

Versão do evento financeiro

Example:1
tipostring

Tipo do evento financeiro

Enum:"RECEITA""DESPESA"
Example:"RECEITA"
agendadoboolean

Indica se o evento financeiro é agendado

Example:false
descricaostring

Descrição do evento financeiro

Example:"Venda de consultoria"
data_competenciastring, (date)

Data de competência do evento financeiro

Example:"2026-10-01"
valornumber

Valor do evento financeiro

Example:1200
id_clientestring, (uuid)

Identificador do cliente, em contas a receber

Example:"f91047eb-2cff-4546-80e3-0f2b54d2cce0"
id_fornecedorstring, (uuid)

Identificador do fornecedor, em contas a pagar

Example:"fda2f85c-ecd1-4cf1-9d0b-170c54b4cb3e"
observacaostring

Observação do evento financeiro

Example:"Contrato 2026/014"
referencia_externastring

Referência externa enviada na criação

Example:"ERP-REC-000123"
id_recorrenciastring

Identificador (UUID) da recorrência. Vem como string vazia quando o evento não pertence a uma recorrência

Example:"35473eec-4e74-11ee-b500-9f61de8a8b8b"
indice_recorrenciainteger

Posição do evento na recorrência. Vem como 0 quando o evento não pertence a uma recorrência

Example:1
referenciaobject(EventoFinanceiroCriadoReferencia)

Origem do evento financeiro

rateioArray of objects(EventoFinanceiroCriadoRateioCategoria)

Rateio do evento financeiro

condicao_pagamentoobject(EventoFinanceiroCriadoCondicaoPagamento)
Response
{
  "id": "9e4bb72d-f6f6-4fbf-9ca9-5e444e0c2e39",
  "versao": 1,
  "tipo": "RECEITA",
  "agendado": false,
  "descricao": "Venda de consultoria",
  "data_competencia": "2026-10-01",
  "valor": 1200,
  "id_cliente": "f91047eb-2cff-4546-80e3-0f2b54d2cce0",
  "observacao": "Contrato 2026/014",
  "referencia_externa": "ERP-REC-000123",
  "id_recorrencia": "",
  "indice_recorrencia": 0,
  "referencia": {
    "id": "9e4bb72d-f6f6-4fbf-9ca9-5e444e0c2e39",
    "origem": "LANCAMENTO_FINANCEIRO",
    "revisao": 1
  },
  "rateio": [
    { … }
  ],
  "condicao_pagamento": {
    "quantidade_parcelas": 2,
    "parcelas": [ … ]
  }
}