Bol.com koppelen aan AFAS: verkopen en kosten via je App connector in de boekhouding
Bol.com en AFAS spreken geen gemeenschappelijke taal. Bol.com geeft per bestelling een lijst artikelen, een uitbetaling die later komt en retouren in een eigen overzicht. AFAS Profit wil een boeking die via een UpdateConnector binnenkomt, met een debiteur, een grootboekrekening en een BTW-code per regel. Schakel haalt je verkopen op via de Bol.com Retailer API, zet ze om naar het formaat van jouw connectoren en schrijft ze met de token van jouw omgeving weg in AFAS.
Alle Bol.com koppelingenAlle AFAS koppelingen
Wat er over de schakel gaat
Alles wat deze koppeling verplaatst tussen Bol.com en AFAS, en hoe vaak.
-
Verkopen als financiële mutatie
Elke afgehandelde Bol.com-bestelling wordt een boeking in AFAS via de UpdateConnector voor financiële mutaties (FiEntries), met het ordernummer als omschrijving. Jij wijst aan welk dagboek en welke grootboekrekening voor omzet gelden.
-
Klanten als verkooprelatie
Kopers worden als verkooprelatie aangemaakt of herkend, via een UpdateConnector voor verkooprelaties (KnSalesRelationOrg voor organisaties, KnSalesRelationPer voor personen). Bol.com geeft je alleen een doorstuuradres als e-mail, dus een relatie blijft dun: naam, adres en land.
-
Commissie en logistiek apart
Uit de factuurspecificatie van Bol.com komen commissie, verzendlabels en advertentiekosten op hun eigen grootboekrekening terecht. Zo blijft je omzet bruto en zie je in AFAS wat het kanaal werkelijk kost.
-
Retouren als tegenboeking
Een retour waarvoor Bol.com de koper terugbetaalt, komt als tegenboeking in AFAS. Bol.com kent meerdere afhandelresultaten en betaalt er maar een deel van terug; alleen die laatste worden gecrediteerd.
-
Zo praat AFAS: de API in het kort
AFAS werkt met een REST-service per omgeving (productie, test en accept), een token in de Authorization-header en alleen de connectoren die je in de App connector hebt geactiveerd. Er zijn geen webhooks, dus Schakel pollt. Zonder skip en take geeft AFAS de eerste 100 rijen terug, en een fout in een bedrijfsregel komt als HTTP 500 met de tekst in de header X-Profit-Error.
-
Rekenvoorbeeld (fictief)
Voorbeeld: een bestelling van 48,40 euro incl. 21% BTW wordt 40,00 omzet en 8,40 BTW. Bol.com houdt daar bijvoorbeeld 4,84 commissie incl. BTW van in: 4,00 kosten plus 0,84 voorbelasting, geboekt op de kostenrekening. Retourneert de koper, dan volgt een tegenboeking van 48,40. Bedragen zijn verzonnen om het principe te tonen.
Welk Bol.com-veld waar in AFAS terechtkomt
Dit is de indeling die we aanhouden. De exacte veldnamen lees je in AFAS uit de metainfo van jouw eigen omgeving, die kan per inrichting verschillen.
Bestelling
orderId
Omschrijving van de financiële mutatie
Besteldatum
orderPlacedDateTime, in Amsterdamse tijd
Boekdatum, zodat een bestelling om 23:30 in het juiste kwartaal valt
Koper
billingDetails met naam, adres, land en eventueel BTW-nummer
Verkooprelatie (KnSalesRelationOrg of KnSalesRelationPer)
Artikelregel
orderItems met EAN, aantal en prijs incl. BTW
Detailregel op de omzetrekening, BTW-code per regel
Verzonden of geannuleerd
quantityShipped en quantityCancelled
Alleen verzonden stuks komen in de boeking
Commissie
Factuurspecificatie, regel COMMISSION
Kostenrekening voor commissie, apart van omzet
Verzendlabel en advertenties
Regels zoals PLAZA_RETURN_SHIPPING_LABEL en SPONSORED_PRODUCTS_ADS
Eigen kostenrekening per soort
Retour
Retour met afhandelresultaat, bijvoorbeeld RETURN_RECEIVED
Tegenboeking, alleen bij een resultaat waarbij Bol.com terugbetaalt
In de factuurspecificatie van Bol.com staan kosten als positief bedrag en omzet als negatief. Schakel draait dat om, zodat een kostenrekening in AFAS gewoon een kost laat zien.
Wat Bol.com naar AFAS je scheelt
- Geen Bol.com-export meer omzetten naar een importbestand voor AFAS.
- Alleen de connectoren die jij activeert worden gebruikt, de rest van je omgeving blijft dicht.
- Commissie en retourkosten staan los van je omzet, dus je marge klopt.
- Elke fout uit AFAS is terug te lezen in het logboek, met de tekst van AFAS zelf.
Zo zet je het op
- 01
Koppel Bol.com
Je maakt in je Bol.com-verkoopaccount een Client ID en Client Secret voor de Retailer API aan en plakt die in Schakel. De verbinding wordt direct getest.
- 02
Maak een App connector in AFAS
In AFAS maak je een App connector aan, activeer je de UpdateConnectors voor financiële mutaties en verkooprelaties en genereer je een token. Dat token is achteraf niet meer in te zien, dus je geeft het meteen aan Schakel door.
- 03
Wijs dagboek, rekeningen en BTW aan
Je kiest het dagboek, de grootboekrekeningen voor omzet en kosten en de BTW-codes zoals je ze in AFAS gebruikt. De veldnamen van elke connector staan in de metainfo van jouw omgeving, daar sluiten we op aan.
- 04
Controleer de eerste boekingen
Je ziet eerst een paar boekingen ter controle. Daarna lopen nieuwe verkopen door en staan fouten met de AFAS-melding erbij in het logboek.
Wat je nodig hebt
- Een Bol.com-verkoopaccount met Client ID en Client Secret voor de Retailer API
- Een AFAS Profit-omgeving met een App connector en een token
- De UpdateConnectors voor financiële mutaties en verkooprelaties geactiveerd in die App connector
Weet je niet hoe je aan die sleutels komt? Stap voor stap:
Waar het draait
Op app.schakel.app, met je eigen Schakel-account. Geen webshop nodig.
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
Bol.com en AFAS is er één van veel. Kies twee systemen en zie wat er tussen loopt.
Veelgestelde vragen
Is de koppeling Bol.com naar AFAS beschikbaar?
Vraag deze koppeling aan en krijg toegang. Je laat weten dat je Bol.com aan AFAS wilt koppelen, en we zorgen dat je aan de slag kunt. Je hoort binnen 24 uur van ons.
Hoe maak ik het token in AFAS aan?
Je maakt een App connector aan, kiest daarin de UpdateConnectors en maakt op het tabblad voor gebruikerstokens een token aan. AFAS toont dat token maar één keer. Raak je het kwijt, dan maak je een nieuw token en vervang je het oude.
Waarom krijg ik een fout 401 of 400 uit AFAS?
Meestal klopt het omgevingsnummer, het omgevingstype of het token niet, of staat de connector niet aan in de App connector. AFAS geeft in al die gevallen dezelfde soort foutcode, dus controleer die drie punten eerst.
Kan ik eerst in een testomgeving proberen?
Ja. AFAS heeft aparte adressen voor productie, test en accept. Je kunt de koppeling eerst op test laten lopen en daarna het adres en het token van productie invullen.
Waarom komen boekingen niet direct door?
AFAS kent geen webhooks, dus Schakel vraagt periodiek op wat er nieuw is. Schakel boekt een bestelling bovendien pas als alle stuks zijn verzonden of geannuleerd, zodat een geannuleerd stuk nooit een creditboeking nodig heeft. Een boeking volgt dus na verzending.
Wat doet de koppeling met Bol.com België?
Verkopen aan Belgische kopers komen met het land van de koper op de relatie en met de BTW-code die jij daarvoor in AFAS hebt aangewezen. Welke code dat is hangt af van of je OSS gebruikt, dus dat leg je bij het instellen vast.
Kun je Bol.com koppelen aan AFAS?
Ja. Schakel legt de verbinding via de officiële API's van Bol.com 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 Bol.com 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.