> ## 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 (oude API) koppelen
> Koppel de verouderde vervoerder Instabox (oude API) met je Client-ID, Client secret en Klantnummer, en waarom nieuwe inrichtingen liever Instabox gebruiken.
**Instabox (oude API)** is de oudere manier om Instabox te koppelen. Het is gemarkeerd als **Verouderd** op het tabblad **Alle vervoerders**. Beweeg over het label om te lezen: “De losse Instabox-API is verouderd. Stap over op de Instabox-integratie via Instabee.”
Gebruik het alleen als je nog inloggegevens hebt voor het oudere Instabox-systeem (een client-ID en secret). Gebruik voor een nieuwe inrichting in plaats daarvan [Instabox koppelen](/docs/nl/how-to/connect-instabox). De velden die elke vervoerder heeft, staan onder [Inloggegevens van de vervoerder](/docs/nl/how-to/carrier-credentials).
Bestaande koppelingen blijven werken: je kunt deze vervoerder nog steeds koppelen en er zendingen mee verzenden. Nieuwe inrichtingen horen **Instabox** te gebruiken.
Op dit formulier kies je 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).
## Voordat je begint
Je hebt drie gegevens van Instabox nodig voor het oudere systeem:
* je **Client-ID**
* je **Client secret**
* je **Klantnummer**, het voorvoegsel dat Instabox voor je pakketnummers zet (bijvoorbeeld `PA02`)
Dit is niet hetzelfde als de ene **API-sleutel** die je gebruikt bij [Instabox koppelen](/docs/nl/how-to/connect-instabox). **Meer informatie** op de kaart opent [instabee.com](https://instabee.com).
## Instabox (oude API) koppelen
Klik in de zijbalk op **Vervoerders** en open dan het tabblad **Alle vervoerders**.
Zoek de kaart met de naam **Instabox (oude API)** met het gele label **Verouderd**. Dit is een andere kaart dan **Instabox**. Klik op **Koppelen**.
Het venster **Vervoerder koppelen** gaat open. Vul een **Naam van de vervoerder** in en dan **Client-ID**, **Client secret** en **Klantnummer**. **Testmodus** staat onder **Optionele velden**.
Klik op **Koppelen**. Je ziet “Vervoerder gekoppeld” en de vervoerder verschijnt op het tabblad **Mijn vervoerders**.
## Velden op het formulier
| Veld | Verplicht | Wat je invult |
| - | - | - |
| **Naam van de vervoerder** | Ja | De naam die je ziet bij **Mijn vervoerders** en wanneer je een vervoerder kiest bij een zending. Begint als **Instabox (oude API)**. |
| **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 leeg zodat elk merk de vervoerder kan gebruiken. |
| **Client-ID** | Ja | Je client-ID van Instabox. Het formulier zegt: “Je OAuth-client-ID van Instabox”. |
| **Client secret** | Ja | Het secret dat bij je client-ID hoort. Het wordt verborgen terwijl je typt. Het formulier zegt: “Je OAuth-client secret van Instabox”. |
| **Klantnummer** | Ja | Het formulier zegt: “Je klantnummer bij Instabox, gebruikt als voorvoegsel van de pakket-ID (bijv. PA02)”. |
| **Testmodus** | Nee | Een selectievakje, standaard uit. Het formulier zegt: “De testomgeving van Instabox gebruiken”. |
**Koppelen** doet niets zolang **Naam van de vervoerder**, **Client-ID**, **Client secret** en **Klantnummer** niet alle vier een waarde hebben.
### Test of live
Bij deze oudere koppeling bepaalt Instabox aan de hand van de inloggegevens die je invoert of het zijn testsysteem of echte zendingen gebruikt, niet aan de hand van het selectievakje **Testmodus**. Testinloggegevens van Instabox maken testzendingen aan. Live inloggegevens maken echte zendingen aan, ook als **Testmodus** aanstaat. Om te proberen, vraag je Instabox om testinloggegevens en zet je **Testmodus** aan zolang je ze gebruikt. Zie [Testmodus](/docs/nl/how-to/sandbox-mode).
## Na het koppelen
De vervoerder verschijnt onder **Mijn vervoerders** met een badge **Gekoppeld**. Kies je hem bij een zending, dan toont hij ook het label **Verouderd**. Het verzendproduct kies je bij elke zending of in een verzendregel, niet op dit formulier. Zie [Verzendproducten en extra diensten](/docs/nl/how-to/carrier-products-and-services).
| Verzendproduct | Type zending | Bezorgt bij een afhaalpunt? |
| - | - | - |
| **Bezorging bij pakketautomaat** | Uitgaand | Ja, een Instabox-pakketautomaat |
| **Thuisbezorging** | Uitgaand | Nee |
| **Retour via pakketautomaat** | Inkomend (retour) | Nee. Je klant levert het pakket in bij een willekeurige Instabox-automaat. Zet de extra dienst **Retour zonder label** aan als de klant geen verzendlabel hoeft te printen. |
Producten worden meestal gebruikt binnen en tussen Zweden, Noorwegen, Denemarken, Finland en Nederland, van 0.1 tot 20 kg. Je kunt andere landen kiezen in een verzendregel. Instabox accepteert of weigert de zending wanneer je hem verzendt.
* **Bezorging bij pakketautomaat** heeft een afhaalpunt (hier een pakketautomaat) nodig voordat je kunt verzenden. Zie [Een afhaalpunt kiezen](/docs/nl/how-to/pick-a-service-point).
* Instabox stuurt track-&-traceupdates uit zichzelf naar Zippendo. Je hoeft niets in te stellen. Zie [Tracking-webhooks van vervoerders](/docs/nl/how-to/tracking-webhooks).
* Instabox maakt geen douanedocumenten aan. Staat bij de verzendregel **Proformafactuur genereren** of **Handelsfactuur genereren** aan, dan maakt Zippendo dat document aan. Zie [Douane en documenten](/docs/nl/how-to/customs-and-documents).
* Deze vervoerder is niet beschikbaar onder **Ophaalopdrachten**.
## De koppeling wijzigen of verwijderen
Om te wijzigen open je **Vervoerders** → **Mijn vervoerders** en klik je op de kaart op **Vervoerder bewerken**. De pagina **Vervoerder bewerken** heeft twee secties:
* **Algemeen**: **Naam van de vervoerder** en **Merk**, als je organisatie merken heeft.
* **Vervoerderinstellingen**: **Client-ID**, **Client secret**, **Klantnummer** en **Testmodus**.
Klik op **Opslaan**. Je ziet “Vervoerder bijgewerkt”.
Om 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 mee verwijderd. Zendingen die je al hebt verzonden, houden hun verzendlabels en trackingnummers.
Als je overstapt naar de nieuwe koppeling, koppel dan eerst **Instabox**, pas je verzendregels aan zodat ze die gebruiken en verwijder daarna deze oude koppeling.
## Veelvoorkomende problemen
| Wat je ziet | Wat je doet |
| - | - |
| “Kan de vervoerder niet koppelen. Probeer het opnieuw.” | Controleer of elk verplicht veld is 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 vervoerderlimiet 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.” bij het verzenden | Controleer **Client-ID** en **Client secret** bij **Vervoerder bewerken**. Een actuele **API-sleutel** van Instabox werkt hier niet. Gebruik voor die sleutel [Instabox koppelen](/docs/nl/how-to/connect-instabox). |
| “Dit verzendproduct bezorgt bij een afhaalpunt. Kies een afhaalpunt voordat je verzendt.” | Kies een pakketautomaat voor **Bezorging bij pakketautomaat**. Zie [Een afhaalpunt kiezen](/docs/nl/how-to/pick-a-service-point). |
| “De vervoerder heeft dit geweigerd. Bekijk de reden van de vervoerder, corrigeer de gegevens en probeer het opnieuw.” met de reden “Instabox … is not available for …” bij het verzenden | Instabox biedt dit verzendproduct niet aan voor dat land en die postcode. Controleer het adres, of kies een ander verzendproduct. |
## Gerelateerd
* [Instabox koppelen](/docs/nl/how-to/connect-instabox)
* [Een vervoerder of integratie koppelen](/docs/nl/how-to/connect-index)
* [Inloggegevens van de vervoerder](/docs/nl/how-to/carrier-credentials)
* [Testmodus](/docs/nl/how-to/sandbox-mode)
* [Een vervoerdersintegratie 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.