Picqer API koppelen aan je webshop.

Picqer is magazijnsoftware voor webshops, gemaakt in Nijmegen. Het regelt wat er ná de bestelling gebeurt: picken, inpakken, verzenden, voorraad bijhouden, inkopen en retouren verwerken.

Het zit dus tussen je webshop en je vervoerder, en het is voor veel webshops het systeem waar de werkelijke voorraad in staat. Dat maakt het een logische bron voor je site: wat Picqer zegt dat er is, is wat er is. Verzend je zonder magazijnsysteem, dan kan je webshop ook rechtstreeks op de PostNL API.

Elke klant heeft een eigen subdomein en daarop staat de API. Aanmelden gaat met een API-sleutel als gebruikersnaam via basic auth; een wachtwoord is niet nodig.

Wat er te benaderen valt is breed: orders, producten, voorraad, picklijsten, zendingen, retouren, inkooporders, klanten, leveranciers, magazijnlocaties, prijslijsten en eigen velden. Genoeg om een webshop, een klantportaal of een dashboard op te bouwen.

Daarnaast zijn er webhooks. Picqer meldt zelf wanneer de voorraad verandert of een picklijst wordt afgesloten, en dan verversen wij wat er op de site moet veranderen. Dat is netter dan elke minuut vragen of er nog iets is, en het houdt het aantal aanroepen laag.

De volgorde die wij aanhouden:

1. Voor de bouw vragen we bij Picqer een gratis testaccount aan. Dat geeft Picqer aan ontwikkelaars, zodat er niet op het echte magazijn wordt getest.
2. In de instellingen van Picqer maak je een API-sleutel aan voor deze ene integratie.
3. We bouwen de vier processen die Picqer zelf aanraadt voor een webshopkoppeling: een nieuw product in de winkel wordt een product in Picqer, een betaalde bestelling wordt een klant en een order, een afgesloten picklijst zet de status en eventueel een mail naar de klant in gang, en een wijziging in de vrije voorraad gaat meteen naar de winkel.
4. Bij de livegang zetten we de webhooks op je eigen subdomein aan en draaien we een eerste volledige synchronisatie van de voorraad.

Het eerste is de voorraad. Een webshop die zijn voorraadgetal uit Picqer haalt, verkoopt niet meer wat er niet ligt. Dat scheelt de mail die begint met "helaas".

Het tweede is de status van een bestelling. Wanneer is hij gepickt, wanneer is hij verzonden, met welk volgnummer. Dat kun je in een eigen account of in je eigen mail zetten in plaats van de klant naar de vervoerder te sturen.

En het derde is de levertijd. Wie inkooporders meeneemt, kan zeggen wanneer iets weer binnen is in plaats van alleen dat het op is. Dat is precies het verschil tussen een bezoeker die wegklikt en een bezoeker die wacht.

Bijna elk gesprek over een Picqer-koppeling gaat uiteindelijk over één vraag: welk getal toon je?

Er ligt fysieke voorraad, er staan orders op te wachten, er is inkoop onderweg en er zijn retouren die nog moeten worden goedgekeurd. Het getal dat een bezoeker wil zien is wat hij vandaag kan bestellen, en dat is geen van die getallen los.

Wij spreken dat aan het begin af en leggen het vast, inclusief wat er gebeurt bij nul. Toon je dan niets, een wachtlijst, of een verwachte datum uit de inkooporder? Dat is een keuze met gevolgen voor je omzet, en die hoort niet bij de bouwer te liggen.

Picqer rekent per API-sleutel met normaal 500 aanvragen per minuut, en kan dat bijstellen als het platform druk is. In elk antwoord staan twee headers: X-RateLimit-Limit met de grens van dat moment en X-RateLimit-Remaining met wat er nog over is.

Ga je eroverheen, dan antwoordt Picqer met 429 Too Many Requests en wordt de aanvraag genegeerd. Hij wordt dus niet later alsnog uitgevoerd. Picqer noemt het niet ondersteunen van die limiet zelf het meest voorkomende probleem bij gebruikers van de API. Wij bouwen het vanaf de eerste versie in: bij een 429 wacht de koppeling en probeert hij het later opnieuw.

Daarnaast geven de meeste lijsten 100 resultaten per keer, met offset voor de volgende 100. Een volledige synchronisatie van een grote catalogus kost dus meer aanroepen dan je zou denken, en daarom doen de webhooks het dagelijkse werk.

Voor WooCommerce bestaat een standaardintegratie, en voor een gewone webshop is dat vaak genoeg. Wij bouwen erop of ernaast als er meer nodig is: een voorraadgetal dat rekening houdt met inkoop onderweg, een verwachte leverdatum op de productpagina, of de status van een zending in je eigen klantaccount. Bouwen we de WooCommerce webshop zelf, dan nemen we die koppeling mee in het traject. Maak je de labels niet in Picqer maar in Sendcloud, lees dan hoe we Sendcloud koppelen aan je shop.

Op een maatwerksite in Next.js ontvangt een eigen serverroute de webhooks van Picqer en ververst alleen de productpagina’s waarvan de voorraad is veranderd. Zo blijft de site snel en blijft het aantal aanroepen klein.

De orders die Picqer verwerkt, gaan daarna vaak door naar de boekhouding; hoe dat werkt staat bij Exact Online. Wat we aan webshops en maatwerk bouwen lees je bij Design & Development.