WooCommerce koppelen aan AFAS: bestellingen en klanten in je Profit-omgeving, zonder dubbele relaties
Een WooCommerce-webshop en AFAS Profit komen uit twee werelden. De webshop draait op je eigen WordPress en rekent in bedragen per regel; AFAS is een ERP dat alleen binnenlaat wat via een geactiveerde UpdateConnector komt. De lastigste stap is niet de boeking, maar de klant: AFAS kan in een REST-aanroep niet tegelijk toevoegen en wijzigen, dus eerst moet blijken of de relatie al bestaat. Schakel leest je bestellingen met leesrechten uit WooCommerce en doet die controle voordat er iets in AFAS komt.
Alle WooCommerce koppelingenAlle AFAS koppelingen
Wat er over de schakel gaat
Alles wat deze koppeling verplaatst tussen WooCommerce en AFAS, en hoe vaak.
-
Eerst zoeken, dan toevoegen of wijzigen
In REST voegt een POST toe en wijzigt een PUT; allebei in een aanroep kan niet. Schakel zoekt de klant daarom eerst op en kiest dan de juiste methode, zodat een terugkerende klant geen tweede verkooprelatie krijgt.
-
Bestellingen als financiële mutatie
Een bestelling wordt een financiële mutatie (FiEntries) met een regel per product, op het dagboek en de omzetrekening die jij kiest. Verzending en kortingscodes krijgen een eigen regel.
-
Bedragen zonder BTW als uitgangspunt
WooCommerce toont prijzen incl. of excl. BTW, afhankelijk van hoe je winkel is ingesteld, maar de bedragen per regel zijn in de API altijd excl. belasting. Schakel rekent daarvan uit, en voegt de belasting per tarief toe, zodat het niet uitmaakt hoe je shop de prijs laat zien.
-
Accenten en speciale tekens
AFAS wil speciale tekens als UTF-8 ontvangen; anders verschijnt er een vraagteken in plaats van een é of ü. Namen als Zoë of Müller blijven dus heel in je verkooprelaties.
-
Zo praat AFAS: grenzen om te kennen
Een aanroep verloopt na ongeveer vijftien minuten, een filter in de URL mag maximaal 2048 tekens zijn en er geldt een fair-usebeleid: wie elke minuut dezelfde 15 MB aan data ophaalt, krijgt een verzoek om contact op te nemen. Fouten in bedrijfsregels komen als HTTP 500, met de tekst Base64-gecodeerd in de header X-Profit-Error.
-
Rekenvoorbeeld (fictief)
Voorbeeld: twee producten van 20,00 excl., 6,00 excl. verzending en een kortingscode van 4,00 excl., 21% over alles, geeft 42,00 excl. en 8,82 BTW, dus 50,82 incl. In AFAS staan drie regels en de relatie bestond al, dus er volgt een PUT in plaats van een POST. Bedragen zijn verzonnen.
Welk WooCommerce-veld waar in AFAS terechtkomt
De veldnamen in AFAS lees je uit de metainfo van je eigen omgeving; dit is de indeling.
Bestelnummer
number van de order
Omschrijving van de financiële mutatie
Klant
billing met naam, bedrijf, adres en land
Verkooprelatie (organisatie of persoon), eerst gezocht, dan POST of PUT
billing.email
E-mailadres van de relatie en sleutel om te herkennen
Productregel
line_items met subtotaal excl. belasting
Regel op de omzetrekening
Verzending
shipping_lines
Eigen regel op de verzendrekening
Kortingscode
coupon_lines
Negatieve regel op de kortingsrekening
Belasting
tax_lines per tarief
BTW-code per regel
Refund
refunds met bedrag
Tegenboeking in dezelfde connector
Wat WooCommerce naar AFAS je scheelt
- Een terugkerende klant krijgt in AFAS geen tweede relatie.
- Het maakt niet uit of je webshop prijzen incl. of excl. BTW toont.
- Namen met accenten komen goed aan.
- Schakel kan niets veranderen in je WooCommerce-winkel.
Zo zet je het op
- 01
Koppel WooCommerce met leesrechten
Je vult het adres van je webshop in en klikt op Goedkeuren in je eigen WordPress. Schakel krijgt leestoegang tot bestellingen, klanten en producten. Zet permalinks niet op Standaard, anders vinden we de REST API niet.
- 02
Maak de App connector in AFAS
Je maakt een App connector, activeert de UpdateConnectors voor financiële mutaties en verkooprelaties en maakt een token. Je geeft dat token, het omgevingsnummer en het omgevingstype (productie, test of accept) aan Schakel.
- 03
Kies dagboek, rekeningen en BTW
Je kiest het dagboek, de omzetrekeningen en de BTW-codes. De veldnamen van elke connector staan in de metainfo van jouw omgeving.
- 04
Controleer en laat lopen
Je ziet de eerste mutaties in het overzicht voordat ze doorgaan. Daarna lopen nieuwe bestellingen mee en staat de AFAS-melding in het logboek.
Wat je nodig hebt
- Een WooCommerce-webshop op https, bereikbaar vanaf internet, met permalinks niet op Standaard
- Een AFAS Profit-omgeving met een App connector, een token en de benodigde UpdateConnectors geactiveerd
Weet je niet hoe je aan die sleutels komt? Stap voor stap:
Waar het draait
In je Shopify-admin, als app. Je logt in via Shopify, geen apart account.
Daarna vanaf €10 per maand bij jaarlijks betalen, of je blijft op gratis. Bekijk de pakketten
Start gratisHeb je precies deze koppeling nodig, of iets wat die nog niet doet? Vertel wat je nodig hebt en je hoort binnen 24 uur van ons.
Gerelateerde koppelingen
Koppel een ander paar
WooCommerce en AFAS is er één van veel. Kies twee systemen en zie wat er tussen loopt.
Veelgestelde vragen
Is de koppeling WooCommerce naar AFAS beschikbaar?
Vraag deze koppeling aan en krijg toegang. Je laat weten dat je WooCommerce aan AFAS wilt koppelen, en we zorgen dat je aan de slag kunt. Je hoort binnen 24 uur van ons.
Waarom krijg ik geen verbinding met mijn webshop?
Meestal staan de permalinks nog op Standaard. Zet ze in WordPress onder Instellingen en Permalinks op bijvoorbeeld Berichtnaam. Controleer ook dat de webshop op https draait en vanaf internet bereikbaar is.
Waarom geeft AFAS een foutcode 500?
Dat is een melding uit een bedrijfsregel in AFAS, bijvoorbeeld een ontbrekende rekening. De tekst staat Base64-gecodeerd in de header X-Profit-Error; Schakel decodeert die en zet de melding in het logboek.
Kan ik eerst op een testomgeving oefenen?
Ja, AFAS kent een testomgeving en een accept-omgeving met eigen adressen. Zet daar de koppeling op, controleer de eerste mutaties en vervang daarna het adres en het token door die van productie.
Wat doet Schakel als een klant in WooCommerce is verwijderd?
De boeking gebruikt de gegevens die op de bestelling zelf staan, dus een verwijderd klantaccount maakt niets stuk. Een gast zonder account werkt hetzelfde: naam en adres komen uit de bestelling.
Wordt voorraad of productinformatie ook bijgewerkt?
Nee. Schakel schrijft niets naar WooCommerce en stuurt alleen orders, klanten en refunds naar AFAS. Voorraad en producten beheer je in je webshop of in AFAS zelf.
Kun je WooCommerce koppelen aan AFAS?
Ja. Schakel legt de verbinding via de officiële API's van WooCommerce en AFAS, dus je installeert niets op je eigen server en er gaat niets buiten die twee partijen om.
Met welk btw-tarief komen mijn verkopen in AFAS terecht?
Het tarief wordt per regel gezet: 21%, 9% of 0%. Verkopen naar België en andere EU-landen krijgen het tarief van het land van bestemming, klaar voor je OSS-aangifte.
Mis je iets dat je nodig hebt?
Vertel wat WooCommerce en AFAS voor jou zouden moeten doen. Staat het er nog niet bij, dan is dat meestal omdat niemand het gevraagd heeft. Je hoort binnen 24 uur van ons.