AFAS Profit instellen: App connector, token en connectors
De AFAS Profit-koppeling zet debiteuren en verkoopfacturen vanuit i-Reserve door naar een AFAS-administratie via de AFAS REST API. Anders dan Exact Online en Moneybird gebruikt AFAS geen OAuth2 maar een App connector met een token. Daarnaast kan de koppeling betalingen (zoals iDEAL-aanbetalingen) als financiële mutatie boeken en optioneel debiteurwijzigingen uit AFAS terughalen. Zie AFAS facturatie en AFAS klantsynchronisatie voor die onderdelen.
1. Aan de AFAS-kant (eenmalig)
- Maak een App connector aan onder Algemeen → Beheer → App connector en genereer daarin een token.
- Koppel de App connector aan een gebruikersgroep/autorisatierol met de rechten uit stap 4.
- Voeg alle benodigde Get- en UpdateConnectors (stap 2 en 3) toe aan de lijst van de App connector. Let op: een connector die niet expliciet aan de App connector is toegevoegd geeft een
403-fout, ook als de gebruikersgroep hem wel toestaat. - Noteer het omgevingsnummer (lidmaatschapsnummer) en welke omgeving je gebruikt: productie (
https://<omgeving>.rest.afas.online/…) of test (https://<omgeving>.resttest.afas.online/…).
2. Benodigde GetConnectors (lezen: AFAS → i-Reserve)
De standaardnamen hieronder zijn per licentie aanpasbaar; gebruikt jouw AFAS-inrichting andere connectornamen, dan vul je die in bij de koppeling.
| Doel | Standaard connectornaam | Verplicht |
|---|---|---|
| Debiteuren | Profit_Debtor | Ja |
| Facturen | Profit_Debtor_Invoices | Ja |
| Contactpersonen | Profit_Contacts | Ja |
| Grootboekrekeningen | Profit_Accounts | Ja |
| Kostenplaatsen | Profit_CostCentre | Ja |
| BTW-codes | Profit_VAT_Code | Ja |
| Dagboeken | Profit_Journals | Ja |
| Artikelen | Profit_Article | Optioneel |
Elke GetConnector moet in de AFAS-administratie bestaan, aan de App connector zijn toegevoegd en de velden bevatten die de veldmapping verwacht (debiteurnummer, contact- en adresvelden, IBAN/BIC, BTW-code, betaalconditie).
3. Benodigde UpdateConnectors (schrijven: i-Reserve → AFAS)
| Doel | Connector | Verplicht |
|---|---|---|
| Debiteur aanmaken/bijwerken | KnSalesRelationOrg (standaard) of KnOrganisation | Ja |
| Factuur | Afhankelijk van de factuurmodus — zie AFAS facturatie | Ja (één modus) |
| Betalingsboeking | FiEntries | Ja, altijd |
FiEntries is de universele basis: het is de standaard-factuurmodus én wordt altijd gebruikt voor de betalingsboeking, ongeacht de gekozen factuurmodus.
4. Autorisatie (AFAS-gebruikersgroep)
- Debiteuren: inzien, bijwerken (en in een testomgeving ook verwijderen, zodat testdata opgeruimd kan worden).
- Leesrechten op BTW-codes, kostenplaatsen/projectcodes, grootboekrekeningen en dagboeken.
- Financiële mutaties en verkoopfacturen: aanmaken en wijzigen.
- Contactpersonen: lezen en schrijven — debiteur-schrijfacties nesten contact- en adresobjecten.
5. Voorwaarden in de AFAS-administratie
- Een open boekjaar/periode die mutaties en facturen accepteert.
- Een verkoopdagboek (voor factuurdocumenten) en een memoriaal/financieel dagboek (voor mutaties).
- Geldige BTW-codes, grootboekrekeningen en kostenplaatsen — dezelfde codes die je aan de i-Reserve-kant in de mapping gebruikt.
- Minimaal één betaalconditie als die in de debiteurgegevens wordt meegestuurd.
6. Aan de i-Reserve-kant
- Open Beheer → Integraties → AFAS en vul het omgevingsnummer en het token in.
- Controleer de connectornamen; de standaardwaarden komen overeen met de tabellen hierboven.
- Kies de factuurmodus (zie AFAS facturatie).
- Vul de mapping: koppel i-Reserve BTW-tarieven aan AFAS BTW-codes, grootboekrekeningen en kostenplaatsen. De koppeling kan de beschikbare waarden rechtstreeks uit AFAS opzoeken.
- Stel in de Parameters per klantveld de veldmapping en de synchronisatierichting in (zie AFAS klantsynchronisatie).
- Zet de koppeling op actief.
7. Checklist
- ☐ App connector aangemaakt, token gegenereerd en genoteerd.
- ☐ Alle GetConnectors (stap 2) bestaan én zijn aan de App connector toegevoegd.
- ☐ UpdateConnectors (stap 3) toegevoegd: debiteur-connector, factuur-connector,
FiEntries. - ☐ Gebruikersgroep heeft de rechten uit stap 4.
- ☐ Open periode, verkoopdagboek en memoriaal aanwezig; BTW-codes/grootboeken/kostenplaatsen kloppen met de mapping.
- ☐ Omgevingsnummer + juiste omgeving (rest/resttest) ingevuld in i-Reserve.
- ☐ Factuurmodus gekozen; mapping en parameters gevuld; koppeling actief.
- ☐ Testfactuur definitief gemaakt en gecontroleerd in AFAS (debiteur + boeking/factuur + BTW kloppen).
