Magento 2

Magento kan bron én doel zijn: de catalogus eruit halen en voorraad en prijzen erin zetten, of andersom. De koppeling praat met de REST API van Magento 2.

Wat je nodig hebt

Een integratie in Magento met een access token en leesrechten op minimaal Catalog, Sales en Customers. Voor terugschrijven ook schrijfrechten op wat je stuurt.

1. In Magento: System → Extensions → Integrations → Add New Integration.
2. Onder API kies je de resources hierboven.
3. Save → Activate en kopieer de Access Token.
4. In Nexym: Koppel → Koppelingen & sync → + Koppeling toevoegen → Magento 2, plak de winkel-URL en het token, en druk op Test connection.

Veld	Voorbeeld
Basis-URL	https://shop.example.com
Store code	default (of je eigen store view)
Access token	het token uit stap 3

Merk, EAN, leverancier en btw

Magento heeft geen vaste velden voor merk, EAN of leverancier: elke shop legt die in eigen attributen vast. Welk attribuut een veld vult, stel je in op de veldkoppeling van Producten IN (Koppel → Koppelingen & sync → een koppeling → Wat synchroniseren → Veldkoppeling, het scherm Map Products IN). Daar staat het één keer; Producten OUT op dezelfde koppeling schrijft terug naar hetzelfde attribuut, zonder dat je het daar opnieuw invult.

Rij	Standaard	Wat het doet
Merk (brand)	manufacturer	De bron is de code van het attribuut met het merk (een keuzelijst). Nexym slaat de optie-id op als merkcode en de naam van de optie als merknaam; de rij Merknaam volgt de rij Merk vanzelf.
EAN (ean)	ean	De code van het attribuut met de EAN/GTIN, vaak ean, gtin of barcode.
Leverancier (supplier_reference)	leeg	De code van het attribuut met de leverancier. Leeg laten als je shop er geen heeft. Is het een keuzelijst, dan slaat Nexym de naam van de optie op (“Acme Supplies”, niet “230”); een tekstattribuut komt over zoals het is.
Btw-tarief (vat_rate)	0 → 0, 2 → 21	Een Value lookup op de rij: belastingklasse-id → btw-%. Magento slaat per product een klasse op, geen percentage. Klasse 2 is Taxable Goods. Een klasse die niet in de tabel staat, laat het btw-tarief leeg. Bij terugschrijven werkt de tabel andersom: 21% wordt klasse 2.

Heet het merk-attribuut in je shop brand, dan zet je in de rij Merk de bron van manufacturer op brand en sla je op. Met Test zie je meteen wat de rij oplevert.

Bij de eerste keer opslaan van de koppeling kijkt Nexym welke attributen je shop heeft en vult hij de rijen Merk, EAN en Leverancier voor je in:

• Merk: brand. Alleen als je shop geen brand heeft, manufacturer.
• EAN: ean, dan gtin, dan barcode.
• Leverancier: manufacturer (als het merk dat attribuut niet al gebruikt), dan supplier, dan vendor.

Een rij die je zelf hebt aangepast, blijft staan.

In Map Products OUT staan de rijen Merk, EAN, Leverancier en Btw-tarief met Volgt Map Products IN: ze hebben geen eigen bron. Je kunt ze daar wel uitzetten of overschrijven. Heeft de koppeling geen Producten IN, dan gebruikt Producten OUT het standaardattribuut (of wat bij het opslaan is gevonden), en zegt de rij dat.

De merknaam komt uit de opties van het merk-attribuut. Zet daarom ook Attributen (catalogus) IN aan en draai die eerst. Dat geldt ook voor een leverancier uit een keuzelijst: zolang Nexym de opties niet kent, blijft het optie-id staan.

Overal waar je een waarde ziet (het product, de tab Velden, het voorbeeld in de mapping, de wijzigingen in een rapport) toont Nexym de naam van een optie of categorie, met het id ernaast. Een merkwijziging in een rapport lees je dus als Joust → Luma, niet als 213 → 212. De opties van een configureerbaar product staan in de tab Velden als Kleur: Zwart, Blauw · Maat: S, M, L, en de websites van een product bij hun naam (bijvoorbeeld Main Website; Nexym leest die lijst één keer per dag uit Magento). Een product dat nog een leverancier-id heeft van vóór deze wijziging toont daarom ook al de naam; bij de volgende import slaat Nexym de naam op. Naar Magento gaat altijd het id: Producten OUT zoekt het bij de naam op. Omdat alleen de weergave verandert, stuurt dat geen producten opnieuw.

