Objetivo

Realizar la conciliación automática de cobros utilizando las APIs de bancos en general (ej.: Inter, Itaú, Bradesco, Santander, Banco do Brasil, etc.), y reflejar los pagos en EVO marcando los recibibles como recibidos (pagados).

🚧 Importante: Actualmente no existe integración directa EVO ↔ Banco.
Lo que sí es posible es que el cliente desarrolle una automatización propia que consuma las APIs del banco y, posteriormente, utilice la EVO API para actualizar el estado financiero.

Endpoint Principal (EVO API)

Marks a list of receivables as received (paid)

PUT /api/v1/receivables/mark-received

Endpoints Auxiliares (EVO)

Consultar recibibles (para mapear títulos abiertos)

GET /api/v1/receivables

Consultar cuentas bancarias (para obtener el idBankAccount)

GET /api/v1/bank-accounts

(Opcional) Consultar deudores / morosidad

GET /api/v1/receivables/debtors

Requisitos

Integración del lado del cliente con el banco

El cliente debe consultar en el banco los pagos confirmados mediante APIs bancarias.

Recibibles existentes en EVO

Los títulos deben existir en EVO como cuentas por cobrar.

Mapeo entre Banco ↔ EVO

El cliente necesita una estrategia para identificar qué pago del banco corresponde a qué recibible en EVO (ej.: valor, fecha, pagador, descripción, identificadores, etc.).

idBankAccount

Identificador de la cuenta bancaria en EVO donde se registrará el cobro.

Paso a Paso

1. Consulte las Cuentas Bancarias en EVO

Antes de marcar los pagos, es necesario obtener el idBankAccount que será utilizado para registrar el cobro.

Endpoint:

GET /api/v1/bank-accounts

Elija la cuenta correcta (ej.: “Cuenta Corriente Principal”) y guarde el campo id.

2. Consulte los Recibibles Abiertos en EVO

El siguiente paso es listar los recibibles que aún no han sido pagados, para cruzarlos con los pagos obtenidos desde el banco.

Endpoint:

GET /api/v1/receivables

Filtros recomendados:

Período de vencimiento (dueDateStart, dueDateEnd)

Tipo de pago (paymentTypes)

ID	Tipo de Pago
1	Efectivo
2	Tarjeta de Crédito
3	Tarjeta de Débito
4	Cheque
5	Boleto Bancario
6	PagSeguro
7	Depósito
8	Débito en Cuenta
9	Internet
11	Créditos de Venta
12	Tarjeta de Crédito Online
13	Transferencia
18	Pix
0	Saldo Deudor

Estado del recibible (accountStatus)

1 = Abierto

4 = Atrasado

Consejo: Trabajar con una ventana de fechas (ej.: últimos 7 días) evita consultas muy grandes y facilita la conciliación.

3. Consulte los Pagos Confirmados en el Banco

Del lado del banco, el cliente debe consultar las APIs disponibles para:

Identificar valores recibidos

Obtener fecha/hora del pago

Obtener el valor, pagador e identificadores (cuando existan)

Este paso ocurre fuera de la EVO API, utilizando las APIs oficiales del banco.

4. Realice el Match (Banco ↔ EVO)

El cliente deberá cruzar los datos del banco con los datos retornados en el endpoint GET /receivables.

El objetivo es construir una lista de IDs de EVO:

idReceivable (EVO) ← será utilizado en mark-received

Campos útiles retornados por EVO para realizar el match:

idReceivable

ammount

dueDate

payerName

paymentType

description

authorization (cuando aplique)

🚧 Importante: la EVO API no realiza este match automáticamente.
La conciliación depende de la lógica implementada por el integrador.

5. Marque los Recibibles como Recibidos en EVO

Con los idReceivable identificados, envíe la solicitud para marcar los títulos como pagados.

Parámetros:

Parámetro	Tipo	Obligatorio	Descripción
`idsReceivables`	array<int32>	Sí	Lista de IDs de los recibibles que serán marcados como pagados
`idBankAccount`	int32	Sí	Cuenta bancaria de EVO donde se registrará el cobro

Ejemplo de Solicitud

Preguntas Frecuentes

1. ¿Es posible conectar directamente cualquier banco con EVO vía API?

No.
Actualmente EVO no posee integración directa con bancos.

El flujo recomendado es:

El cliente consume las APIs del banco

Realiza el match de los pagos

Utiliza la EVO API para registrar los cobros

2. ¿Existe algo nativo para tarjeta de crédito?

Para pagos con tarjeta, EVO se integra con algunos gateways de pago, que actúan como puente entre EVO y el ecosistema de adquirencia/bancos.

🚧 EVO no se comunica directamente con adquirentes ni bancos para pagos con tarjeta.

3. ¿Qué sucede si marco un recibible incorrectamente como pagado?

El recibible será actualizado en EVO como recibido, impactando:

financiero

estado de cobranza

reportes

Por lo tanto, el proceso de match debe realizarse con cuidado.

Resultado Esperado

Después de ejecutar el flujo:

Los pagos identificados en el banco serán reflejados en EVO

Los títulos correspondientes serán marcados como Recibidos

El financiero quedará consistente con el extracto bancario (siempre que el match se haya realizado correctamente)

Conciliación de pagos bancarios

Objetivo#

Endpoint Principal (EVO API)#

Endpoints Auxiliares (EVO)#

Consultar recibibles (para mapear títulos abiertos)#

Consultar cuentas bancarias (para obtener el idBankAccount)#

(Opcional) Consultar deudores / morosidad#

Requisitos#

Paso a Paso#

1. Consulte las Cuentas Bancarias en EVO#

2. Consulte los Recibibles Abiertos en EVO#

3. Consulte los Pagos Confirmados en el Banco#

4. Realice el Match (Banco ↔ EVO)#

5. Marque los Recibibles como Recibidos en EVO#

Ejemplo de Solicitud#

Preguntas Frecuentes#

1. ¿Es posible conectar directamente cualquier banco con EVO vía API?#

2. ¿Existe algo nativo para tarjeta de crédito?#

3. ¿Qué sucede si marco un recibible incorrectamente como pagado?#

Resultado Esperado#