> ## 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 (ancienne API)

> Connectez le transporteur obsolète Instabox (ancienne API) avec votre ID client, votre Secret client et votre Numéro client, et pourquoi les nouvelles configurations doivent utiliser Instabox à la place.

**Instabox (ancienne API)** est l'ancienne façon de connecter Instabox. Elle est marquée **Obsolète** dans l'onglet **Tous les transporteurs**. Survolez le badge pour lire : « L'API Instabox autonome est obsolète. Passez à l'intégration Instabox basée sur Instabee. »

Utilisez-la uniquement si vous avez encore des identifiants pour l'ancien système Instabox (un ID client et un secret). Pour une nouvelle configuration, utilisez plutôt [Connecter Instabox](/docs/fr/how-to/connect-instabox). Les champs communs à tous les transporteurs figurent dans [Identifiants des transporteurs](/docs/fr/how-to/carrier-credentials).

<Warning>
  Les connexions existantes continuent de fonctionner : vous pouvez encore connecter ce transporteur et envoyer des expéditions avec lui. Les nouvelles configurations doivent utiliser **Instabox**.
</Warning>

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

## Avant de commencer

Il vous faut trois informations d'Instabox pour l'ancien système :

* votre **ID client**
* votre **Secret client**
* votre **Numéro client**, le préfixe qu'Instabox place sur vos numéros de colis (par exemple `PA02`)

Elles ne sont pas les mêmes que la **Clé d'API** unique utilisée dans [Connecter Instabox](/docs/fr/how-to/connect-instabox). **En savoir plus** sur la carte ouvre [instabee.com](https://instabee.com).

## Connecter Instabox (ancienne API)

<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 la bonne carte">
    Trouvez la carte nommée **Instabox (ancienne API)** avec le badge jaune **Obsolète**. C'est une carte différente de **Instabox**. Cliquez sur **Connecter**.
  </Step>

  <Step title="Remplir le formulaire">
    La fenêtre **Connecter un transporteur** s'ouvre. Saisissez un **Nom du transporteur**, puis **ID client**, **Secret client** et **Numéro client**. **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 Instabox (ancienne API) avec le badge Obsolète">
  <img src="https://mintcdn.com/zippendo/N1ddF4iNJRYFMBrw/images/fr/how-to/connect-instabox-legacy/01-all-carriers-card-light.png?fit=max&auto=format&n=N1ddF4iNJRYFMBrw&q=85&s=bbb53ba4b247fe5f275d6f02e8bff82b" alt="Onglet Tous les transporteurs avec la carte Instabox (ancienne API) marquée Obsolète, avec les boutons Connecter et En savoir plus" className="block dark:hidden" width="2880" height="1800" data-path="images/fr/how-to/connect-instabox-legacy/01-all-carriers-card-light.png" />

  <img src="https://mintcdn.com/zippendo/N1ddF4iNJRYFMBrw/images/fr/how-to/connect-instabox-legacy/01-all-carriers-card-dark.png?fit=max&auto=format&n=N1ddF4iNJRYFMBrw&q=85&s=9824ae86a5ec7dafa9b6b743520bcdac" alt="Onglet Tous les transporteurs avec la carte Instabox (ancienne API) marquée Obsolète, avec les boutons Connecter et En savoir plus" className="hidden dark:block" width="2880" height="1800" data-path="images/fr/how-to/connect-instabox-legacy/01-all-carriers-card-dark.png" />
</Frame>

<Frame caption="Saisissez l'ID client, le Secret client et le Numéro client">
  <img src="https://mintcdn.com/zippendo/N1ddF4iNJRYFMBrw/images/fr/how-to/connect-instabox-legacy/02-connect-modal-light.png?fit=max&auto=format&n=N1ddF4iNJRYFMBrw&q=85&s=653da1219d6b51f09ea6d379c0a121f7" alt="Fenêtre Connecter un transporteur pour Instabox (ancienne API) avec ID client, Secret client et Numéro client" className="block dark:hidden" width="2880" height="2800" data-path="images/fr/how-to/connect-instabox-legacy/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/N1ddF4iNJRYFMBrw/images/fr/how-to/connect-instabox-legacy/02-connect-modal-dark.png?fit=max&auto=format&n=N1ddF4iNJRYFMBrw&q=85&s=35ff245681a95d530e7bd741411673d6" alt="Fenêtre Connecter un transporteur pour Instabox (ancienne API) avec ID client, Secret client et Numéro client" className="hidden dark:block" width="2880" height="2800" data-path="images/fr/how-to/connect-instabox-legacy/02-connect-modal-dark.png" />
</Frame>

