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

# Demander une intégration de transporteur

> Demandez à Zippendo d'ajouter un transporteur absent de l'onglet Tous les transporteurs, depuis Demandes de transporteur, avec le site web du transporteur, ses identifiants de test et la méthode de connexion.

Si le transporteur que vous utilisez ne figure pas dans l'onglet **Tous les transporteurs**, vous pouvez demander à Zippendo de créer la connexion. Vous envoyez le site web du transporteur, les liens vers sa documentation et des identifiants de **test**, et Zippendo crée et teste la connexion avec l'IA. Lorsqu'elle est prête, vous connectez le transporteur comme n'importe quel autre.

Pour un transporteur déjà présent dans **Tous les transporteurs**, voir [Identifiants des transporteurs](/docs/fr/how-to/carrier-credentials). La présentation complète se trouve dans [Transporteurs](/docs/fr/tutorials/carriers).

## Vos demandes

Dans la barre latérale, cliquez sur **Demandes de transporteur**. La page s'intitule **Demandes de transporteur** et liste vos demandes sous **Vos demandes**. Cliquez sur **Demander un transporteur** en haut pour en envoyer une nouvelle.

La liste comporte ces colonnes : **Transporteur**, **Statut**, **Méthode de connexion**, **Envoyée le** et **Dernière mise à jour**. Cliquez sur une ligne pour voir les détails. Lorsque vous n'avez encore aucune demande, la page affiche « Aucune demande de transporteur » et un bouton **Demander un transporteur**.

<Frame caption="La page Demandes de transporteur avant votre première demande">
  <img src="https://mintcdn.com/zippendo/KTui86ABjYKAHhqP/images/fr/how-to/request-carrier-integration/01-request-list-light.png?fit=max&auto=format&n=KTui86ABjYKAHhqP&q=85&s=a96b488752a4fe3461224f490f13231a" alt="Page Demandes de transporteur sans demande pour le moment et le bouton Demander un transporteur" className="block dark:hidden" width="2880" height="1800" data-path="images/fr/how-to/request-carrier-integration/01-request-list-light.png" />

  <img src="https://mintcdn.com/zippendo/KTui86ABjYKAHhqP/images/fr/how-to/request-carrier-integration/01-request-list-dark.png?fit=max&auto=format&n=KTui86ABjYKAHhqP&q=85&s=829746a05e1b978eed8d59f09a8489dc" alt="Page Demandes de transporteur sans demande pour le moment et le bouton Demander un transporteur" className="hidden dark:block" width="2880" height="1800" data-path="images/fr/how-to/request-carrier-integration/01-request-list-dark.png" />
</Frame>

### Statut

| Statut | Signification |
| - | - |
| **En attente** | Vous avez envoyé la demande. Elle attend l'approbation de Zippendo. |
| **Approuvée** | Zippendo a accepté la demande. Le travail peut commencer. |
| **En cours** | Zippendo crée la connexion. |
| **En attente de vérification** | La connexion est créée et attend une vérification par l'équipe Zippendo. |
| **Terminé** | La création est terminée. |
| **Publiée** | Le transporteur est prêt. Vous pouvez le connecter depuis **Tous les transporteurs**. |
| **Refusée** | Zippendo n'a pas accepté la demande. |
| **Échec** | La création a échoué. |

## Envoyer une demande

<Steps>
  <Step title="Ouvrir le formulaire">
    Dans **Demandes de transporteur**, cliquez sur **Demander un transporteur**. La fenêtre **Demander un transporteur** s'ouvre.
  </Step>

  <Step title="Décrire le transporteur">
    Renseignez **Nom du transporteur** et **Site web du transporteur**. Ajoutez une **URL de la documentation** et une **URL Swagger / OpenAPI** si le transporteur les publie à l'intention des développeurs.
  </Step>

  <Step title="Ajouter les identifiants de test">
    Choisissez la **Méthode de connexion** utilisée par le transporteur, puis renseignez les champs d'identifiants qui apparaissent. Utilisez les informations du système de test du transporteur, pas votre compte de production.
  </Step>

  <Step title="L'envoyer">
    Ajoutez des **Notes** s'il y a quelque chose que nous devons savoir, puis cliquez sur **Envoyer la demande**. Vous voyez « Demande de transporteur envoyée », et la demande apparaît dans la liste avec le statut **En attente**.
  </Step>
</Steps>

