Base de connaissances Deliveo

Le Deliveo Website Plugin (DWP) est un module Deliveo intégrable à un site web, qui permet aux visiteurs ou aux clients du site de déposer directement un envoi, de consulter leurs envois existants et, en fonction des fonctionnalités autorisées, d'effectuer d'autres opérations.

Le DWP se connecte au système via l’API Deliveo ; son utilisation nécessite donc un abonnement Deliveo actif et un accès à l’API.

Le module peut être intégré à votre propre site web ; il est donc particulièrement utile pour les services de livraison qui souhaitent permettre à leurs clients d’enregistrer ou de consulter leurs envois sans avoir à s’inscrire séparément ni à utiliser le portail client Deliveo.

Principales fonctionnalités

Le DWP offre notamment les fonctionnalités suivantes :

création d’un nouvel envoi ;
sélection d’une option de livraison ;
sélection d’un point de retrait ;
gestion du paiement à la livraison ;
utilisation du numéro de référence et du code de suivi ;
Gestion des champs personnalisés OP1–OP3 ;
calcul des frais d'expédition ;
calcul du poids volumétrique ;
Paiement en ligne via Barion ;
consultation des envois ;
affichage des informations de suivi ;
téléchargement de l'étiquette ;
téléchargement de la feuille de signature ;
modification ou annulation d'un envoi, le cas échéant ;
demander le retour d'un envoi livré.

Certaines des fonctions disponibles peuvent être activées ou désactivées dans les paramètres.

Envoi d’un envoi

L'une des principales fonctions du DWP est la création de nouveaux envois. Sur l'interface d'envoi, l'utilisateur peut saisir les données nécessaires à l'acheminement de l'envoi, puis le DWP les transmet au système Deliveo.

Coordonnées de l'expéditeur

Dans la section « Coordonnées de l’expéditeur », il est possible de saisir les informations nécessaires concernant le lieu d’enlèvement de l’envoi et la personne de contact. Il peut s’agir, par exemple, des éléments suivants :

le nom ;
raison sociale ;
pays ;
code postal ;
ville ;
adresse ;
numéro de téléphone ;
adresse e-mail.

Les champs effectivement affichés peuvent varier en fonction de la version et de la configuration de DWP.

Coordonnées du destinataire

Dans la section « Coordonnées du destinataire », vous devez saisir les informations nécessaires à la livraison. Tout comme pour l’expéditeur, vous pouvez indiquer ici les coordonnées de contact et l’adresse du destinataire.

Utilisation d’un point de retrait

Le DWP est capable d’afficher les emplacements actifs de type « Point de retrait » créés dans Deliveo. Le point de retrait peut être sélectionné séparément :

sur la page d’enregistrement ;
du côté de la livraison.

Ainsi, l’envoi peut partir d’un point de retrait, arriver à un point de retrait ou, selon les possibilités offertes par le service de livraison, utiliser un point de retrait des deux côtés. Le DWP importe les points de retrait directement depuis le système Deliveo ; leur gestion s’effectue donc non pas dans le DWP, mais dans les données de base correspondantes de Deliveo.

Gestion du payeur

Le DWP peut être utilisé de deux manières différentes, selon que tous les envois en ligne appartiennent ou non au même client.

Utilisation d’un client fixe

Un identifiant client fixe peut être défini dans la configuration. Dans ce cas :

chaque envoi créé via le DWP est attribué à ce client ;
aucun bloc « Payeur » distinct n’apparaît pour le visiteur ;
la relation de facturation est déterminée par le client spécifié dans la configuration.

Cette option est utile pour les sites web où le DWP est fourni à un seul client sous contrat.

Création d’un client à partir des données fournies

Si aucun Client n’est défini de manière fixe, le visiteur peut saisir les coordonnées du payeur. Le DWP vérifie alors, sur cette base, si le Client correspondant existe déjà dans le système Deliveo.

S’il est trouvé, le client existant est utilisé. Si aucun client correspondant n’est trouvé, le DWP en crée un à partir des données fournies, puis associe le nouvel envoi à ce client.

Contenu de l’envoi et colis

Un envoi peut être composé d’un ou plusieurs colis physiques. Dans le DWP, plusieurs colis peuvent être ajoutés au même envoi. Pour chaque colis, vous pouvez notamment indiquer :

poids ;
la longueur ;
la largeur ;
la hauteur ;
un identifiant unique.

