Tracciamento pacchi

Scopo e intenzione dell’utente: lo strumento risolve il tracciamento pacchi multi-spedizionieri per team operativi e flussi di lavoro di supporto. Accetta una o più tracking-number con identificativi di corriere opzionali per recuperare stato attuale, localizzazione ed ETA. Viene utilizzato da fulfilment e-commerce, pianificazione logistica e agenti di supporto per fornire aggiornamenti precisi ai clienti o alimentare dashboard a valle, soprattutto quando è necessaria una visione unificata tra vettori. Logica di base e caratteristiche: capacità principali includono normalizzazione input, mapping dei corrieri e orchestrazione API per recuperare stato in tempo reale da corrieri o aggregatori di dati. Funzionalità obbligatorie: lookup multipli, schema di output standardizzato, validazione degli input e controlli di aggiornamento dati. Funzionalità opzionali/avanzate: elaborazione in batch con gestione delle limitazioni di velocità, caching, notifiche tipo webhook e formati esportabili (JSON/CSV) con supporto di localizzazione.
Inputs & Outputs: Input includono tracking_numbers (array di stringhe, richiesto), carriers (opzionale array o mapping), include_eta (booleano, predefinito true), locale (opzionale). Output sono shipments (array di oggetti) con campi: tracking_number, carrier, status, location, timestamp, eta, history (array di eventi). Regole di validazione: numeri di tracciamento non vuoti e identificativi di carrier noti se forniti, timestamp ISO 8601 per output.
Algoritmi & Calcoli: Lo strumento usa chiamate REST API verso carriers o aggregatori con timeout e policy di retry. Regole ETA: utilizzare ETA fornita dal carrier quando disponibile; altrimenti stima tramite tempi di transito tipici per percorso e l’ultimo evento. Normalizzazione dello stato: mappa gli stati specifici del carrier a una taxonomy comune (In Transit, Out for Delivery, Delivered, Exception, Pending).
Errori & casistiche limite: input non validi, carrier sconosciuti o input mancanti provocano errori di validazione. Risultati parziali con codici di errore per spedizione quando un carrier non è raggiungibile. Timeout, rate limit o errori API provocano retry o fallback ai dati più recenti quando consentito.
Industria/Regione & Localizzazione: standard ISO 8601, orario UTC e taxonomy di stato standardizzata. Copertura globale; formati dati conforme alle convenzioni di settore. Protezione dati conforme GDPR e pratiche regionali; valuta non applicabile. Ipotesi ed esclusioni: si presuppone accesso alle API dei carrier o aggregatori autorizzati; nessuna interfaccia utente; dati non disponibili contrassegnati; nessuno streaming in tempo reale; esclude logica di instradamento interno o dati di inventario.