<Frame caption="Le Mode test se trouve sous Champs facultatifs">
  <img src="https://mintcdn.com/zippendo/N1ddF4iNJRYFMBrw/images/fr/how-to/connect-instabox-legacy/03-optional-fields-light.png?fit=max&auto=format&n=N1ddF4iNJRYFMBrw&q=85&s=45218cc532603d80ddfb34daead58b48" alt="Formulaire Instabox (ancienne API) défilé jusqu'à Champs facultatifs avec la case Mode test" className="block dark:hidden" width="2880" height="2800" data-path="images/fr/how-to/connect-instabox-legacy/03-optional-fields-light.png" />

  <img src="https://mintcdn.com/zippendo/N1ddF4iNJRYFMBrw/images/fr/how-to/connect-instabox-legacy/03-optional-fields-dark.png?fit=max&auto=format&n=N1ddF4iNJRYFMBrw&q=85&s=3de4af73d4573e6a794264a0f29443cb" alt="Formulaire Instabox (ancienne API) défilé jusqu'à Champs facultatifs avec la case Mode test" className="hidden dark:block" width="2880" height="2800" data-path="images/fr/how-to/connect-instabox-legacy/03-optional-fields-dark.png" />
</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 à **Instabox (ancienne API)**. |
| **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 | Votre ID client d'Instabox. Le formulaire indique : « Votre ID client OAuth Instabox ». |
| **Secret client** | Oui | Le secret associé à votre ID client. Il est masqué pendant la saisie. Le formulaire indique : « Votre secret client OAuth Instabox ». |
| **Numéro client** | Oui | Le formulaire indique : « Votre numéro client Instabox, utilisé comme préfixe de l'identifiant du colis (par exemple PA02) ». |
| **Mode test** | Non | Une case à cocher, décochée par défaut. Le formulaire indique : « Utiliser l'environnement de test d'Instabox ». |

**Connecter** ne fait rien tant que **Nom du transporteur**, **ID client**, **Secret client** et **Numéro client** n'ont pas tous une valeur.

### Test ou production

Pour cette ancienne connexion, c'est Instabox qui décide entre son système de test et les vraies expéditions d'après les identifiants que vous saisissez, et non d'après la case **Mode test**. Des identifiants de test d'Instabox créent des expéditions de test. Des identifiants de production créent de vraies expéditions, même avec **Mode test** activé. Pour essayer, demandez à Instabox des identifiants de test et activez **Mode test** pendant que vous les utilisez. Voir [Mode test](/docs/fr/how-to/sandbox-mode).

## Après la connexion

Le transporteur apparaît dans **Mes transporteurs** avec un badge **Connecté**. Lorsque vous le choisissez sur une expédition, il affiche aussi le badge **Obsolète**. 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).

| Offre transporteur | Type d'expédition | Livre en point relais ? |
| - | - | - |
| **Livraison en consigne automatique** | Sortante | Oui, une consigne automatique Instabox |
| **Livraison à domicile** | Sortante | Non |
| **Retour en consigne automatique** | Entrante (retour) | Non. Votre client dépose le colis dans n'importe quelle consigne Instabox. Activez le service **Retour sans étiquette** si le client ne doit pas imprimer d'étiquette. |

Les offres sont en général utilisées en Suède, en Norvège, au Danemark, en Finlande et aux Pays-Bas, à l'intérieur de chaque pays et entre eux, de 0.1 à 20 kg. Vous pouvez choisir d'autres pays dans une règle d'expédition. Instabox accepte ou refuse l'envoi lorsque vous l'expédiez.

* **Livraison en consigne automatique** nécessite un point relais (ici, une consigne) avant l'envoi. Voir [Choisir un point relais](/docs/fr/how-to/pick-a-service-point).
* Instabox envoie lui-même les mises à jour de suivi à Zippendo. Il n'y a rien à configurer. Voir [Webhooks de suivi des transporteurs](/docs/fr/how-to/tracking-webhooks).
* Instabox ne crée pas de documents douaniers. Si la règle d'expédition a **Générer une facture pro forma** ou **Générer une facture commerciale** activé, Zippendo crée ce document. Voir [Douane et documents](/docs/fr/how-to/customs-and-documents).
* Ce transporteur n'est pas disponible sous **Enlèvements**.

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

Lorsque vous passez à la nouvelle connexion, connectez d'abord **Instabox**, mettez à jour vos règles d'expédition pour l'utiliser, puis supprimez cette ancienne connexion.

## Problèmes courants

| Ce que vous voyez | Que faire |
| - | - |
| « Impossible de connecter le transporteur. Réessayez. » | Vérifiez que tous les champs obligatoires sont renseignés, 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 | Vérifiez **ID client** et **Secret client** dans **Modifier le transporteur**. Une **Clé d'API** Instabox actuelle ne fonctionne pas ici. Utilisez [Connecter Instabox](/docs/fr/how-to/connect-instabox) pour cette clé. |
| « Cette offre transporteur livre en point relais. Choisissez un point relais avant l'envoi. » | Choisissez une consigne pour **Livraison en consigne automatique**. Voir [Choisir un point relais](/docs/fr/how-to/pick-a-service-point). |
| « Le transporteur a refusé la demande. Consultez le motif indiqué par le transporteur, corrigez les informations et réessayez. » avec le motif « Instabox … is not available for … » lors de l'envoi | Instabox ne propose pas cette offre pour ce pays et ce code postal. Vérifiez l'adresse, ou choisissez une autre offre. |

## Voir aussi

* [Connecter Instabox](/docs/fr/how-to/connect-instabox)
* [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)
* [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.