De Shopify-sleutel die je winkel verhuist

Wat die sleutel is, en waarom je hem zelf maakt

Shopify geeft geen wachtwoord uit waarmee een andere dienst je winkel kan lezen. In plaats daarvan maak je een kleine app in je eigen winkel, vink je precies aan wat hij mag lezen, en geeft Shopify die app een token. Dat token plak je in Omniterra, en wij lezen je catalogus erdoorheen.

Twee dingen volgen daaruit, allebei in jouw voordeel:

• Jij bepaalt wat wij zien. We krijgen alleen de rechten die jij aanvinkt. We vragen leesrechten, niets dat in je Shopify-winkel schrijft.
• Je kunt het op elk moment afsnijden. Verwijder de app in Shopify en het token werkt onmiddellijk niet meer, zonder bericht aan wie dan ook.

Je Shopify-winkel draait de hele tijd door. Niets van wat wij doen verandert daar iets aan.

Stap 1 — de app-instellingen openen

Ga in je Shopify-beheer naar Instellingen → Apps en verkoopkanalen → Apps ontwikkelen.

Zie je een knop Ontwikkeling van aangepaste apps toestaan, druk die dan in. Shopify vraagt dit één keer per winkel, en alleen de eigenaar kan het doen.

Stap 2 — de app aanmaken

Druk op Een app maken, geef hem een naam die je later herkent — «Omniterra migratie» volstaat — en bevestig.

De app is op dit moment leeg. Hij kan nog niets lezen.

Stap 3 — de rechten aanvinken

Open het tabblad Configuratie en daarna Admin API-integratie → Bewerken.

Vink leesrechten aan voor alles wat je mee wilt nemen:

Druk op Opslaan.

Omniterra laat je deze exacte lijst ook op het importscherm zien, klaar om te kopiëren, en zegt welke er nog ontbreken als de verbinding onvolledig terugkomt.

Stap 4 — de app installeren en het token kopiëren

Ga naar het tabblad API-referenties en druk op App installeren.

Shopify toont nu het Admin API-toegangstoken, een tekenreeks die met `shpat_` begint. Kopieer die.

Lees dit stuk goed: Shopify toont dat token één keer. Sluit je de pagina zonder het te kopiëren, dan zie je het niet terug — je moet de app verwijderen en opnieuw installeren om een nieuw token te krijgen. Er gaat geen werk verloren, maar het zijn vervelende vijf minuten.

Stap 5 — het in Omniterra plakken

Ga in je Omniterra-beheer naar Producten → Import / Export, kies Shopify, typ het adres van je winkel (`mijn-winkel.myshopify.com`) en plak het token.

Druk op Verbinden. Wij lezen je catalogus en laten zien wat we gevonden hebben voordat er iets wordt weggeschreven: hoeveel producten, klanten, bestellingen, pagina’s. Er beweegt niets tot jij het zegt.

Als er staat dat er rechten ontbreken

Deze verrast mensen, dus goed om vooraf te weten: Shopify meldt de rechten die bij de installatie zijn verleend, niet wat er nu in de configuratie staat. Vink je na het installeren meer vakjes aan, dan houdt de app de oude, smallere toegang.

De oplossing is opnieuw installeren: Configuratie → Admin API-integratie → Bewerken, vink aan wat ontbreekt, Opslaan, en dan API-referenties → App opnieuw installeren. Het token blijft hetzelfde.

Als je de app in het Dev Dashboard hebt gebouwd

Sommige winkels hebben een app die op `dev.shopify.com` is gemaakt in plaats van in het winkelbeheer. Het idee is hetzelfde, met twee extra punten:

1. Bewerk `access_scopes` in de app-configuratie en druk op Opslaan.
2. Druk op Uitbrengen. Zonder release blijft je wijziging een niet-gepubliceerde versie en krijgt de winkel die nooit te zien.
3. Installeer de app opnieuw op de winkel, zodat de nieuwe rechten echt worden verleend.

Wat er meekomt, en wat niet kan

Producten met hun varianten, afbeeldingen, collecties, klanten, bestellingen, kortingen, pagina’s, blogberichten, menu’s, omleidingen en bestanden komen allemaal mee.

Sommige dingen kunnen niet mee, en dat zeggen we vooraf in plaats van achteraf: cadeaukaartcodes (Shopify geeft die nooit vrij), opgeslagen kaartgegevens (die horen bij je betaalprovider, niet bij je winkel) en geïnstalleerde apps van derden, met de gegevens die ze in zichzelf bewaren.

Als er minder producten binnenkomen dan verwacht

Drie dingen verklaren bijna elk geval, en geen daarvan betekent dat de import is mislukt.

Concepten en gearchiveerde producten blijven standaard achter. Shopify houdt ze buiten de actieve catalogus, en wij ook. Wil je ze wel, publiceer ze dan in Shopify vóór de import, of haal ze op en zet ze hier daarna op concept.

Producten zonder prijs of zonder variant worden overgeslagen, want zo kunnen ze niet verkocht worden. Ze staan in het eindrapport, bij naam, zodat je precies ziet welke en waarom.

Een recht dat je na het installeren aanvinkt geldt pas als je de app opnieuw installeert; dat is dezelfde valkuil als hierboven. Installeer opnieuw en druk dan in het importscherm op Opnieuw controleren — we lezen je catalogus nog eens, zonder iets aan te raken dat al is overgekomen.

Je mag de import gerust twee keer draaien. Producten worden gekoppeld op hun Shopify-handle, dus een tweede ronde werkt bij wat er al staat in plaats van dubbelingen te maken.

Hoe lang het duurt

Een catalogus van een paar honderd producten is meestal in een paar minuten klaar. Grote winkels lopen in porties en je mag de pagina verlaten — de import gaat door en je ziet de voortgang als je terugkomt.