Eigen verzendmethode met JSON push (technisch)

Deze uitleg gaat over de oude "JSON push" methode. Voor nieuwe integraties raden we aan deze nieuwe manier te gebruiken.

Picqer ondersteunt standaard 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.

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.

JSON Push

De verzendmethode die we in Picqer gebruiken noemen we 'JSON Push'. 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 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 van het label.

Koppeling instellen

Maak een nieuwe JSON push integratie aan. (Alleen mogelijk via deze directe url.)

Geef de koppeling een naam.

Onder 'Configuratie' geef je aan wat de URL is en voeg je eventueel een gebruikersnaam en wachtwoord toe. Als de gebruikersnaam is ingevuld, wordt dit als HTTP Basic Auth meegezonden.

Geef vervolgens het afzenderadres op dat gewenst is en klik op ‘Opslaan’.

De verzendmethode is nu toegevoegd.

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.

Geeft deze pagina antwoord op je vraag?