Regístrate

Caso de uso · Fraude e investigación

Detección de empresas pantalla

Los equipos de fraude, investigación y diligencia reforzada necesitan señales que puedan defender ante un examinador, no una puntuación de caja negra. Esta página enumera cada señal que la API de Prometiam puede exponer realmente para empresas pantalla y administradores en serie — el endpoint y el campo detrás de cada una, y dónde se agota cada señal.

Endpoints y campos comprobados contra la especificación publicada de la API el 16 de septiembre de 2026 · English version

El problema

Los equipos de fraude, investigación y diligencia reforzada de marketplaces, proveedores de pagos, prestamistas y fintechs ven el mismo patrón una y otra vez: una contraparte pasa un KYB básico —la ficha registral es real, la entidad está activa— y aun así resulta ser una sociedad instrumental usada para mover dinero y desaparecer. Una sola consulta no lo detecta. La señal casi siempre es una combinación: una entidad de pocas semanas de antigüedad, capitalizada en el mínimo legal, dirigida por un administrador que ya ha abierto y cerrado una serie de empresas parecidas.

Ninguna API puede afirmar que una empresa es una sociedad instrumental, y esta tampoco lo hace. Lo que Prometiam sí puede hacer es exponer los hechos registrales individuales que los investigadores ya revisan a mano, para que un analista dedique tiempo solo a las contrapartes que de verdad merecen una segunda mirada, en lugar de repetir las mismas consultas en varios portales.

El patrón

Una revisión de empresa pantalla son varias llamadas sobre un mismo candidato, no una sola. Resolver la entidad es la primera y la más barata, y es el ancla sobre la que se construyen el resto de señales:

curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=ES&name=ACME+TRADING+SL&founded_after=2026-01-01' \
  -H 'Authorization: Bearer rk_live_...'

El id, founding_date, capital_amount, status y previous_names de esa única respuesta ya cubren tres de las siete señales de abajo. El resto viene de endpoints separados, construidos a propósito.

Siete señales, no un veredicto

  1. Antigüedad. founding_date y el filtro founded_after en GET /companies/search. Una contraparte constituida el mes pasado no demuestra nada por sí sola, pero es el hecho más barato de comprobar y la razón para mirar el resto. Ver new incorporations feed para este filtro como feed diario independiente.
  2. Capital. capital_amount y capital_currency en la misma ficha de empresa — una empresa en o cerca del mínimo legal de su jurisdicción, que factura a una escala que no encaja, es la señal clásica de infracapitalización. Se devuelve cuando el registro ha publicado una cifra; un valor nulo no es en sí mismo una señal.
  3. Administradores en serie. GET /directors/network?country=ES&min_companies=N encuentra personas vinculadas a un número inusual de empresas (añade legal_entities=true para incluir administradores personas jurídicas); GET /people/{id} devuelve entonces el historial completo de appointments[] de esa persona, cada uno con is_current, appointment_date y end_date. Varios nombramientos no vigentes cuyas empresas se disolvieron y reaparecieron con otro nombre es el patrón fénix. Disponible para España, Francia, Reino Unido y Noruega; Irlanda y Polonia son a nivel empresa, así que esta señal no existe ahí. Ver director-network analysis (en inglés) para el método completo.
  4. Cambios. previous_names en la ficha de empresa, más los eventos address_change, name_change, director_change y capital_change de GET /company-events/search — España, Francia y Reino Unido; Noruega solo tiene eventos de cambio del registro, desde el 14 de octubre de 2026 (sin boletín). Merece la pena ampliar la misma búsqueda a eventos de disolución e insolvencia en empresas que comparten administrador con el candidato.
  5. Estado. status y dissolution_date en la ficha de empresa; la insolvencia de empresas en dieciséis mercados, España incluida, a través de POST /insolvency/check; GET /search sigue sirviendo los anuncios concursales de España.
  6. Listas. POST /sanctions/screen de la razón social y sus administradores conocidos juntos, hasta 50 nombres en una llamada — en beta. Una coincidencia es un match de nombre con una puntuación de confianza, no una determinación.
  7. Titularidad en Reino Unido. GET /people/search?country=GB se apoya en los datos del Companies House, que devuelve People with Significant Control junto a administradores. La titularidad real en esta API es solo para Reino Unido: el resto de registros devuelven administradores, un concepto jurídico distinto de la titularidad real.

