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

> Connectez Instabox dans Zippendo avec votre clé d'API Instabee, choisissez entre test et production avec Mode test, et expédiez vers des consignes Instabox et au domicile.

Connectez **Instabox** pour envoyer des colis vers des consignes Instabox et au domicile de vos clients en Suède, en Norvège, au Danemark et en Finlande. Instabox fait partie d'Instabee, et Zippendo s'y connecte avec une seule clé d'API Instabee.

Dans **Tous les transporteurs**, utilisez la carte nommée **Instabox**. La carte nommée **Instabox (ancienne API)** est une ancienne connexion en cours de retrait : voir [Connecter Instabox (Legacy API)](/docs/fr/how-to/connect-instabox-legacy).

Cette page ne traite que d'Instabox. Les champs communs à tous les transporteurs figurent dans [Identifiants des transporteurs](/docs/fr/how-to/carrier-credentials). Pas à pas : [Transporteurs](/docs/fr/tutorials/carriers).

## Ce qu'il vous faut chez Instabox

* Un contrat d'expédition Instabox.
* Une **clé d'API Instabee Integration** pour ce contrat. Instabee vous fournit la clé. Zippendo ne peut pas la créer pour vous.

## Connecter Instabox

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

  <Step title="Cliquez sur Connecter sur Instabox">
    Repérez la carte nommée **Instabox**, sans « Legacy API » et sans badge **Obsolète**, et cliquez sur **Connecter**. (**En savoir plus** ouvre instabee.com.)
  </Step>

  <Step title="Remplissez le formulaire">
    La fenêtre **Connecter un transporteur** s'ouvre. **Nom du transporteur** est déjà rempli avec « Instabox ». Collez votre clé dans **Clé d'API**. **Mode test** se trouve sous **Champs facultatifs**.
  </Step>

  <Step title="Cliquez sur Connecter dans la fenêtre">
    Vous voyez **Transporteur connecté**. Instabox apparaît maintenant dans **Mes transporteurs** avec la mention **Connecté**.
  </Step>
</Steps>

<Frame caption="La carte Instabox dans Tous les transporteurs">
  <img src="https://mintcdn.com/zippendo/N1ddF4iNJRYFMBrw/images/fr/how-to/connect-instabox/01-all-carriers-card-light.png?fit=max&auto=format&n=N1ddF4iNJRYFMBrw&q=85&s=0dafedfac9209a3af2bb706e5892d78c" alt="Tous les transporteurs avec la carte Instabox et ses boutons Connecter et En savoir plus" className="block dark:hidden" width="2880" height="1800" data-path="images/fr/how-to/connect-instabox/01-all-carriers-card-light.png" />

  <img src="https://mintcdn.com/zippendo/N1ddF4iNJRYFMBrw/images/fr/how-to/connect-instabox/01-all-carriers-card-dark.png?fit=max&auto=format&n=N1ddF4iNJRYFMBrw&q=85&s=625c631857b91df88f478c9f3bd1ec01" alt="Tous les transporteurs avec la carte Instabox et ses boutons Connecter et En savoir plus" className="hidden dark:block" width="2880" height="1800" data-path="images/fr/how-to/connect-instabox/01-all-carriers-card-dark.png" />
</Frame>

<Frame caption="Connecter un transporteur pour Instabox - Clé d'API et Mode test">
  <img src="https://mintcdn.com/zippendo/N1ddF4iNJRYFMBrw/images/fr/how-to/connect-instabox/02-connect-modal-light.png?fit=max&auto=format&n=N1ddF4iNJRYFMBrw&q=85&s=d405827968f6f1b2a359df529073de6f" alt="Fenêtre Connecter un transporteur pour Instabox avec la Clé d'API obligatoire et le Mode test facultatif" className="block dark:hidden" width="2880" height="1800" data-path="images/fr/how-to/connect-instabox/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/N1ddF4iNJRYFMBrw/images/fr/how-to/connect-instabox/02-connect-modal-dark.png?fit=max&auto=format&n=N1ddF4iNJRYFMBrw&q=85&s=972717be49e1e537302d7077e24b2134" alt="Fenêtre Connecter un transporteur pour Instabox avec la Clé d'API obligatoire et le Mode test facultatif" className="hidden dark:block" width="2880" height="1800" data-path="images/fr/how-to/connect-instabox/02-connect-modal-dark.png" />
</Frame>

## Que saisir

