Skip to main content
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. Les champs communs à tous les transporteurs figurent dans Identifiants des transporteurs.
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.
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.

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. En savoir plus sur la carte ouvre instabee.com.

Connecter Instabox (ancienne API)

1

Ouvrir Tous les transporteurs

Dans la barre latérale, cliquez sur Transporteurs, puis ouvrez l’onglet Tous les transporteurs.
2

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

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

Connecter le transporteur

Cliquez sur Connecter. Vous voyez « Transporteur connecté », et le transporteur apparaît dans l’onglet Mes transporteurs.
Onglet Tous les transporteurs avec la carte Instabox (ancienne API) marquée Obsolète, avec les boutons Connecter et En savoir plusOnglet Tous les transporteurs avec la carte Instabox (ancienne API) marquée Obsolète, avec les boutons Connecter et En savoir plus

La carte Instabox (ancienne API) avec le badge Obsolète

Fenêtre Connecter un transporteur pour Instabox (ancienne API) avec ID client, Secret client et Numéro clientFenêtre Connecter un transporteur pour Instabox (ancienne API) avec ID client, Secret client et Numéro client

Saisissez l'ID client, le Secret client et le Numéro client

Formulaire Instabox (ancienne API) défilé jusqu'à Champs facultatifs avec la case Mode testFormulaire Instabox (ancienne API) défilé jusqu'à Champs facultatifs avec la case Mode test

Le Mode test se trouve sous Champs facultatifs

Champs du formulaire

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.

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. 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.
  • Instabox envoie lui-même les mises à jour de suivi à Zippendo. Il n’y a rien à configurer. Voir Webhooks de suivi des transporteurs.
  • 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.
  • 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

Voir aussi