Un ejemplo real

Esto no puntúa nada. Llama a los endpoints anteriores para un candidato y monta las respuestas en un expediente para que lo lea un analista:

import os, requests

API = 'https://api.prometiam.com/functions/v1/risk-api'
HEAD = {'Authorization': f'Bearer {os.environ["PROMETIAM_API_KEY"]}'}

def expediente_revision(name, country):
    """Reúne las señales registrales de un candidato en un expediente
    para que lo lea un analista. Nada aquí se puntúa, se pondera ni se
    convierte en un veredicto."""
    card = {'name': name, 'country': country}
    hit = requests.get(f'{API}/companies/search',
        params={'name': name, 'country': country, 'limit': 1}, headers=HEAD).json()['data']
    if not hit:
        return {**card, 'found': False}
    co = hit[0]
    card.update(found=True, company_id=co['id'], founding_date=co.get('founding_date'),
                capital_amount=co.get('capital_amount'), capital_currency=co.get('capital_currency'),
                status=co.get('status'), dissolution_date=co.get('dissolution_date'),
                previous_names=co.get('previous_names'))

    if country in ('ES', 'FR', 'GB', 'NO'):  # administradores: IE/PL son a nivel empresa
        net = requests.get(f'{API}/directors/network',
            params={'country': country, 'min_companies': 5}, headers=HEAD).json()['data']
        card['serial_officers'] = [n['person_name'] for n in net if co['id'] in n['company_ids']]

    if country in ('ES', 'FR', 'GB'):  # flujo de actos societarios; Noruega no lo tiene
        ev = requests.get(f'{API}/company-events/search',
            params={'country': country, 'company_name': name, 'limit': 20}, headers=HEAD).json()['data']
        card['recent_events'] = [e['event_type'] for e in ev]

    if country == 'ES':  # los concursos de España también se leen con /search; /insolvency/check los cubre igual
        notices = requests.get(f'{API}/search',
            params={'name': name, 'country': 'ES'}, headers=HEAD).json()['data']
        card['concursal_notices'] = len(notices)
    elif country in ('FR', 'GB', 'NO'):  # insolvencia de empresas en dieciséis mercados
        result = requests.post(f'{API}/insolvency/check',
            json={'items': [{'country': country, 'name': name}]}, headers=HEAD).json()['data'][0]
        card['insolvency_status'] = result['status']
    # IE/PL: hoy no cubierto por ninguna de las dos vías de insolvencia

    hits = requests.get(f'{API}/sanctions/screen',
        params={'name': name}, headers=HEAD).json()['data']  # beta
    card['sanctions_hit_count'] = len(hits)
    return card  # un expediente para que lo lea un analista, nunca una decisión

Unas 40 líneas y cinco llamadas que cubren seis de las siete señales; añade una sexta llamada a GET /people/search?country=GB — la señal de titularidad en Reino Unido — cuando el candidato es una entidad británica.

Qué te devuelve

  • De GET /companies/search y GET /companies/{id}: founding_date, capital_amount / capital_currency, status, dissolution_date, previous_names[] (cada uno con name, from_date, until_date).
  • De GET /directors/network: person_id, person_name, company_count, is_legal_entity, company_ids[], company_names[].
  • De GET /people/{id}: appointments[], cada uno con company_name, company_number, role, appointment_date, end_date, is_current.
  • De GET /company-events/search: event_type, event_date, previous_value, new_value, source.
  • De POST /insolvency/check: un status de found/none/error/timeout por elemento, hasta cinco notices, y latest_filing_date. GET /search (el concurso de acreedores español) devuelve las notificaciones directamente, cada una con su propio status, event_type y filing_date registrales.
  • De POST /sanctions/screen: un status de match/clear, hits[] con match_score, source_list e is_active.

Encaje de precio

