Custom pakketdienst
Met de Custom pakketdienst koppel je zelf elke vervoerder met een API aan Picqer. Je bouwt een webservice die het label bij de vervoerder ophaalt, of zelf maakt, en aan Picqer teruggeeft. Hiervoor moet je programmeren.
Op deze pagina
Voorbereiding
Je bouwt een webservice die bereikbaar is via internet, met:
- Een URL waarop Picqer de zending aanmaakt. Picqer stuurt de gegevens van de zending en de picklijst als JSON en verwacht een trackingcode en het label terug. Het label is altijd een PDF. Voor printers die ZPL ondersteunen kun je ook een ZPL-versie meesturen.
- Optioneel een URL die de opties voor het verzendprofiel teruggeeft. Lees daarover meer bij Verzendprofiel instellen.
Hoe de request en de response eruitzien, staat in de API-documentatie van de Custom pakketdienst.
Pakketdienst koppelen
Geef de pakketdienst een naam.
Vul de gegevens van je webservice in.
- Configuration URL: de URL die de opties voor het verzendprofiel teruggeeft. Laat hem leeg als je geen opties per verzendprofiel nodig hebt.
- Shipment creation URL: de URL waarop Picqer de zending aanmaakt. Dit veld is verplicht.
- Username (optional) en Password or API key: Picqer stuurt ze mee als HTTP Basic Authentication. Geef je elk Picqer-account eigen inloggegevens, dan bedien je meerdere accounts met één webservice.
Klik op 'Opslaan'.
Verzendprofiel instellen
Wat er op het label komt, bepaalt je webservice. Zonder 'Configuration URL' heeft het verzendprofiel daarom geen eigen opties.
Wil je per verzendprofiel iets kiezen, zoals het product van de vervoerder of een extra dienst, vul dan een 'Configuration URL' in. Picqer haalt daar de opties op en toont ze bij het aanmaken van een verzendprofiel. Bij elke zending stuurt Picqer de gekozen opties van het verzendprofiel mee naar je webservice.
Geeft je webservice in de configuratie ook aan dat hij meerdere dozen per zending ondersteunt, dan kun je in Picqer meerdere dozen per zending versturen.
Beschikbaar maken voor alle Picqer-gebruikers
Een Custom pakketdienst werkt op dezelfde manier als de pakketdiensten die in Picqer zitten. Wil je je koppeling later voor alle Picqer-gebruikers beschikbaar maken, dan hoeft je webservice daarvoor niet te veranderen. Lees meer over een pakketdienst integreren in Picqer.
Bestaande JSON Push koppeling
Vroeger koppelde je een eigen vervoerder met de pakketdienst 'JSON Push'. 'Custom' is daarvoor in de plaats gekomen. Heb je al een JSON Push koppeling, dan blijft die gewoon werken. Moet je hem opnieuw instellen, lees dan het artikel over de JSON Push pakketdienst. Bouw je een nieuwe koppeling, gebruik dan 'Custom'.
