Picqer API: koppelen, webhooks en limieten uitgelegd
De Picqer API laat je eigen systemen koppelen aan je magazijn. Zo werkt toegang met een API-sleutel, wat webhooks doen en waar je op let bij limieten, paginering en testen.

Wanneer heb je de Picqer API nodig?
Voor veel webshops volstaat een standaardkoppeling. Picqer heeft officiële integraties met onder meer Shopify en WooCommerce; lees daarvoor onze koppelchecklist. De API wordt interessant als je een eigen of minder gangbaar webshopsysteem hebt, gegevens wilt uitwisselen met een ERP of boekhoudpakket, of eigen rapportages en automatiseringen wilt bouwen.
Volgens de officiële API-documentatie hebben alle Picqer-gebruikers toegang tot de API. Picqer beschrijft een RESTful API met JSON en stelt dat vrijwel alle gegevens en handelingen uit de app ook via de API beschikbaar zijn. De documentatie is alleen in het Engels beschikbaar. Cart.nl heeft de API niet zelf in een productieomgeving getest; deze gids vat de officiële documentatie samen, gecontroleerd op 2 november 2026.
Vraag jezelf eerst af of maatwerk nodig is. Een eigen koppeling moet je onderhouden, bewaken en aanpassen als systemen veranderen. Weeg die beheerlast mee naast de Picqer-kosten en de vraag of Picqer als WMS past.
Toegang: API-sleutel, eigen adres en User-Agent
Elke Picqer-klant heeft een eigen subdomein en daarmee een eigen API-adres, in de vorm https://jouwnaam.picqer.com/api/v1/. De documentatie noemt dat alleen versie 1 actief is en dat wijzigingen die niet terugwaarts compatibel zijn een nieuwe versie-URL krijgen. De API werkt uitsluitend via HTTPS.
Voor toegang gebruik je een API-sleutel. Die maak en trek je in via Instellingen > API Keys in de Picqer-app. Picqer gebruikt HTTP Basic Auth: de sleutel is de gebruikersnaam, het wachtwoord wordt genegeerd. Een API-sleutel kan volgens Picqer niet worden gebruikt om in te loggen in de webapp. Het advies van de aanbieder is om per toepassing een aparte sleutel te gebruiken, zodat je één koppeling kunt intrekken zonder de rest te raken.
Picqer vereist daarnaast een User-Agent-header met de naam van je toepassing en een website- of e-mailadres, zodat ze contact kunnen opnemen. Bewaar sleutels in een beveiligde omgeving van je server, nooit in de broncode van een website, een gedeeld document of een screenshot. Leg vast wie sleutels mag aanmaken en wanneer je ze vervangt.