Een merk of leverancier die Magento nog niet kent. Geef je een product in Nexym een merk- of leveranciersnaam waarvoor het attribuut in Magento geen optie heeft, dan stuurt Producten OUT dat ene veld niet mee, en ook niet het oude id in de plaats. De rest van het product gaat gewoon. Nexym voegt de naam toe als nieuwe optie aan het attribuut, net alsof je hem zelf in de optie-editor had toegevoegd (To be created in …). De attribuut-export (Attributen (catalogus) OUT) maakt de optie aan in Magento, of neemt een bestaande optie met dezelfde naam over. Daarna stuurt de volgende product-export het nieuwe id. Tot dan staat in Runs & logs bij de product-export welke naam wacht. Heeft het attribuut in Magento een vaste lijst, dan kan Nexym geen optie toevoegen: de run zegt dat, en je kiest in Magento of Nexym een bestaande optie. Dit geldt voor elk veld dat een naam terugzet naar een optie-id.

Onder Product defaults op de koppeling staat nog Send URL key (url_key) (URL-sleutel meesturen, standaard uit): of Producten OUT de URL-sleutel van een product naar Magento stuurt. Zie De URL-sleutel.

Wat er over de lijn gaat

Entiteit	IN	OUT
Producten en varianten	ja	ja
Voorraad	ja	ja
Prijzen	ja	ja
Categorieën en attributen	ja	ja
Orders	ja	nee
Klanten	ja	ja

!

Magento’s afbeeldingen komen als pad, niet als volledige URL. De koppeling zet er zelf het mediapad voor. Draait je media op een ander domein, vul dan Primair (CDN) in (zie hieronder) — anders wijst elke afbeelding naar een adres dat niet bestaat.

Productafbeeldingen: CDN en fallback

Onder Instellingen staan bij Productafbeeldingen twee adressen:

• Primair (CDN) — waar je productafbeeldingen vandaan komen, bijvoorbeeld https://cdn.voorbeeldshop.nl/media/catalog/product. Leeg = de shop-URL; dan is er geen CDN en ook geen fallback nodig.
• Fallback — gebruikt als een afbeelding niet op je CDN staat. Leeg = de shop-URL met het gewone mediapad (/media/catalog/product). Vul alleen iets in als je bestanden op een ander adres staan.

Wat er gebeurt als je CDN een afbeelding niet heeft:

• Op je website en in het dashboard probeert de browser eerst je CDN. Lukt dat niet, dan laadt hij dezelfde afbeelding één keer van het fallback-adres. Dat geldt voor de zoekfunctie, de chat, popups, de keuzehulp, de configurator, de maatkiezer, reviews en het retourportaal. Laadt de fallback wel, dan meldt de browser dat aan Nexym — alleen het adres van de afbeelding, niets over de bezoeker.
• In mails, feeds, exports en Ask AI kan niets terugvallen. Nexym controleert daarom elke ochtend, en direct nadat je een van de twee adressen opslaat, tien recente afbeeldingen op je CDN. Ontbreken de meeste, dan gebruiken die uitvoer het fallback-adres tot een volgende controle weer slaagt. Een afbeelding die een browser als ontbrekend meldde, komt een week lang van het fallback-adres.

Naast de velden zie je de laatste controle, bijvoorbeeld CDN gecontroleerd 14:10 · 10/10 ok of CDN gecontroleerd 14:10 · 3/10 niet gevonden → fallback in gebruik.

i

Shopify en WooCommerce hebben deze velden niet. Shopify zet afbeeldingen op zijn eigen CDN en WooCommerce geeft het volledige adres in je eigen uploadmap: daar is geen tweede kopie om op terug te vallen.

Goed om te weten

