Om het koppelen van je webshop zo eenvoudig mogelijk te maken, beschikt Douano over een interactieve installatiewizard. Dit scherm loodst je stap-voor-stap door het volledige configuratieproces heen.

Hieronder lichten we elke stap van deze wizard in detail toe, zodat je precies weet welke gegevens je bij de hand moet hebben om de Shopify-plug-in succesvol te activeren.

Shopify - Fase 1: de configuratie in Shopify

☝️ Hoewel de configuratiewizard in Douano je door de meeste instellingen heen helpt, bevindt de allereerste fase van de installatie zich volledig binnen je Shopify-omgeving.

Omdat de wizard geen directe toegang heeft tot de beveiligde achterkant van jouw Shopify-shop, zul je de onderstaande stappen eerst handmatig in orde moeten maken. Zodra je deze gegevens hebt verzameld, kun je de installatiewizard in Douano starten om de koppeling definitief te maken.

💡 Om Douano veilig te laten communiceren met je Shopify-webshop, maken we gebruik van een op maat gemaakte app binnen jouw eigen Shopify-omgeving. Volg onderstaande stappen om de koppeling succesvol op te zetten.

Stap 1: De app aanmaken in Shopify

Log in op het Shopify-beheercentrum (Admin) van je webshop.
Navigeer in het linkermenu naar Instellingen → Apps.
Klik bovenaan op Apps ontwikkelen (Develop apps)
In het onderstaand scherm App development die zich automatisch opent kies je voor 'allow legacy custom app development'
Kies in het volgend scherm Apps voor 'allow custom app development'
Vervolgens kies je voor 'create a legacy custom app'
Voer een duidelijke naam in, bijvoorbeeld: Douano Integratie.
Klik op App aanmaken om te bevestigen.

Stap 2: API-rechten (scopes) configureren

Nu de app bestaat, moeten we Douano de juiste lees- en schrijfrechten geven.

Klik binnen de zojuist aangemaakte app op Admin API-bevoegdheden instellen (Configure Admin API scopes).

Vink de onderstaande scopes aan. Ze zijn hieronder per categorie ingedeeld:

Producten & Voorraad: write_products, read_products, write_inventory, read_inventory
Bestellingen: read_orders, write_orders (Optioneel: vink ook read_all_orders aan als je historische bestellingen ouder dan 60 dagen wilt ophalen)
Klanten: write_customers, read_customers
Locaties & Markten: read_locations, read_locales, read_markets, read_translations
Kortingen & Bestanden: read_discounts, read_files
Verzending & Afhandeling (Fulfillment):
- write_assigned_fulfillment_orders,
- read_assigned_fulfillment_orders,
- write_merchant_managed_fulfillment_orders, read_merchant_managed_fulfillment_orders, write_custom_fulfillment_services, read_custom_fulfillment_services, write_shipping, read_shipping

Klik uiteindelijk rechtsboven of rechtsonder op Opslaan.

Stap 3: De app installeren en het toegangstoken kopiëren

Klik bovenaan de pagina op de groene knop App installeren en bevestig de installatie.
Je wordt nu automatisch doorgestuurd naar het tabblad API-referenties (API credentials).
Onder het gedeelte Admin API-toegangstoken zie je een token staan dat begint met shpat_.

☝️ Dit toegangstoken wordt slechts één keer getoond! Kopieer het token direct en sla het veilig op (bijvoorbeeld in een wachtwoordmanager). Als je de pagina verlaat of ververst, kun je het token nooit meer inzien. Je zult de app dan moeten verwijderen en opnieuw moeten aanmaken.

Stap 4: Het Webhook-geheim kopiëren

Blijf op hetzelfde tabblad (API-referenties).
Scroll naar beneden tot je bij het onderdeel Webhookabonnementen (Webhook subscriptions) komt.
Zoek naar de tekst: "Uw webhooks worden ondertekend met" (Your webhooks will be signed with).
Kopieer de code (het handtekeningsgeheim) die hierachter staat.

