PrestaCOP integración API y servicios OpenData

API de cartera de préstamos

Exportación de solo lectura de cada préstamo activo y cerrado: capital, calendario de intereses, frecuencia de cuota (diaria, semanal, esquemas tipo "gota a gota"), plan de pagos y saldo restante. Diseñada para que la oficina central concilie cada ruta de cobrador independiente en una vista consolidada de la cartera total.

Maestro de clientes

Cédula, contacto, dirección, geolocalización, notas KYC y bandera de mal cliente reportado. Sirve para cruzar nuevos solicitantes contra listas negras compartidas y para deduplicar entre sucursales que antes llevaban registros en papel.

Libro de cobradores y rutas

Resumen diario por cobrador: recibos cobrados, gastos, nuevos préstamos otorgados, pagos procesados y la traza GPS mientras el rastreo está activo. Alimenta cálculo de comisiones, analítica de cobertura de ruta y detección de fraude en campo.

Sincronización de recibos y tickets

Los recibos que PrestaCOP normalmente imprime o comparte por WhatsApp se transmiten como eventos estructurados (monto, cliente, cobrador, marca de tiempo, método) hacia tu plataforma contable — sin reescribir tickets en papel.

Balances y rentabilidad

Vistas de rentabilidad diarias, semanales y mensuales derivadas de préstamos otorgados, capital recuperado y gastos operativos. Expuestas tanto en filas crudas como en KPIs preagregados para herramientas de BI (Power BI, Looker Studio, Metabase).

Webhooks y eventos en tiempo real

Notificaciones tipo push para nuevo pago recibido, préstamo desembolsado, cobrador iniciando o cerrando ruta y alerta de validación de cédula reportada. Permite que un tablero de control muestre los movimientos en vivo, replicando la función "ver todos los movimientos" de la app.

1. Conciliación diaria de cartera contra el ERP

Contexto: Una financiera regional opera cinco rutas de cobranza con PrestaCOP y registra los resultados en un ERP externo. Datos involucrados: la API de cartera (saldos pendientes), el endpoint de resumen diario y el libro de pagos. Mapeo OpenData: se expone como un feed normalizado de "cuenta de préstamo + transacciones" similar a las respuestas de extracto de OpenBanking, de modo que el ERP trate cada ruta como si fuera una cuenta bancaria.

2. Tablero de supervisión de cobradores en campo

Contexto: Un operador de microfinanzas quiere visibilidad en vivo de la ubicación de cada cobrador y de cuánto se ha recibido en tiempo real. Datos involucrados: libro de cobradores + muestras GPS + eventos por webhook. Mapeo OpenFinance: el feed en vivo se vuelve un flujo de "notificación de transacción", similar a un webhook de pago de comercio, pero acotado a cobranzas en efectivo en campo.

3. Compartir riesgo de mal cliente entre empresas

Contexto: Dos prestamistas que cooperan quieren saber cuándo cualquiera reporta a un cliente moroso. Datos involucrados: reportes de mal cliente + eventos de validación de certificados. Mapeo de cumplimiento: se expone únicamente bajo acuerdos explícitos entre responsables del tratamiento, respetando el régimen de Habeas Data Financiero (Ley 1266 de 2008), dado que se trata de información crediticia negativa.

4. BI y analítica de rentabilidad

Contexto: Una oficina central corre tableros de rentabilidad en Metabase. Datos involucrados: balances + recibos + gastos de cobradores + resumen del día. Mapeo OpenData: los datos se materializan en un pequeño data warehouse (Postgres / BigQuery) con un esquema estable, de modo que los reportes sigan siendo válidos aunque cambien las pantallas internas de PrestaCOP.

5. Migración o doble operación con otra plataforma de préstamos

Contexto: Un operador está migrando de PrestaCOP a una plataforma mayor como LoanPro, Nortridge o HES LoanBox y quiere correr en paralelo durante un trimestre. Datos involucrados: endpoint de snapshot de respaldo en la nube + maestros de préstamo y de cliente. Patrón de integración: feed nocturno de diferencias enviado a la API de ingesta de la plataforma destino, con un reporte de conciliación cada mañana.

Autorizar y refrescar sesión

POST /api/v1/prestacop/auth/login
Content-Type: application/json

