Skip to main content
Atualização de Setembro de 2026 A versão 3.1.10 traz a conciliação bancária pela API pública: importação de extratos, consulta das movimentações e conciliação com contas a pagar e a receber, sem precisar abrir a tela de conciliação.

Novas Funcionalidades

Extrato Bancário

Foram adicionados novos endpoints para gerenciar os extratos bancários importados. Com esses endpoints, é possível:
  • GET /extratos-bancarios - Listar extratos importados com paginação e filtros
    • Filtros disponíveis: nome do arquivo, data inicial, data final, conta financeira
  • GET /extratos-bancarios/{idExtratoBancario} - Obter os detalhes de um extrato e suas movimentações
    • Cada movimentação informa a situação (pendente, ignorado, adicionado ao caixa ou vinculado a duplicata) e o lançamento de caixa conciliado, quando existir
  • POST /extratos-bancarios - Importar um arquivo de extrato bancário (OFX ou XML) em uma conta financeira
    • Arquivo enviado como multipart/form-data
    • Retorna o ID do extrato criado
  • DELETE /extratos-bancarios/{idExtratoBancario} - Excluir um extrato importado e todas as suas movimentações
    • A exclusão não estorna conciliações já realizadas

Conciliação das Movimentações

  • POST /extratos-bancarios/{idExtratoBancario}/movimentacoes/{idMovimentacao}/vinculo-conta - Conciliar uma movimentação com uma ou mais contas a pagar ou a receber, baixando as contas
    • Suporta baixa parcial e os campos valor, juros, desconto, acréscimo e taxa
  • POST /extratos-bancarios/{idExtratoBancario}/movimentacoes/{idMovimentacao}/lancamento - Transformar uma movimentação em lançamento no caixa
    • Suporta categoria, contato e histórico
  • POST /extratos-bancarios/{idExtratoBancario}/movimentacoes/{idMovimentacao}/ignorar - Ignorar uma movimentação que não precisa de conciliação
  • POST /extratos-bancarios/{idExtratoBancario}/movimentacoes/{idMovimentacao}/desfazer-ignorar - Desfazer a ignoração de uma movimentação
  • POST /extratos-bancarios/{idExtratoBancario}/movimentacoes/{idMovimentacao}/estornar - Estornar o tratamento de uma movimentação, voltando ela a ficar pendente

Permissões

Os endpoints de extrato bancário exigem as novas permissões de extrato bancário (leitura, escrita e exclusão) liberadas no gerenciamento de acessos do usuário da API.