Picqer Shopify koppeling

Wat je tussen Picqer en Shopify koppelt

Shopify vangt de order. Picqer pickt, verpakt en verzendt, en weet wat er vrij op de plank ligt. Tussen de twee lopen vier stromen, en een vijfde komt van buiten: de voorraad en leverdatum van je leverancier.

Producten worden aan elkaar gekoppeld op één sleutel: de SKU van de Shopify-variant is de productcode in Picqer. Picqer eist dat een productcode uniek is. Shopify eist dat van een SKU niet, dus de koppeling controleert bij de start op dubbele en lege SKU's en meldt ze voordat er voorraad wordt geschreven.

Welk systeem is leidend, per gegeven

Over de laatste regel: Picqer staat backorders altijd toe. Of een klant een product zonder voorraad kan bestellen, bepaalt dus de webshop, per variant.

Wat Picqer en Shopify anders bewaren

Vrije voorraad tegenover available en committed

Picqer geeft per product en per magazijn een rij getallen terug:

{
  "productcode": "10482",
  "stock": [
    {
      "idwarehouse": 18,
      "stock": 20,
      "reserved": 6,
      "reservedbackorders": 0,
      "reservedpicklists": 6,
      "freestock": 14
    }
  ]
}

stock is wat er ligt, reserved wat al verkocht en nog niet gepickt is, freestock het verschil. Shopify houdt per variant en per locatie eigen standen bij. available is wat te koop is. committed is wat in geplaatste orders zit die nog niet zijn afgehandeld. on_hand is de som van die twee en van de standen voor gereserveerd, beschadigd, veiligheidsvoorraad en kwaliteitscontrole.

De rekensom. Er liggen 20 stuks. Een Shopify-order neemt er 4, een bol-order die rechtstreeks in Picqer staat 2. De vrije voorraad is 20 min 6 is 14. Schrijft de koppeling de 20 als on_hand, dan trekt Shopify zijn eigen 4 af en toont 16: de bol-order kent Shopify niet. Schrijft hij de 14 als available, dan klopt het. De vrije voorraad kan in Picqer ook negatief zijn, bij backorders. Shopify krijgt dan 0.

Het venster tussen order en reservering

Een order die net in Shopify is geplaatst, staat nog niet in Picqer. In dat venster is available in Shopify al 4 lager en freestock in Picqer nog niet. Een voorraadronde die dan schrijft, zet de 4 terug.

Shopify heeft daar een controle voor. Elke hoeveelheid in inventorySetQuantities krijgt een changeFromQuantity mee: het aantal dat de koppeling het laatst heeft gezien.

{
  "name": "available",
  "reason": "correction",
  "quantities": [
    {
      "inventoryItemId": "gid://shopify/InventoryItem/30322695",
      "locationId": "gid://shopify/Location/124656943",
      "quantity": 14,
      "changeFromQuantity": 16
    }
  ]
}

Staat er in Shopify inmiddels 15 omdat er een order bij kwam, dan weigert Shopify de wijziging met de fout CHANGE_FROM_QUANTITY_STALE. De koppeling wacht tot die order in Picqer is gereserveerd en schrijft dan het nieuwe getal. Het veld is verplicht; wie null meegeeft slaat de controle over. Vanaf API-versie 2026-04 vraagt de mutatie ook een idempotentiesleutel.

Magazijnen en locaties

Een Picqer-magazijn heeft drie instellingen die hier tellen: accept_orders, counts_for_general_stock en priority. Een order kan worden beperkt tot de magazijnen die hem mogen leveren. Shopify wijst een order zelf toe en splitst hem in fulfilment orders, elk met een eigen locatie. De koppeling legt de tabel vast: magazijn Utrecht hoort bij locatie Utrecht, de winkel met kassa is een Shopify-locatie zonder Picqer-magazijn. Orders voor die winkel blijven buiten Picqer, of worden met fulfillmentOrderMove verplaatst naar een locatie die wel uit Picqer levert. Zie voorraad over meerdere magazijnen.

De kant van de leverancier

Picqer heeft inkooporders met een verwachte leverdatum, delivery_date, en geeft per product de openstaande inkoopregels terug op volgorde van aankomst. Een backorder krijgt daaruit een date_available. Wat Picqer niet doet, is het voorraadbestand van een leverancier inlezen: wat de leverancier zelf nog heeft liggen staat er niet in.