Le DWP détermine les données globales de l'envoi à partir des données de chaque colis.

Poids total et volume total

En cas d’utilisation de plusieurs colis, le système additionne leur poids et leur volume. Sur la base des dimensions indiquées, le DWP calcule automatiquement le poids volumétrique.

Le poids volumétrique permet de prendre correctement en compte, lors du calcul des frais, les colis de grande taille mais relativement légers.

Options de livraison

L’option de livraison créée dans Deliveo peut être sélectionnée pour l’envoi. Le DWP importe les options de livraison disponibles depuis le système Deliveo ; leur création et leur gestion s’effectuent donc sur le portail de gestion des expéditions.

Grâce à l’option de livraison, le service de messagerie peut proposer différents modes de prestation, par exemple avec des conditions de livraison ou d’enlèvement différentes.

Paiement à la livraison

Le DWP prend en charge l’enregistrement des envois contre remboursement. Si l’envoi est assorti d’un contre-remboursement, il est possible d’indiquer le montant du contre-remboursement et les données associées. La gestion du contre-remboursement dans Deliveo s’effectue selon le processus standard de gestion des contre-remboursements.

Numéro de référence et code de suivi

Les informations suivantes peuvent être renseignées pour l'envoi :

un numéro de référence ;
un code de suivi.

Ces éléments permettent de relier les identifiants propres à des systèmes externes, des boutiques en ligne ou des processus côté client à l’envoi Deliveo.

Champs spécifiques OP1–OP3

Le DWP prend en charge les champs OP1, OP2 et OP3 de Deliveo. Il s'agit de champs de données personnalisés qui peuvent être utilisés pour demander des informations complémentaires nécessaires au fonctionnement du service de livraison. Le nom affiché de ces champs peut être modifié dans la configuration ; ainsi, le visiteur n’a pas besoin de voir les désignations techniques OP1, OP2 ou OP3.

Calcul des frais

Le DWP est capable de demander un tarif au système Deliveo sur la base des données relatives à l'envoi. Lors du calcul du tarif, les éléments suivants peuvent notamment être pris en compte :

l'adresse d'enlèvement et l'adresse de livraison ;
l'option de livraison ;
le nombre de colis ;
le poids ;
le volume ;
poids volumétrique ;
paiement à la livraison ;
les conditions tarifaires configurées dans Deliveo.

Le montant réel des frais est toujours déterminé par la tarification définie dans Deliveo.

Paiement en ligne avec Barion

Le DWP peut également être utilisé avec le paiement en ligne via Barion. Si l’intégration Barion est activée et que le calcul des frais effectué par Deliveo renvoie un montant à payer, le visiteur peut régler les frais du service en ligne dans le cadre de l’envoi de son colis.

Dans ce cas, la procédure est la suivante :

Le visiteur renseigne les informations relatives à l’envoi.
Le DWP calcule le montant des frais de livraison.
Le visiteur effectue le paiement via l'interface Barion.
Une fois le paiement effectué, le DWP crée l'envoi dans Deliveo.

Le système évite ainsi la création d’un envoi non payé en cas de paiement échoué ou interrompu.

Consultation d’un envoi

Le DWP dispose également d’une fonction dédiée à la recherche d’envois. Cette fonction peut être activée ou désactivée séparément dans la configuration. Pour rechercher un envoi, le visiteur doit saisir :

le DeliveoIDL'identifiant primaire unique de vos envois dans le système Deliveo. ;
le code postal du destinataire.

L’utilisation conjointe de ces deux informations empêche quiconque de consulter les données de l’envoi en ne connaissant que le DeliveoIDL'identifiant primaire unique de vos envois dans le système Deliveo..

Les données affichées lors de la consultation

Une fois l’identification réussie, le DWP peut afficher les informations relatives à l’envoi.

Celles-ci peuvent inclure :

le statut actuel de l’envoi ;
l'historique de l'envoi ;
le contenu du colis ;
les coordonnées de l'expéditeur ;
les coordonnées du destinataire ;
les informations de suivi ;
l'étiquette de l'envoi ;
le bon de signature.

L'affichage des coordonnées de l'expéditeur et du destinataire peut être configuré séparément.

Téléchargement de l'étiquette

L'étiquette correspondant à l'envoi recherché peut être téléchargée depuis le DWP si cette fonctionnalité est disponible. Cela s'avère utile, par exemple, lorsque l'expéditeur souhaite imprimer et apposer lui-même l'étiquette sur le colis.

