Comment se connecter à Maersk Global eCommerce

Dans cet article, vous découvrirez comment connecter Maersk Global eCommerce à ShippyPro et comment configurer la livraison à domicile, la livraison en point relais (PUDO), les retours et la clôture des expéditions (manifeste).

Maersk Global eCommerce est la plateforme européenne de Maersk pour les colis e-commerce. C'est la nouvelle intégration Maersk, disponible depuis mai 2026. Si vous utilisez encore l'ancienne connexion, consultez l'article Comment se connecter à Maersk E-Delivery Final Mile.

Sommaire :

1. Avant de commencer
2. Configuration du transporteur
3. Options supplémentaires
4. Erreurs & Solutions

1. Avant de commencer

Pour configurer Maersk Global eCommerce, il vous faut :

• un contrat actif avec Maersk ;
• une Consumer Key et un Consumer Secret : les identifiants API de votre application sur le Maersk Developer Portal. Si vous ne les avez pas encore, demandez-les à votre Account Manager Maersk ;
• votre entrepôt enregistré par Maersk comme point de départ des expéditions. Maersk doit finaliser l'onboarding de votre compte et associer l'adresse de votre entrepôt.

❗ L'adresse d'expéditeur utilisée dans ShippyPro doit correspondre à l'entrepôt enregistré par Maersk. Sinon, Maersk refuse la création de l'étiquette.

2. Configuration du transporteur

1. Allez dans la section Transporteurs et cliquez sur le logo Maersk Global eCommerce (tapez « Maersk » dans la barre de recherche pour le trouver en quelques secondes).

2. Saisissez les identifiants reçus de Maersk :

• Consumer Key
• Consumer Secret

Veillez à ne pas coller d'espaces avant ou après les identifiants. ShippyPro vérifie les identifiants à l'enregistrement.

3. Remplissez ensuite les autres champs :

Service : le service par défaut de vos expéditions. Choisissez Home Delivery, Home Delivery International, PUDO Delivery ou PUDO Return (voir Types de service ci-dessous).

Label Type :

• PDF 4x6 (par défaut)
• ZEBRA 10x15 (203 DPI)

Pre-sort : activez cette option si Maersk vous a demandé de remettre vos expéditions déjà triées dans un seul sac ou conteneur (overpack). Lors de la clôture des expéditions, ShippyPro crée aussi l'étiquette de l'overpack. Avec le Pre-sort activé, toutes les expéditions clôturées ensemble doivent aller vers le même pays de destination.

Overpack Customer Code : obligatoire si le Pre-sort est activé. C'est un code d'exactement 5 caractères (lettres A-Z et chiffres 0-9) attribué par Maersk.

Custom label name : facultatif. Le nom sous lequel vous verrez cette connexion dans ShippyPro.

Test Mode : cette option n'a aucun effet pour Maersk Global eCommerce. C'est la Consumer Key qui détermine si la connexion est de test ou de production : utilisez les identifiants de test fournis par Maersk pour faire des essais.

4. Cliquez sur Enregistrer pour finaliser la connexion.

3. Options supplémentaires

Destinations

Nationales : elles dépendent du pays de votre entrepôt enregistré par Maersk. Maersk opère dans toute l'Europe, par exemple en Italie, Allemagne, aux Pays-Bas, en France, Espagne, Autriche, Belgique, au Danemark et au Royaume-Uni.

Internationales :

• vers les pays de l'UE : service Home Delivery, sans données douanières ;
• vers les pays hors UE ou les zones soumises à la douane (par exemple le Royaume-Uni et les îles Canaries) : ShippyPro utilise automatiquement Home Delivery International. Vérifiez que la commande contient les données douanières : code SH et pays d'origine de chaque article, numéro EORI et numéro de TVA de l'expéditeur. Les numéros IOSS et EORI sont aussi envoyés s'ils sont renseignés.

Options

