Cuando un cliente empresa te pide pagar a 30 o 60 días, le estás financiando. La API devuelve los hechos registrales con los que decide un departamento de riesgos: si la empresa existe y está activa, su antigüedad, si consta en concurso, si figura en la lista de deudores de Hacienda y si el Registro le ha cerrado la hoja. Después la vigila por ti. Hechos, no una puntuación.
Mayoristas, distribuidores, fabricantes, empresas de factoring y de pago aplazado se hacen las mismas preguntas antes de dar plazo. Cada una tiene su llamada, su precio en créditos y su cobertura:
| Pregunta | Llamada | Créditos | Cobertura |
|---|---|---|---|
| ¿Existe y sigue activa? | GET /companies/search?country=ES&nif=…: status, local_status, founding_date | 1 | Las sociedades inscritas en el Registro Mercantil (y el resto de países de la API) |
| ¿Consta en concurso? | GET /companies/{id}?include=insolvency,risk_flags: insolvency_proceedings | 1 | Declaración de concurso, apertura de la fase de liquidación y conclusión, inscritas en el BORME desde 2009 |
| ¿Figura en la lista de deudores de Hacienda? | La misma llamada: risk_flags | — | El listado de la AEAT del artículo 95 bis LGT (deudas de más de 600.000 €) |
| ¿Le han cerrado la hoja registral? | La misma llamada: la marca registry_compliance | — | España, y también Reino Unido, Irlanda y Noruega |
| ¿Qué dicen sus cuentas? | GET /companies/{id}/financials | 25 | En España, solo sociedades cotizadas |
| ¿Está en una lista de sanciones? | GET /sanctions/screen (beta) | 3 | Listas de la UE, la ONU, la OFAC, el Reino Unido y Francia |
Dos matices que conviene saber antes de construir encima. El listado de deudores recoge los saldos a 31 de diciembre del año anterior y se publica unos seis meses después: es un dato a una fecha, y no figurar en él no significa no deber nada (guía del listado). Y las cuentas anuales de las sociedades no cotizadas se depositan en el Registro Mercantil y no forman parte de la API: de las españolas solo servimos los informes financieros anuales de las cotizadas, que la CNMV pone a disposición de forma gratuita en su web.
Una ficha de riesgo con dos llamadas, 2 créditos en total. Guarda la respuesta con su fecha: una decisión de crédito tiene que poder explicar qué se sabía el día que se tomó.
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
def ficha_riesgo(nif):
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'ES', 'nif': nif})
r.raise_for_status()
hits = r.json()['data']
if not hits:
return {'nif': nif, 'decision': 'revisar', 'motivo': 'no consta en el registro'}
e = requests.get(f"{BASE}/companies/{hits[0]['id']}", headers=H,
params={'include': 'insolvency,risk_flags'}).json()['data']
return {
'nombre': e['company_name'],
'estado': e['status'], # active, in_liquidation, deregistered...
'constitucion': e['founding_date'],
'concursos': e['insolvency_proceedings'], # [] si no consta ninguno
'marcas': e['risk_flags'], # deudor AEAT, hoja cerrada...
}
print(ficha_riesgo('A46103834'))
Para toda la cartera, resuelve antes los NIF con POST /companies/lookup (100 por llamada) y pasa los concursos de los 15 mercados con POST /insolvency/check, también de 100 en 100 y a 2 créditos por empresa. Un lote que supera lo que te queda de cuota se rechaza entero antes de empezar, nunca a medias.
Un límite vale lo que valen los datos del día en que se fijó. Suscribe a los clientes a los que das plazo con POST /monitor y recibirás un aviso con cada acto inscrito en el BORME (nombramientos y ceses, ampliaciones de capital, cambios de domicilio, disolución, declaración de concurso) y con cada cambio de estado. La monitorización no consume créditos: el periodo de prueba vigila 3 empresas, Starter 25, Professional 250 y Scale 2.500. Los avisos se leen siempre en GET /monitor; el envío a un webhook empieza en Professional.
curl -X POST 'https://api.prometiam.com/functions/v1/risk-api/monitor' \
-H 'Authorization: Bearer rk_live_...' \
-H 'Content-Type: application/json' \
-d '{"company_id": 34393, "label": "cliente-4711"}'
La declaración de concurso cambia el cobro: frena las ejecuciones individuales y abre el plazo para comunicar tu crédito a la administración concursal, el que fija el auto, por regla general un mes desde su publicación en el BOE. Ojo con un detalle: nuestros avisos españoles salen de la inscripción en el BORME, que llega de media unas diez semanas después de la resolución del juzgado, y a veces más de un año. Para el plazo de comunicación no esperes al BORME: en cuanto sepas del concurso, consulta el edicto en el BOE. Cada aviso trae la fecha de la resolución, la del BORME y el enlace a la publicación.
La ficha de un cliente español cuesta 2 créditos (búsqueda y ficha con concursos y marcas); con el cribado de sanciones, 5. Los errores no cuestan nada. Starter cuesta 9,99 € al mes con 1.000 créditos, Professional 29,99 € con 10.000 y Scale 99,99 € con 50.000, que incluye los estados financieros (10 llamadas al mes en los demás planes y en la prueba). La prueba gratuita dura 14 días con 500 créditos: se pide una tarjeta y no se cobra nada durante la prueba.
Based on data from the Agencia Estatal Boletín Oficial del Estado (BORME). Contains CVR data (Erhvervsstyrelsen), CC BY 4.0.
Empieza tu prueba gratuita de 14 días · Documentación de la API
La prueba dura 14 días e incluye 500 créditos. Se pide una tarjeta, pero no se cobra nada durante la prueba; después sigue el plan Starter (9,99 € al mes) salvo que la canceles.