• Magento stuurt tijden altijd in UTC. Nexym rekent ze om; bij Instellingen hoef je geen tijdzone te kiezen. Staat een oudere koppeling nog op een andere tijdzone, dan zie je een waarschuwing met de knop Zet op UTC.
• Magento filtert en pagineert met searchCriteria; de koppeling doet dat voor je, maar bij hele grote catalogi loont een kleinere paginagrootte.
• Prijzen op productniveau komen binnen via de variant die het product vertegenwoordigt. Zie je geen prijzen, controleer dan of varianten aan staan onder What to sync.
• Omschrijving, korte omschrijving, meta title en meta description stuurt Nexym bij het terugschrijven uit het product zelf: wat je in Nexym aanpast (ook een goedgekeurde AI-tekst) gaat naar de standaardwaarde in Magento. Is zo’n veld in Nexym leeg, dan blijft de waarde uit de laatste import staan.
• Vertalingen per store view gaan alleen naar die store view. Ze komen nooit in de standaardwaarde terecht.
• Opnieuw ophalen bij een product haalt het product en meteen ook zijn teksten en beschikbaarheid voor elke aangevinkte store view op. Welke store view je in het productdetail bekijkt (ook Standaard), maakt niet uit. Een volledige sync is daarvoor niet nodig.
• Ook de gewone import houdt de teksten per store view bij. Voor elk product dat de import nieuw binnenhaalde of dat veranderd was, leest Nexym daarna op de achtergrond de teksten en beschikbaarheid van elke aangevinkte store view opnieuw. De import zelf wordt daar niet trager van. Het gaat om hoogstens 500 producten per run. Waren het er meer, dan staat dat in het log van de run en leest de volgende volledige sync de rest.
• Vertaalde opties van een attribuut (bijvoorbeeld de kleur Zwart, Schwarz, Noir) gaan per optie in één keer naar Magento, met de namen van alle store views samen. Magento vervangt bij een optie namelijk altijd alle vertalingen tegelijk. Voor een store view die deze koppeling niet bijwerkt, stuurt Nexym mee wat daar in Magento al staat. Zo raakt geen store view zijn vertaling kwijt. Alleen opties waarvan een vertaling in Nexym veranderde gaan mee, en alleen als Magento ze nog niet zo heeft.
• Nexym stuurt geen vertaalde opties voor attributen met een vaste lijst in Magento, zoals Visibility, Status, Country of Manufacture en Layout. Magento kan daar geen vertaling per store view bij opslaan, en er ook geen optie aan toevoegen. Je ziet dan een melding in Runs & logs, geen fout.
• Een nieuwe optie die je in Nexym toevoegt aan een attribuut uit Magento, maakt Nexym bij de volgende attribuut-export aan in Magento: de Admin-naam, de plek in de lijst en de namen van alle store views in één keer. Magento geeft de optie een eigen nummer (id). Nexym neemt dat nummer over, bij de optie en bij elk product dat hem al had. Die producten gaan bij de volgende product-export met het juiste nummer naar Magento. In Runs & logs staat dan bijvoorbeeld Option ‘Rood’ created in Magento (id 61), met de naam van je koppeling, ook in het log van de run. De run telt het attribuut als verwerkt en vat de opties samen, bijvoorbeeld Processed 1 attribute_definition record(s). Options in Magento: 1 created, 3 updated with store labels. Staat er Processed 0 zonder die zin, dan was er niets te doen.
• Heeft Magento al een optie met dezelfde Admin-naam (hoofdletters tellen niet mee), dan maakt Nexym geen tweede aan, maar neemt hij de bestaande over. Dat gebeurt bijvoorbeeld als een eerdere poging wel aankwam maar het antwoord niet.
• Een optie die ooit uit Magento kwam en daar nu weg is, maakt Nexym niet opnieuw aan. Magento is leidend voor zijn eigen opties: de volgende import haalt hem ook uit Nexym.
• Een nieuw attribuut maak je in Magento zelf aan. Nexym maakt alleen opties aan.
• Het staal (swatch) van een nieuwe optie bij een visueel attribuut zoals Color is leeg. Kies de kleur of afbeelding in Magento, onder Stores → Attributes → Product.
• Voorraad en prijzen stuurt Nexym naar producten die al in Magento bestaan. Kent Nexym het product nog niet van deze koppeling, dan zoekt hij het op SKU op. Een SKU die Magento niet heeft, zie je in Runs & logs als not found: voorraad maakt nooit een product aan.
• Catalogusprijsregels staan niet op het product. De prijs die je shop daarmee toont, haalt de aparte unit Prijzen — eindprijs (catalogusprijsregels) op, standaard elk uur. Zie Magento — eindprijzen.
• Naar Magento gaat alleen de gewone verkoopprijs (de basisprijs). Een actieprijs, een prijs uit een prijslijst, een klantprijs of een staffelprijs gaat niet mee, omdat hij anders de basisprijs zou overschrijven.
• Wat Nexym per product uit Magento haalt, naast naam, prijs en teksten: merk en merknaam, EAN, leverancier, btw-tarief, alle categorieën (en de eerste daarvan als hoofdcategorie; Magento kent geen hoofdcategorie), de afbeeldingen, en bij een enkelvoudig product van een configureerbaar product het bovenliggende product.
• Per product houdt Nexym bij op welke websites het staat en op welke store views het aan staat en vindbaar is (status Enabled en zichtbaarheid Search of Catalog, Search). Dat laatste leest Nexym per store view, bij een volledige sync met store views aangevinkt, en voor een nieuw of veranderd product ook na de gewone import. Nexym leest alleen de aangevinkte store views en die van je websites (Setup → Websites), honderd producten per keer; andere store views van je shop slaat het over. Site search toont op een website alleen producten die op de store view van die website beschikbaar zijn. Let op: in Magento geldt status voor de hele website, zichtbaarheid per store view.
• Ook de inkoopprijs (het Magento-attribuut cost) komt mee, als Cost price. Elk kind van een configureerbaar product houdt zijn eigen inkoopprijs. Nexym rekent er de marge mee uit en toont beide in het productdetail. Maak je de inkoopprijs in Magento leeg, dan verdwijnt hij bij de volgende import ook uit Nexym. De inkoopprijs blijft intern: hij gaat niet naar zoeken, chat of feeds (zie Inkoopprijs en marge).
• Gerelateerde producten, upsells en cross-sells (in Magento: Related Products, Up-Sells and Cross-Sells) komen mee, in de volgorde van Magento. Staat een gekoppeld product nog niet in Nexym, dan wacht de koppeling op de SKU en legt Nexym hem vanzelf zodra dat product binnenkomt. Je ziet ze in het productdetail op het tabblad Related. Bij terugschrijven gaan ze ook mee: zie hieronder.
• Productreviews uit Magento haal je binnen met de module Reviews: zie Reviews-instellingen. Magento Open Source heeft geen REST-koppeling voor reviews, dus Nexym leest ze via GraphQL: alleen goedgekeurde reviews van producten die in de winkel zichtbaar zijn, tot 100 per product.
• Niet uit Magento: bezorgdatum, bezorginstructies, verdieping en lift (bij klanten en orders), een aparte categorietitel en onderste categorietekst, en de fulfilmentstatus van een order. Magento heeft daar geen standaardveld voor.
• Terugschrijven stuurt alleen wat veranderde. Pas je bij een product één attribuut aan, dan krijgt Magento een verzoek met de SKU en dat ene attribuut. Magento laat de rest van het product zoals het is. Een catalogus die je net uit Magento hebt opgehaald, gaat er dus niet in zijn geheel weer heen. Wil je één product compleet terugsturen, open het dan en klik bij de koppeling op Opnieuw versturen. Zie Wat een export verstuurt.
• Bij een product dat je terugschrijft vult Magento zelf de standaardwaarde in van attributen die nog leeg waren (bijvoorbeeld het label van een afbeelding). Dat doet Magento bij elke productwijziging, ook als je het in de Magento-admin opslaat.
• Voorraad en prijzen gaan altijd compleet: het aantal gaat samen met op voorraad, en een prijs gaat als hele prijsregel.
• Bestaat een product niet meer in Magento, dan slaat de export het standaard over en meldt dat in Runs & logs. Bij Producten OUT kun je instellen dat Nexym het opnieuw aanmaakt, met al zijn velden. Voorraad en prijzen maken nooit een product aan.
• Is de database van Magento even bezet (bijvoorbeeld tijdens het herindexeren), dan probeert Nexym het verzoek een paar keer opnieuw voordat het een fout wordt.

