Cómo comprobar por API los nombres de clientes, proveedores y socios contra las listas de sanciones internacionales, junto con la verificación del NIT, y una descripción franca de lo que esta consulta no es: no reemplaza el SARLAFT ni el SAGRILAFT de su empresa.
En Colombia se llama «listas restrictivas» a las listas de personas y entidades sancionadas o vinculadas con el lavado de activos y la financiación del terrorismo. Los equipos de cumplimiento las consultan cuando vinculan a un cliente o a un proveedor y, después, de forma periódica, como parte del sistema de gestión de riesgo de la empresa (SARLAFT, o SAGRILAFT en las sociedades que lo aplican). La consulta se repite muchas veces, y por eso conviene poder automatizarla.
Esta guía explica qué parte de esa consulta cubre la API de Prometiam y cuál no. El cribado de sanciones de la API está en beta.
Varias de las listas internacionales son públicas y gratuitas: la OFAC, la ONU y la Unión Europea publican las suyas en sus sitios. Para comprobar un nombre aislado basta con buscarlo allí. La API es útil cuando hay muchos nombres, cuando la comprobación debe repetirse cada día o cuando el resultado tiene que quedar registrado en el expediente de la contraparte.
No incluye listas nacionales colombianas, como las que publican la Procuraduría, la Contraloría o la Policía Nacional. Si su política las exige, deben consultarse por separado en la fuente.
El flujo habitual es buscar la sociedad por NIT en el registro mercantil y cribar su razón social, y los nombres de las personas que usted ya conozca, en una sola llamada POST /sanctions/screen. Admite hasta 50 nombres por llamada.
curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=CO&company_number=900843898-9' \ -H 'Authorization: Bearer rk_live_...'
curl -X POST 'https://api.prometiam.com/functions/v1/risk-api/sanctions/screen' \
-H 'Authorization: Bearer rk_live_...' \
-H 'Content-Type: application/json' \
-d '{"names": ["RAPPI S.A.S."], "threshold": 85}'
La respuesta trae un resultado por nombre, en el orden de la solicitud, dentro de data:
{
"data": [
{ "index": 0, "input": { "name": "RAPPI S.A.S." },
"status": "clear", "hits": [], "best_match_score": null }
],
"meta": { "items": 1, "matches": 0, "clear": 1, "errors": 0, "threshold": "85" }
}
clear significa que ningún nombre de las listas activas coincide por encima del umbral que usted fijó; no es una certificación de que la persona o la sociedad no esté sancionada. Cuando hay coincidencias, hits trae la lista, el nombre listado y una puntuación de parecido, para que una persona de su equipo decida. Un umbral más bajo devuelve más coincidencias y más falsos positivos: la decisión sobre el umbral es de su función de cumplimiento.
Cribar un nombre cuesta 3 créditos. El cribado por lotes y completo está en el plan Professional (€ 29,99 al mes, 10.000 créditos); la prueba gratuita de 14 días, con 500 créditos, incluye además 25 llamadas de cribado al mes, nombre por nombre. Se requiere una tarjeta, pero no se cobra nada durante la prueba. Consultar el NIT cuesta 1 crédito. Los precios son públicos.
Contains data from Confecámaras (Registro Único Empresarial y Social, RUES), via the Portal de Datos Abiertos www.datos.gov.co, licensed CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/). Modified by Prometiam; the Colombian records are offered under CC BY-SA 4.0. Los registros colombianos se ofrecen bajo la licencia CC BY-SA 4.0 (con compartir igual): puede copiarlos, reutilizarlos y redistribuirlos, también con fines comerciales, citando la fuente y manteniendo la misma licencia.
Empezar la prueba gratuita de 14 días · Documentación de la API
La prueba dura 14 días e incluye 500 créditos. Se requiere una tarjeta; durante la prueba no se cobra nada y después se aplica el plan Starter (9,99 € al mes), salvo que cancele.