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

# Instabox koppelen

> Koppel Instabox in Zippendo met je Instabee API-sleutel, kies met Testmodus tussen test en live en verzend naar pakketautomaten en huisadressen van Instabox.

Koppel **Instabox** om pakketten te verzenden naar pakketautomaten van Instabox en naar het huis van je klanten in Zweden, Noorwegen, Denemarken en Finland. Instabox maakt deel uit van Instabee en Zippendo maakt met één Instabee API-sleutel verbinding.

Gebruik op **Alle vervoerders** de kaart met de naam **Instabox**. De kaart met de naam **Instabox (oude API)** is een oudere koppeling die wordt uitgefaseerd: zie [Instabox koppelen (oude API)](/docs/nl/how-to/connect-instabox-legacy).

Deze pagina gaat alleen over Instabox. De velden die elke vervoerder heeft, staan bij [Inloggegevens van vervoerders](/docs/nl/how-to/carrier-credentials). Stappenplan: [Vervoerders](/docs/nl/tutorials/carriers).

## Wat je van Instabox nodig hebt

* Een verzendovereenkomst met Instabox.
* Een **API-sleutel voor de Instabee Integration API** voor die overeenkomst. Instabee geeft je de sleutel. Zippendo kan die niet voor je aanmaken.

## Instabox koppelen

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

  <Step title="Op Koppelen klikken bij Instabox">
    Zoek de kaart met de naam **Instabox**, zonder "oude API" en zonder badge **Verouderd**, en klik op **Koppelen**. (**Meer informatie** opent instabee.com.)
  </Step>

  <Step title="Het formulier invullen">
    Het venster **Vervoerder koppelen** wordt geopend. **Naam van de vervoerder** is al ingevuld met "Instabox". Plak je sleutel in **API-sleutel**. **Testmodus** staat onder **Optionele velden**.
  </Step>

  <Step title="In het venster op Koppelen klikken">
    Je ziet **Vervoerder gekoppeld**. Instabox staat nu onder **Mijn vervoerders** met de markering **Gekoppeld**.
  </Step>
</Steps>

<Frame caption="De kaart van Instabox bij Alle vervoerders">
  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-instabox/01-all-carriers-card-light.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=70294d312e370b9c612c72244fc83f24" alt="Alle vervoerders met de kaart van Instabox en de knoppen Koppelen en Meer informatie" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-instabox/01-all-carriers-card-light.png" />

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

<Frame caption="Vervoerder koppelen voor Instabox - API-sleutel en Testmodus">
  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-instabox/02-connect-modal-light.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=7fc795299c0cfe402315a8a3aa57162d" alt="Venster Vervoerder koppelen voor Instabox met de verplichte API-sleutel en de optionele Testmodus" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-instabox/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-instabox/02-connect-modal-dark.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=d48a626f11d86d8268f2d4f0ddaec136" alt="Venster Vervoerder koppelen voor Instabox met de verplichte API-sleutel en de optionele Testmodus" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-instabox/02-connect-modal-dark.png" />
</Frame>

## Wat je invult

| Veld | Verplicht | Omschrijving in het formulier | Wat je invult |
| - | - | - | - |
| **Naam van de vervoerder** | Ja | | De naam die je in Zippendo ziet. Laat "Instabox" staan of wijzig het. |
| **Merk** | Nee | **Alleen dit merk kan deze vervoerder gebruiken.** | Alleen zichtbaar als je organisatie [merken](/docs/nl/how-to/create-a-brand) heeft. |
| **API-sleutel** | Ja | Je API-sleutel voor de Instabee Integration API (meegestuurd als 'Authorization: ApiKey \<key>') | De sleutel precies zoals Instabee die je heeft gegeven. |
| **Testmodus** | Nee | De testomgeving van Instabee gebruiken | Laat uit voor echte zendingen. Zie hieronder. |

Dit formulier heeft geen client-ID, client secret of klantnummer. Die horen bij [Instabox (oude API)](/docs/nl/how-to/connect-instabox-legacy).

## Test of live

Met **Testmodus** aan stuurt Zippendo je zendingen naar het testsysteem van Instabee in plaats van het echte systeem. Je gebruikt dezelfde **API-sleutel**. Zet het uit voordat je echte bestellingen verzendt. Meer in [Testmodus](/docs/nl/how-to/sandbox-mode).

