Plugin per il sito web Deliveo (DWP)

Il Deliveo Website Plugin (DWP) è un modulo Deliveo integrabile in un sito web che consente ai visitatori o ai clienti del sito di effettuare direttamente la spedizione, verificare le spedizioni esistenti e, a seconda delle funzionalità abilitate, eseguire ulteriori operazioni.

Il DWP si collega al sistema tramite l’API di Deliveo, pertanto per il suo utilizzo sono necessari un abbonamento Deliveo attivo e l’accesso all’API.

Il modulo può essere integrato nel proprio sito web, pertanto è utile soprattutto per i corrieri che desiderano consentire ai propri clienti di registrare o consultare le spedizioni senza dover effettuare una registrazione separata o utilizzare il Portale Clienti Deliveo.

Funzionalità principali

Il DWP offre, tra le altre, le seguenti funzionalità:

• creazione di una nuova spedizione;

• selezione dell’opzione di consegna;

• scelta del punto di ritiro;

• gestione del pagamento in contrassegno;

• utilizzo del numero di riferimento e del codice di tracciamento;

• Gestione dei campi personalizzati OP1–OP3;

• calcolo delle spese di spedizione;

• calcolo del peso volumetrico;

• pagamento online con Barion;

• ricerca della spedizione;

• visualizzazione delle informazioni di tracciamento;

• download dell'etichetta;

• download del modulo di firma;

• modifica o cancellazione della spedizione, se autorizzata;

• avvio della procedura di restituzione di una spedizione consegnata.

Alcune delle funzioni disponibili possono essere attivate o disattivate dalle impostazioni.

Invio di spedizioni

Una delle funzioni principali del DWP è la creazione di nuove spedizioni. Nell’interfaccia di invio delle spedizioni, l’utente può inserire i dati necessari per la consegna della spedizione, dopodiché il DWP li inoltra al sistema Deliveo.

Dati del mittente

Nei dati del mittente è possibile inserire le informazioni necessarie relative al luogo di ritiro della spedizione e al referente. Queste possono includere, ad esempio:

• nome;

• ragione sociale;

• paese;

• codice postale;

• città;

• indirizzo;

• numero di telefono;

• indirizzo e-mail.

I campi effettivamente visualizzati possono variare a seconda della versione e della configurazione di DWP.

Dati del destinatario

Nei dati del destinatario è necessario inserire le informazioni necessarie per la consegna. Analogamente al mittente, anche qui è possibile inserire i dati di contatto e l'indirizzo del destinatario.

Utilizzo dei punti di ritiro

Il DWP è in grado di visualizzare le ubicazioni attive di tipo “Punto di ritiro” create in Deliveo. Il punto di ritiro può essere selezionato separatamente:

• nella pagina di ritiro;

• nella pagina di consegna.

In questo modo, la spedizione può partire da un punto di ritiro, arrivare a un punto di ritiro oppure – a seconda delle opzioni offerte dal servizio di corriere – il punto di ritiro può essere utilizzato su entrambi i lati. Il DWP importa i punti di ritiro direttamente dal sistema Deliveo, pertanto la loro gestione non avviene nel DWP, ma nei relativi dati anagrafici di Deliveo.

Gestione del pagatore della fattura

Il DWP può essere utilizzato in due modi, a seconda che tutte le spedizioni online appartengano allo stesso Cliente.

Utilizzo di un cliente fisso

Nella configurazione è possibile specificare un ID cliente fisso. In questo caso:

• ogni spedizione creata tramite il DWP verrà assegnata a questo Cliente;

• al visitatore non viene visualizzato un blocco separato relativo al pagatore;

• il rapporto di fatturazione è determinato dal Cliente specificato nella configurazione.

Questa opzione è utilizzabile nei casi in cui il DWP sia fornito a un unico Cliente convenzionato.

Creazione di un Cliente in base ai dati specificati

Se non è stato impostato un Cliente fisso, il visitatore può inserire i dati del pagatore della fattura. Sulla base di questi dati, il DWP verifica se il Cliente corrispondente esiste già nel sistema Deliveo.

Se lo trova, utilizza il cliente esistente. Se non trova un cliente corrispondente, il DWP lo crea in base ai dati inseriti e associa la nuova spedizione a tale cliente.

Contenuto della spedizione e Colli

Una spedizione può essere costituita da uno o più pacchi fisici, ovvero Colli. Nel DWP è possibile aggiungere più Colli alla stessa spedizione. Per ogni singolo Colli è possibile specificare, tra le altre cose:

