Prérequis
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
Configuration
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é.
Frais de livraison
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 :
Prix | Pays | Poids (de) | Poids (à) |
5.90 | France |
Pour une tarification par poids, la configuration sera par exemple :
Prix | Pays | Poids (de) | Poids (à) |
5.38 | France | 0.25 | |
5.98 | France | 0.25 | 0.50 |
6.70 | France | 0.50 | 0.75 |
7.26 | France | 0.75 | 1.00 |
8.06 | France | 1.00 |
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 :
method | store_id | country_id | weight_from | weight_to | price | is_active |
pickup | 0 | FR | 0.25 | 5.46 | 1 |
Les codes des méthodes (colonne method) sont les suivants :
- predict : DPD Predict
- classic : DPD classic
- pickup : DPS relais Pickup
Export des commandes vers Station.NET
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.

API
List of REST Endpoints
Guest cartGET /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-predictCustomer cart
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-predictPickup Data
GET /V1/dpdPickup/:pickupId GET /V1/dpdPickup GET /V1/dpdPickup/order/:orderIdPrice Data
GET /V1/dpdPrice/:priceId GET /V1/dpdPrice/search POST /V1/dpdPrice DELETE /V1/dpdPrice/:priceId DELETE /V1/dpdPriceExport
GET /V1/dpdExport/export GET /V1/dpdExport/export/:orderId