Skip to main content
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. De velden die elke vervoerder heeft, staan onder Inloggegevens van de vervoerder.
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.

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. Meer informatie op de kaart opent instabee.com.

Instabox (oude API) koppelen

1

Alle vervoerders openen

Klik in de zijbalk op Vervoerders en open dan het tabblad Alle vervoerders.
2

De juiste kaart zoeken

Zoek de kaart met de naam Instabox (oude API) met het gele label Verouderd. Dit is een andere kaart dan Instabox. Klik op Koppelen.
3

Het formulier invullen

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

De vervoerder koppelen

Klik op Koppelen. Je ziet “Vervoerder gekoppeld” en de vervoerder verschijnt op het tabblad Mijn vervoerders.
Tabblad Alle vervoerders met de kaart Instabox oude API gemarkeerd als Verouderd, met de knoppen Koppelen en Meer informatieTabblad Alle vervoerders met de kaart Instabox oude API gemarkeerd als Verouderd, met de knoppen Koppelen en Meer informatie

De kaart Instabox (oude API) met het label Verouderd

Venster Vervoerder koppelen voor Instabox oude API met Client-ID, Client secret en KlantnummerVenster Vervoerder koppelen voor Instabox oude API met Client-ID, Client secret en Klantnummer

Vul Client-ID, Client secret en Klantnummer in

Formulier voor Instabox oude API, naar beneden gescrold naar Optionele velden met het selectievakje TestmodusFormulier voor Instabox oude API, naar beneden gescrold naar Optionele velden met het selectievakje Testmodus

Testmodus staat onder Optionele velden

Velden op het formulier

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.

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. 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.
  • Instabox stuurt track-&-traceupdates uit zichzelf naar Zippendo. Je hoeft niets in te stellen. Zie Tracking-webhooks van vervoerders.
  • 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.
  • 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

Gerelateerd