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

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

Request

Permite criar um novo evento financeiro de contas a pagar, informando dados como valor, fornecedor, condições de pagamento, descrição, conta financeira e rateio. Esse endpoint facilita o registro das obrigações financeiras da empresa.

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-pagar.

Security
BearerAuth
Bodyapplication/jsonrequired

Dados do evento financeiro de contas a pagar

descricaostringrequired

Descrição do evento financeiro

Example:"Aluguel do escritório - outubro"
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:2500
conta_financeirastring, (uuid)required

Identificador da conta financeira. A conta Receba Fácil não é aceita em contas a pagar

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

Identificador do fornecedor

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

Observação do evento financeiro

Example:"Contrato 2026/014"
referencia_externastring

Identificador do evento financeiro no seu sistema

Example:"ERP-PAG-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-pagar \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "descricao": "Aluguel do escritório - outubro",
    "data_competencia": "2026-10-01",
    "valor": 2500,
    "conta_financeira": "c89475a2-bdf9-4e6b-ae5b-5a8e96cab946",
    "id_fornecedor": "fda2f85c-ecd1-4cf1-9d0b-170c54b4cb3e",
    "observacao": "Contrato 2026/014",
    "referencia_externa": "ERP-PAG-000123",
    "rateio": [
      {
        "id_categoria": "937f6d29-3b2c-4eee-9778-29e54606f8b5",
        "valor": 2500,
        "rateio_centro_custo": [
          {
            "id_centro_custo": "bbe8049e-71df-4bf7-91f8-3b14ac5a6cdc",
            "valor": 2500
          }
        ]
      }
    ],
    "condicao_pagamento": {
      "parcelas": [
        {
          "descricao": "Parcela 1",
          "data_vencimento": "2026-10-10",
          "conta_financeira": "c89475a2-bdf9-4e6b-ae5b-5a8e96cab946",
          "metodo_pagamento": "BOLETO_BANCARIO",
          "detalhe_valor": {
            "valor_bruto": 2500
          }
        }
      ]
    }
  }'

Responses

Evento financeiro de contas a pagar 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": "DESPESA",
  "agendado": false,
  "descricao": "Aluguel do escritório - outubro",
  "data_competencia": "2026-10-01",
  "valor": 2500,
  "id_fornecedor": "fda2f85c-ecd1-4cf1-9d0b-170c54b4cb3e",
  "observacao": "Contrato 2026/014",
  "referencia_externa": "ERP-PAG-000123",
  "id_recorrencia": "",
  "indice_recorrencia": 0,
  "referencia": {
    "id": "9e4bb72d-f6f6-4fbf-9ca9-5e444e0c2e39",
    "origem": "LANCAMENTO_FINANCEIRO",
    "revisao": 1
  },
  "rateio": [
    { … }
  ],
  "condicao_pagamento": {
    "quantidade_parcelas": 1,
    "parcelas": [ … ]
  }
}