Legentic Locate API

La Legentic Locate API consente alle organizzazioni di monitorare automaticamente i casi relativi a veicoli smarriti o rubati confrontandoli con i dati investigativi di Legentic, aggiornati continuamente.

Progettata specificamente per i flussi di lavoro successivi alla gestione di un sinistro e per il recupero dei veicoli, la Locate API aiuta assicuratori, investigatori, team di recupero e specialisti antifrode a identificare se i veicoli scomparsi ricompaiono in annunci online o nei documenti di spedizione.

Quando un caso viene inviato all'API, Legentic valuta gli identificatori del veicolo rispetto alle regole aziendali Locate predefinite e restituisce:

• Quali regole sono state attivate
• Il livello di gravità dei risultati
• Il numero di record corrispondenti
• Informazioni sui documenti pertinenti
• Link diretti per analizzare i risultati all'interno della Legentic Platform

A differenza delle ricerche manuali una tantum, la Locate API supporta flussi di monitoraggio e rilevamento continuativi, aiutando le organizzazioni a reagire rapidamente quando i veicoli ricompaiono in fonti di dati esterne.

Casi d'uso tipici

• Flussi di recupero di veicoli rubati
• Monitoraggio successivo alla gestione dei sinistri
• Supporto alle indagini sulle frodi
• Operazioni di recupero degli asset
• Monitoraggio di spedizioni ed esportazioni
• Escalation dei casi ad alto rischio
• Flussi di monitoraggio continuo dei veicoli

Esempio di flusso di lavoro

• Viene registrato un caso di furto o smarrimento di un veicolo
• L'organizzazione invia il caso alla Locate API
• Legentic valuta continuamente il veicolo rispetto alle fonti di dati aggiornate
• L'API rileva annunci o documenti di spedizione corrispondenti
• Gli investigatori ricevono avvisi e link diretti per l'indagine
• I processi di recupero o escalation possono iniziare immediatamente

Questo consente alle organizzazioni di reagire più rapidamente quando i veicoli scomparsi ricompaiono nei marketplace esterni o nei registri di trasporto.

Prima di iniziare

La Locate API deve essere prima abilitata dal team Legentic. Per richiedere l'accesso, contatta il team Legentic Support all'indirizzo support@legentic.com.

Configurazione

-> Scheda Quick Start

La sezione Quick Start all'interno della piattaforma include:

• Documentazione degli endpoint
• Esempi di richieste e risposte
• Dettagli di autenticazione
• Indicazioni per l'integrazione
• Strumenti per testare l'API

Questa sezione è destinata principalmente agli sviluppatori e ai team di integrazione.

-> Scheda Settings

La sezione Settings consente agli utenti di esaminare le regole aziendali utilizzate per i flussi di lavoro Locate, che possono determinare come vengono rilevati i veicoli scomparsi nelle fonti di dati supportate.

-> Scheda Credentials

Tutte le richieste API richiedono una chiave API, che può essere generata dalla scheda Credentials.

Note importanti:

• Le chiavi API diventano attive immediatamente dopo la creazione
• Solo i Company Admin possono creare o gestire le credenziali
• Le chiavi API devono essere sempre conservate in modo sicuro

-> Scheda Usage

Le statistiche di utilizzo sono disponibili nella scheda Usage all'interno della piattaforma.

Nota:

• I dati di utilizzo potrebbero presentare un lieve ritardo nella reportistica
• Le ricerche estese su più Paesi possono aumentare i tempi di risposta
• Le ricerche ampie possono restituire set di risultati più grandi

Best practice per le ricerche Locate

Per migliorare la qualità dei risultati e l'efficienza delle attività di recupero:

-> Utilizza VIN e targa insieme quando possibile

Fornire entrambi gli identificatori può migliorare significativamente le capacità di corrispondenza e aumentare la probabilità di rilevare record pertinenti.

-> Utilizza filtri Paese pertinenti

Questo può contribuire a migliorare la precisione della ricerca, le prestazioni operative e la rilevanza dei risultati. La ricerca in tutti i Paesi accessibili può aumentare i tempi di risposta e il volume dei risultati.

-> Ripeti regolarmente le ricerche

Si raccomanda vivamente di rieseguire regolarmente le ricerche per i casi di recupero attivi. Poiché Legentic indicizza continuamente nuovi dati, se una ricerca iniziale non produce corrispondenze, potrebbero comparire successivamente record pertinenti quando vengono indicizzati nuovi annunci o documenti di spedizione.

-> Includi le informazioni del caso

Le informazioni contestuali, come date del caso, tipologia del caso e dettagli del sinistro o del recupero, possono supportare i flussi di lavoro interni e migliorare la collaborazione tra i team.

Comprendere i risultati

La Locate API restituisce risultati strutturati quando vengono rilevati record corrispondenti. Questi possono includere:

• Annunci di vendita di veicoli
• Documenti di spedizione
• Date di pubblicazione
• Informazioni sui prezzi dei veicoli
• Domini delle fonti
• Paesi di origine e destinazione della spedizione

Ogni risultato include inoltre:

• Una descrizione della regola che spiega perché è stata rilevata la corrispondenza
• Il numero di record corrispondenti
• Un link diretto per l'indagine all'interno della Legentic Platform

Rilevamento dei dati di spedizione

La Locate API può anche rilevare veicoli presenti nei documenti di spedizione. Questo può aiutare le organizzazioni a identificare potenziali spostamenti internazionali, attività di esportazione o trasporti transfrontalieri relativi a veicoli scomparsi.

I risultati relativi alle spedizioni possono includere:

• Paese di origine
• Paese di destinazione
• Timestamp della spedizione

Domande frequenti

-> La Locate API monitora continuamente i veicoli?

L'API esegue le ricerche rispetto a fonti di dati Legentic continuamente aggiornate. Per i casi attivi, si consiglia alle organizzazioni di rieseguire regolarmente le ricerche.

-> Quali tipi di dati può rilevare Locate?

• Annunci di vendita online
• Annunci sui marketplace
• Record di spedizione e trasporto

in base alle regole aziendali configurate per la propria organizzazione.

-> Sono necessari sia il VIN sia la targa?

No. È possibile utilizzare uno dei due identificatori.

Tuttavia, fornire entrambi gli identificatori può migliorare le capacità di corrispondenza e la precisione del rilevamento.

-> Posso effettuare ricerche in più Paesi contemporaneamente?

Sì. È possibile includere nella richiesta più codici Paese.

È inoltre possibile utilizzare ["*"] per effettuare una ricerca in tutti i Paesi a cui la propria organizzazione ha accesso.

-> Cosa succede se non vengono trovate corrispondenze?

L'assenza di risultati significa semplicemente che al momento della ricerca non sono stati rilevati record corrispondenti.

Poiché ogni giorno vengono indicizzati nuovi dati, potrebbero comunque comparire corrispondenze in un momento successivo.

-> Tutti i risultati vengono trattati come ad alta priorità?

Attualmente, i risultati Locate vengono generalmente trattati come risultati ad alta gravità, poiché potrebbero indicare la ricomparsa o lo spostamento di un veicolo scomparso.

Supporto

Se hai bisogno di assistenza per:

• Accesso API
• Configurazione dell'integrazione
• Configurazione dei flussi di lavoro Locate
• Strategie di monitoraggio per il recupero
• Ottimizzazione delle ricerche
• Risoluzione dei problemi

contatta il team Legentic Support all'indirizzo support@legentic.com.

Quando contatti il supporto, può essere utile includere:

• Timestamp delle richieste
• ID dei casi
• Messaggi di errore
• Esempi di richieste o risposte