> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecter DHL Parcel Benelux

> Connectez DHL Parcel Benelux sous Transporteurs avec l'ID utilisateur d'API, la clé d'API et le numéro de compte issus de My DHL eCommerce, ainsi que le mode test facultatif.

**DHL Parcel Benelux** expédie des colis depuis les Pays-Bas, la Belgique et le Luxembourg : colis à domicile, en ServicePoint et en boîte aux lettres, colis professionnels et palettes Europlus, Parcel Connect dans toute l'Europe, expéditions retour et enlèvements. Les champs communs à tous les transporteurs figurent dans [Identifiants des transporteurs](/docs/fr/how-to/carrier-credentials).

Pour les expéditions express dans le monde entier, voir [Connecter DHL Express](/docs/fr/how-to/connect-dhl) : il s'agit d'un compte DHL distinct. Si DHL eCommerce Europe vous a fourni un accès à l'API eConnect et un ID client, utilisez plutôt [Connecter DHL eCommerce Europe](/docs/fr/how-to/connect-dhl-ecommerce-eu).

<Info>
  Vous ne choisissez pas d'adresse de l'expéditeur dans ce formulaire. Ajoutez vos adresses sous le menu de l'organisation → **Gérer** → **Adresses**. Vous choisissez l'adresse de l'expéditeur sur chaque expédition ou dans une [règle d'expédition](/docs/fr/how-to/shipping-rule-fields). DHL Parcel Benelux expédie depuis une adresse aux Pays-Bas, en Belgique ou au Luxembourg, et les expéditions retour reviennent à une telle adresse.
</Info>

## Avant de commencer

* Un compte professionnel DHL eCommerce avec accès à **My DHL eCommerce**. L'équipe commerciale de DHL ouvre les comptes professionnels. **En savoir plus** sur la carte ouvre [DHL eCommerce for business](https://www.dhlecommerce.nl/en/business).
* Une clé d'API issue de My DHL eCommerce (voir ci-dessous), et le **numéro de compte** DHL sur lequel vos expéditions et vos enlèvements sont facturés, par exemple `08500001`.
* Pour **Mode test** : un compte de test fourni par l'équipe commerciale de DHL. Votre clé d'API de production ne fonctionne pas sur le système de test de DHL.

Vous pouvez connecter DHL Parcel Benelux plusieurs fois. Donnez à chaque connexion son propre **Nom du transporteur**.

## Obtenir votre clé d'API

Dans My DHL eCommerce, ouvrez **Settings** dans le menu utilisateur, allez dans l'onglet **API keys** et cliquez sur **Create API key**. DHL n'affiche l'ID utilisateur et la clé qu'une seule fois : copiez-les donc tous les deux immédiatement. Une nouvelle clé remplace aussitôt l'ancienne : mettez donc à jour chaque connexion de ce compte DHL dans **Modifier le transporteur**.

## Connecter DHL Parcel Benelux

<Steps>
  <Step title="Ouvrir Tous les transporteurs">
    Dans la barre latérale, cliquez sur **Transporteurs**, puis ouvrez l'onglet **Tous les transporteurs**.
  </Step>

  <Step title="Trouver DHL Parcel Benelux">
    Sur la carte **DHL Parcel Benelux**, cliquez sur **Connecter**.
  </Step>

  <Step title="Remplir le formulaire">
    La fenêtre **Connecter un transporteur** s'ouvre. Saisissez un **Nom du transporteur**, votre **ID utilisateur d'API**, votre **Clé d'API** et votre **Numéro de compte**. **Mode test** se trouve sous **Champs facultatifs**.
  </Step>

  <Step title="Connecter le transporteur">
    Cliquez sur **Connecter**. Vous voyez « Transporteur connecté », et le transporteur apparaît dans l'onglet **Mes transporteurs**.
  </Step>
</Steps>

