e-Boekhouden API key Shopify: zo verbind je de koppeling

De app staat in Shopify, de testorder is betaald, en e-Boekhouden.nl blijft leeg. Meestal ontbreekt dan geen “sync-knop”, maar de e-Boekhouden API key Shopify. Zonder dat token mag de koppeling niets in je administratie schrijven. Met een sleutel die je te vroeg opslaat — vóór je hem kopieert — zie je hem niet meer terug.

Dit artikel volgt de stappen uit de e-Boekhouden.nl API Key-documentatie: inloggen, Beheer, Koppelingen, API, token aanmaken, plakken in de Shopify-app en Connecten. Daarna pas Paid/Fulfilled en grootboek.

We schreven eerder wat de Shopify e-Boekhouden koppeling synct. Dat is het resultaat. Hier gaat het om de sleutel die de brug opent.

Waarom de API-key de eerste echte stap is

Shopify is je verkoopkanaal. e-Boekhouden.nl is je administratie. Die twee praten niet vanzelf. De e-Boekhouden.nl Koppeling van Online Origins stuurt orders, klanten en financiële mutaties realtime door — listing 5.0 uit 1 review, $13.95/maand, 14 dagen trial, facturatie in USD. De listing is Nederlands; de UI van e-Boekhouden.nl ook.

Die realtime sync (FAQ: zodra een order of refund in Shopify wijzigt, gaat die onmiddellijk mee, zonder extra wachttijd of sync-toeslag) start pas als de app mag schrijven. Daarvoor heb je een API-key uit dezelfde administratie als waar je wilt boeken. Een sleutel van een testadministratie of van je accountant-omgeving op de verkeerde tenant levert geen mutaties in de administratie die je bedoelt.

Shopify zelf levert geen e-Boekhouden-token. Je maakt hem in e-Boekhouden.nl en plakt hem in de app.

Wat merchants nu proberen

1. Installeren en wachten

De Shopify-app installeren is niet hetzelfde als verbinden. Zonder Connecten blijft de mutatielijst leeg, ook als de order Paid is.

2. Een verlopen token of de verkeerde API-pagina

e-Boekhouden.nl heeft een API-scherm onder Koppelingen. De docs wijzen naar e-Boekhouden API en daarna Verder — niet naar een willekeurige andere integratie. Tokens hebben een geldigheid; de docs zeggen dat je de einddatum zo ver mogelijk in de toekomst zet, en dat e-Boekhouden doorgaans maximaal één jaar toestaat.

3. Opslaan vóór kopiëren

De docs zijn stellig: sla het API-token niet op voordat je het kopieert. Na opslaan is het token om veiligheidsredenen niet meer zichtbaar. Dan maak je een nieuwe aan. Geen screenshot van een weggevallen veld “terugzoeken”.

Geen van die routes geeft je een groene verbinding plus een testmutatie.

Hoe je de API-key aanmaakt en verbindt

De stappen hieronder komen uit de API Key-docs. De schermnamen zijn Nederlands, zoals in e-Boekhouden.nl.

In e-Boekhouden.nl

1. Log in op je account op e-boekhouden.nl.

2. Klik bovenin op Beheer.

3. Kies in de linkerzijbalk Koppelingen.

4. Open API. Klik Verder bij e-Boekhouden API.

5. Klik Toevoegen om een nieuwe API-key te maken.

6. Geef de koppeling een herkenbare naam, bijvoorbeeld Shopify Koppeling. Zet de einddatum zo ver mogelijk; houd rekening met maximaal ongeveer één jaar.

7. Kopieer het token eerst. Sla daarna pas op. Na opslaan is het token weg.

Gebruik één token per administratie die je wilt vullen. Mix geen POS-testomgeving met de live-administratie.

In de Shopify-app

Installeer de e-Boekhouden.nl Koppeling als dat nog niet is gebeurd. Plak de gekopieerde API-key in de daarvoor bestemde velden in de app en klik Connecten. Dat is de letterlijke knop uit de docs: zonder die klik is er geen integratie.

