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

> Connectez Porterbuddy sous Transporteurs avec votre clé d'API Instabee, et utilisez la case Mode test pour essayer le système de test d'Instabee.

**Porterbuddy** livre des colis au domicile de vos clients en Norvège, en Suède et au Danemark. Il fait partie d'Instabee, le même groupe qu'Instabox et Budbee. Porterbuddy n'a pas de consignes automatiques. Les champs communs à tous les transporteurs figurent dans [Identifiants des transporteurs](/docs/fr/how-to/carrier-credentials).

<Info>
  Vous ne choisissez pas d'adresse d'expéditeur dans ce formulaire. Ajoutez vos adresses via 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 une **Clé d'API** d'Instabee pour votre contrat Porterbuddy. Zippendo ne peut pas créer cette clé pour vous.
* **En savoir plus** sur la carte ouvre [porterbuddy.com](https://porterbuddy.com). C'est le site web public de Porterbuddy, pas l'endroit où obtenir une clé.
* Budbee utilise le même type de clé. Voir [Connecter Budbee](/docs/fr/how-to/connect-budbee).

Vous pouvez connecter Porterbuddy plusieurs fois. Donnez à chaque connexion son propre **Nom du transporteur**.

## Connecter Porterbuddy

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

  <Step title="Repérez Porterbuddy">
    Sur la carte **Porterbuddy**, cliquez sur **Connecter**.
  </Step>

  <Step title="Remplissez le formulaire">
    La fenêtre **Connecter un transporteur** s'ouvre. Saisissez un **Nom du transporteur** et votre **Clé d'API**. **Mode test** se trouve sous **Champs facultatifs**.
  </Step>

  <Step title="Connectez 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 Porterbuddy dans l'onglet Tous les transporteurs">
  <img src="https://mintcdn.com/zippendo/spw3EVEzZ5LWUqKq/images/fr/how-to/connect-porterbuddy/01-all-carriers-card-light.png?fit=max&auto=format&n=spw3EVEzZ5LWUqKq&q=85&s=97ede6441fec0614963d02364ef794e2" alt="Onglet Tous les transporteurs avec la carte Porterbuddy et ses boutons Connecter et En savoir plus" className="block dark:hidden" width="2880" height="1800" data-path="images/fr/how-to/connect-porterbuddy/01-all-carriers-card-light.png" />

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

<Frame caption="Saisissez votre clé d'API. Le mode test est facultatif.">
  <img src="https://mintcdn.com/zippendo/spw3EVEzZ5LWUqKq/images/fr/how-to/connect-porterbuddy/02-connect-modal-light.png?fit=max&auto=format&n=spw3EVEzZ5LWUqKq&q=85&s=9c40c792af0ac10cf97699d5c02496fd" alt="Fenêtre Connecter un transporteur pour Porterbuddy avec le champ Clé d'API et la case Mode test" className="block dark:hidden" width="2880" height="1800" data-path="images/fr/how-to/connect-porterbuddy/02-connect-modal-light.png" />

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

## Champs du formulaire

| Champ | Obligatoire | Que saisir |
| - | - | - |
| **Nom du transporteur** | Oui | Le nom que vous voyez dans **Mes transporteurs** et lorsque vous choisissez un transporteur sur une expédition. Au départ, c'est **Porterbuddy**. |
| **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 le champ vide pour que toutes les marques puissent l'utiliser. |
| **Clé d'API** | Oui | La clé d'Instabee. Le formulaire indique : « Votre clé d'API Instabee Integration (envoyée sous la forme 'Authorization: ApiKey \<key>') ». Collez uniquement la clé elle-même. |
| **Mode test** | Non | Une case à cocher, décochée par défaut. Le formulaire indique : « Utiliser l'environnement de test d'Instabee ». |

**Connecter** ne fait rien tant que **Nom du transporteur** et **Clé d'API** n'ont pas de valeur.

**Mode test** envoie vos expéditions au système de test d'Instabee, de sorte qu'aucune expédition réelle n'est créée. Le système de test nécessite une clé de test d'Instabee : une clé de production n'y fonctionne pas, et une clé de test ne fonctionne pas pour les expéditions réelles. Laissez **Mode test** désactivé pour les expéditions réelles. 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 transporteur sur chaque expédition ou dans une règle d'expédition, pas dans ce formulaire. Voir [Offres transporteur et services additionnels](/docs/fr/how-to/carrier-products-and-services).

| Offre transporteur | Type d'expédition | Ce qu'elle fait |
| - | - | - |
| **Livraison à domicile** | Sortante | Livre à l'adresse du domicile du destinataire. |
| **Retour depuis le domicile** | Entrante (retour) | Porterbuddy récupère le retour au domicile de votre client. |

Les deux offres transporteur desservent la Norvège, la Suède et le Danemark, à l'intérieur de chaque pays et entre eux, de 0,1 à 20 kg. Porterbuddy ne livre jamais en point relais, vous n'en choisissez donc pas.

* Porterbuddy n'est pas disponible sous **Enlèvements**. Voir [Planifier un enlèvement](/docs/fr/how-to/schedule-a-pickup) pour les transporteurs qui le sont.
* Instabee 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).
* Porterbuddy 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).

## 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** : **Clé d'API** 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 que vous avez 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 que **Nom du transporteur** et **Clé d'API** 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 la **Clé d'API** dans **Modifier le transporteur**, et vérifiez que **Mode test** correspond au type de clé (test ou production). Voir [Échecs d'authentification auprès des transporteurs](/docs/fr/knowledge-base/carrier-authentication-failures). |
| « L'offre transporteur choisie ne dessert pas ces pays. Choisissez-en une autre. » | L'expéditeur ou le destinataire est en dehors de la Norvège, de la Suède et du Danemark. Choisissez un autre transporteur. |
| « Le transporteur n'a pas répondu. Réessayez dans un instant. » | Instabee n'a pas répondu à temps. Patientez un instant et renvoyez l'expédition. |

## Voir aussi

* [Connecter Budbee](/docs/fr/how-to/connect-budbee)
* [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)
* [Transporteurs](/docs/fr/tutorials/carriers)


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