<Frame caption="La carte DHL Parcel Benelux dans Tous les transporteurs">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/zippendo/images/how-to/connect-dhl-parcel-nl/01-all-carriers-card-light.png" alt="Tous les transporteurs avec la carte DHL Parcel Benelux et ses boutons Connecter et En savoir plus" className="block dark:hidden" />

  <img src="https://mintlify.s3.us-west-1.amazonaws.com/zippendo/images/how-to/connect-dhl-parcel-nl/01-all-carriers-card-dark.png" alt="Tous les transporteurs avec la carte DHL Parcel Benelux et ses boutons Connecter et En savoir plus" className="hidden dark:block" />
</Frame>

<Frame caption="Connecter un transporteur pour DHL Parcel Benelux - renseignez ID utilisateur d'API, Clé d'API et Numéro de compte">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/zippendo/images/how-to/connect-dhl-parcel-nl/02-connect-modal-light.png" alt="Fenêtre Connecter un transporteur pour DHL Parcel Benelux avec les champs obligatoires ID utilisateur d'API, Clé d'API et Numéro de compte" className="block dark:hidden" />

  <img src="https://mintlify.s3.us-west-1.amazonaws.com/zippendo/images/how-to/connect-dhl-parcel-nl/02-connect-modal-dark.png" alt="Fenêtre Connecter un transporteur pour DHL Parcel Benelux avec les champs obligatoires ID utilisateur d'API, Clé d'API et Numéro de compte" className="hidden dark:block" />
</Frame>

## Champs du formulaire

| Champ | Obligatoire | Ce qu'il faut saisir |
| - | - | - |
| **Nom du transporteur** | Oui | Le nom que vous voyez dans **Mes transporteurs** et lorsque vous choisissez un transporteur sur une expédition. Il démarre à **DHL Parcel Benelux**. |
| **Marque** | Non | Affiché uniquement si votre organisation a des [marques](/docs/fr/how-to/create-a-brand). Le formulaire indique : « Seule cette marque peut utiliser ce transporteur. » Laissez vide pour que toutes les marques puissent l'utiliser. |
| **ID utilisateur d'API** | Oui | Affiché lorsque vous créez la clé. Copiez-le exactement. Le formulaire indique : « L'ID utilisateur de votre clé d'API, disponible dans My DHL eCommerce sous Settings > API keys. » |
| **Clé d'API** | Oui | Affichée une seule fois, avec l'ID utilisateur. Le formulaire indique : « Le secret de la même clé d'API, dans My DHL eCommerce sous Settings > API keys. » |
| **Numéro de compte** | Oui | Figure dans votre contrat DHL. Le formulaire indique : « Votre numéro de compte DHL eCommerce, facturé pour les expéditions et les enlèvements (par exemple 08500001). » |
| **Mode test** | Non | Une case à cocher, décochée par défaut. Le formulaire indique : « Utiliser l'environnement de test de DHL Parcel. Nécessite des identifiants de test fournis par l'équipe commerciale de DHL ; votre clé d'API habituelle n'y fonctionne pas. » |

**Connecter** ne fait rien tant que **Nom du transporteur**, **ID utilisateur d'API**, **Clé d'API** et **Numéro de compte** n'ont pas de valeur.

Laissez **Mode test** désactivé pour les vraies commandes. Un compte de test ne fonctionne que lorsque **Mode test** est activé, et votre clé d'API de production que lorsqu'il est désactivé. Voir [Mode test](/docs/fr/how-to/sandbox-mode).

## Après la connexion

Le transporteur apparaît dans **Mes transporteurs** avec un badge **Connecté**. Vous choisissez l'offre sur chaque expédition ou dans une règle d'expédition, pas dans ce formulaire. Voir [Offres transporteur et services](/docs/fr/how-to/carrier-products-and-services). Une offre ou un service additionnel qui ne figure pas dans votre contrat DHL est refusé lors de l'envoi, avec le motif donné par DHL.