| Champ | Obligatoire | Description dans le formulaire | Que saisir |
| - | - | - | - |
| **Nom du transporteur** | Oui | | Le nom que vous voyez dans Zippendo. Gardez « Instabox » ou modifiez-le. |
| **Marque** | Non | **Seule cette marque peut utiliser ce transporteur.** | Affiché uniquement si votre organisation a des [marques](/docs/fr/how-to/create-a-brand). |
| **Clé d'API** | Oui | Votre clé d'API Instabee Integration (envoyée sous la forme 'Authorization: ApiKey \<key>') | La clé exactement telle qu'Instabee vous l'a donnée. |
| **Mode test** | Non | Utiliser l'environnement de test d'Instabee | Laissez-le désactivé pour les expéditions réelles. Voir ci-dessous. |

Ce formulaire ne comporte ni identifiant client, ni secret client, ni numéro client. Ils relèvent d'[Instabox (Legacy API)](/docs/fr/how-to/connect-instabox-legacy).

## Test ou production

Avec **Mode test** activé, Zippendo envoie vos expéditions au système de test d'Instabee au lieu du système réel. Vous utilisez la même **Clé d'API**. Désactivez-le avant d'expédier de vraies commandes. Plus d'informations dans [Mode test](/docs/fr/how-to/sandbox-mode).

## Après la connexion

Vous choisissez une offre transporteur Instabox lorsque vous [créez une expédition](/docs/fr/how-to/send-a-shipment) ou une [règle d'expédition](/docs/fr/how-to/shipping-rule-fields). Voir [Offres transporteur et services additionnels](/docs/fr/how-to/carrier-products-and-services). Chaque colis peut peser de 0,1 à 20 kg.

| Offre transporteur | À utiliser pour | Choisir une consigne ? |
| - | - | - |
| **Livraison en consigne automatique** | Envoyer vers une consigne Instabox | Oui |
| **Livraison à domicile** | Envoyer au domicile du destinataire. Instabox planifie l'horaire de livraison. | Non |
| **Retour en consigne automatique** (expédition retour) | Votre client dépose le retour dans une consigne. Service additionnel facultatif : **Sans étiquette** | Oui |

Instabox n'a pas d'offre transporteur de retour à domicile.

* **Consignes automatiques :** pour **Livraison en consigne automatique** et **Retour en consigne automatique**, choisissez la consigne 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).
* **Enlèvements :** Instabox n'est pas disponible sous **Enlèvements**.
* **Suivi :** les mises à jour de suivi viennent d'Instabee. Le transporteur n'a pas de paramètre de suivi. Voir [Webhooks de suivi des transporteurs](/docs/fr/how-to/tracking-webhooks).
* **Douane :** Instabox ne crée pas de documents douaniers dans Zippendo.

## Si la connexion échoue

Zippendo enregistre votre clé sans la vérifier. Une erreur apparaît la première fois que vous envoyez une expédition.

| Ce que vous voyez | Que faire |
| - | - |
| Rien ne se passe quand vous cliquez sur **Connecter** | Renseignez **Nom du transporteur** et **Clé d'API**. |
| **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. Changez de formule ou supprimez un transporteur que vous n'utilisez plus ([Facturation et utilisation](/docs/fr/how-to/billing-and-usage)). |
| **Le transporteur a refusé vos identifiants. Mettez-les à jour sous Transporteurs.** | Collez à nouveau la clé sans espaces superflus. Si vous l'avez copiée depuis l'ancienne configuration Instabox, demandez à Instabee une clé d'API Instabee Integration. |
| **Cette offre transporteur livre en point relais. Choisissez un point relais avant l'envoi.** | Choisissez une consigne sur l'expédition. |
| **L'offre transporteur choisie ne dessert pas ces pays. Choisissez-en une autre.** | Instabox n'expédie qu'en Suède, en Norvège, au Danemark et en Finlande. |
| **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 d'Instabox si l'expédition existe avant de la renvoyer. |

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

## Modifier ou supprimer la connexion

* **Modifier :** dans **Mes transporteurs**, cliquez sur **Modifier le transporteur**. Mettez à jour les champs sous **Paramètres du transporteur** et cliquez sur **Enregistrer**.
* **Supprimer :** sur la même page, cliquez sur **Supprimer**, saisissez le nom du transporteur en majuscules (par exemple `INSTABOX`) et cliquez sur **Supprimer**. Les règles d'expédition qui utilisent ce transporteur sont également supprimées. Les expéditions que vous avez déjà envoyées conservent leurs étiquettes et leurs numéros de suivi.

## 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)
* [Connecter Instabox (Legacy API)](/docs/fr/how-to/connect-instabox-legacy)
* [Offres transporteur et services additionnels](/docs/fr/how-to/carrier-products-and-services)
* [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.