API de Diligencia de Proveedores

Compras y gestión de proveedores homologan a un proveedor una vez y rara vez vuelven a comprobarlo. Prometiam cubre todo el ciclo — resolver, verificar, cribar y vigilar — para proveedores registrados en España, Francia, Reino Unido, Irlanda, Polonia y Noruega, desde una sola API REST y una sola clave.

El patrón

Cinco pasos, ejecutados sobre todo el maestro de proveedores en lugar de fila a fila. Resuelva un lote de proveedores con POST /companies/lookup (hasta 100 elementos, por company_number, NIF, SIREN, número de IVA o un nombre difuso con match_score). Obtenga cada ficha con GET /companies/{id}?include=risk_flags,insolvency,lei para el estado registral, dissolution_date, administradores donde el registro los recoja, el aviso de grandes deudores de la AEAT solo en España, y cualquier LEI. Críbelo a él y a sus administradores con POST /sanctions/screen (hasta 50 nombres, alcance de plan Professional, beta). Compruebe la insolvencia: para proveedores españoles, los anuncios concursales están en GET /search; para los otros nueve mercados con cobertura de insolvencia societaria, POST /insolvency/check cubre hasta 100 elementos por llamada. Y siga vigilando: POST /monitor envía un webhook firmado para España, Irlanda y Polonia, y un barrido diario con GET /company-events/search cubre España, Francia y Reino Unido.

Qué no cubre

Irlanda y Polonia son a nivel de empresa, así que no hay administradores que cribar ni anuncios de insolvencia que comprobar para un proveedor registrado allí. Noruega no tiene flujo de eventos societarios. La titularidad real es solo el registro británico de Personas con Control Significativo — el resto de registros devuelve administradores y consejeros, no titulares reales. El cribado de sanciones es beta. Prometiam no devuelve una puntuación de crédito, estados financieros, datos ESG, ni historial de contratación pública, y no es asesoramiento legal sobre si una comprobación satisface la Directiva europea de diligencia debida en sostenibilidad corporativa (CSDDD) o su propia política de riesgo de terceros — aporta las comprobaciones de identidad, estado, sanciones e insolvencia que esa política suele pedir.

Ajuste de precio

POST /companies/lookup, GET /companies/{id} y POST /insolvency/check corren en el mismo alcance base que una búsqueda de empresas, así que un maestro de 2.000 proveedores es 2.000 + 2.000 + 2.000 = 6.000 solicitudes dentro del plan Starter (9,99 €/mes, 10.000 llamadas) por sí solo. El cribado de sanciones necesita el plan Professional (29,99 €/mes, 100.000 llamadas) sea cual sea el tamaño del maestro — es el único paso limitado por alcance en lugar de volumen, y donde se activa el cribado completo de sanciones y control de exportaciones. Cada elemento de un lote cuenta como una solicitud; un lote mayor que lo que queda en el plan se rechaza de antemano con 429 batch_exceeds_quota y max_items_now.

Leer más · Conseguir una clave API gratis

Límites de alcance, dicho con claridad

País Administradores a cribar Anuncios de insolvencia Webhook Barrido diario
EspañaSíSí — concursal, GET /searchSíSí
FranciaSíSí — POST /insolvency/checkNoSí
Reino UnidoSíSí — POST /insolvency/checkNoSí
IrlandaNo — a nivel de empresaSin cobertura todavíaSíNo
PoloniaNo — a nivel de empresaSin cobertura todavíaSíNo
NoruegaSíSí — POST /insolvency/checkNoNo — sin flujo de eventos

Frequently asked questions

¿Qué se entiende por diligencia debida de un proveedor?
Como mínimo: confirmar que la entidad existe y está activa, cribar su razón social y sus administradores donde el registro los recoja contra las listas de sanciones, y comprobar si hay anuncios de insolvencia societaria. La Directiva europea de diligencia debida en sostenibilidad corporativa (CSDDD) y la mayoría de políticas internas de riesgo de terceros piden esa misma base. Prometiam no es asesoramiento legal sobre si una relación concreta cumple una u otra — aporta las comprobaciones de identidad, estado, sanciones e insolvencia que el expediente necesita para mostrar que se hicieron.
¿Puedo ejecutar esto contra varios miles de proveedores a la vez?
Sí. POST /companies/lookup y POST /insolvency/check admiten hasta 100 elementos por llamada, y POST /sanctions/screen hasta 50 nombres. Cada elemento cuenta como una solicitud dentro de su plan. Un lote mayor que lo que queda en el plan se rechaza de antemano con 429 batch_exceeds_quota, y max_items_now en la respuesta indica cuántos caben ahora mismo. El cribado de sanciones necesita además el alcance del plan Professional; los otros tres endpoints por lotes funcionan en cualquier plan.
¿Esto cubre la titularidad real, no solo los administradores?
Solo para el Reino Unido, a través del registro de Personas con Control Significativo (PSC) en la ficha de la empresa. España, Francia, Reino Unido y Noruega devuelven administradores y consejeros, pero un administrador no es un titular real. Irlanda y Polonia son a nivel de empresa: sin administradores todavía, para ninguna de las dos cosas. Si el proveedor tiene un identificador LEI, GET /lei/{lei}/relationships añade el padre directo y el último de GLEIF Nivel 2.
¿Qué países tienen realmente cobertura de insolvencia para un proveedor?
Los anuncios concursales de España están en GET /search. Francia, Reino Unido y Noruega tienen cobertura societaria a través de POST /insolvency/check, junto con otros seis mercados donde Prometiam no tiene registro mercantil: Alemania, Austria, Suiza, Finlandia, Estados Unidos y Países Bajos. Irlanda y Polonia no tienen cobertura de anuncios de insolvencia en ninguno de los dos endpoints todavía.
¿Cómo sigo vigilando a un proveedor tras el alta?
Dos formas. POST /monitor da de alta una empresa y envía un webhook firmado ante cambios de estado, disolución y nuevas coincidencias en sanciones, para España, Irlanda y Polonia. Para España, Francia y Reino Unido, un barrido diario con GET /company-events/search sobre su propio maestro de proveedores recoge capital_change, director_change, dissolution y el resto. Noruega no tiene flujo de eventos societarios, así que un proveedor noruego se vigila repitiendo el resolver y el cribado en un calendario.