• Label Type : PDF 4x6, ZPL 10x15 (203 DPI)
• Track & Trace : disponible
• PickUp/DropOff (PUDO) : disponible
• Cash On Delivery : disponible
• Return Labels : disponible
• Return Labels (in the box) : NON disponible
• Multiparcel : disponible
• Delete Shipment (Void) : disponible
• Closeout : disponible (obligatoire pour chaque expédition)
• Credentials Validation : disponible
• Checkout : disponible
• Live Rates : NON disponible
• Book/Schedule Pickup : NON disponible (Maersk enlève les colis dans votre entrepôt enregistré)
• Address Check : NON disponible
• Insurance : NON disponible
• Non-Delivery Options : NON disponible
• Paperless : NON disponible (retours avec QR code bientôt disponibles)
• Proof Of Delivery (POD) : NON disponible (bientôt disponible)
• CN22 / CN23 : pas nécessaires. Maersk gère la douane avec les données envoyées dans l'expédition.

Types de service

• Home Delivery : livraison à domicile, nationale et vers les pays de l'UE.
• Home Delivery International : livraison à domicile vers les pays hors UE et les zones soumises à la douane. Si vous avez configuré Home Delivery, ShippyPro passe automatiquement à ce service quand la destination l'exige.
• PUDO Delivery : livraison dans un point relais Maersk. Nécessite l'option transporteur Pickup Point ID.
• PUDO Return : retour avec une étiquette imprimée par votre client, qui dépose le colis dans n'importe quel point relais Maersk participant. ShippyPro l'utilise automatiquement pour chaque expédition de retour.

Bientôt disponibles : les services Select (Select Home, Select PUDO, Select PUDO Return) et Essential. Nous mettrons à jour cet article dès leur sortie.

Options transporteur

Clôture des expéditions (Closeout)

Avec Maersk Global eCommerce, vous devez clôturer toutes les expéditions pour envoyer le manifeste à Maersk. Quelques règles :

• clôturez ensemble uniquement les expéditions confiées au même transporteur du dernier kilomètre (par exemple DHL Parcel NL) : Maersk l'attribue à la création de l'étiquette ;
• avec le Pre-sort activé, clôturez ensemble uniquement les expéditions vers le même pays de destination. Vous recevrez aussi l'étiquette de l'overpack à apposer sur le sac ou le conteneur.

Retours

Les étiquettes de retour utilisent le service PUDO Return : votre client imprime l'étiquette et dépose le colis dans n'importe quel point relais Maersk participant. Le colis est livré à votre entrepôt enregistré.

📌 Certains transporteurs du dernier kilomètre ne permettent pas d'annuler une étiquette de retour (par exemple DHL Parcel NL aux Pays-Bas). Dans ce cas, contactez Maersk pour l'annuler.

Checkout

Maersk Global eCommerce est aussi disponible dans ShippyPro Checkout : vous pouvez proposer à vos clients la livraison à domicile et la livraison en point relais Maersk.

4. Erreurs & Solutions

No matching Maersk facility found
L'adresse d'expéditeur ne correspond pas à l'entrepôt enregistré par Maersk. Vérifiez l'adresse enregistrée avec Maersk et utilisez la même adresse comme expéditeur dans ShippyPro.

Pickup Point ID manquant
Le service PUDO Delivery nécessite un point relais. Ajoutez l'option transporteur Pickup Point ID à l'expédition.

Invalid PUDO
Le point relais n'existe plus ou n'est pas valide pour l'adresse du destinataire. Vérifiez qu'il se trouve dans le même pays que le destinataire et sélectionnez-en un nouveau.

No Routing Available
Le trajet demandé (pays de départ, pays de destination et service) n'est pas activé sur votre compte Maersk. Contactez votre Account Manager Maersk pour l'activer.

declaredValue is required and must be greater than 0 for Premium coverage customers
Votre compte Maersk dispose de la couverture Premium, qui exige une valeur déclarée. Contactez notre support pour vérifier la configuration.

Void operation is not supported for carrier …
Le transporteur du dernier kilomètre ne permet pas d'annuler cette étiquette (par exemple les retours DHL Parcel NL). Contactez Maersk pour l'annuler.

Erreur de clôture : final supplier manquant ou différent
Les expéditions sélectionnées sont confiées à des transporteurs du dernier kilomètre différents. Clôturez séparément les expéditions de chaque transporteur.

Erreur de clôture avec le Pre-sort activé
Vérifiez que l'Overpack Customer Code comporte exactement 5 caractères (A-Z, 0-9) et que toutes les expéditions sélectionnées vont vers le même pays.

Invalid Credentials
La Consumer Key ou le Consumer Secret ne sont pas corrects. Vérifiez que vous les avez copiés sans espaces.