Wat Producten OUT naar Magento stuurt

Producten OUT stuurt terug wat de import uit Magento leest en wat Magento bij het product zelf bewaart. Per product gaat alleen wat anders is dan wat Magento al heeft, altijd samen met de SKU (zie Wat een export verstuurt).

Veld in Nexym	In Magento	Hoe
Naam, prijs, online	name, price, status	Zoals ze zijn. Online is Enabled, anders Disabled.
Omschrijving, korte omschrijving, meta title, meta description	dezelfde attributen	Uit het product in Nexym.
Gewicht	weight	Van de variant die het product vertegenwoordigt.
Actieprijs, van en tot	special_price, special_from_date, special_to_date	De algemene actieprijs van het product. Zet je geen begindatum, dan vult Magento zelf de datum van vandaag in.
Inkoopprijs	cost	Terug naar het eigen cost-attribuut van Magento, dat alleen in de admin staat.
Merk	het attribuut van de rij Merk in Map Products IN	Als optie-id: Nexym zoekt de merknaam op in de opties van dat attribuut. Kent het attribuut die naam niet, dan gaat er geen merk mee tot de optie in Magento bestaat (zie Merk, EAN, leverancier en btw).
EAN	het attribuut van de rij EAN in Map Products IN
Leverancier	het attribuut van de rij Leverancier in Map Products IN	Alleen als die rij een attribuut heeft. Bij een keuzelijst als optie-id, opgezocht bij de naam; kent het attribuut die naam niet, dan gaat er geen leverancier mee tot de optie in Magento bestaat.
Btw-tarief	tax_class_id	Via de Value lookup op de rij Btw-tarief in Map Products IN, andersom. Een tarief dat niet in de tabel staat, gaat niet mee.
Categorieën	category_ids	Alle categorieën, als Magento-id. Dat kan alleen als de categorieën uit Magento zijn geïmporteerd (Categorieën IN). Heeft Nexym een categorie die Magento niet kent, dan gaan de categorieën van dat product niet mee.
Websites	website_ids
Gerelateerd, upsells, cross-sells	product_links	Alleen SKU’s die Magento kent. Niet bij een gegroepeerd product.
URL	url_key	Alleen met Send URL key aan.

