> ## 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 Posti
> Connectez Posti dans Zippendo avec votre ID client, votre secret client et votre numéro de contrat logistique, ainsi que le nom d'utilisateur et le mot de passe facultatifs de la Tracking API.
**Posti** expédie des colis depuis la Finlande : vers des consignes automatiques et des points relais Posti, en livraison à domicile, en Express le lendemain, en petits colis livrés à domicile, en retours clients, et en colis Priority et EMS dans le monde entier. Les champs communs à tous les transporteurs figurent dans [Identifiants des transporteurs](/docs/fr/how-to/carrier-credentials).
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). Posti expédie depuis une adresse en Finlande ou dans les îles Åland, et les retours reviennent à une adresse en Finlande.
## Avant de commencer
* Un compte client professionnel Posti avec un **numéro de contrat logistique**, généralement composé de six chiffres.
* Un utilisateur dans [OmaPosti Pro](https://pro.posti.fi/) avec le rôle **API Manager**, pour vous connecter au [Posti Developer Portal](https://developer.posti.com/). Si vous n'avez pas ce rôle, demandez à l'utilisateur OmaPosti Pro principal de votre organisation d'ouvrir **Users management → Users**, de cliquer sur **Edit** sur votre utilisateur et de cocher **API Manager** sous **Other services**.
* Un compte d'application dans le Developer Portal, pour l'**ID client** et le **Secret client**. Les étapes sont décrites ci-dessous.
* Facultatif, pour le suivi : un compte de service **Tracking API** fourni par le service client de Posti. Vous pouvez envoyer des expéditions sans lui.
Vous pouvez connecter Posti plusieurs fois, par exemple une connexion par contrat logistique. Donnez à chacune son propre **Nom du transporteur**. **En savoir plus** sur la carte ouvre la page de Posti consacrée à ses services pour l'e-commerce.
## Obtenir vos identifiants Posti
Ouvrez [developer.posti.com](https://developer.posti.com/) et connectez-vous avec votre utilisateur OmaPosti Pro.
Ouvrez **Configure application accounts → Application account list** et cliquez sur **Add new application account user**. Activez **Enabled** et donnez-lui un nom, par exemple `Zippendo`.
Sélectionnez **shippingapi** et **2026-04**. Sans **2026-04**, vous pouvez envoyer des expéditions, mais la recherche de points relais et les retours sans étiquette ne fonctionnent pas.
Ajoutez le numéro de contrat logistique que vous saisirez dans Zippendo, puis cliquez sur **Save**.
Le portail ne les affiche qu'une seule fois. Copiez-les tous les deux. Si vous perdez le secret, créez de nouveaux identifiants dans le portail et mettez à jour le transporteur dans Zippendo.
Pour le suivi, demandez au service client de Posti un compte de service **Tracking API** pour votre contrat. Posti vous envoie un nom d'utilisateur et un mot de passe.
## Connecter Posti
Dans la barre latérale, cliquez sur **Transporteurs**, puis ouvrez l'onglet **Tous les transporteurs**.
Sur la carte **Posti**, cliquez sur **Connecter**.
La fenêtre **Connecter un transporteur** s'ouvre. **Nom du transporteur** est déjà rempli avec « Posti ». Saisissez votre **ID client**, votre **Secret client** et votre **Numéro de contrat logistique**. **Nom d'utilisateur de la Tracking API** et **Mot de passe de la Tracking API** se trouvent sous **Champs facultatifs**.
Cliquez sur **Connecter**. Vous voyez « Transporteur connecté », et le transporteur apparaît dans l'onglet **Mes transporteurs**.
## Champs du formulaire
**Secret client** et **Mot de passe de la Tracking API** masquent ce que vous saisissez.
| 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 à **Posti**. |
| **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 client** | Oui | Le formulaire indique : « Depuis le Developer Portal de Posti (developer.posti.com) : le Client ID de l'utilisateur de compte d'application que vous ajoutez pour Zippendo. Sélectionnez les deux rôles d'API, shippingapi et 2026-04. » |
| **Secret client** | Oui | Le formulaire indique : « Le Client secret que le Developer Portal affiche une seule fois, avec le Client ID. » |
| **Numéro de contrat logistique** | Oui | Chiffres uniquement. Le formulaire indique : « Votre numéro de contrat logistique Posti, généralement six chiffres commençant par 6. Ajoutez-le au même utilisateur de compte d'application dans le Developer Portal, sinon Posti refuse vos expéditions. » |
| **Nom d'utilisateur de la Tracking API** | Non | Renseignez les deux champs de suivi ou aucun. Le formulaire indique : « Le nom d'utilisateur de la Tracking API que le service client de Posti vous fournit pour votre contrat. Nécessaire uniquement pour suivre vos expéditions. » |
| **Mot de passe de la Tracking API** | Non | Le formulaire indique : « Le mot de passe que Posti envoie avec le nom d'utilisateur de la Tracking API. Posti bloque le compte pendant une heure après cinq tentatives de connexion échouées. » |
**Connecter** ne fait rien tant que **Nom du transporteur**, **ID client**, **Secret client** et **Numéro de contrat logistique** n'ont pas de valeur.
## Tester la connexion
Posti n'a pas de système de test : il n'y a donc pas de case **Mode test**. Chaque expédition que vous envoyez est une vraie expédition Posti sur votre contrat logistique. Posti indique qu'une expédition n'est facturée que si elle est physiquement expédiée : une étiquette de test que vous ne remettez jamais ne coûte donc rien.
Pour essayer la connexion, envoyez une expédition à votre propre adresse et vérifiez son étiquette. Posti prévient le destinataire : indiquez donc votre propre adresse e-mail et votre propre numéro de téléphone sur une expédition de test. Zippendo ne peut pas annuler une expédition Posti : contactez Posti si vous devez en faire annuler une. 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 qui ne figure pas dans votre contrat Posti est refusée lors de l'envoi, avec le motif donné par Posti.
| Offre | Livre à | Poids max. |
| - | - | - |
| **Postal Parcel (Postipaketti)** | Une consigne automatique ou un point relais Posti en Finlande, dans les îles Åland, en Estonie, en Lettonie ou en Lituanie. | 25 kg |
| **Home Parcel (Kotipaketti)** | La porte du destinataire, à un moment que Posti convient avec lui. Finlande, îles Åland et pays baltes. | 25 kg, 35 kg avec Encombrant |
| **Express Parcel (Express-paketti)** | Livraison le lendemain contre signature. Finlande, îles Åland et pays baltes. | 25 kg, 35 kg avec Encombrant |
| **Small Parcel to Door (Pikkupaketti ovelle)** | La boîte aux lettres ou la porte du destinataire en Finlande et dans les îles Åland, jusqu'à 38 x 38 x 28 cm. | 4 kg |
| **Retour (Palautus)** (expédition retour) | Votre client dépose un colis dans n'importe quel point relais ou consigne automatique Posti, à destination de votre adresse en Finlande. | 25 kg, 35 kg avec Encombrant |
| **Priority Parcel** | Plus de 200 pays, à domicile ou en point relais selon le pays. | 25 kg, 30 kg avec Encombrant |
| **EMS** | Plus de 200 pays, à domicile contre signature. | 25 kg, 30 kg avec Encombrant |
Toutes les offres, sauf **Retour (Palautus)**, nécessitent le numéro de téléphone du destinataire, pour les avis de Posti. **Home Parcel (Kotipaketti)** et **Express Parcel (Express-paketti)** peuvent comporter plusieurs colis dans une expédition. Les autres offres acceptent un colis par expédition.
### Services additionnels et informations supplémentaires
Chaque offre propose deux choix sous **Informations supplémentaires pour le transporteur** :
* **Format d'étiquette** : PDF (par défaut) ou ZPL pour les imprimantes thermiques.
* **Instructions de livraison** : jusqu'à 120 caractères imprimés sur l'étiquette, par exemple un code de porte.
Les étiquettes mesurent 10 x 15 cm. Les offres internationales qui n'ont pas d'étiquette à ce format s'impriment sur une page A5.
Vous choisissez les services additionnels sur l'expédition ou dans une règle d'expédition. Chaque offre liste les services additionnels que Posti propose pour elle : **Avis d'arrivée par SMS ou e-mail**, **Préavis avant livraison**, **Fragile**, **Encombrant (colis hors format)**, **Pas de consigne automatique extérieure**, **Livraison le samedi**, **Remise en main propre (contrôle d'identité)**, **Recommandé (remis contre signature)**, **Livraison sans signature**, **Heure de livraison convenue par téléphone**, **Appel avant livraison**, **Transport sans énergie fossile (part allouée)** et, uniquement pour **Retour (Palautus)**, **Retour sans étiquette (code d'envoi)**. Choisissez **Encombrant (colis hors format)** pour un colis de plus de 25 kg ou plus grand que le format standard de l'offre.
### Points relais Postipaketti
**Postal Parcel (Postipaketti)** livre dans un point relais. Choisissez le point relais dans la section **Point relais** de l'expédition avant l'envoi. La recherche nécessite le rôle **2026-04** sur votre compte d'application. 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).
### Retours
**Retour (Palautus)** ramène un colis de votre client à votre adresse. Il ne nécessite pas de point relais, et votre contrat Posti doit inclure les retours clients.
Avec **Retour sans étiquette (code d'envoi)**, votre client écrit un code sur le colis au lieu d'imprimer une étiquette. L'expédition affiche le code comme **Code sans étiquette** sous **Informations de suivi**. Envoyez-le à votre client. Si Posti crée le retour sans code, l'expédition affiche un avertissement. Envoyez alors l'étiquette à votre client.
### Douane
Les expéditions vers un pays hors de l'UE, et à destination ou en provenance des îles Åland, des îles Canaries, de Ceuta ou de Melilla, transmettent les données douanières des lignes de commande : description, code tarifaire (code SH), quantité, valeur et pays d'origine. Posti renvoie la déclaration en douane et la facture commerciale avec l'étiquette, et elles apparaissent avec les documents de l'expédition.
Ajoutez votre numéro EORI sous [Paramètres de l'organisation](/docs/fr/how-to/organization-settings). Lorsque le destinataire a un numéro EORI, saisissez-le dans **Numéro EORI du destinataire** sur le destinataire. Voir [Douane et documents](/docs/fr/how-to/customs-and-documents).
### Enlèvements et suivi
* Posti n'est pas disponible sous **Enlèvements**. Organisez les enlèvements directement avec Posti. Vous ne pouvez pas définir de créneau d'enlèvement sur une expédition Posti. Voir [Planifier un enlèvement](/docs/fr/how-to/schedule-a-pickup) pour les transporteurs qui le sont.
* Lorsque **Nom d'utilisateur de la Tracking API** et **Mot de passe de la Tracking API** sont renseignés, Zippendo récupère les mises à jour de suivi de Posti environ toutes les heures. Sans eux, aucun événement de suivi n'apparaît. Chaque expédition a tout de même son numéro de suivi et un **Lien de suivi** vers posti.fi. Si l'identifiant de suivi est incorrect, corrigez-le dans **Modifier le transporteur** et cliquez sur **Enregistrer**. 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 client**, **Secret client**, **Numéro de contrat logistique**, **Nom d'utilisateur de la Tracking API** et **Mot de passe de la Tracking API**.
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, 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 | L'**ID client** ou le **Secret client** est incorrect, ou le compte d'application n'a pas les deux rôles d'API. Corrigez-le dans le Developer Portal ou dans **Modifier le transporteur**. |
| « Les paramètres du transporteur sont incomplets ou non valides. Vérifiez-les sous Transporteurs. » | **Numéro de contrat logistique** contient autre chose que des chiffres. Corrigez-le dans **Modifier le transporteur**. |
| « Posti n'a pas pu créer l'expédition. » | Posti a refusé l'expédition, par exemple parce que le numéro de contrat logistique n'est pas attribué au compte d'application. L'expédition affiche le motif donné par Posti. Corrigez-le 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. » | Le numéro de téléphone du destinataire manque, l'expédition comporte trop de colis pour l'offre, un colis est trop lourd ou trop grand, ou Posti ne propose pas à cet endroit un service additionnel choisi. L'expédition indique ce qui ne va pas. |
| « Cette offre transporteur livre en point relais. Choisissez un point relais avant l'envoi. » | Choisissez un point relais pour **Postal Parcel (Postipaketti)** sur l'expédition. |
| « L'offre transporteur choisie ne dessert pas ces pays. Choisissez-en une autre. » | Choisissez une offre Posti qui couvre le pays du destinataire. |
| « 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. » | Il manque à une ligne de commande une description, un code tarifaire, une quantité ou une valeur. Renseignez-la et envoyez à nouveau. |
| « Le transporteur a accepté l'expédition, mais n'a fourni ni étiquette ni code QR, et Zippendo ne peut pas les redemander. Demandez-les au transporteur et n'envoyez pas l'expédition une nouvelle fois. » | Contactez Posti pour obtenir l'étiquette. N'envoyez pas l'expédition une nouvelle fois. |
| « 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. » | Vérifiez auprès de Posti si l'expédition existe avant de la renvoyer. |
| Aucun événement de suivi n'apparaît | Vérifiez que les deux champs de suivi sont renseignés et corrects. |
| « Impossible de joindre les transporteurs pour le moment. Réessayez dans un instant. » ou « Le transporteur a refusé la demande. Consultez le motif indiqué par le transporteur, corrigez les informations et réessayez. » | Patientez un instant et envoyez à nouveau, ou corrigez ce qu'indique le motif donné par Posti. |
Plus d'aide : [Échecs d'authentification auprès des transporteurs](/docs/fr/knowledge-base/carrier-authentication-failures).
## 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 transporteur et services](/docs/fr/how-to/carrier-products-and-services)
* [Choisir un point relais](/docs/fr/how-to/pick-a-service-point)
* [Douane et documents](/docs/fr/how-to/customs-and-documents)
* [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.