Inizia
Integrazione / SDK
Verifica degli utenti
Verifica aziendale
Monitoraggio delle transazioni
ChangelogQuando usare quale superficie
Gli endpoint
Gli strumenti MCP corrispondenti sono
didit_transaction_rule_list, didit_transaction_rule_get, didit_transaction_rule_create, didit_transaction_rule_update, didit_transaction_rule_delete, didit_transaction_rule_backtest, didit_transaction_rule_library_list, didit_transaction_rule_install e didit_transaction_rule_uninstall - vedi il riferimento degli strumenti MCP.
Lo schema completo - il catalogo dei campi, tutti i 19 operatori di condizione, le finestre di velocità, le condizioni raggruppate e i sei tipi di azione - è documentato nella pagina Rules & Scoring ed è incluso nel riferimento API.
Creare, testare con backtest, attivare
Il modello di rilascio sicuro per qualsiasi nuova regola:1
Crea la regola in modalità TEST
scope e conditions descrivono la transazione valutata: una transazione finanziaria in entrata in EUR con un amount grezzo inferiore a 10.000. Le voci di aggregation descrivono la finestra di 30 giorni per lo stesso soggetto: almeno 20 transazioni finanziarie in entrata in EUR e nessuna di 10.000 EUR o più. Entrambe le voci di aggregazione devono essere soddisfatte, indipendentemente da ciò che indica evaluation_mode - questa impostazione regola solo le condizioni.Questo esempio usa amount grezzo e fissa currency a EUR in entrambe le parti, quindi non dipende dalla normalizzazione dei cambi. Per fare il backtest sui fixture della sandbox, invia almeno 20 transazioni finanziarie in entrata in EUR per lo stesso soggetto entro 30 giorni, ciascuna con amount inferiore a 10.000. Né preferred_currency_amount né amount_in_default_currency sono obbligatori. L’acquisizione in sandbox salva queste transazioni; esegui il backtest in modo esplicito.Una regola TEST viene valutata su ogni nuova transazione e registra quali transazioni avrebbe intercettato, ma non modifica mai il punteggio o lo stato della transazione.Un filtro di aggregazione non è una condizione. Una condizione legge solo la transazione valutata; un filtro di aggregazione restringe solo la finestra storica e confronta per uguaglianza o appartenenza a una lista - non esiste un filtro
lt, quindi non puoi contare solo i trasferimenti sotto 10.000.La voce max ... lt 10000 è il modo supportato per porre un limite massimo alla finestra: richiede che ogni transazione nella finestra sia inferiore a 10.000, il che è più restrittivo che contare solo quelle piccole - un trasferimento da 12.000 tra i venti impedisce alla regola di scattare. Elimina quella voce se preferisci che il conteggio stia da solo, e in tal caso dillo nel titolo: senza di essa la regola conta i trasferimenti in entrata di qualsiasi importo, e diciannove trasferimenti da 50.000 seguiti da uno piccolo la fanno scattare.2
Testa con backtest sulla tua cronologia
matched sorprendente significa che le soglie vanno ottimizzate prima che la regola possa produrre effetti.3
Attiva
Migrazione delle regole da un altro provider
Poiché la creazione di una regola è una semplice chiamata API con uno schema completamente documentato, un assistente AI può tradurre l’esportazione delle regole di un altro provider in regole Didit al posto tuo.- Esporta le regole dal provider attuale: la maggior parte degli strumenti esporta in CSV o Excel.
- Trascina il file nell’assistente della console Didit (oppure in qualsiasi agente collegato tramite MCP, come Claude con il Didit MCP collegato). I fogli di calcolo vengono convertiti automaticamente in testo.
- L’assistente associa ogni riga allo schema Didit (condizioni, finestre di frequenza, azioni) e ti mostra la corrispondenza, segnalando qualsiasi elemento che non ha un equivalente in Didit, prima di creare qualsiasi cosa.
- Dopo la tua conferma crea le regole in modalità TEST, le sottopone a backtest sulla tua cronologia delle transazioni e riporta le righe create correttamente, quelle la cui creazione è fallita e quelle non associabili.
- Verifica i numeri e attiva le regole che ti sembrano corrette, dalla console oppure con un
PATCH {"mode": "ACTIVE"}.
scope e conditions vincolano la transazione valutata a un trasferimento in uscita in EUR inferiore a 10.000, e i filtri di aggregazione vincolano la finestra di 30 giorni agli stessi trasferimenti in uscita in EUR dello stesso soggetto. L’amount grezzo è confrontabile solo all’interno di una stessa valuta, quindi mantieni la valuta vincolata come sopra. Un tetto multivaluta richiede un importo normalizzato per ogni transazione nella finestra. Passare solo a preferred_currency_amount non garantisce la disponibilità: gli importi normalizzati storici mancanti possono essere trattati come zero dalle aggregazioni numeriche.
La voce max è ciò che mantiene la finestra sotto 10.000 EUR, perché un filtro di aggregazione non può esprimere inferiore a 10.000: vedi la nota sul passaggio di creazione sopra per il compromesso che comporta. Qualsiasi elemento che lo schema non può esprimere in modo esatto va dichiarato esplicitamente nella description della regola, anziché approssimato in silenzio.
Gli errori di validazione sono volutamente precisi
Gli endpoint di creazione e aggiornamento validano i valori di condizioni, aggregazione e scope in base a ciò che il motore delle regole accetta esattamente: operatori o metriche sconosciuti, finestre malformate ("30days" invece di "30d"), direzioni di scope non valide, contains_any senza una lista, fuzzy_match senza un score, e change_status verso AWAITING_USER senza un workflow_id restituiscono tutti un 400 che indica l’indice e il problema, invece di salvare una regola che non corrisponde mai senza segnalazioni. Agenti e script devono leggere il corpo dell’errore e correggere il payload. Le chiavi di scope extra oltre a transaction_types, directions e action_types vengono salvate ma ignorate dal motore, come le ha sempre salvate la Business Console.
Passaggi successivi
Regole e punteggio
Lo schema completo delle regole: campi, operatori, finestre di frequenza, azioni.
API per la creazione delle regole
Documentazione di riferimento degli endpoint con gli schemi di richiesta e risposta.
Libreria delle regole
Il catalogo di 150+ preset e i suoi pacchetti.
Panoramica di MCP
Collega un agente AI al tuo spazio di lavoro Didit.