Zo gaat het met lijsten en lege velden:

• Een leeg veld in Nexym wist niets in Magento. Is bijvoorbeeld de EAN of de actieprijs in Nexym leeg, dan blijft de waarde in Magento staan. Een actieprijs haal je dus weg in Magento zelf.
• Categorieën, websites en gekoppelde producten gaan als hele lijst. Magento vervangt wat er stond. Verandert er één categorie, dan gaat de hele indeling mee. Nexym is dan leidend: een categorie of koppeling die alleen in Magento staat, verdwijnt. Na een import uit Magento kent Nexym ze allemaal. De volgorde van producten binnen een categorie blijft staan.
• Bij een gegroepeerd product stuurt Nexym geen gekoppelde producten: Magento zou dan ook de producten van de groep loskoppelen.
• Niet via het product: voorraad (dat doet Voorraad OUT), afbeeldingen (die gaan niet naar Magento), de attributenset, het producttype en de zichtbaarheid van een bestaand product, en de koppeling tussen een configureerbaar product en zijn varianten. Op het mappingscherm staat bij elk veld dat niet meegaat waarom.

Elke regel zie je terug op Velden van Producten OUT, waar je hem kunt aanpassen of uitzetten.

De URL-sleutel

De URL-sleutel (url_key) is het adres van het product in je shop. Daarom stuurt Nexym hem standaard niet mee. Zet je Send URL key (url_key) aan, dan gaat de URL uit Nexym (alleen de sleutel, zoals fusion-backpack) naar Magento als hij in Nexym is veranderd. Nexym vraagt Magento dan om een permanente doorverwijzing (301) van het oude adres. Links en zoekresultaten blijven werken, maar zoekmachines stappen na verloop van tijd over op het nieuwe adres. Is de URL in Nexym leeg, dan blijft die van Magento staan.

Alleen ingeschakelde producten of producten op voorraad importeren