## Na het koppelen

Je kiest een Instabox-product wanneer je [een zending aanmaakt](/docs/nl/how-to/send-a-shipment) of een [verzendregel](/docs/nl/how-to/shipping-rule-fields). Zie [Verzendproducten en extra diensten](/docs/nl/how-to/carrier-products-and-services). Elk pakket mag 0,1 tot 20 kg wegen.

| Product | Gebruik het voor | Pakketautomaat kiezen? |
| - | - | - |
| **Bezorging bij pakketautomaat** | Verzenden naar een pakketautomaat van Instabox | Ja |
| **Thuisbezorging** | Verzenden naar het huis van de ontvanger. Instabox plant het bezorgmoment. | Nee |
| **Retour via pakketautomaat** (retourzending) | Je klant geeft het retour af bij een pakketautomaat. Optionele dienst: **Zonder label** | Ja |

Instabox heeft geen product voor retouren van thuis.

* **Pakketautomaten:** kies bij **Bezorging bij pakketautomaat** en **Retour via pakketautomaat** de pakketautomaat in het gedeelte **Afhaalpunt** van de zending voordat je verzendt. Zie [Een afhaalpunt kiezen](/docs/nl/how-to/pick-a-service-point).
* **Ophaalopdrachten:** Instabox is niet beschikbaar onder **Ophaalopdrachten**.
* **Track & trace:** trackingupdates komen van Instabee. De vervoerder heeft geen trackinginstelling. Zie [Trackingwebhooks van vervoerders](/docs/nl/how-to/tracking-webhooks).
* **Douane:** Instabox maakt in Zippendo geen douanedocumenten aan.

## Als de koppeling mislukt

Zippendo slaat je sleutel op zonder die te controleren. Een fout komt pas aan het licht wanneer je voor het eerst een zending verzendt.

| Wat je ziet | Wat je doet |
| - | - |
| Er gebeurt niets wanneer je op **Koppelen** klikt | Vul **Naam van de vervoerder** en **API-sleutel** in. |
| **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. Upgrade of verwijder een vervoerder die je niet meer gebruikt ([Facturatie en gebruik](/docs/nl/how-to/billing-and-usage)). |
| **De vervoerder heeft je inloggegevens geweigerd. Werk de inloggegevens bij onder Vervoerders.** | Plak de sleutel opnieuw zonder extra spaties. Als je hem hebt gekopieerd uit de oude Instabox-koppeling, vraag Instabee dan om een API-sleutel voor de Instabee Integration API. |
| **Dit verzendproduct bezorgt bij een afhaalpunt. Kies een afhaalpunt voordat je verzendt.** | Kies een pakketautomaat bij de zending. |
| **Het gekozen verzendproduct verzendt niet tussen deze landen. Kies een ander verzendproduct.** | Instabox verzendt alleen binnen Zweden, Noorwegen, Denemarken en Finland. |
| **De verbinding met de vervoerder werd verbroken voordat er antwoord kwam. Zippendo heeft geen bevestiging dat de zending is aangemaakt. Controleer dit bij de vervoerder voordat je opnieuw verzendt.** | Controleer bij Instabox of de zending bestaat voordat je hem opnieuw verzendt. |

Meer hulp: [Authenticatiefouten bij vervoerders](/docs/nl/knowledge-base/carrier-authentication-failures).

## De koppeling wijzigen of verwijderen

* **Wijzigen:** klik onder **Mijn vervoerders** op **Vervoerder bewerken**. Werk de velden onder **Vervoerderinstellingen** bij en klik op **Opslaan**.
* **Verwijderen:** klik op dezelfde pagina op **Verwijderen**, typ de naam van de vervoerder in hoofdletters (bijvoorbeeld `INSTABOX`) en klik op **Verwijderen**. Verzendregels die deze vervoerder gebruiken, worden ook verwijderd. Zendingen die je al hebt verzonden, houden hun verzendlabels en trackingnummers.

## Zie ook

* [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)
* [Instabox koppelen (oude API)](/docs/nl/how-to/connect-instabox-legacy)
* [Verzendproducten en extra diensten](/docs/nl/how-to/carrier-products-and-services)
* [Een vervoerderintegratie aanvragen](/docs/nl/how-to/request-carrier-integration)
* [Vervoerders](/docs/nl/tutorials/carriers)


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