Zelf pakketdiensten integreren (technisch)
Deze manier vervangt de oude JSON push methode.
Picqer ondersteunt standaard een veel pakketdiensten, maar het komt natuurlijk voor dat je een andere verzendpartij wilt integreren in Picqer. Je kan daarom je eigen verzendmethode in Picqer aanmaken, waarmee je via een eigen script verzendlabels voor Picqer kunt maken.
Dat kan met de 'Custom' verzendmethode in Picqer. Hiermee kan je zelf een koppeling maken tussen Picqer en elke vervoerder met een API.
Voor deze integratie is het nodig om te programmeren, technische kennis is dus vereist. Je maakt een eigen script die op het web toegankelijk is. Wij sturen een verzoek voor een label naar dat script, het is aan jou om het label op te halen uit de API van de vervoerder of zelf te genereren, en dan aan ons terug te sturen. Hieronder de technische uitleg voor programmeurs om deze koppeling te maken.
Zelfde manier als geïntegreerde pakketdiensten
Met deze methode kan je een eigen integratie maken voor 1 account, maar ook de ontwikkeling starten voor een vaste integratie in Picqer.
Deze manier werkt exact hetzelfde als hoe pakketdiensten integreren met Picqer. Daardoor kan je met deze methode klein beginnen voor 1 of 2 Picqer accounts en later als pakketdienst in Picqer geïntegreerd worden voor alle gebruikers, zonder extra werk aan jullie kant.
Custom verzendmethode
De verzendmethode heet in Picqer 'Custom'. Hiermee kun je een URL opgeven die voor deze verzendmethode gebruikt moet worden. Als de gebruiker in Picqer een hiermee een zending maakt, doet Picqer een POST-request op de opgegeven URL, met daarin in JSON alle informatie over de zending en de picklijst. Picqer verwacht als reactie een JSON met daarin de barcode en een base64 van de PDF of ZPL van het label.
Je kan ook dynamische configuratie-opties geven. Daarmee kan in Picqer per verzendprofiel andere opties gekozen worden. Als je dat wilt gebruiken geef je ook een Configuratie URL op.
Koppeling instellen
Ga naar nieuwe Custom pakketdienst.
Geef je koppeling een naam.
Als je gebruik wilt maken van dynamische configuratie-opties, geef je een Configuration URL op.
Geef de Shipment creation URL op. Dit is de locatie van je script die we aanroepen als er een zending gemaakt moet worden.
Voor authenticatie is een Password of API key verplicht. Je kan ook een Username opgeven. Deze worden gebruikt als Basic HTTP authentication. Op deze manier kan je via 1 script verschillende accounts bedienen.
Klik op ‘Opslaan’.
De verzendmethode is nu toegevoegd. De volgende stap is een verzendprofiel toevoegen. Als je een Configuration URL hebt opgegeven, halen we daar de configuratie-opties op en tonen we die in het formulier.
Request & response
De technische details over de request die Picqer stuurt en de response die je moet geven, vind je in de API documentatie.
Transparant
De gebruiker merkt in Picqer geen verschil tussen eigen gemaakte verzendmethodes of door Picqer ondersteunde verzendmethodes. Het maken van verzendlabels gaat op precies dezelfde manier.