Bij Koppel → Koppelingen & sync → een koppeling → Wat synchroniseren, met het potlood bij Producten · IN, staan twee vinkjes die los van elkaar werken: Alleen ingeschakelde producten importeren en Alleen producten op voorraad importeren (nabestellen telt als op voorraad). Een product dat nog niet in Nexym staat, komt alleen binnen als het voldoet aan elk vinkje dat aan staat. Minder producten maakt de import sneller en lichter; aanbevolen.

Vinkjes	Nieuw, uitgeschakeld	Nieuw, aan maar uitverkocht
Geen	binnen	binnen
Alleen ingeschakeld	overgeslagen	binnen
Alleen op voorraad	binnen als het op voorraad is (offline in Nexym)	overgeslagen
Beide	overgeslagen	overgeslagen

• Wat al in Nexym staat, wordt altijd bijgewerkt en nooit verwijderd. Zet je een product in Magento uit of raakt het uitverkocht, dan werkt Nexym het gewoon bij: een product dat later uit gaat, gaat in Nexym offline.
• Configureerbare producten tellen op het hoofdproduct. Alle maten en kleuren eronder komen altijd mee, ook een uitverkochte maat, zodat de keuzes compleet zijn.
• Weer op voorraad. Magento past de updated_at van een product niet aan als alleen de voorraad verandert. Staat het voorraadvinkje aan en ook de import van Voorraad, dan ziet Nexym bij de voorraadimport welke artikelen weer op voorraad zijn en nog niet in Nexym staan, en haalt het precies die producten meteen op. In Runs & logs zie je dat als productrun met Back in stock, not in Nexym yet. Zet je een product in Magento weer aan, dan pakt de gewone productimport het vanzelf op.
• Standaard: beide aan voor een nieuwe koppeling. Een koppeling die er al was, houdt haar gedrag (alles importeren). Op Wat synchroniseren zie je dan de aanbeveling met een knop Inschakelen. Stond Alleen verkoopbare producten importeren al aan, dan staan nu beide vinkjes aan.

Het filter werkt op wat de import ophaalt: bij de eerste en een volledige import vraagt Nexym Magento alleen ingeschakelde producten (als dat vinkje aan staat); de voorraad vraagt het per pagina op, alleen voor producten die nog niet in Nexym staan en alleen als het voorraadvinkje aan staat.

Voorraad uit Magento

Haal je voorraad uit Magento, dan is de shop leidend. Nexym rekent niets zelf uit en neemt over wat Magento per SKU meldt: het aantal en of het op voorraad is.

• Import via MSI. Heeft je shop Multi-Source Inventory, dan staat Use bulk stock import (MSI) aan: Nexym vinkt het zelf aan als de shop MSI heeft, bij het opslaan van de koppeling of anders bij de eerste voorraadrun. Een volledige voorraadimport leest dan 250 SKU’s per verzoek. Een gewone voorraadrun en de voorraadrun na een order lezen 100 SKU’s per verzoek. Voorraad van producten die niet in Nexym staan, wordt overgeslagen zonder dat Nexym er iets voor schrijft, en de run zegt het in dezelfde zin als zonder MSI. Heeft een SKU voorraad op meer bronnen, dan telt elke bron als een voorraadregel.
• Zonder MSI. Een volledige voorraadimport leest alle voorraadregels van de shop per 1.000, en koppelt ze aan de producten die al in Nexym staan. Voorraad van producten die niet in Nexym staan, wordt overgeslagen zonder extra verzoek. Bij 31.000 producten in Magento en 10.000 in Nexym zijn dat ongeveer 31 verzoeken. De run zegt dan bijvoorbeeld 10.214 producten in de hub bijgewerkt of ongewijzigd · 20.886 voorraadregels in Magento overgeslagen (niet in de hub); Records is het aantal producten in Nexym. Een gewone voorraadrun leest eerst de lijst van wat uitverkocht is, en daarna per gewijzigd product de voorraad. Een product dat weer op voorraad is, wordt direct daarna gelezen. Zo staat wat wel of niet te bestellen is er het eerst in.
• Alleen ingeschakelde producten. De voorraad van een uitgeschakeld product wordt niet gelezen en niet bijgewerkt. Zet je het weer aan, dan komt de voorraad mee bij de volgende run.
• Lange runs. Duurt een voorraadrun langer dan een half uur, dan gaat hij verder in een nieuwe job, bij het artikel waar hij was. In Runs & logs staat dan Voortgang bewaard; gaat verder bij pagina 3 van 20.
• Na elke orderimport en elke creditnota-import haalt Nexym de voorraad van de artikelen op die orders en creditnota’s meteen opnieuw op. Dat staat in Runs & logs als gewone voorraadrun, met Refreshed after order import of Refreshed after return import. Dit gebeurt alleen als de import van Voorraad aan staat.
• Magento past updated_at van een product niet aan als een order of de voorraad-API de voorraad verandert. Een gewone voorraadrun ziet zulke wijzigingen dus niet altijd. Na elke order- en creditnota-import wordt de voorraad van de artikelen daarop bijgewerkt. Wil je dat elke voorraadrun toch alles leest, zet dan bij Voorraad · IN (het potlood) Elke run alles ophalen (niet alleen wijzigingen) aan: met MSI is dat 250 SKU’s per verzoek, en alleen wat verschilt wordt opgeslagen (zie Koppelingen). Een schema van een uur is dan meestal genoeg.
• Komt je voorraad uit een ERP of WMS, stuur die dan juist naar Magento (Voorraad OUT) en haal hem niet uit Magento op.
• Alleen Opnieuw ophalen van één product leest de voorraad ook mee met het product.