☝️ Werk je met een partneraccount in Shopify zal je het webhookgeheim terugvinden onder notifications in je linkermenu. Deze zal hier weergeven worden onder "Your webhooks will be signed with".

Overzicht: welke gegevens heb je nodig om de configuratie te kunnen starten in Douano?

Gegeven	Waar te vinden?	Voorbeeld
Winkel-URL	De adresbalk van je browser wanneer je ingelogd bent in de Shopify-admin.	`jouwwinkel.myshopify.com`
Admin API-toegangstoken	Op het tabblad API-referenties (zie Stap 3). Begint altijd met `shpat_`.	`shpat_abcdef123456...`
Webhook-geheim	Op het tabblad API-referenties onder het kopje 'Webhookabonnementen' (zie Stap 4).	`1a2b3c4d5e6f...`

Shopify - Fase 2: Configuratiewizard in Douano

Zodra de Shopify-plugin geactiveerd is, kan de koppeling in het Douano-portaal worden geactiveerd en getest. Volg hiervoor de onderstaande stappen.

Navigeer in Douano naar: Instellingen ➔ Shopify ➔ Configuratiewizard

Stap 1: De verbinding

💡 In deze stap van de wizard leg je de daadwerkelijke verbinding tussen jouw Douano-omgeving en je Shopify-webshop. Hiermee open je de digitale snelweg die ervoor zorgt dat beide systemen veilig informatie met elkaar kunnen uitwisselen en synchroniseren.

Gegevens invullen: Vul de gegevens in die je in de eerdere stappen hebt verzameld (zoals beschreven in het overzicht hierboven).
Verbinding testen: Klik op de knop 'Verbinding testen'.
Webhooks registreren: Zodra de test is geslaagd, verschijnt er direct naast de testknop een nieuwe knop: 'Webhooks registreren'. Klik hierop.
Succesmelding: Na de registratie verschijnt er onderaan het scherm een groen kader met een succesmelding. Je verbinding is nu actief.

Stap 2: Algemeen

💡 In deze stap bepaal je de spelregels van de synchronisatie: wat moet er wel gebeuren, wat juist niet, en op welke manier? Door deze parameters nauwkeurig in te stellen, sluit de koppeling aan op jouw bedrijfsvoering.

Hieronder lichten we de keuzemogelijkheden in detail toe, zodat je de koppeling optimaal kunt configureren.

Prijsklasse voor prijzen: Hierbij duid je de prijsklasse aan van welke de prijzen opgenomen zullen worden in Shopify voor de gekoppelde producten. Je kan er ook voor opteren om een afzonderlijke prijsklasse in Douano aan te maken voor de producten in je Shopifywinkel.
Relatie voor Shopify-klant: Je selecteert hier één vooraf aangemaakte, algemene relatie (bijvoorbeeld een relatie die je "Consumenten Shopify" of "Webshop Verkopen" hebt genoemd). Alle anonieme of B2C-bestellingen van wie het e-mailadres niet gekend is in Douano worden dan administratief op deze fictieve klant geboekt.
Product voor verzending: Dit is het artikel waarop de verzendkosten worden geboekt. Je selecteer hier een in Douano aangemaakte service/dienst, bijvoorbeeld "verzendkosten". Het geld dat de klant betaalt voor de verzending via Shopify wordt dan aan dit product gekoppeld.
Bestellingen automatisch bevestigen: deze laat je aangevinkt staan tenzij je elke ontvangen webshoporder eerst handmatig wilt controleren en bevestigen.
Voorraad synchroniseren naar Shopify: deze optie zorgt ervoor dat de voorraadmutaties in beide systemen worden verwerkt. Deze laat je altijd aan staan.
Verzendingen gebeuren in eigen beheer (synchroniseren naar Shopify): Deze optie zorgt ervoor dat wanneer een verzending in Douano wordt afgerond, deze automatisch als Shopify fulfillment (= voltooid) naar de webshop wordt gestuurd en weergegeven in je orderoverzicht van Shopify.
Producten synchroniseren naar Shopify: De geselecteerde producten die ook in Shopify worden gebruikt zullen daar aangepast worden wanneer je een wijziging in Douano doorvoert.
Bestellingen synchroniseren vanaf datum: Als je webshop al twee jaar live staat, staan er honderden of duizenden oude bestellingen in Shopify. Als je de plug-in activeert zonder datum, zou Douano proberen om al die historische bestellingen alsnog te importeren. Dat trekt je huidige voorraad volledig scheef en gooit je accijnsaangiftes van het verleden in de war. Door de datum van vandaag in te geven negeert Douano alles uit het verleden en start de synchronisatie pas vanaf dit specifieke moment.
Productcategorie: hier duid je aan welke productcategorie wordt doorgestuurd naar Shopify. Alle producten met deze categorie zullen bijgevolg doorgestuurd worden.