| Offre | Livre à | Colis par expédition | Poids max. |
| - | - | - | - |
| **DHL Parcel Home delivery** | Des particuliers aux Pays-Bas et en Belgique. | Un | 31 kg |
| **DHL Parcel ServicePoint delivery** | Un DHL ServicePoint ou une consigne automatique aux Pays-Bas ou en Belgique. | Un | 20 kg |
| **DHL Parcel Mailbox parcel** | Des boîtes aux lettres aux Pays-Bas et en Belgique, jusqu'à 38 x 26 x 3 cm. Pas au départ du Luxembourg. | Un | 2 kg |
| **DHL Europlus Business delivery** | Des entreprises aux Pays-Bas, en Belgique et au Luxembourg. | Plusieurs colis ou palettes | 31 kg par colis, 1000 kg par palette |
| **DHL Europlus International** | Des entreprises dans toute l'Europe, y compris la Suisse, la Norvège et le Royaume-Uni. | Plusieurs colis ou palettes | 31 kg par colis, 1000 kg par palette |
| **DHL Parcel Connect Home delivery** | Des particuliers dans les autres pays de l'UE. | Un | 31 kg |
| **DHL Parcel Connect ServicePoint delivery** | Un DHL ServicePoint dans les autres pays de l'UE. | Un | 31 kg |
| **DHL Parcel Return** | Expédition retour : votre client vous renvoie un colis à votre adresse. | Un | 31 kg |

Pour une offre à un seul colis, scindez d'abord une expédition qui comporte plusieurs colis. Voir [Scinder et déplacer des colis](/docs/fr/how-to/split-and-move-parcels). Les offres Home, ServicePoint, Mailbox et Parcel Connect nécessitent l'adresse e-mail du destinataire.

### Services additionnels et informations supplémentaires

Choisissez les services additionnels sur l'expédition ou dans une règle d'expédition. Chaque offre liste les services additionnels qu'elle propose, et certains ne s'appliquent que dans certains pays.

| Service | Ce qu'il fait |
| - | - |
| **Livraison en soirée** / **Livraison le samedi** | Livraison en soirée ou le samedi. Vous ne pouvez pas utiliser les deux sur une même expédition. |
| **Signature à la livraison** / **Signature au ServicePoint** | Le destinataire signe pour le colis. |
| **Pas de livraison chez un voisin** | DHL ne laisse pas le colis chez un voisin. |
| **Vérification de l'âge à la livraison** | DHL vérifie l'âge du destinataire. |
| **Plusieurs tentatives de livraison** | DHL tente de livrer plus d'une fois. |
| **Expresser (livraison avant 11:00)** / **Livraison sur un chantier** | Livraison Europlus Business avant 11:00, ou sur un chantier. |
| **Assurance tous risques** | Assure le colis. Renseignez **Montant assuré (EUR)**. |
| **Étiquette de retour incluse** | Ajoute une étiquette de retour pour votre client aux documents de l'expédition. |
| **Retour sans impression (code QR par e-mail)** | Pour **DHL Parcel Return** depuis les Pays-Bas. Voir « Expéditions retour » ci-dessous. |

Sous **Informations supplémentaires pour le transporteur**, chaque offre comporte aussi **Format d'étiquette** (PDF, ou ZPL pour une imprimante d'étiquettes Zebra) et **Type de colis**. Laissez **Type de colis** vide, et Zippendo le choisit d'après le poids et les dimensions de chaque colis.

### DHL ServicePoints (points relais)

**DHL Parcel ServicePoint delivery** et **DHL Parcel Connect ServicePoint delivery** livrent dans un point relais. Choisissez le point relais dans la section **Point relais** de l'expédition avant l'envoi. Voir [Choisir un point relais](/docs/fr/how-to/pick-a-service-point) et [Points relais](/docs/fr/how-to/drop-point-and-service-points).

### Expéditions retour

**DHL Parcel Return** ramène un colis de votre client à votre adresse. Votre client le dépose dans un DHL ServicePoint. Avec **Retour sans impression (code QR par e-mail)**, DHL envoie par e-mail à votre client un code QR à présenter au ServicePoint au lieu d'une étiquette. Cela nécessite l'adresse e-mail de votre client, et l'expédition n'obtient pas de numéro de suivi. Voir [Expéditions retour](/docs/fr/how-to/inbound-and-returns).

