DPD France

Module DPD France pour Magento et Adobe Commerce

Prérequis

Magento

  • Compatible Magento 2.4.0 à 2.4.7, OpenSource / Adobe Commerce / Mage-OS.

PHP

  • PHP >= 8.0
  • Extension SOAP (php-soap) pour la livraison en relais Pickup

Configuration

L'activation du mode de livraison Dpd s'effectue depuis le menu :

Boutiques (Stores) > Configuration (Configuration) > Ventes (Sales) > Modes de livraison (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)
  • Activer l'assurance (Enable Insurance) : Activer l'assurance Ad Valorem à l'export des commandes

Méthodes de livraison

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

  • Predict
  • Classic
  • Relais Pickup

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 relais Pickup :

  • 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 (Sales) > Dpd > Prix (Prices)

Ajouter un tarif

  • Activer (Enable) : Activer ou non le tarif
  • Vue boutique (Store View) : Boutique sur laquelle le tarif sera appliqué. Pour appliquer sur l'ensemble des boutiques, sélectionnez "Toutes les boutiques"
  • Méthode (Method) : Méthode de livraison Dpd
  • Pays (Country) : Pays de livraison
  • Code postal (Postcode) : Code postal de livraison. Utilisez le symbole * à la fin pour une application générique (par exemple : 20*).
  • Poids de (Weight From) : Poids minimum du panier pour l'application du tarif, en kg ou lbs selon la configuration générale
  • Poids à (Weight To) : Poids maximum du panier pour l'application du tarif, en kg ou lbs selon la configuration générale
  • Prix (Price) : Prix de la livraison dans la devise du magasin
  • Livraison gratuite (Free Shipping) : Sous-total TTC du panier pour bénéficier de la livraison gratuite

Si un prix pour un code postal est défini, il sera appliqué prioritairement.

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

Pour un prix spécifique en Corse :

Prix Pays Code postal Poids (de) Poids (à)
18.90 France 20*

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 postcode 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 : DPD 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 :

Magasins (Stores) > Configuration (Configuration) > Ventes (Sales) > Paramètres de livraison (Shipping settings) > Origine (Origin)

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

Boutiques (Stores) > Configuration (Configuration) > Ventes (Sales) > Modes de livraison (Shipping Methods) > DPD > Export (Station.NET)

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

Export

L'export des commandes s'effectue depuis le menu : Ventes (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à exportées.

Export des commandes DPD

API

List of REST Endpoints

Guest cart

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

Customer 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-predict

Pickup Data

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

Price Data

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

Export

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

L'identifiant du relais Pickup ("dpd_pickup_id") est associé à l'adresse de livraison sur les endpoints natifs : 

GET    /V1/orders/:id
GET    /V1/orders

Exemples

Récupérer une liste de point de retrait

GET https://www.domain.tld/index.php/rest/V1/dpdPickup?
    searchCriteria[filter_groups][0][filters][0][field]=street&
    searchCriteria[filter_groups][0][filters][0][value]=3%20Av%20Matignon&
    searchCriteria[filter_groups][1][filters][0][field]=city&
    searchCriteria[filter_groups][1][filters][0][value]=Paris&
    searchCriteria[filter_groups][2][filters][0][field]=postcode&
    searchCriteria[filter_groups][2][filters][0][value]=75008

Récupérer les données d'un point de retrait

GET https://www.domain.tld/index.php/rest/V1/dpdPickup/P84150

Récupérer l'identifiant du point de retrait d'une commande

GET https://www.domain.tld/index.php/rest/V1/dpdPickup/order/1

Récupérer les données d'export vers Station.NET

GET https://www.domain.tld/index.php/rest/V1/dpdExport/export?orderIds[]=1&orderIds[]=2&orderIds[]=3

Récupérer la ligne d'export d'une commande vers Station.NET

GET https://www.domain.tld/index.php/rest/V1/dpdExport/export/1