Financeiro (v1)
A API de Financeiro tem como objetivo oferecer um conjunto de recursos para gerenciar de forma programática os principais aspectos financeiros de uma empresa, desde a criação de eventos de contas a receber ou pagar, passando pela gestão de contas financeiras, centros de custo, categorias, até a consulta de saldos. Com esta API, sistemas podem integrar de forma fluida com o módulo financeiro da Conta Azul, garantindo que lançamentos, saldos, classificações e relatórios estejam sempre sincronizados.
Se desejar aprofundar o entendimento das regras de negócio aplicadas pelo ERP, recomendamos, de forma opcional a consulta à nossa Central de Ajuda:
Contas a pagar e receber:
https://ajuda.contaazul.com/hc/pt-br/sections/20564397198989-Lan%C3%A7amentos-financeiros-contas-a-receber-e-a-pagar
Cadastro e gestão de contas financeiras:
https://ajuda.contaazul.com/hc/pt-br/sections/20546846147981-Cadastro-e-gest%C3%A3o-de-contas-financeiras
Categorias financeiras e centro de custos:
https://ajuda.contaazul.com/hc/pt-br/sections/28553633338765-Categorias-financeiras-e-centros-de-custo
Breaking change a partir de 18/10/2026. A criação de contas a pagar e a receber deixa de retornar o protocolo: a resposta do
POSTjá traz a conta criada, com oid. As rotas atuais continuam existindo, com o novo retorno, e há novas rotas com o mesmo comportamento.
Novos endpoints (use estes): criam a conta e devolvem o resultado na mesma chamada.
POST /v1/financeiro/contas-a-pagarPOST /v1/financeiro/contas-a-receber
Endpoints atuais, que continuam existindo e passam a devolver a conta criada em vez do protocolo:
POST /v1/financeiro/eventos-financeiros/contas-a-pagarPOST /v1/financeiro/eventos-financeiros/contas-a-receber
Descontinuado em 18/10/2026: GET /v1/protocolo/{id}. A API de Protocolos deixa de existir.
| Até 17/10/2026 | A partir de 18/10/2026 | |
|---|---|---|
| Chamadas para criar e confirmar | 3: POST, GET /v1/protocolo/{id} e GET .../eventos-financeiros/{id_evento}/parcelas | 1: POST |
Resposta do POST | 202 com protocolo e status PENDING | 201 com a conta criada, o id e as parcelas |
| Erros de validação | Só na consulta do protocolo (ERROR) | Na própria resposta do POST, com HTTP 400 |
A sua integração é afetada se cria contas a pagar ou a receber pela API e usa o protocolo retornado na criação ou consulta GET /v1/protocolo/{id}. Se for o seu caso, faça o ajuste até 18/10/2026, quando a API de Protocolos deixa de existir:
- Leia o
iddireto da resposta doPOST, sem guardar nem consultar o protocolo. - Trate os erros na própria resposta do
POST, que passam a voltar com status HTTP 4xx e a mensagem do erro. - Remova as rotinas de espera ou nova tentativa que aguardavam o protocolo sair de
PENDING. - Precisa das parcelas? Elas já vêm em
condicao_pagamento.parcelas, e com oidda conta a consulta de parcelas continua funcionando como hoje.
Dúvidas ou ajuda com o prazo: api@contaazul.com.