A conciliação de extrato bancário é o processo de comparar os lançamentos financeiros registrados pela empresa com as movimentações reais do banco, verificando se tudo está correto e alinhado. Essa integração entre sistema interno e extrato bancário garante que entradas e saídas de dinheiro estejam devidamente registradas, evitando erros, fraudes e inconsistências. Para empresas, isso é essencial: melhora o controle do fluxo de caixa, facilita auditorias, reduz retrabalho e aumenta a confiabilidade das informações financeiras. É um passo básico, mas estratégico, para uma gestão financeira eficiente.
Este guia tem como objetivo auxiliar na conciliação bancária automatizada utilizando as APIs disponibilizadas pelo BTG Empresas, permitindo identificar e classificar transações de entrada e saída nas contas da empresa.
APIs utilizadas na conciliação
Criação de Cobrança (Boletos, Boleto Híbrido e PIX)
Criar Cobrança - Utilizado para emitir boletos, boleto híbrido e cobranças do tipo PIX.
Criação de iniciação de pagamentos
Criar iniciação de pagamento ou transferência - Utilizado para iniciar pagamentos diretamente via integração.
Consulta de extrato bancário
Consultar extrato de uma conta específica - Retorna todas as transações (créditos e débitos) da conta.
Identificação das transações no extrato
Cada transação no extrato possui atributos que permitem a conciliação com os dados operacionais.
{
"type": "credit | debit",
"descriptionDetails": "Utilize esse campo para conciliar seus pagamentos.",
"endToEndId": "Utilize esse campo para conciliar suas cobranças ou pagamentos do tipo PIX.",
"details": {
"barCode": "Utilize esse campo para conciliar suas cobranças do tipo boleto."
}
}| Tipo | Campo | Como conciliar |
|---|---|---|
| Boletos | details.barCode | Compare com o código de barras dos boletos emitidos via API de Cobranças |
| PIX | endToEndId | Compare com o endToEndId retornado nas APIs de cobranças ou Pagamento |
| Pagamentos | descriptionDetails | Utilize o valor informado no campo internalDescription, informado durante a criação do pagamento para identificar e categorizar a transação no extrato. |
Recuperação dos dados
A recuperação dos dados listados acima para a realização da conciliação pode ser realizados por meio da listagem em suas respectivas APIs:
- Boletos: Listar cobranças
- PIX: Listar cobranças ou Listar um pagamento ou transferência específico
- Pagamentos: Listar um pagamento ou transferência específico
Ou então pode-se utilizar os envios de webhook, que sempre conterão as informações necessárias para a realização da conciliação:
- Boletos: Eventos de webhook de cobrança
- PIX: Eventos de webhook de cobrança ou Eventos de webhook de pagamentos
- Pagamentos: Eventos de webhook de pagamentos