> ## 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 PostNL

> Connectez PostNL sous Transporteurs avec votre clé d'API, votre code client et votre numéro client, ainsi que le lieu de dépôt et le mode test facultatifs.

**PostNL** expédie des colis aux Pays-Bas et en Belgique : à domicile, vers des points PostNL et des consignes automatiques, avec des créneaux de livraison et des retours. Il expédie aussi dans toute l'UE et dans le monde entier avec des déclarations en douane. Les champs communs à tous les transporteurs figurent dans [Identifiants des transporteurs](/docs/fr/how-to/carrier-credentials).

<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).
</Info>

Chaque expédition PostNL est envoyée avec votre propre clé d'API PostNL et les informations de votre contrat.

## Avant de commencer

* Un contrat professionnel PostNL (PostNL Pakketten) avec les produits que vous voulez utiliser activés.
* Une **Clé d'API** PostNL depuis [Mijn PostNL](https://mijn.postnl.nl/). PostNL vous donne une clé pour son système de test et une autre pour les vraies expéditions. Une clé de test ne fonctionne qu'avec **Mode test** activé.
* Votre **Code client** PostNL (1 à 6 caractères, par exemple `DEVC`) et votre **Numéro client** (8 chiffres maximum). Vous trouvez les deux sur votre contrat PostNL et dans Mijn PostNL.
* Facultatif : le code à 6 chiffres du **Lieu de dépôt**, si PostNL vous en a donné un.

Vous pouvez connecter PostNL plusieurs fois, par exemple une connexion par contrat. Donnez à chacune son propre **Nom du transporteur**. **En savoir plus** sur la carte ouvre la page de PostNL pour les clients professionnels.

## Connecter PostNL

<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 PostNL">
    Sur la carte **PostNL**, cliquez sur **Connecter**.
  </Step>

  <Step title="Remplir le formulaire">
    La fenêtre **Connecter un transporteur** s'ouvre. Saisissez un **Nom du transporteur**, votre **Clé d'API**, **Code client** et **Numéro client**. **Lieu de dépôt** et **Mode test** se trouvent 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>

## 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 à **PostNL**. |
| **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. |
| **Clé d'API** | Oui | Votre clé issue de Mijn PostNL. Le formulaire indique : « Votre clé d'API PostNL issue de Mijn PostNL (les clés de test ne fonctionnent qu'en mode test). » |
| **Code client** | Oui | Le formulaire indique : « Code client attribué par PostNL Pakketten (1 à 6 caractères, par exemple DEVC). » |
| **Numéro client** | Oui | Le formulaire indique : « Numéro client attribué par PostNL Pakketten (8 chiffres maximum). » |
| **Lieu de dépôt** | Non | Exactement 6 chiffres. Le formulaire indique : « Code à 6 chiffres du lieu de dépôt PostNL prévu dans votre contrat, si vous en avez un. » |
| **Mode test** | Non | Une case à cocher, décochée par défaut. Le formulaire indique : « Utiliser le système de test de PostNL avec une clé d'API de test. Laissez désactivé pour les vraies expéditions. » |

**Connecter** ne fait rien tant que **Nom du transporteur**, **Clé d'API**, **Code client** et **Numéro client** n'ont pas de valeur. Si **Code client** dépasse 6 caractères, si **Numéro client** dépasse 8 caractères, ou si **Lieu de dépôt** ne compte pas exactement 6 caractères, vous voyez « Impossible de connecter le transporteur. Réessayez. »

**Mode test** envoie vos expéditions au système de test de PostNL, de sorte qu'aucune vraie expédition n'est créée. Utilisez votre clé d'API de test tant qu'il est activé, et votre clé de production 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 et services des transporteurs](/docs/fr/how-to/carrier-products-and-services).

La description de chaque offre indique son code produit PostNL, ce qui vous permet de la rapprocher de votre contrat. Vous ne pouvez envoyer qu'avec les offres que PostNL a activées pour vous. Les autres offres sont refusées lors de l'envoi, avec « PostNL n'a pas pu créer l'expédition. »

Groupes d'offres :

