Saltar al contenido principal
POST
curl

Descripción general

Activa o desactiva la monitorización AML continua de las entidades empresariales seleccionadas, exactamente igual que la acción Monitorización AML continua de Business Console. Business Console y este endpoint ejecutan la misma operación interna, por lo que las reglas, la facturación y los resultados son idénticos. Envía primero estimate_only: true para ver cuántas empresas hay seleccionadas, cuántas necesitan un nuevo análisis AML, el importe único de los análisis y el importe anual de la monitorización. La simulación no realiza ninguna escritura. La estimación usa los mismos nombres de campo que el endpoint de usuarios, así que users_total es el número de empresas seleccionadas.

Cómo se procesa una selección

  • Un análisis monitorizado por empresa. Una empresa que se verificó varias veces se monitoriza y se factura una sola vez. Al desactivarla, la monitorización se apaga en todos los análisis de esa empresa.
  • Las empresas sin análisis AML se analizan primero. Didit crea para ellas una nueva verificación AML (visible en la pestaña Verifications de la empresa), que se factura como un análisis AML normal, y activa en ella la monitorización. El análisis usa la razón social (o el nombre comercial) y el país de la empresa; una empresa sin ningún nombre se informa como skipped_no_identity_data en lugar de descartarse sin aviso.
  • Las aplicaciones de sandbox nunca crean análisis (skipped_sandbox).
  • El saldo se comprueba de antemano. La activación se rechaza con 403 cuando tu saldo no cubre la estimación, y la respuesta incluye la estimación para que sepas cuánto debes recargar.
  • Renovación anual. A una empresa que pasa a estar monitorizada se le factura el precio anual de monitorización en su próxima fecha de renovación, la misma fecha que Business Console muestra en la columna Ongoing monitoring. Desactivar detiene la renovación; no reembolsa un periodo ya facturado.

Selección y tamaño del lote

Selecciona las empresas con vendor_data_list, didit_internal_id_list o ambos; las dos listas se combinan con OR. Una solicitud acepta como máximo 1000 identificadores entre ambas listas. Los identificadores que no coinciden con ninguna empresa de tu aplicación se devuelven en unmatched, tal como se enviaron, y nunca hacen fallar la solicitud: una selección que no coincide con nada termina como un trabajo vacío (total: 0) con todos los identificadores listados, la misma convención que siguen los endpoints de eliminación por lotes.

En la misma llamada o en segundo plano

Las selecciones de 20 empresas o menos se procesan en la misma llamada, que devuelve 200 con el trabajo terminado. Las selecciones más grandes devuelven 202 con un trabajo PENDING; consulta Obtener trabajo de monitorización AML periódicamente hasta que status sea COMPLETED o FAILED. En ambos casos, el trabajo incluye una entrada de results por empresa con su outcome.

Webhooks

Activar o desactivar la monitorización no emite ningún webhook propio. Una vez activada la monitorización, los reanálisis siguen disparando los eventos habituales status.updated y data.updated descritos en Monitorización AML continua.

Permisos

Cualquier clave de API activa de la aplicación puede invocar este endpoint. Las claves de API de Didit tienen alcance de aplicación, no de rol: los roles y permisos de Business Console determinan lo que una persona puede hacer en Business Console y no se evalúan para el tráfico de la Management API.

Páginas relacionadas

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Cuerpo

application/json

Selecciona empresas con vendor_data_list, didit_internal_id_list o ambas (las dos listas se combinan con OR). Como máximo 1000 identificadores por solicitud entre ambas listas.

is_enabled
boolean
requerido

true para activar la monitorización, false para desactivarla.

estimate_only
boolean
predeterminado:false

Si es true, devuelve la estimación del costo y no realiza ninguna escritura: ni análisis, ni facturación, ni tarea.

vendor_data_list
string[]

Tus propios identificadores de las empresas que se van a activar o desactivar, comparados exactamente como se enviaron.

didit_internal_id_list
string<uuid>[]

IDs internos de Didit de las empresas que se van a activar o desactivar: el didit_internal_id que devuelven los endpoints de creación, obtención y listado.

Respuesta

La estimación (cuando estimate_only es true) o el trabajo completado para una selección procesada en línea.

Vista previa del coste. Se devuelve directamente cuando estimate_only es true (no se escribe nada).

users_total
integer
requerido

Perfiles que coinciden con la selección.

already_enabled
integer
requerido

Perfiles ya monitorizados (no hay nada que hacer al activar; son los que se desactivan al desactivar).

with_existing_aml
integer
requerido

Perfiles cuyo análisis AML existente pasará a estar monitorizado (sin un nuevo análisis).

needing_screening
integer
requerido

Perfiles sin ningún análisis AML que se analizarán primero (se factura como un análisis AML normal).

skipped_no_identity_data
integer
requerido

Perfiles que no se pueden analizar porque faltan datos de identidad.

skipped_blocked
integer
requerido

Usuarios bloqueados que se omitirán (siempre 0 para empresas).

estimated_screening_cost_usd
number
requerido

Costo único de los nuevos análisis.

Ejemplo:

0.2

estimated_annual_monitoring_cost_usd
number
requerido

Coste anual de monitorización de los perfiles que pasarán a estar monitorizados.

Ejemplo:

0.07

balance_sufficient
boolean
requerido

Si el saldo de la organización cubre el análisis más el primer año de monitorización.

unmatched
string[]
requerido

Identificadores de la solicitud que no coincidieron con ningún perfil de esta aplicación, exactamente como se enviaron.

Última modificación el 1 de noviembre de 2026