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

# Porterbuddy koppelen

> Koppel Porterbuddy onder Vervoerders met je Instabee API-sleutel en gebruik het selectievakje Testmodus om het testsysteem van Instabee uit te proberen.

**Porterbuddy** bezorgt pakketten bij je klanten thuis in Noorwegen, Zweden en Denemarken. Het maakt deel uit van Instabee, dezelfde groep als Instabox en Budbee. Porterbuddy heeft geen pakketautomaten. De velden die elke vervoerder heeft, staan bij [Inloggegevens van vervoerders](/docs/nl/how-to/carrier-credentials).

<Info>
  Je kiest in dit formulier geen afzenderadres. Voeg je adressen toe via het organisatiemenu → **Beheren** → **Adressen**. Het afzenderadres kies je bij elke zending of in een [verzendregel](/docs/nl/how-to/shipping-rule-fields).
</Info>

## Voordat je begint

* Je hebt een **API-sleutel** van Instabee nodig voor je overeenkomst met Porterbuddy. Zippendo kan deze sleutel niet voor je aanmaken.
* **Meer informatie** op de kaart opent [porterbuddy.com](https://porterbuddy.com). Dat is de openbare website van Porterbuddy, niet de plek om een sleutel te krijgen.
* Budbee gebruikt hetzelfde soort sleutel. Zie [Budbee koppelen](/docs/nl/how-to/connect-budbee).

Je kunt Porterbuddy meer dan eens koppelen. Geef elke koppeling een eigen **Naam van de vervoerder**.

## Porterbuddy koppelen

<Steps>
  <Step title="Alle vervoerders openen">
    Klik in de zijbalk op **Vervoerders** en open dan het tabblad **Alle vervoerders**.
  </Step>

  <Step title="Porterbuddy zoeken">
    Klik op de kaart **Porterbuddy** op **Koppelen**.
  </Step>

  <Step title="Het formulier invullen">
    Het venster **Vervoerder koppelen** wordt geopend. Vul een **Naam van de vervoerder** en je **API-sleutel** in. **Testmodus** staat onder **Optionele velden**.
  </Step>

  <Step title="De vervoerder koppelen">
    Klik op **Koppelen**. Je ziet "Vervoerder gekoppeld" en de vervoerder verschijnt op het tabblad **Mijn vervoerders**.
  </Step>
</Steps>

<Frame caption="De kaart van Porterbuddy op het tabblad Alle vervoerders">
  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-porterbuddy/01-all-carriers-card-light.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=707ce2f054613a7a57704d10f397f1fe" alt="Tabblad Alle vervoerders met de kaart van Porterbuddy en de knoppen Koppelen en Meer informatie" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-porterbuddy/01-all-carriers-card-light.png" />

  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-porterbuddy/01-all-carriers-card-dark.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=c9a5346df7e9d752a0827186d83fa54d" alt="Tabblad Alle vervoerders met de kaart van Porterbuddy en de knoppen Koppelen en Meer informatie" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-porterbuddy/01-all-carriers-card-dark.png" />
</Frame>

<Frame caption="Vul je API-sleutel in. Testmodus is optioneel.">
  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-porterbuddy/02-connect-modal-light.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=d94dd66f138d3c9c99485c71919a2ad8" alt="Venster Vervoerder koppelen voor Porterbuddy met het veld API-sleutel en het selectievakje Testmodus" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-porterbuddy/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/BWawNjUeX_42GZbK/images/nl/how-to/connect-porterbuddy/02-connect-modal-dark.png?fit=max&auto=format&n=BWawNjUeX_42GZbK&q=85&s=baa51f073b5aea8c80737eb040da0f7f" alt="Venster Vervoerder koppelen voor Porterbuddy met het veld API-sleutel en het selectievakje Testmodus" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-porterbuddy/02-connect-modal-dark.png" />
</Frame>

## Velden in het formulier

| Veld | Verplicht | Wat je invult |
| - | - | - |
| **Naam van de vervoerder** | Ja | De naam die je ziet onder **Mijn vervoerders** en wanneer je bij een zending een vervoerder kiest. Die begint als **Porterbuddy**. |
| **Merk** | Nee | Alleen zichtbaar als je organisatie [merken](/docs/nl/how-to/create-a-brand) heeft. Het formulier zegt: "Alleen dit merk kan deze vervoerder gebruiken." Laat het leeg om elk merk de vervoerder te laten gebruiken. |
| **API-sleutel** | Ja | De sleutel van Instabee. Het formulier zegt: "Je API-sleutel voor de Instabee Integration API (meegestuurd als 'Authorization: ApiKey \<key>')". Plak alleen de sleutel zelf. |
| **Testmodus** | Nee | Een selectievakje, standaard uit. Het formulier zegt: "De testomgeving van Instabee gebruiken". |

**Koppelen** doet niets totdat **Naam van de vervoerder** en **API-sleutel** een waarde hebben.

Met **Testmodus** worden je zendingen naar het testsysteem van Instabee gestuurd, zodat er geen echte zendingen worden aangemaakt. Het testsysteem heeft een testsleutel van Instabee nodig: een live sleutel werkt daar niet en een testsleutel werkt niet voor echte zendingen. Laat **Testmodus** uit voor echte zendingen. Zie [Testmodus](/docs/nl/how-to/sandbox-mode).

## Na het koppelen

De vervoerder staat onder **Mijn vervoerders** met een badge **Gekoppeld**. Het product kies je bij elke zending of in een verzendregel, niet in dit formulier. Zie [Verzendproducten en extra diensten](/docs/nl/how-to/carrier-products-and-services).

| Product | Type zending | Wat het doet |
| - | - | - |
| **Thuisbezorging** | Uitgaand | Bezorgt op het huisadres van de ontvanger. |
| **Retour ophalen aan huis** | Inkomend (retour) | Porterbuddy haalt het retour op bij je klant thuis. |

Beide producten verzenden binnen en tussen Noorwegen, Zweden en Denemarken, van 0,1 tot 20 kg. Porterbuddy bezorgt nooit bij een afhaalpunt, dus je kiest er geen.

* Porterbuddy is niet beschikbaar onder **Ophaalopdrachten**. Zie [Een ophaalopdracht plannen](/docs/nl/how-to/schedule-a-pickup) voor de vervoerders die dat wel zijn.
* Instabee stuurt trackingupdates uit zichzelf naar Zippendo. Je hoeft niets in te stellen. Zie [Trackingwebhooks van vervoerders](/docs/nl/how-to/tracking-webhooks).
* Porterbuddy maakt geen douanedocumenten aan. Als **Proformafactuur genereren** of **Handelsfactuur genereren** bij de verzendregel aan staat, maakt Zippendo dat document aan. Zie [Douane en documenten](/docs/nl/how-to/customs-and-documents).

## De koppeling wijzigen of verwijderen

Om de koppeling te wijzigen open je **Vervoerders** → **Mijn vervoerders** en klik je op de kaart op **Vervoerder bewerken**. De pagina **Vervoerder bewerken** heeft twee gedeelten:

* **Algemeen**: **Naam van de vervoerder** en **Merk**, als je organisatie merken heeft.
* **Vervoerderinstellingen**: **API-sleutel** en **Testmodus**.

Klik op **Opslaan**. Je ziet "Vervoerder bijgewerkt".

Om de koppeling te verwijderen klik je op dezelfde pagina op **Verwijderen**, typ je de naam van de vervoerder in hoofdletters en klik je op **Verwijderen**. Verzendregels die deze vervoerder gebruiken, worden samen met de vervoerder verwijderd. Zendingen die je al hebt verzonden, houden hun verzendlabels en trackingnummers.

## Veelvoorkomende problemen

| Wat je ziet | Wat je doet |
| - | - |
| "Kan de vervoerder niet koppelen. Probeer het opnieuw." | Controleer of **Naam van de vervoerder** en **API-sleutel** zijn ingevuld en probeer het opnieuw. |
| "Je hebt de limiet van je abonnement bereikt. Upgrade je abonnement of verwijder iets wat je niet meer gebruikt." | De limiet voor vervoerders van je abonnement is bereikt. Zie [Facturatie en gebruik](/docs/nl/how-to/billing-and-usage). |
| "De vervoerder heeft je inloggegevens geweigerd. Werk de inloggegevens bij onder Vervoerders." wanneer je verzendt | Controleer de **API-sleutel** bij **Vervoerder bewerken** en controleer of **Testmodus** past bij het soort sleutel (test of live). Zie [Authenticatiefouten bij vervoerders](/docs/nl/knowledge-base/carrier-authentication-failures). |
| "Het gekozen verzendproduct verzendt niet tussen deze landen. Kies een ander verzendproduct." | De afzender of ontvanger zit buiten Noorwegen, Zweden en Denemarken. Kies een andere vervoerder. |
| "De vervoerder reageert niet. Probeer het zo opnieuw." | Instabee heeft niet op tijd geantwoord. Wacht even en verzend opnieuw. |

## Zie ook

* [Budbee koppelen](/docs/nl/how-to/connect-budbee)
* [Instabox koppelen](/docs/nl/how-to/connect-instabox)
* [Een vervoerder of integratie koppelen](/docs/nl/how-to/connect-index)
* [Inloggegevens van vervoerders](/docs/nl/how-to/carrier-credentials)
* [Testmodus](/docs/nl/how-to/sandbox-mode)
* [Vervoerders](/docs/nl/tutorials/carriers)


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