Kom je er niet uit, of wil je de inrichting uitbesteden: de FAQ noemt een installatieservice (eenmalige vergoeding, terugbetaald als je de koppeling uiteindelijk niet gebruikt). Contact: info@onlineorigins.nl.

Daarna: trigger en grootboek — niet eerder

Pas ná een geslaagde Connecten configureer je wanneer orders doorgezet worden en waar ze landen. Dat staat in Koppeling configureren:

• Betaalde orders (Paid) of Verwerkte orders (Fulfilled)

• Type boeking: mutatie (dagboekmutatie, geen Shopify-PDF-factuur)

• Grootboek: debiteuren (balans, bijvoorbeeld 1300), omzet (winst-en-verlies, géén balans), verzendkosten, betaalkosten

• Optioneel: standaard debiteurcode, aparte POS-debiteur

• OSS: alleen als je die regeling gebruikt, met een BTW-grootboek per EU-land

Een API-key zonder mapping geeft een verbinding zonder bruikbare boekingen. Mapping zonder key geeft niets.

Wat de sleutel wél opent — en wat niet

Met een werkende key synct de app orders, klanten en financiële mutaties. Listing: btw-tarieven, verzendkosten en kortingsregels per order; overzicht van geslaagde en mislukte verwerking; categorie Historical data import (historie zelf is support-only).

Wat de koppeling niet doet, ook niet met een verse API-key (zelfde FAQ):

• Geen PDF-factuur uit Shopify naar e-Boekhouden.nl

• Geen artikelen of voorraad

• Geen geannuleerde orders — gebruik restitutie; die wordt een negatieve mutatie

De key is een schrijfrecht, geen extra productcatalogus.

Als mutaties vastlopen ná verbinden: kijk eerst naar Mutaties Foutmeldingen. Ontbrekend factuuradres (handmatige order of POS) los je op met een standaard debiteurcode, niet met een nieuwe API-key.

Praktijk: van lege administratie naar eerste mutatie

Je hebt een Nederlandse Shopify-shop, boekhouding in e-Boekhouden.nl, nog geen koppeling. Je maakt token Shopify Koppeling, kopieert, slaat op, plakt, Connecten. Daarna Paid, grootboek 1300 / 8000 / 4590 / 4550.

Plaats een testorder met factuuradres. In de app zie je of de mutatie groen is. In e-Boekhouden.nl landt een dagboekmutatie, geen nagetypte verkoopfactuur. Werkt dat, dan pas live traffic — niet andersom.

Handmatige sync-knoppen (docs: handmatig synchroniseren) halen uitsluitend mutaties vanaf installatie. Die knoppen repareren geen ontbrekende API-key.

Wat je nodig hebt om te starten

1. Een e-Boekhouden.nl-administratie waarin je mag beheren (Beheer → Koppelingen).

2. De e-Boekhouden.nl Koppeling in Shopify ($13.95/maand, 14 dagen trial).

3. Een nieuwe API-key via de API Key-stappen: kopiëren vóór opslaan, daarna Connecten.

4. Trigger Paid of Fulfilled plus grootboekmapping.

5. Een testorder met volledig factuuradres. Geen PDF, geen artikelen, geen annulering-zonder-refund verwachten.

Hulp bij inrichten: info@onlineorigins.nl.

Tot slot

Een e-Boekhouden API key Shopify is geen bijzaak achter de grootboekstappen. Het is de voorwaarde. Maak het token in e-Boekhouden.nl onder Beheer → Koppelingen → API → e-Boekhouden API, kopieer het vóór je opslaat, plak het in de app en klik Connecten. Daarna volgt de mapping; daarvóór synct er niets.

Zet de sleutel via de e-Boekhouden.nl Koppeling en laat de volgende betaalde testorder als mutatie in je administratie landen — niet in een spreadsheet.