Regístrate

Caso de uso · Riesgo del comprador público

API de riesgo del comprador público

Dos puntuaciones beta sobre el órgano de contratación, no sobre el proveedor ni sobre una licitación concreta: competencia y contraparte, con las adjudicaciones que las sustentan. España y Francia.

Publicado el 19 de septiembre de 2026 · This page in English

El problema

Un licitador que evalúa a qué órganos de contratación merece la pena presentarse necesita algo más que el histórico de adjudicaciones: necesita saber si ese comprador concentra sus contratos en un incumbente, si sus procedimientos suelen cerrarse con una sola oferta o si sus proveedores tienden a fallar. Un equipo que financia facturas al sector público — factoring o confirming sobre cobros pendientes de la administración — tiene la pregunta inversa: qué compradores tienen bases de proveedores frágiles, y cuánto depende un proveedor concreto de un único organismo. Un equipo de auditoría o integridad necesita cribar una cartera entera de compradores y abrir solo los casos que merecen revisión manual.

La API de Prometiam calcula dos puntuaciones calibradas sobre cada órgano de contratación español o francés con historial suficiente, y expone las adjudicaciones concretas detrás de cada una para que la revisión sea verificable, no una caja negra.

Lo que hay que tener claro antes de usar esto

Las puntuaciones describen al ÓRGANO DE CONTRATACIÓN — el comprador — nunca a un proveedor ni a una licitación individual. Hay dos modelos independientes. competition es la probabilidad de que la próxima adjudicación del comprador reciba una sola oferta, comparada con lo que atraen licitaciones comparables. counterparty es la probabilidad de que un proveedor al que ese comprador adjudica entre en concurso de acreedores en los 24 meses siguientes: es una señal débil, en torno al doble de la tasa base en lo alto del rango, y conviene leerla siempre junto con las adjudicaciones de evidencia, no de forma aislada.

Cada bloque de riesgo trae score (una escalera de 1 a 10 sobre el log-odds de la probabilidad: 1 es el percentil 1 de los compradores puntuados del país, 10 el percentil 99, con anclas fijas), probability (la tasa calibrada del comprador para su próxima adjudicación: su recuento observado contraído hacia la expectativa del modelo con un prior de 30 adjudicaciones, calibrado fuera de muestra), base_rate, relative_risk (probability dividido entre base_rate), percentile del residuo frente a sus pares, observed_rate, expected_rate, awards_scored y confidence. Un comprador se puntúa solo a partir de 20 adjudicaciones en el periodo.

Los endpoints

GET /procurement/buyers lista órganos de contratación puntuados, ordenados por uno de los dos modelos, con country, model (competition o counterparty), min_score, name, region, limit y cursor para paginación por keyset. Cada fila trae el comprador, su cobertura y ambos bloques de riesgo. El perfil completo — comportamiento, adjudicaciones de evidencia y los cinco mayores proveedores — está en GET /procurement/buyer/{id}, con id el identificador nacional del comprador (código DIR3 o NIF en España, SIRET en Francia) y country ES o FR.

# Compradores españoles con score de competencia alto o superior
curl "https://api.prometiam.com/functions/v1/risk-api/procurement/buyers?country=ES&model=competition&min_score=8&limit=20" \
  -H "Authorization: Bearer rk_live_..."

A partir de un comprador de la lista se abre su perfil completo y, si hace falta, la relación con uno de sus cinco mayores proveedores:

# 1. Perfil completo del comprador
curl "https://api.prometiam.com/functions/v1/risk-api/procurement/buyer/LA0014114?country=ES" \
  -H "Authorization: Bearer rk_live_..."

# 2. Dependencia mutua entre ese comprador y uno de sus mayores proveedores
curl "https://api.prometiam.com/functions/v1/risk-api/procurement/relationship?country=ES&buyer=EA0008424&supplier=B64892839" \
  -H "Authorization: Bearer rk_live_..."