<Frame caption="Le formulaire Demander un transporteur avec la méthode de connexion Clé d'API">
  <img src="https://mintcdn.com/zippendo/KTui86ABjYKAHhqP/images/fr/how-to/request-carrier-integration/02-request-form-api-key-light.png?fit=max&auto=format&n=KTui86ABjYKAHhqP&q=85&s=c7f1d89ea246530e1f9ad9623fb567d2" alt="Fenêtre Demander un transporteur avec le nom du transporteur, le site web, les liens vers la documentation et le champ Clé d'API" className="block dark:hidden" width="2880" height="2800" data-path="images/fr/how-to/request-carrier-integration/02-request-form-api-key-light.png" />

  <img src="https://mintcdn.com/zippendo/KTui86ABjYKAHhqP/images/fr/how-to/request-carrier-integration/02-request-form-api-key-dark.png?fit=max&auto=format&n=KTui86ABjYKAHhqP&q=85&s=51c917ba5d7840fabd68d5f734b56bb7" alt="Fenêtre Demander un transporteur avec le nom du transporteur, le site web, les liens vers la documentation et le champ Clé d'API" className="hidden dark:block" width="2880" height="2800" data-path="images/fr/how-to/request-carrier-integration/02-request-form-api-key-dark.png" />
</Frame>

### Champs

| Champ | Obligatoire | Ce qu'il faut saisir |
| - | - | - |
| **Nom du transporteur** | Oui | Le nom du transporteur. 80 caractères maximum : lettres, chiffres, espaces et `. & ' + / ( ) _ -`. Les autres caractères affichent « Uniquement des lettres, des chiffres et . & ' + / ( ) \_ - ». |
| **Site web du transporteur** | Oui | Une adresse web complète, par exemple `https://developer.carrier.com`. |
| **URL de la documentation** | Non | L'endroit où le transporteur décrit son système à l'intention des développeurs. |
| **URL Swagger / OpenAPI** | Non | Un fichier de description technique, si le transporteur en propose un. Demandez au transporteur si vous n'êtes pas sûr. |
| **Méthode de connexion** | Oui | La façon dont le système du transporteur vérifie qui vous êtes. Elle démarre sur **Clé d'API**. Voir la section suivante. |
| **Tester sur le système de production du transporteur** | Non | Un interrupteur, désactivé par défaut. Voir ci-dessous. |
| **Notes** | Non | Tout ce que nous devons savoir d'autre sur le transporteur, 1000 caractères maximum. |

Une adresse web non valide affiche « Saisissez une URL valide ». Un champ obligatoire vide affiche « Ce champ est obligatoire ».

### Identifiants pour chaque méthode de connexion

Les champs d'identifiants changent selon la **Méthode de connexion**. Seuls les champs du type choisi sont envoyés.

| Méthode de connexion | Champs à renseigner |
| - | - |
| **Clé d'API** | **Clé d'API**. S'il est vide, vous voyez « La clé d'API est obligatoire ». |
| **OAuth 2.0** | **ID client**, **Secret client** et **URL du jeton** (l'adresse web où le transporteur délivre l'accès, par exemple `https://auth.carrier.com/token`). |
| **Nom d'utilisateur et mot de passe** | **Nom d'utilisateur** et **Mot de passe**. |
| **Personnalisé** | Sous **Identifiants personnalisés**, ajoutez une ligne pour chaque information, avec une **Clé** (son nom) et une **Valeur**. **Ajouter un champ** ajoute une ligne, et **Retirer le champ** en retire une. Au moins une ligne doit avoir un nom, sinon vous voyez « Ajoutez au moins une paire clé/valeur ». |

Le transporteur vous indique le type qu'il utilise. Si vous n'êtes pas sûr, demandez au transporteur, ou choisissez **Personnalisé** et ajoutez chaque information qu'il vous a donnée.

<Frame caption="Avec OAuth 2.0, renseignez ID client, Secret client et URL du jeton">
  <img src="https://mintcdn.com/zippendo/KTui86ABjYKAHhqP/images/fr/how-to/request-carrier-integration/03-request-form-oauth-light.png?fit=max&auto=format&n=KTui86ABjYKAHhqP&q=85&s=c1d720b7a53eaaabc1f5d601e1309b23" alt="Fenêtre Demander un transporteur avec la méthode de connexion OAuth 2.0 et les champs ID client, Secret client et URL du jeton" className="block dark:hidden" width="2880" height="2800" data-path="images/fr/how-to/request-carrier-integration/03-request-form-oauth-light.png" />

  <img src="https://mintcdn.com/zippendo/KTui86ABjYKAHhqP/images/fr/how-to/request-carrier-integration/03-request-form-oauth-dark.png?fit=max&auto=format&n=KTui86ABjYKAHhqP&q=85&s=5480b895c540b9b9648d0ad6151fadb7" alt="Fenêtre Demander un transporteur avec la méthode de connexion OAuth 2.0 et les champs ID client, Secret client et URL du jeton" className="hidden dark:block" width="2880" height="2800" data-path="images/fr/how-to/request-carrier-integration/03-request-form-oauth-dark.png" />
