Documentation du Dpd

Magento

• Magento supérieure ou égale à la version 2.1 (2.1+, 2.2+, 2.3+, 2.4+) pour les versions CE et EE

Note : pour la version 2.4.0 uniquement, un patch officiel Magento est à appliquer : Shipping labels creation known issue in Magento 2.4.0

Le bug apparaît sur la version 2.4.0 (résolu en 2.4.1). Il provoque des dysfonctionnements dans la génération des étiquettes et l'affichage des livraisons.

Tunnels de commande

Liste des tunnels de commande compatibles

PHP

• Version de PHP comprise entre 7.2 et 8.1
• Extension SOAP (php-soap) pour la livraison en Relais

L'activation du mode de livraison Dpd s'effectue depuis le menu : Stores > Configuration > Sales > Shipping Methods > Dpd

Général

• Activé (Enabled) : activer les méthodes d'expédition Dpd
• Titre (Title) : titre de la méthode
• Tri (Sort Order) : position de la méthode dans le tunnel de commande
• Afficher la méthode si elle n'est pas applicable (Show Method if Not Applicable) : afficher la méthode Dpd même si elle ne peut s'appliquer à l'adresse de livraison du client
• Message d'erreur (Displayed Error Message) : Message affiché si la méthode ne peut s'appliquer à l'adresse de livraison du client
• Calcul du poids (Weight Calculation) : Permet d'autoriser ou non les méthodes de livraison DPD pour un panier dont le poids dépasse le seuil autorisé
• Ouvrir la fenêtre au clic sur la méthode de livraison (Open pop-in on shipping method selection) : Ouvrir directement ou non la pop-in au clic sur la méthode (Relais et Predic)

Méthodes de livraison

Activez les méthodes de livraison Dpd souhaitées :

• Predict
• Classic
• Point de retrait

Paramètres :

• Activé (Enabled) : activer la méthode
• Nom (Name) : nom de la méthode
• Poids maximum (Maximum Weight) : poids maximum accepté pour affichage de la méthode
• Pays (Ship to Specific Countries) : pays activés pour la méthode
• Tri (Sort Order) : position de la méthode

Uniquement en point de retrait :

• Carrier (Carrier) : Identifiant d'accès à l'API
• Key (Key) : Clé de sécurité
• Type de carte (Map Type) : Google Maps (licence) ou OpenStreetMap (gratuit)
  • Google Map API Key (Google Map API Key) : clé d'API Google pour affichage de la carte. Générer une clé.

Menu

La configuration des prix s'effectue depuis le menu Ventes > Dpd > Prix

Ajouter un tarif

• Activer : Activer ou non le tarif
• Vue boutique : Boutique sur laquelle le tarif sera appliqué. Pour appliquer sur l'ensemble des boutiques, sélectionnez "Toutes les boutiques"
• Méthode : Méthode de livraison Dpd
• Pays : Pays de livraison
• Poids de : Poids minimum du panier pour l'application du tarif, en kg ou lbs selon la configuration générale
• Poids à : Poids maximum du panier pour l'application du tarif, en kg ou lbs selon la configuration générale
• Prix : Prix de la livraison dans la devise du magasin
• Livraison gratuite : Sous-total TTC du panier pour bénéficier de la livraison gratuite

Exemples

Pour une tarification au forfait, la configuration du prix sera par exemple :

Pour une tarification par poids, la configuration sera par exemple :

Exports

Pour l'export CSV des tarifs, sélectionnez l'action Exporter

Imports

Pour l'import CSV des tarifs, sélectionnez l'action Importer

Le fichier CSV doit contenir, dans l'ordre indiqué, les colonnes suivantes :

Les codes des méthodes (colonne method) sont les suivants :

• predict : DPD Predict
• classic : DPD classic
• pickup : DPS relais Pickup

Configuration

Il est nécessaire de renseigner l'adresse de l'expéditeur. Les données utilisées sont celles contenues dans la configuration native suivante :

Stores > Configuration > Sales > Shipping settings > Origin

D'autres champs (optionnels) peuvent être renseignés dans la configuration du module :

Stores > Configuration > Sales > Shipping Methods > Dpd > Export (Station.NET)

• N° de compte chargeur : Numéro de compte communiqué par DPD. Pour une multi-boutique avec plusieurs comptes cette configuration est indispensable.
• E-mail expéditeur : E-mail de l'expéditeur
• Téléphone fixe expéditeur : Numéro de téléphone fixe de l'expéditeur
• Téléphone mobile expéditeur : Numéro de téléphone mobile de l'expéditeur
• Méthodes d'expédition à exporter : Méthode à afficher dans la grille d'export des commandes DPD

Export

L'export des commandes s'effectue depuis le menu : Sales > DPD > Export ou depuis la grille des commandes via l'action DPD Export (Export DPD).

Sélectionnez les commandes que vous souhaitez exporter puis l'action Exporter. Le fichier généré est un fichier plat au format txt à importer dans Station.NET

Un flag Exporté (dpd_is_exported) passe à oui une fois l'action Exporter sélectionnée. Vous pouvez alors filtrer sur les commandes déjà contenues dans un fichier d'export.

List of REST Endpoints

GET    /V1/guest-carts/:cartId/dpd-pickup
PUT    /V1/guest-carts/:cartId/dpd-pickup/:pickupId/:telephone
DELETE /V1/guest-carts/:cartId/dpd-pickup

GET    /V1/guest-carts/:cartId/dpd-predict
PUT    /V1/guest-carts/:cartId/dpd-predict/:telephone
DELETE /V1/guest-carts/:cartId/dpd-predict

GET    /V1/carts/mine/dpd-pickup
PUT    /V1/carts/mine/dpd-pickup/:pickupId/:telephone
DELETE /V1/carts/mine/dpd-pickup

GET    /V1/carts/mine/dpd-predict
PUT    /V1/carts/mine/dpd-predict/:telephone
DELETE /V1/carts/mine/dpd-predict

GET    /V1/dpdPickup/:pickupId
GET    /V1/dpdPickup
GET    /V1/dpdPickup/order/:orderId

GET    /V1/dpdPrice/:priceId
GET    /V1/dpdPrice/search
POST   /V1/dpdPrice
DELETE /V1/dpdPrice/:priceId
DELETE /V1/dpdPrice

GET    /V1/dpdExport/export
GET    /V1/dpdExport/export/:orderId