Feuille de signature

L'affichage ou le téléchargement du bordereau de signature lié à la livraison peut également être autorisé. Si la fonction est active et qu'un document correspondant est disponible pour l'envoi, celui-ci est accessible depuis l'interface de consultation du DWP.

Modification et suppression d’un envoi

Dans le DWP, il est possible d’autoriser la modification et la suppression d’un envoi créé précédemment. Cette fonctionnalité n’est disponible que si elle a été activée dans la configuration du DWP. De plus, l’envoi doit remplir les conditions suivantes :

il n’a pas encore été pris en charge par le coursier ;
il n’a pas encore été livré ;
il n’a pas été payé.

Si l'une de ces conditions est déjà remplie, la modification ou la suppression de l'envoi n'est pas autorisée depuis le DWP.

Retour

Le DWP prend également en charge le lancement de la procédure de retour des envois livrés. Cette fonctionnalité peut être activée séparément. Si le retour est possible pour un envoi livré, le DWP prépare le nouveau formulaire d'expédition à partir des données de l'envoi d'origine.

Ce faisant, les données suivantes de l'envoi d'origine :

les coordonnées de l’expéditeur deviennent celles du destinataire du retour ;
les coordonnées du destinataire deviennent celles de l’expéditeur du retour

L'utilisateur n'a donc pas besoin de saisir à nouveau l'intégralité des coordonnées. Techniquement, le renvoi correspond à la création d'un nouvel envoi.

Personnalisation de l'affichage

L'apparence du DWP est en partie configurable. Il est notamment possible de définir :

un logo personnalisé ;
la couleur du thème ;
les fonctions affichées ;
le nom de certains champs ;
le nom affiché des champs OP1 à OP3 ;
données affichées sur la page de suivi.

Cela permet d'adapter l'affichage du DWP au site web du service de livraison.

Fonctionnement multilingue

Le DWP peut être utilisé en plusieurs langues. Grâce aux fichiers de langue appropriés, une même installation peut être utilisée sur plusieurs sites web ou pour différentes clientèles parlant des langues différentes.

Installation

Le DWP peut être installé sur votre propre serveur web. Pour l'installation, il suffit de copier les fichiers du programme dans le répertoire web approprié, puis de créer et de configurer le fichier de configuration. La configuration doit notamment inclure :

les informations de connexion à l'API Deliveo ;
les fonctionnalités que vous souhaitez utiliser ;
l'ID client fixe, le cas échéant ;
les paramètres d'affichage ;
les données nécessaires au paiement en ligne ;
d'autres paramètres de fonctionnement.

Les variables de configuration spécifiques nécessaires à l'installation et au fonctionnement sont contenues dans le fichier .env.example .

Téléchargement : https://gitlab.com/mav-it/deliveo-website-plugin

Démonstration : https://dwp.deliveo.eu/

Configuration requise pour le serveur

DWP est une application basée sur PHP. Il est toujours recommandé d'utiliser une version de PHP qui bénéficie encore d'un support officiel.

Le développement et la correction des bogues de Deliveo s'effectuent pour les versions de PHP prises en charge. Nous ne prenons pas en charge la correction des problèmes de compatibilité ou de fonctionnement résultant de l'utilisation d'une version PHP obsolète et qui n'est plus prise en charge. Le serveur web doit également disposer des extensions PHP nécessaires au fonctionnement de DWP et prendre en charge les connexions HTTPS externes.

Mise à jour

Après l'installation d'une nouvelle version, il est recommandé de comparer le fichier .env.example avec la configuration précédente, car l’apparition de nouvelles fonctionnalités peut entraîner l’ajout de nouvelles variables de configuration.

Le plugin est capable de se mettre à jour automatiquement depuis le site https://gitlab.com/mav-it/deliveo-website-plugin. Pour lancer la mise à jour, ajoutez /update à la fin de l'URL d'installation

Ex. : dwp.example.com/update

Informations importantes

Le DWP s’appuie sur l’API de Deliveo ; par conséquent, les données créées ou consultées dans le DWP proviennent directement du système Deliveo. Le DWP n’est pas en soi une base de données dédiée aux services de livraison, mais une interface web complémentaire de Deliveo.

Une grande partie des services disponibles, des options de livraison, des points de retrait, des tarifs et autres règles métier doit donc être configurée non pas dans le DWP, mais sur le portail de gestion Deliveo.