</Frame>

### Tester sur le système de production du transporteur

Laissez cet interrupteur désactivé dans la plupart des cas. Zippendo teste alors la nouvelle connexion sur le système de test du transporteur avec les informations que vous avez saisies.

Activez-le uniquement si le transporteur n'a pas de système de test. Le formulaire indique : « N'activez cette option que si le transporteur n'a pas d'environnement de test. Nous exécutons alors les tests sur le système de production du transporteur avec les identifiants ci-dessus. Laissez-la désactivée pour tester dans l'environnement de test du transporteur. »

Cet interrupteur n'affecte que la demande. Ce n'est pas la case **Mode test** d'un transporteur connecté, voir [Mode test](/docs/fr/how-to/sandbox-mode).

<Frame caption="Tester sur le système de production du transporteur est désactivé par défaut">
  <img src="https://mintcdn.com/zippendo/KTui86ABjYKAHhqP/images/fr/how-to/request-carrier-integration/04-request-form-live-light.png?fit=max&auto=format&n=KTui86ABjYKAHhqP&q=85&s=41b12646444f9f169787b8b0bdc5780e" alt="Fenêtre Demander un transporteur défilée jusqu'à l'interrupteur Tester sur le système de production du transporteur et Notes" className="block dark:hidden" width="2880" height="2800" data-path="images/fr/how-to/request-carrier-integration/04-request-form-live-light.png" />

  <img src="https://mintcdn.com/zippendo/KTui86ABjYKAHhqP/images/fr/how-to/request-carrier-integration/04-request-form-live-dark.png?fit=max&auto=format&n=KTui86ABjYKAHhqP&q=85&s=5eb93028fa36f0cd593acbed6b74011d" alt="Fenêtre Demander un transporteur défilée jusqu'à l'interrupteur Tester sur le système de production du transporteur et Notes" className="hidden dark:block" width="2880" height="2800" data-path="images/fr/how-to/request-carrier-integration/04-request-form-live-dark.png" />
</Frame>

## Suivre une demande

Cliquez sur une demande dans la liste pour ouvrir ses détails. Vous voyez :

* le nom du transporteur et le statut
* un lien vers le site web du transporteur
* vos **Notes**, si vous en avez ajouté
* **Progression** : les étapes de la création, comme **Demande envoyée**, **Analyse du transporteur**, **Génération des étiquettes**, **Génération du suivi**, **Génération des points relais**, **Génération des offres transporteur**, **Exécution des tests** et **Publiée**. Chaque étape est marquée **En attente**, **En cours de création**, **Créé**, **Échec** ou **Ignoré**.

Cliquez sur **Fermer** pour revenir à la liste. Vous ne pouvez pas modifier ni renvoyer une demande depuis ici. Si quelque chose ne va pas, envoyez une nouvelle demande.

Lorsque le statut est **Publiée**, ouvrez **Transporteurs** → **Tous les transporteurs** et connectez le nouveau transporteur comme n'importe quel autre. Choisissez ensuite ses offres comme décrit dans [Offres et services des transporteurs](/docs/fr/how-to/carrier-products-and-services).

## Messages

| Ce que vous voyez | Que faire |
| - | - |
| « Impossible d'envoyer la demande. Réessayez. » | La demande n'a pas été envoyée. Réessayez dans un instant. |
| « Trop de tentatives en peu de temps. Patientez un instant et réessayez. » | Vous avez envoyé beaucoup de demandes en peu de temps. Patientez un moment et réessayez. |
| « Le traitement de cette demande de transporteur est déjà en cours. Attendez qu'il se termine. » | Zippendo travaille déjà sur la demande. Attendez que le statut change. |
| « Impossible de lancer le traitement de cette demande de transporteur. Réessayez dans un instant. » | La création n'a pas pu démarrer. Réessayez dans un instant. Si l'échec persiste, contactez le support Zippendo. |

## Voir aussi

* [Identifiants des transporteurs](/docs/fr/how-to/carrier-credentials)
* [Transporteurs pris en charge](/docs/fr/carriers/supported-carriers)
* [Mode test](/docs/fr/how-to/sandbox-mode)
* [Offres et services des transporteurs](/docs/fr/how-to/carrier-products-and-services)
* [Transporteurs](/docs/fr/tutorials/carriers)


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