Saltar al contingut principal
POST
curl

Visió general

Activa o desactiva el monitoratge AML continu per a les empreses seleccionades, exactament com l’acció Monitoratge AML continu de la Business Console. La Console i aquest endpoint executen la mateixa operació subjacent, de manera que les regles, la facturació i els resultats són idèntics. Envia primer estimate_only: true per veure quantes empreses estan seleccionades, quantes necessiten un nou Cribratge AML, el cost únic del cribratge i el cost anual del monitoratge. Una execució de prova no escriu res. L’estimació fa servir els mateixos noms de camp que l’endpoint d’usuaris, de manera que users_total és el nombre d’empreses seleccionades.

Com es processa una selecció

  • Un cribratge monitoritzat per empresa. Una empresa que s’ha verificat diverses vegades es monitoritza i es factura una sola vegada. Desactivar-lo desactiva el monitoratge en tots els cribratges d’aquesta empresa.
  • Les empreses sense cribratge AML se sotmeten primer a un cribratge. Didit crea un nou Cribratge AML per a elles (visible a la pestanya Verificacions de l’empresa), facturat com un Cribratge AML habitual, i hi activa el monitoratge. El cribratge utilitza el nom legal (o nom de visualització) i el país de l’empresa. Una empresa sense cap nom es informa com a skipped_no_identity_data en lloc de descartar-se en silenci.
  • Les aplicacions de sandbox mai creen cribratges (skipped_sandbox).
  • El saldo es comprova per endavant. L’activació es rebutja amb 403 quan el saldo no cobreix l’estimació, i la resposta inclou l’estimació perquè sàpigues quant cal recarregar.
  • Renovació anual. Una empresa que comença a estar monitoritzada es factura al preu anual de monitoratge en la seva propera data de renovació, la mateixa que la Console mostra a la columna Monitoratge continu. Desactivar-lo atura la renovació; no reembossa cap període ja facturat.

Selecció i mida del lot

Selecciona empreses amb vendor_data_list, didit_internal_id_list, o amb totes dues; les dues llistes es combinen amb OR. Una sol·licitud accepta com a màxim 1000 identificadors entre totes dues llistes. Els identificadors que no coincideixen amb cap empresa de la teva aplicació es retornen a unmatched, tal com s’han enviat, i mai no fan fallar la sol·licitud: una selecció sense coincidències es completa com a tasca buida (total: 0) amb tots els identificadors indicats, igual que als endpoints d’eliminació en lot.

En línia o en segon pla

Les seleccions de 20 empreses o menys es processen en línia i la crida retorna 200 amb la tasca finalitzada. Les seleccions més grans retornen 202 amb una tasca PENDING; consulta Obtenir la tasca de monitoratge AML fins que status sigui COMPLETED o FAILED. En tots dos casos, la tasca porta una entrada results per empresa amb el seu resultat outcome.

Webhooks

Activar o desactivar el monitoratge no emet cap webhook propi. Un cop el monitoratge s’ha activat, els recribratges continuen generant els esdeveniments habituals status.updated i data.updated descrits a Monitoratge AML continu.

Permisos

Qualsevol clau d’API activa de l’aplicació pot cridar aquest endpoint. Les claus d’API de Didit tenen abast d’aplicació, no de rol: els rols i permisos de la Console determinen què pot fer una persona a la Console i no s’avaluen per al trànsit de la Management API.

Relacionats

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Cos

application/json

Selecciona empreses amb vendor_data_list, didit_internal_id_list, o amb totes dues (les dues llistes s'avaluen amb un OR lògic). Com a màxim 1000 identificadors per sol·licitud entre ambdues llistes.

is_enabled
boolean
requerit

true per activar el monitoratge, false per desactivar-lo.

estimate_only
boolean
predeterminat:false

Quan és cert, retorna l'estimació del cost i no realitza cap escriptura: sense cribratge, sense facturació i sense tasca.

vendor_data_list
string[]

Els teus propis identificadors de les empreses a commutar, coincidits exactament com es van enviar.

didit_internal_id_list
string<uuid>[]

ID interns de Didit de les empreses per activar o desactivar: el didit_internal_id retornat pels endpoints de creació, obtenció i llistat.

Resposta

L'estimació (quan estimate_only és cert) o la tasca completada per a una selecció processada en línia.

Vista prèvia del cost. Es retorna directament quan estimate_only és true (no s'escriu res).

users_total
integer
requerit

Perfils que coincideixen amb la selecció.

already_enabled
integer
requerit

Perfils que ja estan monitorats (res a fer en activar; són els que es desactiven en desactivar).

with_existing_aml
integer
requerit

Perfils el cribratge AML existent dels quals passarà a estar monitorat (sense nou cribratge).

needing_screening
integer
requerit

Perfils sense cap cribratge AML als quals es farà primer un cribratge (facturat com un cribratge AML ordinari).

skipped_no_identity_data
integer
requerit

Perfils que no es poden sotmetre a cribratge perquè manquen dades d'identitat.

skipped_blocked
integer
requerit

Usuaris bloquejats que s'ometran (sempre 0 per a empreses).

estimated_screening_cost_usd
number
requerit

Cost únic dels nous cribratges.

Exemple:

0.2

estimated_annual_monitoring_cost_usd
number
requerit

Cost de monitoratge anual dels perfils que passaran a estar monitorats.

Exemple:

0.07

balance_sufficient
boolean
requerit

Si el saldo de l'organització cobreix el cribratge més el primer any de monitoratge.

unmatched
string[]
requerit

Identificadors de la sol·licitud que no coincideixen amb cap perfil d'aquesta aplicació, exactament tal com s'han enviat.

Darrera modificació el 7 de novembre del 2026