* Aux Pays-Bas (expéditeur aux Pays-Bas) : **Expédition standard**, livraison uniquement à l'adresse indiquée, signature à la livraison, assurance complémentaire, vérification de l'âge, colis boîte aux lettres et offres de **Retrait en point PostNL**.
* Pays-Bas vers Belgique, à l'intérieur de la Belgique et Belgique vers Pays-Bas, chacun avec ses propres offres.
* **Parcel EU**, pour les particuliers (2C) et les entreprises (2B), en versions Track & Trace, Insured et Insured Plus.
* **Parcel Non EU** et offres de courrier international (comme **Packet Track & Trace**) pour le reste du monde. Elles comportent une déclaration en douane établie à partir des lignes de commande.
* **Retours** : retour vers un numéro de réponse professionnel ou vers une adresse personnelle, retours à l'intérieur de la Belgique et vers la Belgique, et **Easy Return Service** depuis l'étranger.

### Créneaux de livraison et choix supplémentaires

Les offres aux Pays-Bas proposent ces services : **Livraison en soirée (17:30–22:00)**, **Livraison le jour même (remise avant 11:00)** et **Livraison garantie avant 10:00**, **12:00** ou **17:00**. Lorsque vous en activez un, renseignez aussi **Date de livraison** sous **Informations supplémentaires pour le transporteur**.

Certaines offres nécessitent des informations supplémentaires sur l'expédition :

* Les offres avec assurance complémentaire nécessitent **Montant assuré (EUR)**, jusqu'à 5000.
* Les offres avec vérification de l'âge nécessitent **Date de naissance du destinataire**.
* Les colis boîte aux lettres nécessitent **Date de livraison**.
* **Format d'étiquette** vous permet de choisir **PDF** (par défaut) ou **ZPL (thermique)** pour une imprimante d'étiquettes Zebra.

### Points PostNL (points relais)

Les offres dont le nom commence par **Retrait en point PostNL** livrent dans un point PostNL, comme un commerce ou une consigne automatique. Les points sont disponibles pour les adresses aux Pays-Bas et en Belgique. Choisissez le point sur 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).

### Plusieurs colis dans une expédition

Vous pouvez envoyer jusqu'à quatre colis dans une expédition. Les colis boîte aux lettres sont toujours à raison d'un colis par expédition. Aux Pays-Bas, PostNL traite les colis comme une seule expédition avec une étiquette par colis. Sur les autres trajets, chaque colis devient sa propre expédition PostNL.

### Enlèvements, suivi et douane

* PostNL n'est pas disponible sous **Enlèvements**. Les enlèvements s'organisent via votre contrat PostNL.
* Zippendo récupère les mises à jour de suivi de PostNL toutes les heures. Il n'y a rien à configurer. Voir [Webhooks de suivi des transporteurs](/docs/fr/how-to/tracking-webhooks).
* Pour les expéditions hors de l'UE, PostNL renvoie les déclarations en douane (CN23/CP71) et la facture commerciale avec l'étiquette, Zippendo n'ajoute donc pas les siennes. Voir [Douane et documents](/docs/fr/how-to/customs-and-documents).

## 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** : **Clé d'API**, **Code client**, **Numéro client**, **Lieu de dépôt** 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 |
| - | - |
| « Impossible de connecter le transporteur. Réessayez. » | Vérifiez les champs obligatoires et les longueurs décrites ci-dessus, puis réessayez. |
| « Vous avez atteint la limite de votre formule. Changez de formule ou supprimez un élément 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. » lors de l'envoi | La clé d'API est incorrecte, ou elle ne correspond pas à **Mode test** (une clé de test avec **Mode test** désactivé, ou l'inverse). Corrigez-la dans **Modifier le transporteur**. |
| « PostNL n'a pas pu créer l'expédition. » ou le texte d'erreur propre à PostNL | PostNL a refusé l'expédition, par exemple parce que l'offre ne figure pas dans votre contrat ou que l'adresse est incorrecte. Corrigez ce que le message indique et envoyez à nouveau. |
| « 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. » | Une information obligatoire manque, comme **Montant assuré (EUR)**, **Date de livraison** ou **Date de naissance du destinataire**. Renseignez-la sous **Informations supplémentaires pour le transporteur**. |
| « Cette offre transporteur livre en point relais. Choisissez un point relais avant l'envoi. » | Choisissez un point PostNL sur l'expédition. |
| « L'offre transporteur choisie ne dessert pas ces pays. Choisissez-en une autre. » | Choisissez une offre adaptée à ce trajet, par exemple une offre **Parcel EU** pour un autre pays de l'UE. |

## Voir aussi

* [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 et services des transporteurs](/docs/fr/how-to/carrier-products-and-services)
* [Choisir un point relais](/docs/fr/how-to/pick-a-service-point)
* [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.