• peso;

• lunghezza;

• larghezza;

• altezza;

• identificativo univoco.

Il DWP determina i dati complessivi della spedizione sulla base dei dati relativi ai singoli colli.

Peso totale e volume totale

In caso di utilizzo di più Colli, il sistema somma il loro peso e il loro volume. Sulla base delle dimensioni dei pacchi specificate, il DWP calcola automaticamente anche il peso volumetrico.

Grazie al peso volumetrico, anche i pacchi di grandi dimensioni ma relativamente leggeri possono essere presi in considerazione in modo adeguato nel calcolo della tariffa.

Opzioni di spedizione

Per la spedizione è possibile selezionare l’opzione di spedizione creata in Deliveo. Il DWP importa le opzioni di spedizione disponibili dal sistema Deliveo, pertanto la loro creazione e gestione avviene sul Portale di gestione.

Grazie all’opzione di consegna, il corriere può offrire diverse modalità di servizio, ad esempio con condizioni di consegna o ritiro differenti.

Pagamento in contrassegno

Il DWP supporta la registrazione delle spedizioni in contrassegno. Se alla spedizione è associato un contrassegno, è possibile specificare l’importo del contrassegno e i dati correlati. La gestione del contrassegno in Deliveo avviene secondo la normale procedura di gestione del contrassegno.

Numero di riferimento e codice di tracciamento

Per la spedizione è possibile specificare:

• Numero di riferimento;

• Codice di tracciamento.

Grazie a questi dati, è possibile collegare al pacco Deliveo anche gli identificativi propri di sistemi esterni, negozi online o processi lato cliente.

Campi univoci OP1–OP3

Il DWP supporta i campi OP1, OP2 e OP3 di Deliveo. Si tratta di campi dati personalizzati che possono essere utilizzati per richiedere informazioni aggiuntive necessarie al funzionamento del servizio di corriere. Il nome visualizzato dei campi può essere modificato nella configurazione, in modo che il visitatore non debba vedere le denominazioni tecniche OP1, OP2 o OP3.

Calcolo delle tariffe

Il DWP è in grado di richiedere la tariffa al sistema Deliveo sulla base dei dati della spedizione. Nel calcolo della tariffa possono essere presi in considerazione, tra l’altro:

• indirizzo di ritiro e di consegna;

• l'opzione di trasporto;

• numero di pacchi;

• peso;

• il volume;

• peso volumetrico;

• pagamento in contrassegno;

• condizioni tariffarie configurate in Deliveo.

La tariffa effettiva è sempre determinata dalle impostazioni tariffarie configurate in Deliveo.

Pagamento online con Barion

Il DWP può essere utilizzato anche con il pagamento online tramite Barion. Se l’integrazione con Barion è abilitata e il calcolo delle tariffe di Deliveo restituisce un importo da pagare, il visitatore può pagare online il costo del servizio come parte della procedura di spedizione.

In questo caso, la procedura è la seguente:

1. Il visitatore inserisce i dati della spedizione.

2. Il DWP recupera il costo della spedizione.

3. Il visitatore effettua il pagamento sull’interfaccia di Barion.

4. Una volta effettuato il pagamento, il DWP crea la spedizione su Deliveo.

In questo modo il sistema evita che, in caso di pagamento non andato a buon fine o interrotto, venga creata una spedizione non pagata.

Ricerca delle spedizioni

Il DWP dispone anche di una funzione specifica per la ricerca delle spedizioni. Questa funzione può essere attivata o disattivata separatamente nella configurazione. Per effettuare la ricerca di una spedizione, il visitatore deve inserire:

• il DeliveoID;

• il codice postale del destinatario.

L’uso combinato di questi due dati impedisce che chiunque, conoscendo solo un DeliveoID, possa visualizzare i dati della spedizione.

I dati visualizzati al momento della consultazione

Dopo un'identificazione riuscita, il DWP può visualizzare le informazioni relative alla spedizione.

Tra queste possono figurare:

• lo stato attuale della spedizione;

• il registro della spedizione;

• il contenuto del pacco;

• i dati del mittente;

• i dati del destinatario;

• le informazioni di tracciamento;

• l'etichetta della spedizione;

• il modulo di firma.

La visualizzazione dei dati del mittente e del destinatario è configurabile separatamente.

Download dell'etichetta