El perfil de un comprador trae buyer, as_of, coverage (adjudicaciones, contratos, proveedores distintos, primera y última adjudicación, valor adjudicado, topes de acuerdo marco), risk con los dos bloques (competition y counterparty), behaviour (cuota de oferta única, cuota de adjudicación directa, cuota de acuerdo marco, cuota de modificación, cuota con número de ofertas publicado, cuota de valor del mayor proveedor, HHI de proveedores, media de ofertas), evidence (hasta tres adjudicaciones concretas) y top_suppliers (sus cinco mayores proveedores). GET /procurement/relationship devuelve, para un par comprador-proveedor, sus adjudicaciones conjuntas, el valor adjudicado, la cuota del proveedor sobre el total del comprador, primera y última adjudicación, ofertas y — cuando el proveedor entró en concurso — su fecha.

Tres casos de uso

Decidir si licitar. Antes de dedicar tiempo y recursos a preparar una oferta, un licitador puede consultar el perfil del órgano de contratación: su cuota histórica de oferta única y el peso del proveedor incumbente en top_suppliers indican si ese comprador tiende a repetir con el mismo proveedor o si las licitaciones están realmente abiertas.

Financiación de facturas al sector público. Un proveedor de factoring o confirming sobre cobros pendientes de la administración necesita saber qué órganos de contratación tienen bases de proveedores que fallan con más frecuencia de lo esperado, y cuánto depende un proveedor concreto de un único comprador. El score de contraparte da lo primero; GET /procurement/relationship da lo segundo, con la cuota del proveedor sobre el valor total adjudicado por ese comprador.

Auditoría e integridad. Un equipo de control interno puede cribar una cartera entera de compradores con GET /procurement/buyers?min_score=8 y abrir después, uno a uno, solo los casos con score alto, usando las adjudicaciones de evidence como punto de partida de la revisión manual, no como conclusión.

Límites de alcance, dicho con claridad

  • Beta: los dos modelos de riesgo del comprador están en beta.
  • Cobertura: solo España y Francia.
  • Sujeto de la puntuación: siempre el comprador. Nunca un proveedor ni una licitación concreta.
  • Umbral: un comprador se puntúa a partir de 20 adjudicaciones en el periodo.
  • Señal de contraparte: débil, en torno al doble de la tasa base en lo alto del rango. Léase junto con las adjudicaciones de evidencia.
  • Ofertas en Francia: el número de ofertas se publica solo en parte de las adjudicaciones francesas, así que los totales por comprador que dependen de ese dato son una cota superior.
  • Un motivo para mirar: una puntuación alta no es una constatación de irregularidad.
  • Sin scoring de crédito, cuentas anuales ni puntuación de proveedor: estos endpoints no devuelven nada de eso, solo el comportamiento agregado del comprador.

Preguntas frecuentes

¿La puntuación describe al proveedor o al comprador?
Al comprador. Las dos puntuaciones de /procurement/buyer/{id} describen el comportamiento del órgano de contratación a lo largo de sus adjudicaciones, nunca a un proveedor concreto ni a una licitación individual.

¿Qué mide cada modelo?
competition es la probabilidad de que la próxima adjudicación del comprador reciba una sola oferta, comparada con lo que atraen licitaciones comparables. counterparty es la probabilidad de que un proveedor al que adjudica entre en concurso de acreedores en los 24 meses siguientes: una señal débil, en torno al doble de la tasa base en lo alto del rango, que conviene leer junto con las adjudicaciones de evidencia.

¿Desde cuántas adjudicaciones se puntúa un comprador?
Un órgano de contratación se puntúa a partir de 20 adjudicaciones en el periodo. Por debajo de ese umbral no aparece en /procurement/buyers ni tiene perfil en /procurement/buyer/{id}.

¿Los totales de ofertas son exactos en Francia?
No. Francia publica el número de ofertas solo en parte de sus adjudicaciones, así que los totales por comprador que dependen de ese dato son una cota superior, no una cifra exhaustiva.

¿Esto sustituye un scoring de crédito?
No. Estos endpoints no devuelven cuentas anuales, scoring de crédito ni una puntuación de proveedor de ningún tipo. Una puntuación alta es un motivo para mirar las adjudicaciones de evidencia, no una constatación de irregularidad.

Ver también