De koppeling leest dat bestand wel en gebruikt het op twee plekken. In Shopify gaat een variant met vrije voorraad 0 en 40 stuks bij de leverancier op doorverkopen, met de leverdatum als metafield. Naar Picqer gaan de beschikbaarheid bij de leverancier en de levertijd, zodat inkoop en webshop dezelfde datum zien. Eigen voorraad gaat altijd voor: de leveranciersvoorraad vult alleen aan waar het eigen magazijn op nul staat. Meer hierover op levertijd synchroniseren en Picqer koppeling.

De technische werkelijkheid van deze combinatie

De getallen zijn op 3 oktober 2026 nagelezen in de documentatie van Picqer en Shopify. Picqer meldt dat de limiet van 500 kan meebewegen met de drukte op het platform; de actuele waarde staat in de header X-RateLimit-Limit.

De nachtelijke vergelijking, doorgerekend. 15.000 producten in één magazijn ophalen via GET /warehouses/{id}/stock kost 150 verzoeken van 100 resultaten: ruim binnen de 500 per minuut. Naar Shopify zijn 15.000 hoeveelheden 60 mutaties van 250. Na de vergelijking gaan alleen de verschillen mee.

Webhooks zijn geen garantie, aan geen van beide kanten. Shopify levert een webhook soms twee keer af en garandeert geen volgorde. Picqer schakelt een webhook uit na herhaald falen. De koppeling antwoordt daarom direct met 200, zet het bericht in de wachtrij en controleert de handtekening: X-Picqer-Signature bij Picqer, een HMAC met SHA-256 over de hele inhoud. De nachtelijke vergelijking vangt op wat een webhook heeft gemist. Zie wat is een webhook.

Orders ouder dan 60 dagen. Shopify geeft een app standaard alleen de orders van de laatste 60 dagen. Voor een migratie met oudere openstaande orders is het recht read_all_orders nodig.

De naam van de vervoerder. Shopify herkent een vervoerder alleen als de naam in trackingInfo.company exact overeenkomt met zijn lijst, hoofdletters inbegrepen. De koppeling vertaalt de naam uit de Picqer-zending. De klant krijgt alleen een verzendmail als notifyCustomer aan staat; de standaardwaarde is uit.

Wat een standaardkoppeling hier niet doet

Picqer heeft zelf een Shopify-koppeling en documenteert wat die doet. Op 3 oktober 2026 stond er in de helpartikelen:

• Eén Shopify-locatie. Picqer beheert één locatie per webshop. Orders die in Shopify op een andere locatie binnenkomen worden genegeerd.
• Eén webshop, één Picqer-account. Een Shopify-winkel is één keer te koppelen.
• Alleen onvervulde, betaalde orders. Orders met de fulfilmentstatus unfulfilled en de betaalstatus paid of partially_refunded worden geïmporteerd; met verwachte orders aan ook nog niet betaalde.
• Dubbele SKU's. De voorraad gaat naar de SKU die Shopify als eerste teruggeeft.
• Annuleren werkt één kant op. Een annulering in Picqer verandert niets aan de order in Shopify.

De voorraad van leveranciers zit er niet in: Picqer leest die zelf niet in. Een gebouwde koppeling legt de tabel van magazijnen en locaties vast, de regel per betaalwijze en de bron per leverancier.

Als het misgaat

Voordat de koppeling een order aanmaakt, zoekt hij in Picqer op reference. Picqer dwingt een unieke referentie niet af, dus zonder die controle maakt een herhaald bericht een tweede order. Een bericht dat blijft falen wordt met de oorspronkelijke inhoud bewaard en gaat opnieuw mee zodra de oorzaak is opgelost.

Voor livegang draait de koppeling als dry run: hij laat per variant zien welke voorraad hij zou schrijven en welke orders hij zou aanmaken, zonder te schrijven. Wij hosten en bewaken hem en passen hem aan als Picqer of Shopify een interface wijzigt. Alle voorraadstromen staan op voorraad en beschikbaarheid, de platformkant op Shopify koppeling, en het overzicht op koppelingen. Verwante combinaties: Picqer WooCommerce koppeling en Akeneo Shopify koppeling. Vertel hoeveel magazijnen, locaties en leveranciers je hebt.