L'etichetta relativa alla spedizione ricercata può essere scaricata dal DWP, se tale funzione è disponibile. Ciò è utile, ad esempio, se il mittente della spedizione desidera stampare e applicare autonomamente l'etichetta sul pacco.

Modulo di firma

È inoltre possibile abilitare la visualizzazione o il download del foglio di firma relativo alla consegna. Se la funzione è attiva e per la spedizione è disponibile il documento corrispondente, questo è accessibile dall’interfaccia di consultazione del DWP.

Modifica ed eliminazione della spedizione

Nel DWP è possibile autorizzare la modifica e la cancellazione di una spedizione creata in precedenza. La funzione è utilizzabile solo se abilitata nella configurazione del DWP. Inoltre, la spedizione deve soddisfare le seguenti condizioni:

• non sia ancora stato ritirato dal corriere;

• non è ancora stato consegnato;

• non è stato pagato.

Se una di queste condizioni è già stata soddisfatta, la modifica o la cancellazione della spedizione dal DWP non è consentita.

Reso

Il DWP supporta anche l’avvio della procedura di restituzione delle spedizioni consegnate. Questa funzione può essere abilitata separatamente. Se per una spedizione consegnata è disponibile l’opzione di restituzione, il DWP prepara il nuovo modulo di spedizione utilizzando i dati della spedizione originale.

In questo caso, i dati originali:

• i dati del mittente diventano quelli del destinatario della restituzione;

• i dati del destinatario diventano quelli del mittente della restituzione

.

In questo modo, l’utente non dovrà digitare nuovamente tutti i dati dell’indirizzo. La restituzione comporta tecnicamente la creazione di una nuova spedizione.

Personalizzazione dell’aspetto

L'aspetto del DWP è parzialmente configurabile. Tra le altre cose, è possibile impostare:

• il proprio logo;

• colore del tema;

• funzioni visualizzate;

• nome dei singoli campi;

• nome visualizzato dei campi OP1–OP3;

• dati visualizzati nella pagina di tracciamento.

In questo modo è possibile adattare l'aspetto del DWP al sito web del corriere.

Funzionamento multilingue

Il DWP è disponibile in più lingue. Grazie ai file di lingua appropriati, la stessa installazione può essere utilizzata su siti web in diverse lingue o per diverse fasce di clienti.

Installazione

Il DWP può essere installato su un server web proprio. Per l’installazione è necessario copiare i file del programma nella directory web appropriata, quindi creare e configurare il file di configurazione. Nella configurazione è necessario specificare, tra le altre cose:

• i dati di connessione all’API di Deliveo;

• le funzioni che si desidera utilizzare;

• l'eventuale ID cliente fisso;

• le impostazioni di visualizzazione;

• i dati necessari per il pagamento online;

• altri parametri operativi.

Le variabili di configurazione specifiche necessarie per l'installazione e il funzionamento sono contenute nel file .env.example .

Download: https://gitlab.com/mav-it/deliveo-website-plugin

Demo: https://dwp.deliveo.eu/

Requisiti del server

DWP è un'applicazione basata su PHP. Si raccomanda di utilizzare sempre una versione di PHP ancora ufficialmente supportata.

Lo sviluppo e la correzione dei bug di Deliveo avvengono sulle versioni di PHP supportate. Non ci assumiamo la responsabilità di correggere errori di compatibilità o di funzionamento derivanti dall’uso di versioni PHP obsolete e non più supportate. Il server web deve disporre degli estensioni PHP necessarie per il funzionamento di DWP e della possibilità di connessioni HTTPS esterne.

Aggiornamento

Dopo l’installazione di una nuova versione, è consigliabile confrontare il file .env.example con la configurazione precedente, poiché l’introduzione di nuove funzionalità potrebbe comportare l’aggiunta di nuove variabili di configurazione.

Il plugin è in grado di aggiornarsi automaticamente dal sito https://gitlab.com/mav-it/deliveo-website-plugin. Per eseguire l’aggiornamento, aggiungere /update all’URL di installazione

Es.: dwp.example.com/update

Informazioni importanti

Il DWP si basa sull’API di Deliveo, pertanto i dati creati o interrogati nel DWP provengono direttamente dal sistema Deliveo. Il DWP non è di per sé un database separato dedicato ai servizi di corriere, ma rappresenta l’interfaccia web integrata di Deliveo.

Gran parte dei servizi disponibili, delle opzioni di consegna, dei punti di ritiro, delle tariffe e delle altre regole aziendali deve quindi essere configurata non nel DWP, ma nel Portale di gestione Deliveo.