Stap 3: Producten

💡 In dit onderdeel link je jouw Douano-producten, -locaties definitief aan de producten in Shopify. Dit zorgt ervoor dat beide systemen perfect synchroon lopen wanneer er een bestelling wordt geplaatst of wanneer de voorraad verandert.

Van Douano naar Shopify: De producten die je vanuit Douano naar je webshop wilt doorzetten, heb je in de basis al gemarkeerd door de juiste productcategorie aan hen toe te kennen.
Bestaande producten matchen: Als er in Shopify al producten staan die (vrijwel) hetzelfde zijn als in Douano, vraagt het systeem hier om een bevestiging. Je geeft hier expliciet aan welk Shopify-product aan welk Douano-product gekoppeld mag worden. Hiermee voorkom je dat er per ongeluk dubbele producten in je webshop ontstaan.

Hoe werkt het mappen?

Categorie-filtering: Producten waaraan je in Douano een categorie zoals bijvoorbeeld 'Shopify webshop' hebt toegekend, verschijnen hier automatisch in de lijst.
De exacte connectie leggen: Om de plug-in te laten weten welk Shopify-product bij welk Douano-product hoort, dien je ze hier eenmalig aan elkaar te linken.
Herken ongekoppelde producten: Producten die nog gekoppeld moeten worden, herken je eenvoudig aan het blauwe link-icoon aan het einde van de regel. Klik hierop om de juiste connectie te maken.

☝️ Om ervoor te zorgen dat bestellingen van de juiste plek worden afgeschreven, volgt Douano de locatiestructuur die je in Shopify hebt ingesteld. Dankzij de succesvolle verbinding in de vorige stappen, worden jouw Shopify-locaties hier automatisch ingeladen.

Hoe koppel je de locaties?

Bekijk het overzicht: Onderin dit scherm verschijnen de actieve voorraadlocaties die rechtstreeks uit jouw Shopify-admin zijn opgehaald.
Koppeling starten: Klik op het link-icoon (schakel) achter de Shopify-locatie die je wilt gaan gebruiken.
Douano-locatie toewijzen: Selecteer in het pop-up- of dropdownmenu de gewenste tegenhanger (de voorraadlocatie) binnen Douano.

Eenmaal klaar kies je voor afronden rechts onderaan.

Stap 4: Compleet

💡 Nu de configuratie is afgerond, is het tijd om de reeds bestaande gegevens tussen beide systemen uit te wisselen. Hiermee zet je de basislijnen direct live.

Producten en voorraad naar Shopify sturen

Met deze actie voltooi je de definitieve setup en zorg je ervoor dat beide portalen synchroon lopen:

Producten overzetten: De geselecteerde producten uit Douano worden direct aangemaakt in jouw Shopify-webshop.
Voorraad standbepaling: De actuele voorraadaantallen vanuit Douano worden direct doorgezet en correct weergegeven op je Shopify-dashboard.

Shopify - Configuratiewizard