Als Magento “te veel verzoeken” meldt (429)

Sommige shops beperken hoeveel verzoeken er per minuut binnen mogen komen. Dat doet meestal niet Magento zelf, maar wat ervoor staat: Cloudflare, Fastly, een firewall (WAF) of je hostingpartij. Komt Nexym boven die grens, dan antwoordt de shop met 429 Too Many Requests.

Wat Nexym dan doet:

• Het wacht zo lang als de shop vraagt (de Retry-After in het antwoord) en probeert hetzelfde verzoek opnieuw. Zegt de shop niets, dan wacht Nexym steeds iets langer.
• Na een 429 stuurt Nexym een tijd lang langzamer, zodat het onder de grens van je shop blijft. Alle imports en exports van deze koppeling delen dat tempo.
• Moet het langer wachten, dan schuift de run op naar het moment dat de shop noemde. Hij gaat daarna verder bij de pagina waar hij was, niet opnieuw vanaf het begin.
• In Runs & logs → Per record staat per run één regel, bijvoorbeeld Rate limited by Magento 2 (HTTP 429) — retrying at 22:15 (Retry-After 60 s); resumes at page 12 of 40.
• Weigert de shop zes keer op rij alles, dan wacht Nexym op de volgende geplande run. Lukt een import urenlang niet, dan krijg je een melding (Alerts → Import not successful for hours, standaard na 6 uur).

Wat je zelf kunt doen:

1. Bovenaan de koppeling (en in Runs & logs) zie je of hij afkoelt. Verlaag op het tabblad Instellingen, blok Rate limits, Verzoeken / min als je de grens van je shop kent.
2. Laat je hostingpartij of beheerder van Cloudflare/Fastly/de firewall de grens voor de Nexym-integratie verhogen, of het IP-adres van Nexym toestaan. Nexym meldt zich met de user agent nexym/1.0 (+https://nexym.nl). Het IP-adres geeft Nexym je op aanvraag.
3. Heeft je shop MSI, zet dan Use bulk stock import (MSI) aan: dat scheelt de meeste verzoeken.

Klanten herkennen na het afrekenen

De Magento-checkout (Luma en Hyvä) verstuurt het formulier met het e-mailadres van een gast nooit, en Magento 2.4.7+ blokkeert scripts van buiten op de checkoutpagina. Staat Klant herkennen aan, dan herkent Nexym een gast daarom op de bedankpagina: die stuurt het ordernummer, en na de orderimport neemt Nexym het e-mailadres uit de bestelling. Je hoeft in Magento niets te installeren of in te stellen; de Nexym-tag op je shop is genoeg. Wil je het niet, zet dan Herken gasten na het afrekenen uit. Zie Gasten na het afrekenen.