Un expediente completo de revisión toca unos seis endpoints: resolver la entidad, extraer su red de administradores, extraer sus actos societarios recientes, comprobar el estado de insolvencia o concurso, cribarla contra sanciones y —para una contraparte del Reino Unido— extraer los datos PSC. A ese ritmo, la prueba gratuita de 14 días (500 créditos, sin cobro hasta que termine la prueba) cubre unos 40 expedientes (unos 12 créditos cada uno). Starter (9,99 €/mes, 1.000 créditos) cubre unos 80 al mes; Professional (29,99 €/mes, 10.000 créditos) unos 800, con el alcance completo de cribado de sanciones y control de exportaciones incluido; Scale (99,99 €/mes, 50.000 créditos) unos 4.100.

Límites de alcance, sin rodeos

  • Los administradores —y por tanto la señal de administrador en serie y de patrón fénix— existen para España, Francia, Reino Unido y Noruega. Irlanda es a nivel empresa y los administradores de Polonia solo están en la ficha de empresa (personas físicas enmascaradas por el propio registro, sin búsqueda de personas ni red): sin señal de administrador en serie ahí.
  • Los actos societarios (address_change, name_change, director_change, capital_change) existen para España, Francia y Reino Unido. Noruega solo tiene eventos de cambio del registro, desde el 14 de octubre de 2026 (sin boletín).
  • La insolvencia de empresas cubre dieciséis mercados (FR, DE, GB, AT, CH, NO, FI, US, NL, DK, HR, SE, ES, LV, EE, SG) a través de POST /insolvency/check; GET /search sigue sirviendo los anuncios concursales de España. Irlanda y Polonia no tienen ninguno de los dos.
  • El cribado de sanciones está en beta. El cribado PEP es un añadido opcional y separado (beta, solo España, sin familiares ni allegados) y no es una de las siete señales de arriba.
  • La titularidad real en esta API es solo el registro PSC de Reino Unido, vía GET /people/search?country=GB. El resto de registros devuelven administradores, no titularidad real.
  • Nada de lo anterior está puntuado. El único campo con forma de puntuación en toda la API es el match_score de sanciones — una confianza de coincidencia de nombre, no una puntuación de riesgo, no un veredicto.

Preguntas frecuentes

¿Puede la API decirme que una empresa es una sociedad instrumental?
No. Prometiam devuelve hechos registrales y un match_score de sanciones — nunca una puntuación de riesgo ni un veredicto. Esta página enumera las señales individuales que ya revisan los investigadores, con el endpoint y el campo detrás de cada una, para que sea una persona quien decida qué hacer con ellas.

¿Cómo se detecta un patrón de administrador fénix?
Llama a GET /directors/network con min_companies para encontrar personas vinculadas a un número inusual de empresas, y luego a GET /people/{id} para ver los nombramientos de esa persona, que incluyen is_current, appointment_date y end_date. Varios nombramientos no vigentes cuyas empresas se disolvieron y reaparecieron con otro nombre es el patrón fénix. Los administradores están disponibles para España, Francia, Reino Unido y Noruega; Irlanda es a nivel empresa y los administradores de Polonia solo están en la ficha de empresa (personas físicas enmascaradas por el propio registro, sin búsqueda de personas ni red), así que esta señal no existe ahí.

¿Verifica Prometiam la titularidad real?
Solo para Reino Unido, a través de los datos PSC (People with Significant Control) que devuelve GET /people/search?country=GB. El resto de registros de esta API devuelven administradores, un concepto jurídico distinto de la titularidad real.

¿Qué países soportan las señales de administrador en serie y de cambios?
Los administradores —y por tanto las señales de administrador en serie y de patrón fénix— existen para España, Francia, Reino Unido, Noruega y Polonia (con las personas físicas enmascaradas por el propio registro). Los actos societarios —address_change, name_change, director_change, capital_change— existen para España, Francia y Reino Unido; Noruega solo tiene eventos de cambio del registro, desde el 14 de octubre de 2026 (sin boletín). Irlanda y Polonia son a nivel empresa por ahora en cuanto a estos eventos.

¿Está incluido el cribado de sanciones y es definitivo?
POST /sanctions/screen comprueba hasta 50 nombres — la empresa y sus administradores juntos— contra las listas de la UE, la ONU, OFAC, Reino Unido, Australia (DFAT), el registro francés y las de control de exportaciones de EE. UU. en una sola llamada. Está en beta: trata una coincidencia como una señal más entre varias, no como el único control.

Ver también