Guía de conciliación
La conciliación de extracto bancario es el proceso de comparar los movimientos financieros registrados por la empresa con las operaciones reales del banco, verificando que todo sea correcto y coherente. Esta integración entre el sistema interno y el extracto bancario garantiza que las entradas y salidas de dinero estén debidamente registradas, evitando errores, fraudes e inconsistencias. Para las empresas, esto es esencial: mejora el control del flujo de caja, facilita auditorías, reduce el retrabajo y aumenta la confiabilidad de la información financiera. Es un paso básico, pero estratégico, para una gestión financiera eficiente.
Esta guía tiene como objetivo asistir en la conciliación bancaria automatizada utilizando las APIs proporcionadas por BTG Empresas, permitiendo identificar y clasificar transacciones de entrada y salida en las cuentas de la empresa.
APIs utilizadas en la conciliación
Creación de Cobranza (Boletos, Boleto Híbrido y PIX)
Crear Cobranza - Utilizado para emitir boletos, boleto híbrido y cobros del tipo PIX.
Creación de iniciación de pagos
Crear iniciación de pago o transferencia - Utilizado para iniciar pagos directamente vía integración.
Consulta de extracto bancario
Consultar extracto de una cuenta específica - Retorna todas las transacciones (créditos y débitos) de la cuenta.
Identificación de las transacciones en el extracto
Cada transacción en el extracto posee atributos que permiten la conciliación con los datos operacionales.
{
"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 | Cómo conciliar |
|---|---|---|
| Boletos | details.barcode/details.ourNumber | Compare con el código de barras o ourNumber de los boletos emitidos vía API de Cobranzas |
| PIX | endToEndId | Compare con el endToEndId retornado en las APIs de cobranzas o Pago |
| Pagamentos | descriptionDetails | Utilice el valor informado en el campo internalDescription, informado durante la creación del pago para identificar y categorizar la transacción en el extracto. |
| Boleto híbrido | txId ou details.barcode/details.ourNumber | En el caso de boleto híbrido pagado mediante QR Code utilice el txId. En el caso de pago vía barcode, utilice barcode/ourNumber |
Recuperación de los datos
La recuperación de los datos listados anteriormente para la realización de la conciliación puede efectuarse mediante la consulta en sus respectivas APIs:
- Boletos: Listar cobranzas
- PIX: Listar cobranzas o Listar un pago o transferencia específico
- Pagos: Listar un pago o transferencia específico
O bien se puede utilizar los envíos de webhook, que siempre contendrán la información necesaria para la realización de la conciliación:
- Boletos: Eventos de webhook de cobranza
- PIX: Eventos de webhook de cobranza o Eventos de webhook de pagos
- Pagos: Eventos de webhook de pagos