Rate limits en paginering: de meest gemaakte fout
Picqer hanteert een limiet per API-sleutel. Volgens de documentatie is dat in normale omstandigheden 500 verzoeken per minuut, maar de limiet kan dynamisch worden aangepast afhankelijk van de belasting van het platform. Bouw dus niet op een vast getal. De headers X-RateLimit-Limit en X-RateLimit-Remaining tonen de actuele limiet en het resterende aantal verzoeken.
Bij overschrijding antwoordt Picqer met statuscode 429 en wordt het verzoek genegeerd. De aanbieder noemt het vergeten van rate limiting de belangrijkste oorzaak van problemen bij API-gebruikers. Laat je koppeling daarom vanaf het begin wachten en later opnieuw proberen. De officiële PHP-client heeft daar volgens Picqer een optie voor.
De meeste GET-verzoeken geven maximaal 100 resultaten terug. Met de parameter offset haal je de volgende reeks op. Een export van al je producten of orders vraagt dus meerdere verzoeken. Combineer paginering met de limiet, anders loopt een grote synchronisatie halverwege vast.
Webhooks: niet blijven vragen, maar laten melden
Met webhooks stuurt Picqer een melding naar jouw systeem zodra er iets gebeurt. Je hoeft dan niet steeds de API te bevragen om te zien of er iets veranderd is. Dat spaart verzoeken en houdt je binnen de limieten.
De documentatie noemt onder meer gebeurtenissen voor orders, zoals aangemaakt, toegewezen, gepauzeerd, statuswijziging en voltooid, en voor picklijsten, zoals aangemaakt, gewijzigd en gesloten. De volledige en actuele lijst staat op de webhookpagina. Mist er een gebeurtenis, dan vraagt Picqer om dat te melden.
Ontwerp je ontvanger zo dat dezelfde melding twee keer verwerken geen dubbele order of dubbele mail oplevert. Log binnenkomende meldingen, controleer bij twijfel de actuele stand via de API en zorg dat iemand ziet wanneer meldingen uitblijven. Een webhook is een seintje, geen garantie dat je eigen systeem alles correct heeft verwerkt.
Een eigen webshopkoppeling: de vier basisprocessen
Bouw je zelf een koppeling tussen je webshop en Picqer? De API-documentatie beschrijft vier processen waarmee een eigen koppeling werkt zoals de standaardintegraties. Ten eerste: nieuwe producten in de webshop ook in Picqer aanmaken. Ten tweede: bij een betaalde bestelling een klant en order in Picqer aanmaken. Ten derde: de orderstatus bijwerken en eventueel de klant mailen zodra een picklijst gesloten en verzonden is, via de webhook voor gesloten picklijsten. Ten vierde: voorraad in de webshop direct bijwerken met de webhook voor gewijzigde vrije voorraad.
Gebruik ook hier unieke SKU’s per variant; zonder consistente productcodes raken producten en voorraad uit elkaar. Bepaal vooraf welk systeem leidend is voor productgegevens en welk voor voorraad. Werk je met bundels of sets, laat dan bevestigen hoe samengestelde producten in de API worden behandeld.
Voor fulfilmentbedrijven geldt een aparte situatie. Met de fulfilmentversie van Picqer kun je API-sleutels koppelen aan een fulfilmentklant, met een beperkte toegang. Controleer in de documentatie welke onderdelen die klanten kunnen gebruiken.

Testen, bewaken en uitbesteden
Picqer biedt ontwikkelaars volgens de documentatie een gratis testaccount op aanvraag. Test daar eerst je volledige stroom: product aanmaken, betaalde order, picklijst sluiten, status terug naar de webshop en voorraadwijziging. Voeg uitzonderingen toe zoals een annulering, onvoldoende voorraad, een gedeeltelijke levering en een tijdelijke storing aan jouw kant.
Volg de changelog om op de hoogte te blijven van wijzigingen. Richt monitoring in op foutcodes, 429-antwoorden en uitblijvende webhooks. Leg vast wie de koppeling onderhoudt, wie bij storingen wordt gewaarschuwd en hoe je een order handmatig verwerkt als de koppeling tijdelijk niet werkt.
Heb je geen eigen ontwikkelaar? Vraag een bureau om een offerte met beschrijving van processen, foutafhandeling, beveiliging van sleutels, testplan en onderhoud. Vraag ook wie eigenaar is van de code. Vergelijk de koppelingen van andere WMS-aanbieders en het Picqer-profiel voordat je kiest: een standaardintegratie die je proces dekt is vaak eenvoudiger te beheren dan maatwerk.
Veelgestelde vragen
Volgens de officiële documentatie hebben alle Picqer-gebruikers toegang tot de API. Controleer de actuele voorwaarden van je abonnement bij Picqer.
In de Picqer-app via Instellingen > API Keys. Gebruik bij voorkeur een aparte sleutel per toepassing, zodat je die afzonderlijk kunt intrekken.
Picqer noemt normaal 500 verzoeken per minuut per API-sleutel, maar de limiet kan dynamisch wijzigen. Lees de X-RateLimit-headers en wacht bij een 429-antwoord voordat je opnieuw probeert.
De meeste GET-verzoeken geven maximaal 100 resultaten. Gebruik de parameter offset om volgende resultaten op te halen.
Nee, Picqer vermeldt dat de API-documentatie alleen in het Engels beschikbaar is.