Eigen koppeling via de API

Staat je webshop of systeem niet in de lijst met platforms, dan koppel je het zelf via de Stockhub API. Daarvoor kies je bij een nieuw verkoopkanaal voor API. Stockhub maakt dan een token aan waarmee je eigen systeem bestellingen naar Stockhub stuurt en bijvoorbeeld voorraad en zendingen opvraagt.

Bij een API-kanaal haalt Stockhub zelf niets op en stuurt het niets naar je systeem. Je eigen systeem, of de ontwikkelaar die het bouwt, roept de API aan.

API-kanaal of OpenAPI-koppeling

Een API-kanaal is hetzelfde als een koppeling op de pagina OpenAPI (Integraties > OpenAPI). Je kunt het op twee plekken aanmaken:

• via Integraties > Verkoopkanalen, zoals hieronder beschreven. Je vult dan ook een Afzendernaam in.
• via de knop Nieuwe OpenAPI koppeling op de pagina OpenAPI. Dat lees je in Koppelen met de Stockhub API.

Op welke manier je het ook aanmaakt: het kanaal staat daarna op de pagina OpenAPI, niet in het overzicht van Verkoopkanalen.

Koppeling aanmaken in Stockhub

1. Ga in het menu naar Integraties > Verkoopkanalen.

2. Klik op Nieuw verkoopkanaal. Het venster Verkoopkanaal toevoegen opent.

3. Kies API.

4. Vul de velden in:

   • Omschrijving: een herkenbare naam voor de koppeling. Op de pagina OpenAPI zie je die terug als Naam.
   • Afzendernaam: de naam die op het verzendlabel komt.

   Inloggegevens vul je bij API niet in. Test verbinding is niet nodig: er is nog niets om te testen.

   

5. Klik op Volgende.

6. Je ziet de instellingen onder Automatische gegevens verwerking. Bij een API-kanaal gebruikt Stockhub deze instellingen niet, want je eigen systeem stuurt en vraagt de gegevens op. Je kunt ze laten staan.

7. Klik op Opslaan.

Na het aanmaken

Een API-kanaal is meteen actief. Het fulfilmentbedrijf hoeft het niet eerst te activeren. Zie je na het opslaan toch de melding Activatie verkoopkanaal in behandeling, dan kun je die bij een API-kanaal negeren.

Het token van de koppeling vind je op de pagina OpenAPI: ga in het menu naar Integraties > OpenAPI. Daar wijzig je ook de naam of verwijder je de koppeling. Hoe dat werkt en waar je de technische documentatie van de API vindt, lees je in Koppelen met de Stockhub API.

Bestellingen die je systeem via de API aanmaakt, komen binnen op dit kanaal. Je ziet ze in Stockhub bij je andere bestellingen.

Deel het token alleen met wie je koppeling bouwt. Met het token kan iemand bestellingen voor jou aanmaken.