Staffelprijzen uit je ERP in je webshop: de korting rekent mee terwijl de klant bestelt

Een staffel is een rekenregel, geen prijs

Een basisprijs is één getal per artikel. Een staffel is een regel: vanaf zoveel stuks deze korting, op deze prijs. In het voorbeeld van prijzen en klantafspraken heeft prijslijst Installateurs voor artikel 10482 drie treden. 14 prijslijsten met staffels op 1.800 artikelen, drie treden elk, zijn 75.600 staffelregels.

Met tien klanten die per telefoon bestellen rekent de binnendienst de staffel uit. In een webshop moet de prijs veranderen op het moment dat de klant het aantal in zijn winkelmand aanpast. Een klant met 90 stuks à € 10,63 betaalt € 956,70. Zet hij er 10 bij, dan wordt het 100 maal € 10,09 is € 1.009,00, en die prijs moet hij zien voordat hij afrekent. Staat de staffel niet in de webshop, dan ziet hij € 1.063,00 en belt hij de binnendienst.

Hoe werkt het?

Waar de staffel in het ERP staat

Exact Online bewaart staffels in SalesPriceListVolumeDiscounts. Elke regel heeft een Quantity, een Discount of een NewPrice, en een EntryMethod: 1 is de korting, 2 is de nieuwe prijs. Een prijslijst geldt per artikel of per artikelgroep: Entity 1 of 2 in SalesPriceLists.

De documentatie geeft de formule: de prijs is (1 min Discount) maal BasePriceAmount. Elke trede rekent dus vanaf dezelfde basisprijs. Treden stapelen niet.

De trede op 1 stuk draagt de korting van de prijslijst zelf. De trede op 100 is de "5% extra" van de hub: 0,85 maal 0,95 is 0,8075, dus een korting van 19,25% op de basisprijs.

Van ERP-regel naar prijstrede

Shopify bewaart een staffel als quantityPriceBreaks in een prijslijst: per variant een minimumQuantity en een price. De mutatie quantityPricingByVariantUpdate zet vaste prijzen, bestelregels en treden in één keer. Gaat één wijziging in de aanroep mis, dan wordt geen enkele wijziging toegepast.

{
  "priceListId": "gid://shopify/PriceList/1432",
  "input": {
    "pricesToAdd": [
      { "variantId": "gid://shopify/ProductVariant/4410482",
        "price": { "amount": "10.63", "currencyCode": "EUR" } }
    ],
    "quantityPriceBreaksToAdd": [
      { "variantId": "gid://shopify/ProductVariant/4410482",
        "minimumQuantity": 25, "price": { "amount": "10.38", "currencyCode": "EUR" } },
      { "variantId": "gid://shopify/ProductVariant/4410482",
        "minimumQuantity": 100, "price": { "amount": "10.09", "currencyCode": "EUR" } }
    ]
  }
}

De koppeling rekent elke trede uit, rondt af op centen en schrijft een vaste prijs per trede. De webshop rekent dan niets meer zelf uit, en de stuksprijs op het scherm is de stuksprijs op de orderregel.

De order gaat terug met de prijs die de klant zag

De orderregel in Exact Online heeft een UnitPrice en een Discount, die Exact berekent als (standaardprijs min regelprijs) gedeeld door de standaardprijs. De koppeling stuurt de stuksprijs uit de webshop mee. Rekent het ERP zelf de staffel opnieuw uit met de onafgeronde 10,375, dan zijn 40 stuks € 415,00 in het ERP en 40 maal € 10,38 is € 415,20 in de webshop. Die 20 cent blokkeert het automatisch afletteren van de betaling. Hoe dat werkt staat in bedragen en btw mappen.

Doorvoer

De eerste vulling leest 75.600 staffelregels. Via sync/Sales/SalesPriceListVolumeDiscounts, 1.000 regels per verzoek, zijn dat 76 verzoeken. Via het gewone endpoint met pagina's van 60 zijn het er 1.260: 21 minuten bij 60 verzoeken per minuut en een kwart van het dagbudget van 5.000. Daarna haalt de koppeling alleen regels op met een hogere Timestamp. Aan de Shopify-kant zijn 75.600 treden bij 250 per aanroep 303 aanroepen. De rekenwijze staat in doorvoer berekenen.

Wat er stil misgaat

De eerste rij ontstaat bij het overzetten van een oude prijslijst waarin treden op elkaar stapelden. De koppeling controleert per artikel dat elke hogere trede een lagere stuksprijs geeft. Een trede die dat niet doet, gaat niet naar de webshop en komt op de controlelijst.

Wat je ermee regelt

• Treden per prijslijst. Elke staffel uit het ERP als vaste prijs per aantal, per klantgroep.
• Dezelfde afronding. Eén stuksprijs per trede, in de webshop en op de orderregel.
• Verpakking en bestelregel. Treden die passen op de doos en de minimale afname.
• Acties naast staffels. Een actieperiode met begin- en einddatum, bovenop of in plaats van de staffel.
• Controle vooraf. Een trede die duurder is dan de trede eronder, wordt tegengehouden: zie dry run en goedkeuring.

Een vaste prijs voor één debiteur gaat boven de staffel: zie klantspecifieke prijzen. Welke artikelen een klant überhaupt ziet staat bij assortiment per klant.

Met welke systemen

AFAS geeft alleen vrij wat de beheerder in een GetConnector zet, en zonder take komen de eerste 100 regels terug: een staffeltabel van 75.600 regels wordt in pagina's gelezen. Bij NetSuite mist de REST-record van een voorraadartikel de velden quantitypricingdiscount en quantitypricinglevel. Die komen uit een SuiteQL-query of een RESTlet. De grenzen van Shopify staan in het helpcentrum over volumeprijzen, de formule van Exact Online in de API-documentatie. Beide zijn nagelezen op 3 oktober 2026. Per systeem: Exact Online, AFAS, Shopify.

Wat een standaardkoppeling hier niet doet

In de vaste veldenset van standaardkoppelingen en koppelplatformen staat meestal één verkoopprijs per artikel, soms met een prijs per klantgroep. Een staffel zit daar niet in. Waar een platform staffels wel overzet, is dat gedocumenteerd voor één webshopplatform, met de Quantity Pricing-functie als voorwaarde en zonder ondersteuning voor bundelartikelen.

De tweede grens is het ERP zelf. Geeft de API de staffelkorting niet vrij, dan komt die uit een export van de prijslijst die de koppeling per nacht samenvoegt met de prijzen uit de API:

prijslijst;artikel;vanaf;korting
INSTALLATEURS;10482;1;0,15
INSTALLATEURS;10482;25;0,17
INSTALLATEURS;10482;100;0,1925

De koppeling leest de komma als decimaalteken, controleert dat de korting per trede oploopt en rekent de stuksprijs uit voordat er iets naar de webshop gaat. Stuur één prijslijst met staffels mee, dan hoor je hoe de treden in jouw webshop terechtkomen.