Overslaan en naar hoofdcontent gaan
Terug naar boven

Servicepunten voor de API Integratie

Team Sendcloud
  • Bijgewerkt

Doel: Dit is een gids over hoe je Servicepunten kunt inschakelen voor API integraties. Dit artikel richt zich op het instellen van de Servicepuntenkiezer in een zelfgebouwde shop, waarin Sendcloud verbonden is via een API integratie en niet via een plugin.

Sendcloud API

Sendcloud API's bieden de nodige functies en hulpmiddelen om je verzendautomatisering rond het Sendcloud platform te bouwen, zodat je je verzendproces kunt stroomlijnen en je logistieke proces kunt automatiseren.
Je kunt belangrijke Sendcloud functies integreren met je zelfgebouwde e-commerce systeem. Wij bieden uitgebreide documentatie aan over het integreren met Sendcloud API's in ons Developer Portal.

Bekijk hier het Sendcloud Developer Portal

De Service Point API

De Service Point API voorziet je van de informatie die je nodig hebt om pakketten in te leveren of te verzenden naar een servicepunt (ook bekend als drop-off locaties). De API biedt vier endpoints aan waarmee je servicepunt-locaties kunt opvragen, de beschikbaarheid ervan kunt verifiëren en ze in het Sendcloud platform kunt opslaan voor gebruik tijdens het uitchecken. 

Bekijk hier onze Service Point API Reference

De servicepuntenkiezer integreren

Sendcloud biedt een servicepuntkiezer die gemakkelijk in je systeem geïntegreerd kan worden. Deze toont een kaart op je checkout pagina, waaruit je klanten een geschikt servicepunt kunnen kiezen om hun pakket te laten bezorgen. Meer informatie over de servicepuntkiezer vind je hier.

Let op dat het servicepunt wordt getoond in de taal die in je account is ingesteld en niet in de taal van je web browser. 

Voordat je begint, zorg ervoor dat je:

  1. Je API keys hebt verkregen
  2. Servicepunten hebt ingeschakeld voor de geselecteerde vervoerders in je Integratie instellingen in Sendcloud

Om de servicepuntkiezer te integreren met je zelfgebouwde shop systeem:

  1. Speel wat met het live voorbeeld. Als je een servicepunt kiest, krijg je een servicepunt object en een postnummer - indien ingevoerd - als resultaat. Die gegevens heb je later nodig bij het aanmaken van een nieuwe zending via onze parcels API (zie Create a parcel in onze shipping API referentie). 
  2. Zorg dat je de to_service_point en to_post_number parameters invult wanneer je de data verstuurt.
  3. Je kunt de code onderaan deze pagina kopiëren bij de sectie Usage.

Om te integreren met je back-end code:

  1. Je moet sendcloud.servicePoints.open aanroepen en voorzien van een config object, een succes callback en een faal callback (voorbeeld)
  2. Zodra je een Service Point selecteert zal onze library je callback functie aanroepen met een Service Point Object. Deze bevat de servicepunt adres properties en de unieke service_point_id. 
  3. Wanneer je een zending aanmaakt (Create a parcel) via de API, zul je de request zo moeten structureren dat deze de servicepunt adresgegevens bevat. In de to_service_point parameter verstuur je de service point ID. 
  4. Je kunt hier meer uitleg vinden over het aanmaken van zendingen naar servicepunten via de Sendcloud API. 

Gerelateerde Links: 

Version History

Version: 1.0.0
Date: 2017-01-11 
URL: https://embed.sendcloud.sc/spp/1.0.0/api.min.js