P44 Connect

L'integrazione può essere attivata per singolo cliente; pertanto, vengono trasmessi solo i dati relativi alle spedizioni dei clienti Deliveo designati.

Requisiti preliminari

• abbonamento alla connessione API Deliveo;
• abbonamento al servizio webhook di Deliveo;
• account Project44 attivo;
• autorizzazione all'installazione del plug-in;
• autorizzazione alla configurazione e all'utilizzo del plug-in.

Installazione e accesso

L'estensione può essere installata nel Portale di gestione, alla voce di menu Estensioni.

Dopo l’installazione, è accessibile dalla voce di menu «Componenti aggiuntivi / Project44 Connect». L’installazione e l’utilizzo possono essere effettuati solo da utenti in possesso delle autorizzazioni necessarie.

Voci di menu del componente aggiuntivo:

• Pannello di controllo
• Clienti
• Impostazioni

Collegamento all'account Project44

Quando si collega l'estensione, il sistema crea un utente tecnico nell'account Project44.

Per completare il collegamento:

1. Apri la gestione utenti di Project44.
2. Cerca l'utente il cui nome compare nella pagina Impostazioni di Project44 Connect.
3. Apri i ruoli dell'utente.
4. Nella sezione "Roles", fare clic sul pulsante "Manage Roles".
5. Aggiungi l'autorizzazione "Shipment management".
6. Salva la modifica.

Nella pagina Impostazioni di Project44 Connect, un indicatore di stato verde segnala che la connessione è stata stabilita con successo.

Configurazione dell'ID spedizione inoltrato

Nella pagina Impostazioni è possibile selezionare quale identificativo della spedizione Deliveo deve inoltrare a Project44. Gli identificativi disponibili sono:

• DeliveoID
• Numero di riferimento
• Codice di tracciamento

Per salvare il valore selezionato, clicca sul pulsante "Salva impostazioni identificativo". L'impostazione modifica solo l'identificativo inoltrato a Project44. L'abbinamento interno degli eventi di Deliveo e Project44 continua a basarsi sul DeliveoID.

Configurazione dei webhook

Project44 Connect riceve le notifiche relative agli eventi di spedizione tramite la funzione webhook di Deliveo. Per configurarla:

1. Apri la voce di menu Impostazioni / Webhook nel Portale di gestione.
2. Seleziona l'evento desiderato.
3. Apri le impostazioni avanzate dell'evento.
4. Copia l'URL del webhook visualizzato nella pagina Impostazioni di Project44 Connect per l'evento in questione.
5. Salva la configurazione del webhook.
6. Ripeti l'operazione per tutti gli eventi necessari.

Ai seguenti eventi è associato un URL webhook specifico:

• Creazione di una spedizione
• Ritiro della spedizione
• Trasferimento
• Consegna riuscita
• Consegna non riuscita

Gli URL dei webhook sono univoci, pertanto utilizza sempre gli indirizzi riportati nella pagina Impostazioni della tua installazione di Project44 Connect.

Selezione dei clienti

Nella pagina "Clienti" è possibile specificare quali dati dei clienti Deliveo devono essere trasmessi a Project44.

Per attivare un cliente:

1. Apri la voce di menu "Clienti".
2. Cerca il cliente nell'elenco.
3. Attiva l'interruttore "Attivo" presente nella riga del cliente.

Se l'opzione è attivata, gli eventi relativi alle spedizioni di quel cliente verranno inoltrati. Se l'opzione è disattivata, i dati del cliente non verranno inoltrati a Project44.

L'elenco dei clienti:

• può essere filtrata in base al nome;
• il filtro può essere cancellato;
• in caso di più pagine, è possibile sfogliare le pagine.

Prima di attivare l'integrazione, verifica che siano attivi solo i clienti di cui desideri trasmettere i dati.

Eventi trasmessi

Project44 Connect converte gli eventi di Deliveo in eventi Project44.

Esempi di mappatura degli eventi:

• Creazione di una spedizione → SHIPMENT_CREATED
• Ritiro della spedizione → PICKED_UP
• Trasferimento della spedizione → ARRIVED_AT_STOP
• Consegna riuscita → DELIVERED
• Consegna non riuscita → ad esempio DELIVERY_MISSED oppure RETURN_TO_SENDER

L'evento Project44 relativo alla mancata consegna può dipendere dall'evento di mancata consegna registrato in Deliveo.

Pannello di controllo

Il Pannello di controllo mostra le richieste webhook degli ultimi 30 giorni.

La pagina raggruppa per tipo di evento:

• le creazioni di spedizioni;
• i ritiri delle spedizioni;
• i trasferimenti di invii;
• le consegne andate a buon fine;
• i tentativi di consegna;
• le consegne non andate a buon fine.

L'elenco dettagliato degli eventi contiene i seguenti dati:

• ID Deliveo
• Evento Deliveo
• Evento P44
• Accettato
• Data

La colonna "Accettato" indica se Project44 ha accettato l'evento inviato.

L'elenco:

• può essere filtrata in base all'ID Deliveo;
• può essere sfogliata;
• può essere utilizzata per il controllo cronologico e la ricerca degli errori.

Verifica della connessione dati

Dopo la configurazione, è consigliabile verificare il funzionamento con un invio di prova.

1. Assicurati che il cliente associato alla spedizione sia attivo nella pagina Clienti.
2. Crea o modifica una spedizione in modo che si verifichi uno degli eventi webhook configurati.
3. Apri la dashboard di Project44 Connect.
4. Cerca la spedizione in base all’ID Deliveo.
5. Controlla l’evento Deliveo e l’evento P44 associato.
6. Verifica che la colonna «Accettato» indichi che la ricezione è avvenuta con successo.

Interruzione della connessione

È possibile interrompere la connessione Project44 attiva utilizzando il pulsante “Elimina connessione” nella pagina “Impostazioni”.

Prima di eliminare la connessione, verifica che non sia più necessario l'inoltro degli eventi verso Project44.

Dopo aver interrotto la connessione, è consigliabile controllare anche le impostazioni dei webhook relative a Project44 Connect nel menu Impostazioni → Webhook di Deliveo e, se necessario, rimuoverle.

Errori comuni

Gli eventi non vengono visualizzati sul pannello di controllo

Verifica:

• che la connessione sia attiva;
• che il cliente in questione sia attivo nella pagina Clienti;
• che i webhook necessari siano stati configurati;
• che all'evento corrispondente sia stato associato l'URL del webhook corretto;
• che l'evento si sia verificato negli ultimi 30 giorni.

Project44 non accetta l'evento

Verifica:

• che l'utente tecnico di Project44 disponga dei diritti di gestione delle spedizioni;
• se il collegamento all'account Project44 è attivo;
• se l'ID della spedizione inoltrata è disponibile nella spedizione;
• quali eventi Deliveo e P44 sono visibili sul pannello di controllo.

Le spedizioni di un cliente non vengono inoltrate

Apri la pagina «Clienti» e verifica che l’interruttore «Attivo» relativo al cliente in questione sia attivato.

In Project44 viene visualizzato un ID spedizione errato

Controlla l’ID spedizione selezionato nella pagina “Impostazioni”.

I valori disponibili sono:

• DeliveoID
• Numero di riferimento
• Codice di tracciamento

Dopo aver apportato le modifiche, clicca sul pulsante "Salva impostazioni identificativo".

La trasmissione di un tipo di evento non funziona

Verifica che il webhook relativo a quell'evento sia stato configurato separatamente. Per ogni tipo di evento è necessario utilizzare l'URL specifico visualizzato nella pagina Project44 Connect.