Supporto

Strumenti di supporto e diagnostica per il personale Xplanis: nuovo invio dei webhook di spedizione tramite caricamento di un file CSV.

La pagina Supporto mette a disposizione strumenti speciali di diagnostica e manutenzione, riservati esclusivamente al personale Xplanis con autorizzazione Superadmin. Serve a eseguire misure di supporto mirate durante l'esercizio corrente, ad esempio quando le notifiche di spedizione destinate a un sistema di terzi collegato devono essere nuovamente attivate.

Nota: Questa pagina è visibile e accessibile solo agli utenti con diritti di Superadmin. Gli utenti regolari non vedono queste funzioni.


1. Navigazione

La pagina Supporto è raggiungibile tramite le impostazioni globali. Viene visualizzata solo se l'utente connesso dispone dell'autorizzazione Superadmin richiesta.


2. Inviare nuovamente i webhook di spedizione

Questa funzione consente di attivare nuovamente le notifiche webhook per le spedizioni selezionate. Ciò è utile, ad esempio, quando un sistema di terzi collegato non ha ricevuto o elaborato una notifica e le informazioni di spedizione devono essere trasmesse nuovamente.

In caso di nuovo invio, la notifica viene rigenerata sulla base dei dati di spedizione attuali. Non viene quindi ripetuto il messaggio inviato originariamente, bensì viene generato un nuovo messaggio con lo stato attuale della spedizione.

Procedura

  1. Preparare un file CSV con le spedizioni e i trigger desiderati (vedere la sezione 2.1).
  2. Nell'area Supporto, selezionare il file .csv preparato tramite il campo di selezione del file.
  3. Fare clic sul pulsante «Invia nuovamente».
  4. Attendere il completamento dell'elaborazione. Durante l'invio, l'area è bloccata in modo da non poter attivare operazioni duplicate.

Al termine viene comunicato il numero di notifiche inviate nuovamente.

2.1 Formato del file CSV

Il file da caricare deve essere un file CSV con esattamente due colonne. La prima riga deve contenere la seguente intestazione:

ShipmentId,Trigger
ColonnaSignificato
ShipmentIdID univoco della spedizione per la quale la notifica deve essere inviata nuovamente
TriggerTrigger o evento per il quale viene generata la notifica

Ogni riga successiva descrive una notifica da inviare nuovamente.

Nota: Le voci inserite in duplice copia vengono riconosciute automaticamente ed elaborate una sola volta.

2.2 Comportamento e limitazioni

  • Le notifiche vengono elaborate in lotti per garantire un'elaborazione affidabile anche di quantità più elevate.
  • Se per un gruppo è attivo il modulo di controllo delle spedizioni, le spedizioni non ancora controllate vengono ignorate durante il nuovo invio.
  • Vengono prese in considerazione solo le spedizioni presenti nel sistema.

3. Scaricare un file CSV di esempio

Per poter preparare il file nel formato corretto, è disponibile per il download un file CSV di esempio. Il relativo link apre un file modello in una nuova scheda del browser.

Il file di esempio mostra:

  • la struttura richiesta a due colonne con l'intestazione ShipmentId,Trigger,
  • il modo in cui vengono inserite le singole voci.

Suggerimento: Utilizzare il file di esempio come punto di partenza per evitare errori nella costruzione dell'intestazione e delle colonne.


4. Riepilogo: funzioni disponibili

FunzioneDescrizioneRequisito
Inviare nuovamente i webhook di spedizioneAttivare nuovamente le notifiche per le spedizioni inserite nel CSV con i dati attualiAutorizzazione Superadmin, file CSV correttamente formattato
Scaricare un file CSV di esempioScaricare un file modello nel formato richiestoAutorizzazione Superadmin