### Douane

Les expéditions **DHL Europlus International** qui quittent l'UE comportent une déclaration en douane établie à partir des lignes de commande. Chaque ligne de commande doit avoir une description, un code tarifaire (code SH), une quantité, une valeur et un pays d'origine, le tout dans une seule devise. **Motif d'exportation** et **Numéro de facture** sont des informations facultatives de l'offre. DHL établit la déclaration en douane ou la facture commerciale, et Zippendo l'ajoute aux documents de l'expédition. Vos numéros EORI et VOEC proviennent des [Paramètres de l'organisation](/docs/fr/how-to/organization-settings). Voir [Douane et documents](/docs/fr/how-to/customs-and-documents).

### Enlèvements et suivi

* **Enlèvements :** vous pouvez réserver des enlèvements DHL Parcel Benelux sous **Enlèvements**. Voir [Planifier un enlèvement](/docs/fr/how-to/schedule-a-pickup). Le formulaire d'enlèvement n'a pas de champs horaires pour DHL, et l'expédition elle-même n'a pas de créneau d'enlèvement à définir. Choisissez une date après aujourd'hui et une adresse aux Pays-Bas, en Belgique ou au Luxembourg comportant un nom, une rue et une ville. DHL reçoit vos **Instructions particulières (facultatif)**. Vous ne pouvez ni annuler ni modifier un enlèvement DHL dans Zippendo. Pour annuler, contactez DHL Parcel avec la **Référence transporteur**.
* **Suivi :** Zippendo récupère lui-même les mises à jour de suivi auprès de DHL. Il n'y a rien à configurer. L'**Historique de suivi** commence lorsque DHL enregistre le colis, et le **Lien de suivi** ouvre la page de suivi de DHL. Voir [Webhooks de suivi des transporteurs](/docs/fr/how-to/tracking-webhooks).

## Modifier ou supprimer la connexion

Pour la modifier, ouvrez **Transporteurs** → **Mes transporteurs** et cliquez sur **Modifier le transporteur** sur la carte. La page **Modifier le transporteur** comporte deux sections :

* **Général** : **Nom du transporteur**, et **Marque** si votre organisation a des marques.
* **Paramètres du transporteur** : **ID utilisateur d'API**, **Clé d'API**, **Numéro de compte** et **Mode test**.

Cliquez sur **Enregistrer**. Vous voyez « Transporteur mis à jour ».

Pour la supprimer, cliquez sur **Supprimer** sur la même page, saisissez le nom du transporteur en majuscules, puis cliquez sur **Supprimer**. Les règles d'expédition qui utilisent ce transporteur sont supprimées avec lui. Les expéditions déjà envoyées conservent leurs étiquettes et leurs numéros de suivi.

## Problèmes courants

| Ce que vous voyez | Que faire |
| - | - |
| Rien ne se passe lorsque vous cliquez sur **Connecter** | Renseignez **Nom du transporteur**, **ID utilisateur d'API**, **Clé d'API** et **Numéro de compte**. |
| « Impossible de connecter le transporteur. Réessayez. » | Réessayez. |
| « Vous avez atteint la limite de votre formule. Changez de formule ou supprimez un élément que vous n'utilisez plus. » ou « Vous dépassez les limites de votre formule. Changez de formule ou supprimez ce que vous n'utilisez plus. » | La limite de transporteurs de votre formule est atteinte. Voir [Facturation et utilisation](/docs/fr/how-to/billing-and-usage). |
| « Le transporteur a refusé vos identifiants. Mettez-les à jour sous Transporteurs. » | La clé d'API est incorrecte ou a été remplacée, ou elle ne correspond pas à **Mode test**. Corrigez-la dans **Modifier le transporteur**. |
| « Les paramètres du transporteur sont incomplets ou non valides. Vérifiez-les sous Transporteurs. » | L'**ID utilisateur d'API** n'a pas été copié exactement. Copiez-le à nouveau depuis **Settings** → **API keys** dans My DHL eCommerce. |
| « Certaines options de cette offre transporteur sont manquantes ou non valides. Vérifiez les services additionnels et les options de l'expédition, puis réessayez. » | Plusieurs colis sur une offre à un seul colis, une adresse e-mail du destinataire manquante, un service additionnel hors de ses pays, ou une assurance sans montant. L'expédition indique ce qu'il faut modifier. |
| « La déclaration en douane est incomplète. Chaque article doit avoir une description, une quantité et une valeur déclarée supérieure à zéro. » | Une ligne de commande n'a pas de données douanières. Renseignez-les et envoyez à nouveau. |
| « DHL Parcel Benelux n'a pas pu créer l'expédition. » | DHL a refusé l'expédition. L'expédition affiche le motif donné par DHL, par exemple une offre qui ne figure pas dans votre contrat. |
| « Cette offre transporteur livre en point relais. Choisissez un point relais avant l'envoi. » | Choisissez un DHL ServicePoint sur l'expédition. |
| « L'offre transporteur choisie ne dessert pas ces pays. Choisissez-en une autre. » | Choisissez une offre adaptée à ce trajet. |
| « Le transporteur a accepté l'expédition, mais son étiquette n'a pas pu être téléchargée. Le colis sera tout de même enlevé. Utilisez Récupérer l'étiquette sur l'expédition pour réessayer. » | Cliquez sur **Récupérer l'étiquette** sur l'expédition. |
| « Le transporteur a émis l'étiquette, mais n'a pas pu produire l'un des documents d'accompagnement. Vérifiez les documents de l'expédition avant de remettre le colis. » | Le formulaire douanier n'a pas été téléchargé. Téléchargez-le dans My DHL eCommerce avant de remettre le colis. |
| « La connexion avec le transporteur a été perdue avant sa réponse. Zippendo n'a aucune confirmation que l'expédition a été créée : vérifiez auprès du transporteur avant de la renvoyer. » | Recherchez d'abord l'expédition dans My DHL eCommerce. |
| L'enlèvement affiche **Échec** dans la liste **Enlèvements** avec « Le transporteur a refusé la demande. Consultez le motif indiqué par le transporteur, corrigez les informations et réessayez. » | Vérifiez que la date est postérieure à aujourd'hui et que l'adresse d'enlèvement se trouve aux Pays-Bas, en Belgique ou au Luxembourg et comporte un nom, une rue et une ville. Si tout est correct, renseignez-vous auprès de DHL Parcel avant de demander à nouveau l'enlèvement : il est peut-être déjà planifié. |
| « Le transporteur n'a pas confirmé l'enlèvement, il a donc peut-être quand même été planifié. Vérifiez auprès du transporteur avant de planifier à nouveau l'enlèvement. » | DHL Parcel a peut-être planifié l'enlèvement même s'il n'a pas répondu. Renseignez-vous auprès de DHL Parcel avant de le demander à nouveau, afin que le chauffeur ne passe pas deux fois. |

Plus d'aide : [Échecs d'authentification auprès des transporteurs](/docs/fr/knowledge-base/carrier-authentication-failures).

## Voir aussi

* [Connecter DHL eCommerce Europe](/docs/fr/how-to/connect-dhl-ecommerce-eu)
* [Connecter DHL Express](/docs/fr/how-to/connect-dhl)
* [Connecter un transporteur ou une intégration](/docs/fr/how-to/connect-index)
* [Identifiants des transporteurs](/docs/fr/how-to/carrier-credentials)
* [Mode test](/docs/fr/how-to/sandbox-mode)
* [Offres transporteur et services](/docs/fr/how-to/carrier-products-and-services)
* [Planifier un enlèvement](/docs/fr/how-to/schedule-a-pickup)
* [Demander une intégration de transporteur](/docs/fr/how-to/request-carrier-integration)
* [Transporteurs](/docs/fr/tutorials/carriers)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.