De Shopify-integratie van Nexera houdt je productgegevens gesynchroniseerd tussen je Nexera-werkruimte en een of meerdere Shopify-winkels. De integratie ondersteunt bidirectionele sync, wat betekent dat wijzigingen in zowel Nexera als Shopify worden gedetecteerd, vergeleken en verzoend.
De integratie is gebouwd met de officiële Shopify App Bridge v4 en Polaris v12 SDK, en communiceert met Shopify via de GraphQL Admin API. Authenticatie maakt gebruik van OAuth 2.0 met sessietokens voor de ingebedde app-ervaring.
Belangrijkste integratiefuncties:
Multi-winkel ondersteuning: koppel zoveel Shopify-winkels als je abonnement toestaat. Elke winkel heeft een eigen veldmapping en syncconfiguratie.
Delta-sync: alleen gewijzigde producten worden gesynchroniseerd, waardoor synctijden snel blijven, zelfs voor grote catalogi.
Meertalig: koppel Nexera-taalversies (NL, DE, EN) aan Shopify Markets of de Translate & Adapt-app.
Conflictdetectie: wanneer beide kanten hetzelfde productveld hebben gewijzigd, markeert Nexera het conflict voor handmatige beoordeling.
Terugdraaien: elke sync maakt een snapshot. Als er iets misgaat, draai je met één klik terug naar de vorige status.
Realtime voortgang: WebSocket-aangedreven voortgangsregistratie laat precies zien welke producten worden gesynchroniseerd en wat hun status is.
Nexera biedt twee manieren om een Shopify-winkel te koppelen: OAuth (aanbevolen) en Access Token (handmatig). OAuth is de snelste methode en vereist geen technische kennis.
Met OAuth word je doorgestuurd naar Shopify om de NEXERA PXM-app te autoriseren. Dit duurt minder dan twee minuten en vereist geen configuratie aan de Shopify-kant.
Ga naar Kanalen en dan Shopify: Navigeer in het Nexera-dashboard naar Kanalen > Shopify. Deze pagina toont alle gekoppelde Shopify-winkels en hun syncstatus.
Klik op "Connect Store": Er verschijnt een dialoogvenster met twee tabbladen. Selecteer het tabblad "OAuth App".
Voer je winkeldomein in: Typ je myshopify.com-domein (bijv. jouwwinkel.myshopify.com). Dit moet het myshopify.com-subdomein zijn, niet een aangepast domein. Vind je domein in Shopify Admin onder Instellingen > Domeinen.
Klik op "Connect via OAuth": Je wordt doorgestuurd naar Shopify waar je de machtigingen bekijkt die Nexera vraagt. Klik op Installeren om toegang te verlenen.
Klaar!: Na autorisatie stuurt Shopify je terug naar Nexera. Je winkel verschijnt nu in de winkellijst met de statusbadge "Gekoppeld". Je kunt de veldmapping configureren en je eerste sync uitvoeren.
Als je meer controle wilt over de scopes of al een custom app hebt aangemaakt in Shopify, kun je een Admin API Access Token gebruiken.
Maak een custom app in Shopify: Ga in Shopify Admin naar Instellingen > Apps > Develop apps. Maak een nieuwe app en configureer de Admin API scopes: read_products, write_products, read_inventory, write_inventory, read_locales, write_locales, read_publications, write_publications.
Installeer de app en kopieer het token: Klik op "Install app" en kopieer het Admin API access token (begint met shpat_). Dit token wordt slechts eenmaal getoond.
Ga naar Kanalen > Shopify in Nexera: Klik op "Connect Store". Het tabblad "Access Token" is standaard geselecteerd.
Voer je domein en token in: Vul je myshopify.com-domein en het gekopieerde access token in. Klik op "Connect".
De winkel is gekoppeld: Nexera verifieert het token en koppelt je winkel. Je wordt doorgestuurd naar de winkelpagina waar je de sync kunt configureren.
Shopify-machtigingen
Nexera vraagt alleen de minimale machtigingen aan die nodig zijn voor productsynchronisatie. De app heeft geen toegang tot klantgegevens, bestellingen of betalingsinformatie. Alleen product-, voorraad- en vertaalrechten worden aangevraagd.
Welke methode kiezen?
Gebruik OAuth als je snel aan de slag wilt zonder technische stappen in Shopify. Gebruik Access Token als je specifieke scopes wilt instellen of al een bestaande custom app hebt.
Veldmapping bepaalt hoe Nexera-productvelden overeenkomen met Shopify-productvelden tijdens de synchronisatie. Standaardmappings worden automatisch ingesteld wanneer je een winkel koppelt, maar je kunt ze aanpassen aan je specifieke configuratie.
Productnaam: Title · Bidirectioneel
Beschrijving: Body HTML · Bidirectioneel
SKU: Variant SKU · Bidirectioneel
Prijs: Variant Price · Bidirectioneel
Merk: Vendor · Bidirectioneel
Categorie: Product Type · Bidirectioneel
Afbeeldingen: Product Images · Nexera naar Shopify
SEO-titel: SEO Title (metafield) · Nexera naar Shopify
Tags: Product Tags · Nexera naar Shopify
Koppel aangepaste Nexera-attributen aan Shopify-metavelden voor gegevens die niet passen in standaard Shopify-velden. Geef voor elk aangepast attribuut de Shopify-metaveld-namespace en -key op. Nexera verwerkt automatisch de typeconversie tussen Nexera-attribuuttypen en Shopify-metaveldtypen.
Configureer veldmapping vanuit de winkeldetailpagina: klik op je winkelnaam in Instellingen → Winkels en open vervolgens het tabblad Veldmapping.
Taalmapping verbindt de meertalige content van Nexera (NL, DE, EN) met de bijbehorende taalconfiguratie in je Shopify-winkel. Dit zorgt ervoor dat elke taalversie van je productgegevens bij de juiste markt terechtkomt.
Nexera ondersteunt twee Shopify-lokalisatiemethoden:
Shopify Markets: als je Shopify Markets gebruikt voor internationaal verkopen, koppel je elke Nexera-taal aan een markt. De primaire markt ontvangt de content in de hoofdtaal, en aanvullende markten ontvangen vertaalde content.
Translate & Adapt-app: als je Shopify's Translate & Adapt-app gebruikt, koppelt Nexera talen aan de taalcodes van de app. Vertaalde content wordt verzonden via de Shopify Translations API.
Configureer taalmapping vanuit de winkeldetailpagina onder het tabblad Talen. Selecteer voor elke Nexera-taal de bijbehorende Shopify-markt of -taalregio.
Shopify-vertaalondersteuning
Meertalige sync vereist dat Shopify Markets of de Translate & Adapt-app is geinstalleerd en geconfigureerd in je Shopify-winkel. Zonder een van deze kan alleen de content in de hoofdtaal worden gesynchroniseerd.
Tijdens de sync pusht Nexera de hoofdtaal als standaard productcontent en aanvullende talen als vertalingen. Als een product slechts content in één taal heeft, wordt die content gebruikt voor alle markten totdat vertalingen zijn toegevoegd.
Er zijn verschillende manieren om producten te synchroniseren tussen Nexera en Shopify, van handmatige sync met één klik tot volledig geautomatiseerde geplande synchronisatie.
Klik op Nu synchroniseren op de winkeldetailpagina of vanuit de winkellijst. Dit zet direct een sync-taak in de wachtrij die alle producten verwerkt met wijzigingen sinds de laatste sync.
Stel automatische synchronisatie in op een uurlijks, dagelijks of wekelijks schema vanuit de winkelinstellingen. Geplande syncs worden aangestuurd door pg-boss cron-taken en draaien betrouwbaar op de achtergrond.
Selecteer vanaf de Producten-pagina specifieke producten en klik op Synchroniseren naar Shopify in het menu voor bulkacties. Dit synchroniseert alleen de geselecteerde producten, wat handig is om urgente updates te pushen zonder te wachten op een volledige sync.
Delta-sync: de standaardmodus. Alleen producten die zijn gewijzigd sinds de laatste sync worden verwerkt. Dit houdt synctijden kort en minimaliseert API-aanroepen naar Shopify.
Volledige sync: vergelijkt elk product in Nexera met de Shopify-tegenhanger en werkt eventuele verschillen bij. Gebruik dit na grote datawijzigingen of wanneer je vermoedt dat gegevens niet meer overeenkomen tussen de twee platformen.
Tijdens de sync toont een realtime voortgangsbalk de huidige status. De voortgang wordt aangedreven door WebSocket-events, zodat je kunt zien welk product wordt verwerkt, hoeveel er nog resten en of er fouten zijn opgetreden.
Syncprestaties
Delta-sync verwerkt doorgaans 100 tot 500 producten per minuut, afhankelijk van het aantal velden, varianten en afbeeldingen per product. Volledige syncs duren langer omdat elk product wordt vergeleken. Plan voor grote catalogi (5.000+ producten) volledige syncs buiten piekuren.
Producttags die in Nexera zijn aangemaakt, worden tijdens een productsync gesynchroniseerd als native Shopify-producttags. Tags worden verzonden als kommagescheiden waarden, overeenkomstig het ingebouwde tagformaat van Shopify. Dit betekent dat elke tag die je in Nexera toewijst na de volgende sync een volledig doorzoekbare, filterbare Shopify-tag wordt.
Tags worden automatisch meegenomen wanneer een product wordt gesynchroniseerd, je hoeft niets extra te configureren. De sync stuurt de complete set tags voor elk product. Als je een tag toevoegt, verschijnt deze na sync in Shopify. Als je een tag verwijdert en opnieuw synchroniseert, wordt deze ook uit Shopify verwijderd.
Omdat Nexera-tags native Shopify-tags worden, kun je ze gebruiken om geautomatiseerde Shopify-collecties aan te sturen. Een veelgebruikte workflow:
Maak een tag aan in Nexera (bijv. "Zomer 2026").
Wijs de tag toe aan de relevante producten.
Synchroniseer die producten naar Shopify.
Maak in Shopify een geautomatiseerde collectie aan met de voorwaarde "Producttag is gelijk aan Zomer 2026".
Shopify vult de collectie automatisch met overeenkomende producten, geen handmatig beheer nodig. Naarmate je meer producten tagt in Nexera en synchroniseert, werkt de Shopify-collectie zichzelf bij.
Consistente tagnamen
Gebruik consistente hoofdletters en opmaak voor tags (bijv. altijd "Zomer 2026", niet "zomer-2026") zodat de voorwaarden van je geautomatiseerde Shopify-collecties betrouwbaar matchen. Beheer en standaardiseer tags vanuit Instellingen → Tags in Nexera.
Wanneer zowel Nexera als Shopify wijzigingen hebben in hetzelfde productveld sinds de laatste sync, ontstaat er een conflict. Nexera detecteert deze conflicten automatisch en verwerkt ze volgens je ingestelde strategie.
Voordat een product wordt gesynchroniseerd, vergelijkt Nexera de huidige status in beide systemen met de snapshot die tijdens de laatste sync is gemaakt. Als een veld in zowel Nexera als Shopify is gewijzigd sinds die snapshot, wordt het gemarkeerd als conflict.
Niet-conflicterende wijzigingen worden automatisch samengevoegd. Als bijvoorbeeld de beschrijving is gewijzigd in Nexera en de prijs in Shopify, worden beide updates zonder conflict doorgevoerd.
Nexera wint: De waarde van Nexera overschrijft Shopify voor alle conflicterende velden · Teams die Nexera als leidende bron gebruiken
Shopify wint: De waarde van Shopify overschrijft Nexera voor alle conflicterende velden · Winkels waar medewerkers regelmatig bewerken in Shopify Admin
Handmatig: Conflicterende producten worden gemarkeerd voor handmatige beoordeling met een vergelijking naast elkaar · Teams die volledige controle willen over elke wijziging
Stel je standaardstrategie in bij de syncinstellingen van de winkel. Je kunt de strategie ook per sync overschrijven bij het uitvoeren van een handmatige sync. Producten met onopgeloste conflicten (in de modus Handmatig) verschijnen in een Conflicten-wachtrij waar je elk veld naast elkaar kunt bekijken en kunt kiezen welke waarde je wilt behouden.
Elke sync-operatie wordt vastgelegd in de synchronisatiegeschiedenis met gedetailleerde informatie over wat er is gebeurd. Dit geeft je een volledig auditspoor van alle gegevensuitwisseling tussen Nexera en Shopify.
Elke vermelding in de synchronisatiegeschiedenis bevat:
Tijdstempel: wanneer de sync is gestart en voltooid.
Synctype: delta, volledig of selectief.
Verwerkte producten: totaal aantal producten dat is vergeleken en het aantal dat wijzigingen had.
Aangemaakt / Bijgewerkt / Mislukt: uitsplitsing van hoeveel producten nieuw zijn aangemaakt in Shopify, hoeveel zijn bijgewerkt en hoeveel fouten hebben opgeleverd.
Foutdetails: voor producten die zijn mislukt wordt de specifieke Shopify API-fout vastgelegd met de productnaam en SKU.
Duur: totale tijd die de sync in beslag nam.
Elke sync maakt een snapshot van de betrokken Shopify-producten voordat er wijzigingen worden aangebracht. Als een sync onverwachte resultaten oplevert, kun je terugdraaien naar de status van voor de sync.
Om een sync terug te draaien, ga je naar de synchronisatiegeschiedenis, zoek je de betreffende sync-vermelding en klik je op Terugdraaien. Nexera herstelt de Shopify-producten naar hun status van voor die sync. Alleen de producten die door die specifieke sync zijn geraakt, worden teruggezet.
Terugdraaien is definitief
Het terugdraaien van een sync herstelt Shopify-producten naar hun status van voor de sync. Eventuele wijzigingen die na de oorspronkelijke sync in Shopify zijn gemaakt, worden overschreven door het terugdraaien. Deze actie kan niet ongedaan worden gemaakt, dus controleer de lijst met betrokken producten zorgvuldig voordat je bevestigt.
Synchronisatiegeschiedenis wordt voor onbepaalde tijd bewaard. Je kunt filteren op datumbereik, synctype of status (geslaagd, gedeeltelijk, mislukt) om specifieke sync-events te vinden. De synchronisatiegeschiedenis is toegankelijk vanuit de winkeldetailpagina onder het tabblad Geschiedenis.
