Magento SnelStart koppeling

Wat je tussen Magento en SnelStart koppelt

Magento 2 geeft gegevens vrij via zijn REST API, SnelStart via de B2B API op b2bapi.snelstart.nl/v2/, die alleen werkt met een online administratie. Welke stromen er zijn, hangt af van of SnelStart ook levert of alleen boekt.

Een Magento-order heeft een entity_id, het nummer in elk API-pad, en een increment_id die de klant ziet, bijvoorbeeld 000010482. Dat increment_id gaat als referentie naar SnelStart; het entity_id bewaart de koppeling om later de zending in Magento te boeken. Hoe dit in een koppeling met een ERP of boekhoudpakket past staat op ERP koppeling met je webshop.

Welk systeem is leidend, per gegeven

Wat Magento en SnelStart anders bewaren

SKU's van 64 tekens tegenover artikelcodes van 10 cijfers

Een Magento-SKU mag 64 tekens lang zijn, met letters en streepjes: 10482-BL-M. Een nieuwe SnelStart-administratie accepteert artikelcodes van alleen cijfers, maximaal 10. Elke variant van een configurable product is in Magento een eigen simple product met een eigen SKU, en elke variant moet in SnelStart een eigen artikel zijn. Een collectie van 250 modellen in 12 varianten is 3.000 SKU's. De soort artikelcode zet je in SnelStart dus vooraf om naar cijfers en letters, of de koppeling houdt een vertaaltabel bij van SKU naar artikelcode. Zie SKU of EAN.

Twee orderregels voor één variant

Koopt een klant een configurable product, dan slaat Magento twee orderregels op. De bovenste is de configurable, met product_type configurable en de SKU van de gekozen variant. De tweede is de simple, met een parent_item_id naar de eerste. Een koppeling die elke regel overneemt, zet het artikel twee keer op de verkooporder. De koppeling voegt elk paar samen tot één regel met de SKU van de variant, en controleert daarna of de som van de regels plus verzendkosten gelijk is aan het ordertotaal.

Btw-percentage per regel tegenover de omzetgroep

Een Magento-orderregel heeft een tax_percent, bijvoorbeeld 21, en een tax_amount. SnelStart neemt geen tarief per regel aan: het artikel hangt aan een artikelomzetgroep, die wijst een omzetrekening aan, en de functie van die rekening bepaalt de btw. De koppeling vergelijkt daarom bij elke regel het tax_percent uit Magento met de omzetgroep van het artikel in SnelStart:

Een regel van 21% op een artikel in de groep laag gaat naar de controlelijst en niet stil naar de verkeerde omzetrekening. Verzendkosten staan in Magento op de order, in shipping_amount en shipping_tax_amount, niet als regel. Omdat elke factuurregel in SnelStart een artikel nodig heeft, maakt de koppeling er een regel op een vast verzendartikel van.

Waar de cent wordt afgerond

Magento heeft per website de instelling Tax Calculation Method Based On: per stuk (Unit Price), per regel (Row Total) of over het ordertotaal (Total). De rekensom voor 3 stuks van € 4,13 exclusief btw bij 21%:

Unit Price:  4,13 x 0,21 = 0,8673  ->  0,87 x 3 = 2,61 btw
Row Total:   3 x 4,13 = 12,39 x 0,21 = 2,6019  ->  2,60 btw
Verschil:    1 cent op een regel van 12,39

Rekenen Magento en SnelStart op een ander niveau af, dan wijkt het totaal van de verkooporder af van wat de klant betaalde, en dan lukt het afletteren niet automatisch. De koppeling vergelijkt het totaal in SnelStart met grand_total uit Magento en houdt een order met een verschil vast. Meer in bedragen en btw mappen.

Voorraad rond de pakbon

Magento reserveert bij elke order en laat de reservering pas los als de zending in Magento staat. SnelStart verlaagt de voorraad van een verkooporder op het moment dat je instelt: bij de pakbon of bij de factuur. Met reserveren voor orders in inControle zakt de vrije voorraad al bij het invoeren van de order. Elke weborder mag er maar één keer af:

Bij 20 stuks en een order van 4 toont Magento 16. Na de pakbon meldt SnelStart 16 vrij. Gaat die 16 naar de bron voordat de zending in Magento staat, dan rekent Magento 16 min 4 en toont 12. Dat is precies omgekeerd aan een koppeling met WooCommerce, waar de koppeling de open orders zelf aftrekt. Zie welke voorraad toon je in je webshop.

De technische werkelijkheid van deze combinatie

Nagelezen op 3 oktober 2026 in de documentatie van Adobe en het kennisplein van SnelStart.

Voorraad doorgerekend. 3.000 SKU's met één bron zijn 3.000 bronregels. Met de invoerlimiet van Magento aan, 20 regels per synchroon verzoek, zijn dat 3.000 / 20 = 150 verzoeken. Via het bulk-endpoint is het één verzoek. Na de eerste ronde gaan alleen artikelen mee waarvan de vrije voorraad in SnelStart is veranderd. Het bulk-endpoint hangt aan de consumer async.operations.all; draait die niet, dan blijven de bewerkingen op status 4, Open, en ziet de koppeling dat bij de controle van de status.

Orders doorgerekend. Een order kost aan de SnelStart-kant een zoekopdracht naar de relatie, bij een nieuwe klant een aanmaak, en de verkooporder: twee tot drie verzoeken. 400 orders op een actiedag zijn 800 tot 1.200 verzoeken. Omdat SnelStart zijn limieten niet openbaar maakt, schrijft de koppeling met een vast tempo en leest hij een 429 of 503 als teken om te wachten. Je eigen aantallen reken je door met doorvoer berekenen.

Wat een standaardkoppeling hier niet doet

Standaardkoppelingen tussen Magento en een boekhoudpakket beschrijven hun eigen grenzen. Bij een van de grotere aanbieders stond voor SnelStart:

• Relaties alleen aanmaken, op e-mailadres. Een bestaande relatie wordt nooit bijgewerkt; een bedrijf dat met een ander e-mailadres bestelt, wordt een tweede relatie.
• Hulpartikelen voor verzending en korting die een artikelcode van 25 tekens met letters vragen, dus een aanpassing van de administratie vooraf.
• Eén vaste kostenplaats voor alle orders uit de koppeling.
• Betalingen zoeken op bedrag, e-mailadres en ordernummer, en na drie dagen zonder treffer stoppen.
• Geen voorraad terug naar de webshop: de koppeling loopt één kant op.

Een gebouwde koppeling legt per omzetgroep, per variant en per bron vast wat er gebeurt, boekt de zending in Magento voordat de voorraad volgt, en verwerkt een gedeeltelijke creditnota op regelniveau. Zie ook dubbele klanten en debiteuren.

Als het misgaat

Voordat de koppeling een order schrijft, controleert hij of het increment_id al bij een verkooporder in SnelStart hoort, zodat een nieuwe poging geen tweede order of dubbele omzet maakt. Een order die 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: per order welke relatie, welke artikelen, welke omzetgroep en welk totaal er in SnelStart zouden ontstaan, zonder iets te boeken.

Wij hosten en bewaken de koppeling en passen hem aan als SnelStart of Adobe iets wijzigt. De systeemkant staat op SnelStart koppeling, de platformkant op Magento koppeling, en alle stromen op koppelingen. Verwante combinaties: WooCommerce SnelStart koppeling en Magento Exact Online koppeling. Vertel welk SnelStart-pakket en welke Magento-versie je hebt.