{
  "tenant_id": "ancorp-co-route-07",
  "operator_email": "office@example-co",
  "operator_password": "<stored secret>",
  "device_fingerprint": "srv-edge-01"
}

200 OK
{
  "access_token": "<jwt>",
  "refresh_token": "<jwt>",
  "expires_in": 3600,
  "scopes": ["portfolio.read", "payments.read", "collectors.read"]
}

Obtener el extracto diario de la cartera

POST /api/v1/prestacop/portfolio/statement
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "route_id": "route-07",
  "from_date": "2026-04-21",
  "to_date":   "2026-04-27",
  "include":   ["loans", "payments", "expenses"]
}

200 OK
{
  "route_id": "route-07",
  "loans":    [ /* loan_id, customer_id, principal, balance, status */ ],
  "payments": [ /* payment_id, loan_id, amount, method, collector_id, ts */ ],
  "expenses": [ /* expense_id, collector_id, category, amount, ts */ ],
  "page":     { "next_cursor": null }
}

Webhook en tiempo real al recibir un pago

POST https://your-host.example/webhooks/prestacop
X-PrestaCOP-Signature: sha256=...
Content-Type: application/json

{
  "event": "payment.received",
  "occurred_at": "2026-04-28T15:42:11-05:00",
  "route_id": "route-07",
  "collector_id": "col-014",
  "loan_id": "loan-9931",
  "amount": 25000,
  "currency": "COP",
  "method": "cash",
  "geo": { "lat": 4.6533, "lng": -74.0836 }
}

// Recomendado: verificar HMAC, deduplicar por event_id,
// reintentar con backoff exponencial en 5xx; 4xx es definitivo.

Lista de entregables

• Especificación de API (OpenAPI 3.1 / Swagger), una ruta por dominio de datos
• Reporte de protocolo y flujo de autenticación (cadena de tokens, refresco, firma)
• Código fuente ejecutable (clientes de referencia en Python y Node.js) para cartera, pagos, cobradores y webhooks
• Pruebas automatizadas (respuestas golden-file, verificación de firma, lógica de reintento)
• Pack de cumplimiento Habeas Data: mapa de flujo de datos, matriz de retención, esquema de registro de consentimiento

Modelos de contratación

Entrega de código fuente desde 300 USD — código de API ejecutable más documentación; pago únicamente tras la entrega y aceptación.

API administrada con pago por llamada — conéctate a nuestro endpoint gestionado y paga por solicitud, sin pago inicial. Pensado para equipos que prefieren precio por uso o no quieren hospedar la integración por su cuenta.

Sobre nosotros

Somos un estudio técnico independiente enfocado en integración de interfaces de aplicaciones y entrega de APIs autorizadas. Nuestro equipo viene de back-office de microfinanzas, ingeniería inversa móvil, integración de pasarelas de pago y plataformas cloud, y hemos entregado integraciones en Latinoamérica, Sudeste Asiático y EMEA.

• Microfinanzas, cobro a domicilio, banca digital y pagos transfronterizos
• Análisis de protocolo autorizado, diseño de especificación OpenAPI y entrega de SDK
• Código de referencia en Python / Node.js / Go con harness de pruebas
• Entrega de código fuente desde 300 USD — código ejecutable y documentación completa, pago tras aceptación
• Facturación API por llamada — precio por uso en nuestros endpoints administrados, sin pago inicial

Contacto

Cuéntanos cuál es la app objetivo y qué datos o escenario necesitas. Responderemos con una propuesta acotada, payloads de ejemplo y un cronograma de entrega.

Abrir página de contacto

Flujo de trabajo

1. Confirmación de alcance: qué dominios de datos y escenarios de PrestaCOP entran (cartera, pagos, cobradores, webhooks).
2. Análisis de protocolo y diseño de la API (2 a 5 días hábiles, según complejidad).
3. Construcción y validación interna contra un tenant de pruebas (3 a 8 días hábiles).
4. Documentación, clientes de ejemplo y casos de prueba (1 a 2 días hábiles).
5. Primera entrega típica: 5 a 15 días hábiles; los tiempos de autorización del respaldo en la nube pueden extender el cronograma.

FAQ

¿Qué necesitan de mí para empezar?

¿Cómo manejan el cumplimiento del Habeas Data colombiano?

¿El código fuente de la integración queda para mí?