Alles over AFAS

AFAS: Creditnota's naar AFAS sturen

Stuur creditnota's en retouren uit andere systemen naar AFAS, als directe factuur met voorraadmutatie of als financiële mutatie.

Bijgewerkt op 9 november 2026

Deze flow maakt creditnota's en retouren uit andere applicaties aan in AFAS, bijvoorbeeld terugbetalingen uit je webshop.

Zo werkt het

  • APIcenter zoekt de klant in AFAS op debiteurnummer of e-mailadres. Bestaat de klant niet, dan stopt de flow: deze flow maakt geen klanten aan.
  • Met de instelling Send Refund as kies je hoe de creditering wordt geboekt:
    • Direct Invoice: een directe creditnota. Net als bij een directe factuur wordt er een boeking gemaakt met een bijbehorende voorraadmutatie. De aantallen worden negatief geboekt.
    • Financial Mutation: een memoriaalboeking op het grootboek, met debet en credit omgekeerd ten opzichte van een verkoop.

Wat je eerst nodig hebt

  • De klant bestaat in AFAS, bijvoorbeeld omdat de oorspronkelijke order is verstuurd met Verkooporders naar AFAS sturen.
  • In de App connector staat de UpdateConnector voor de gekozen methode: FbDirectInvoice voor een directe creditnota, FiEntries voor een financiële mutatie. Zie AFAS koppelen aan APIcenter.
  • Stel altijd de administratie in waarin de creditering wordt geboekt, met de instelling voor de standaardadministratie.
  • Voor elke creditnota moet een magazijn bekend zijn, en voor elke regel een eenheid.
  • Voor een financiële mutatie: stel het dagboek in, de grootboekrekeningen, bijvoorbeeld voor omzet, btw, verzending en korting, en de methode voor de financiële mutatie. De methodes worden uitgelegd bij Verkooporders naar AFAS sturen.

Tips

  • Stopt de flow omdat de klant niet is gevonden? Controleer of het debiteurnummer of e-mailadres in de creditering overeenkomt met de klant in AFAS.
  • Gebruik dezelfde boekingsmethode als voor je verkooporders, zodat verkopen en crediteringen op dezelfde plek in je administratie terechtkomen.

Hieronder vind je alle instellingen van deze flow, elk met een eigen uitleg.

Instellingen

De instellingen die je in het dashboard ziet, met wat elke instelling doet.

Bepaalt wat er gebeurt als een veld bij het mappen van de gegevens niet kan worden omgezet. Staat de instelling aan, dan stopt de flow met een foutmelding. Staat de instelling uit, dan gaat de flow verder en wordt dat veld overgeslagen. Standaard staat deze instelling aan.

Met deze instelling bepaal je of de standaardwaarde de grootboekrekening voor korting in de gegevens vervangt. Staat dit aan, dan gebruikt APIcenter altijd de waarde uit Value to use as the default ledger discount account. Staat dit uit, dan wordt die waarde alleen gebruikt als de gegevens zelf geen grootboekrekening voor korting bevatten. Dit werkt alleen als Make use of a default ledger discount account aan staat. Standaard staat dit uit.

Met deze instelling bepaal je of de standaardwaarde de grootboekrekening voor omzet in de gegevens vervangt. Staat dit aan, dan gebruikt APIcenter altijd de waarde uit Value to use as the default ledger revenue account. Staat dit uit, dan wordt die waarde alleen gebruikt als de gegevens zelf geen grootboekrekening voor omzet bevatten. Dit werkt alleen als Make use of a default ledger revenue account aan staat. Standaard staat dit uit.

Met deze instelling bepaal je of de standaardwaarde de grootboekrekening voor verzendkosten in de gegevens vervangt. Staat dit aan, dan gebruikt APIcenter altijd de waarde uit Value to use as the default ledger shipping account. Staat dit uit, dan wordt die waarde alleen gebruikt als de gegevens zelf geen grootboekrekening voor verzendkosten bevatten. Dit werkt alleen als Make use of a default ledger shipping account aan staat. Standaard staat dit uit.

Met deze instelling bepaal je of de standaardwaarde de grootboekrekening voor btw in de gegevens vervangt. Staat dit aan, dan gebruikt APIcenter altijd de waarde uit Value to use as the default ledger tax account. Staat dit uit, dan wordt die waarde alleen gebruikt als de gegevens zelf geen grootboekrekening voor btw bevatten. Dit werkt alleen als Make use of a default ledger tax account aan staat. Standaard staat dit uit.

Make use of a default ledger discount account

Financial Mutation Settings

Zet deze instelling aan om een standaard grootboekrekening voor korting te gebruiken in financiële mutaties. Je hebt dit nodig als je orders of creditnota's als financiële mutatie met het type Extreme naar AFAS stuurt. Standaard staat deze instelling uit.

Make use of a default ledger revenue account

Financial Mutation Settings

Zet deze instelling aan om een standaard grootboekrekening voor omzet te gebruiken in financiële mutaties. Je hebt dit nodig als je orders of creditnota's als financiële mutatie naar AFAS stuurt en de data geen omzetrekening bevat. Standaard staat deze instelling uit.

Make use of a default ledger shipping account

Financial Mutation Settings

Zet deze instelling aan om een standaard grootboekrekening voor verzendkosten te gebruiken in financiële mutaties. Je hebt dit nodig als je orders of creditnota's als financiële mutatie met het type Complex of Extreme naar AFAS stuurt. Standaard staat deze instelling uit.

Make use of a default ledger tax account

Financial Mutation Settings

Zet deze instelling aan om een standaard grootboekrekening voor btw te gebruiken in financiële mutaties. Je hebt dit nodig als je orders of creditnota's als financiële mutatie met het type Recommended, Complex of Extreme naar AFAS stuurt. Standaard staat deze instelling uit.

Bedoeld voor boekhoudpakketten die crediteringen op een vaste debiteurenrekening boeken. De AFAS-flow voor crediteringen gebruikt deze instelling niet, dus aanpassen heeft voor AFAS geen effect. Gebruik voor crediteringen die als financiële mutatie worden geboekt de instellingen voor de omzet-, btw-, verzendkosten- en kortingsrekening. Laat hem op de standaardwaarde (uit) staan.

Bedoeld voor boekhoudpakketten die crediteringen op een vaste omzetrekening boeken. De AFAS-flow voor crediteringen gebruikt deze instelling niet, dus aanpassen heeft voor AFAS geen effect. Gebruik voor crediteringen die als financiële mutatie worden geboekt Use default ledger revenue account mapping table. Laat hem op de standaardwaarde (uit) staan.

Gebruik een mappingtabel om de grootboekrekening voor kortingen te kiezen als een order of creditering als Financial Mutation wordt geboekt. Elke regel koppelt een waarde uit de binnenkomende data aan een grootboekrekeningnummer in AFAS. Een aparte kortingsregel wordt alleen gemaakt bij de financiële mutatiemethode Extreme. Standaard staat dit uit.

Gebruik een mappingtabel om de omzetrekening te kiezen als een order of creditering als Financial Mutation wordt geboekt. Elke regel koppelt een waarde uit de binnenkomende data aan een grootboekrekeningnummer in AFAS. Bij elke financiële mutatiemethode is een omzetrekening nodig. Standaard staat dit uit.

Gebruik een mappingtabel om de grootboekrekening voor verzendkosten te kiezen als een order of creditering als Financial Mutation wordt geboekt. Elke regel koppelt een waarde uit de binnenkomende data aan een grootboekrekeningnummer in AFAS. Verzendkosten krijgen alleen een eigen regel bij de financiële mutatiemethoden Complex en Extreme. Standaard staat dit uit.

Use default ledger tax account mapping table

Financial Mutation Settings

Gebruik een mappingtabel om de btw-rekening te kiezen als een order of creditering als Financial Mutation wordt geboekt. Elke regel koppelt een waarde uit de binnenkomende data aan een grootboekrekeningnummer in AFAS. De btw krijgt een eigen regel bij de financiële mutatiemethoden Recommended, Complex en Extreme. Standaard staat dit uit.

Use financial mutation method

Financial Mutation Settings

Bepaalt hoe een order of creditering in regels wordt opgesplitst als die in AFAS als Financial Mutation (financiële mutatie) wordt geboekt. De tegenkant van de boeking gaat altijd naar de debiteur.

  • Simple (standaard): de hele order op één omzetregel.
  • Recommended: omzet en btw op aparte regels.
  • Complex: een regel per orderregel, elk met een eigen omzetrekening uit de orderdata of business rules, plus aparte regels voor btw en verzendkosten.
  • Extreme: zoals Complex, plus een aparte regel voor kortingen. Gebruik dit alleen samen met een implementatiepartner.

De grootboekrekening voor korting als APIcenter een order of creditnota als financiële mutatie naar AFAS stuurt. Deze wordt gebruikt bij het financiële mutatietype Extreme, dat korting op een aparte regel boekt. Vervang de vooraf ingevulde waarde door een rekeningnummer uit je eigen rekeningschema in AFAS. Vooraf ingevuld: 8100.

De grootboekrekening voor omzet als APIcenter een order of creditnota als financiële mutatie naar AFAS stuurt. Een omzetrekening is verplicht bij elk financieel mutatietype (Simple, Recommended, Complex en Extreme). Vervang de vooraf ingevulde waarde door een rekeningnummer uit je eigen rekeningschema in AFAS. Vooraf ingevuld: 8100.

De grootboekrekening voor verzendkosten als APIcenter een order of creditnota als financiële mutatie naar AFAS stuurt. Deze wordt gebruikt bij de types Complex en Extreme: de orderregel voor verzendkosten (zie Require order line for shipping costs) wordt op deze rekening geboekt. Vervang de vooraf ingevulde waarde door een rekeningnummer uit je eigen rekeningschema in AFAS. Vooraf ingevuld: 1600.

De grootboekrekening voor btw als APIcenter een order of creditnota als financiële mutatie naar AFAS stuurt. Een btw-rekening is verplicht bij de types Recommended, Complex en Extreme, die de btw op een aparte regel boeken. Vervang de vooraf ingevulde waarde door een rekeningnummer uit je eigen rekeningschema in AFAS. Vooraf ingevuld: 1600.

Hiermee bepaal je wat APIcenter doet met een grootboekrekening voor korting die niet in de mappingtabel staat. Bij Waarde negeren blijft het veld leeg, bij Waarde gebruiken blijft de oorspronkelijke waarde staan en bij Standaardwaarde gebruiken gebruikt APIcenter de standaardwaarde uit Value to use as the default ledger discount account. Die standaardwaarde wordt alleen gebruikt als Make use of a default ledger discount account aan staat. Standaard is dit Standaardwaarde gebruiken.

Hiermee bepaal je wat APIcenter doet met een grootboekrekening voor omzet die niet in de mappingtabel staat. Bij Waarde negeren blijft het veld leeg, bij Waarde gebruiken blijft de oorspronkelijke waarde staan en bij Standaardwaarde gebruiken gebruikt APIcenter de standaardwaarde uit Value to use as the default ledger revenue account. Die standaardwaarde wordt alleen gebruikt als Make use of a default ledger revenue account aan staat. Standaard is dit Standaardwaarde gebruiken.

Hiermee bepaal je wat APIcenter doet met een grootboekrekening voor verzendkosten die niet in de mappingtabel staat. Bij Waarde negeren blijft het veld leeg, bij Waarde gebruiken blijft de oorspronkelijke waarde staan en bij Standaardwaarde gebruiken gebruikt APIcenter de standaardwaarde uit Value to use as the default ledger shipping account. Die standaardwaarde wordt alleen gebruikt als Make use of a default ledger shipping account aan staat. Standaard is dit Standaardwaarde gebruiken.

Hiermee bepaal je wat APIcenter doet met een grootboekrekening voor btw die niet in de mappingtabel staat. Bij Waarde negeren blijft het veld leeg, bij Waarde gebruiken blijft de oorspronkelijke waarde staan en bij Standaardwaarde gebruiken gebruikt APIcenter de standaardwaarde uit Value to use as the default ledger tax account. Die standaardwaarde wordt alleen gebruikt als Make use of a default ledger tax account aan staat. Standaard is dit Standaardwaarde gebruiken.

Bepaalt wat er gebeurt als de mappingtabel voor de debiteurenrekening bij crediteringen geen regel heeft voor een waarde: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken houdt de oorspronkelijke waarde aan en Waarde negeren laat het veld leeg. De AFAS-flow voor crediteringen gebruikt deze mapping niet, dus deze instelling heeft voor AFAS geen effect.

Bepaalt wat er gebeurt als de mappingtabel voor de omzetrekening bij crediteringen geen regel heeft voor een waarde: Standaardwaarde gebruiken (standaard) gebruikt de standaardwaarde, Waarde gebruiken houdt de oorspronkelijke waarde aan en Waarde negeren laat het veld leeg. De AFAS-flow voor crediteringen gebruikt deze mapping niet, dus deze instelling heeft voor AFAS geen effect.

Hiermee codeer je de waarden in het adres (de URL) van de doelapplicatie, dus bij flows die gegevens versturen. Dit werkt alleen als Enable URL encoding of data in endpoints aanstaat. Standaard staat dit uit.

Zet dit aan als er speciale tekens in de data staan die in het adres (de URL) van een verzoek terechtkomen, zoals in een SKU of categorienaam. De waarden worden dan URL-gecodeerd, zodat het verzoek niet misgaat. Met Enable URL Encoding of data in the endpoints of the source application en Enable URL Encoding of data in the endpoints of the target application bepaal je voor welke kant dit geldt. Standaard staat dit uit.

Zet dit aan om altijd de standaardwaarde uit Set the administration ID that we use for sending the refunds/creditnotes towards te gebruiken, ook als de data zelf al een administratie bevat. Staat dit uit, dan wordt de standaardwaarde alleen gebruikt als de data geen administratie bevat. Dit werkt alleen als Set the administration aanstaat.

Set the administration

General flow setting

Zet dit aan om een standaard administratie-ID te gebruiken. De waarde komt uit Set the administration ID that we use for sending the refunds/creditnotes towards en wordt ingevuld als de data zelf geen administratie bevat. Standaard staat dit uit.

De code van de AFAS-administratie waar APIcenter orders, inkooporders en creditnota's naartoe stuurt. Vul de code van de administratie in, niet de naam; je kunt elke administratie uit je AFAS-omgeving gebruiken. Voor creditnota's is een administratie altijd verplicht. Bij een multistore-omgeving kun je met een mappingtabel elke store in een eigen administratie laten vallen. Standaard voor AFAS: 01.

Use administration mapping table

General flow setting

Zet dit aan om de administratie om te zetten met een koppeltabel tussen de twee applicaties. Wat er gebeurt met een waarde die niet in de tabel staat, bepaal je met What to do with a value that cannot be mapped using the mapping table. Standaard staat dit uit.

Hier kies je wat er gebeurt met een administratie die niet in de koppeltabel staat. Bij Waarde negeren wordt de waarde leeggelaten, bij Waarde gebruiken blijft de oorspronkelijke waarde staan en bij Standaardwaarde gebruiken wordt de standaardwaarde uit Set the administration ID that we use for sending the refunds/creditnotes towards gebruikt, als je die hebt ingeschakeld. Deze instelling werkt alleen als Use administration mapping table aanstaat. Standaard is Standaardwaarde gebruiken gekozen.

Zet deze instelling aan om een standaarddagboek te gebruiken als de data er geen bevat. Je hebt een dagboek nodig als je orders of creditnota's als financiële mutatie naar AFAS stuurt. De code vul je in bij Value to be used as the default journal id.

Zet dit aan om altijd de standaardwaarde uit Value to be used as the default journal id voor het dagboek te gebruiken. Staat dit uit, dan wordt het standaarddagboek alleen gebruikt als er geen grootboekrekening in de gegevens staat. Deze instelling werkt samen met Enable use of a default journal. Standaard staat deze instelling uit.

De code van het dagboek in AFAS waarop APIcenter financiële mutaties voor orders en creditnota's boekt. Gebruik een dagboekcode die in je AFAS-administratie bestaat. Is er geen dagboek ingevuld, dan gebruikt APIcenter dagboek 40.

Vul hier het e-mailadres in waarnaar APIcenter meldingen stuurt over mislukte activiteiten van deze flow. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan gebruikt APIcenter bij Direct het e-mailadres van je account. Er is geen standaardwaarde.

Vul hier de Slack-webhook van je Slack-werkruimte in om meldingen over mislukte activiteiten ook in Slack te ontvangen. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan stuurt APIcenter geen Slack-melding. Er is geen standaardwaarde.

Notifications frequency

Notifications

Kies hoe vaak APIcenter meldt dat activiteiten van deze flow zijn mislukt. Bij Direct volgt de melding zodra een activiteit mislukt. Bij Elke 30 minuten, Elk uur, Dagelijks en Wekelijks stuurt APIcenter een overzicht van de mislukte activiteiten die nog niet gemeld zijn. Dit werkt alleen als Receive Notifications aan staat. Standaard is dit Direct.

Receive Notifications

Notifications

Zet dit aan om een melding te krijgen als een activiteit van deze flow mislukt. Met Notifications frequency bepaal je hoe vaak je de melding krijgt, en met Notifications Email address en Notifications Slack webhook waar die naartoe gaat. Standaard staat dit uit.

Send Refund as

Order Settings

Bepaalt wat APIcenter in AFAS aanmaakt voor elke binnenkomende order.

  • Order (standaard): een verkooporder. De artikelen moeten in AFAS bestaan en de voorraad wordt bijgewerkt.
  • Quotation: een offerte, zonder voorraadmutatie.
  • Pre Calculation: een voorcalculatie met de verwachte diensten. Bevatten de ordergegevens een projectgroep, dan maakt APIcenter eerst een project aan en koppelt de voorcalculatie daaraan.
  • Direct Invoice: een directe factuur, inclusief voorraadmutatie.
  • Financial Mutation: een boeking in het grootboek, opgesplitst volgens Use financial mutation method. De artikelen hoeven niet in AFAS te bestaan.
  • Forecast: een prognose van de verwachte omzet.

Bij creditnota's kun je alleen kiezen tussen Direct Invoice (standaard, een directe factuur als creditering) en Financial Mutation (een boeking in het grootboek). Bij inkooporders heeft deze instelling geen effect: die worden altijd als inkooporder aangemaakt.

Dit is het maximale aantal pagina's dat de flow in één run ophaalt. Het aantal items per pagina stel je in bij Use page size. De standaardwaarde is 20.

Use page size

Run behaviour

Dit is het aantal items dat de flow per API-verzoek ophaalt. Samen met Maximum number of pages to retrieve bepaalt dit hoeveel items één run kan ophalen. De standaardwaarde is 50.

Zet deze instelling aan om een standaard verzendmethode te gebruiken. De waarde vul je in bij Value to use as the default shipping method id. Met Force the use of the default shipping method bepaal je of deze altijd wordt gebruikt of alleen als de bron geen verzendmethode meegeeft. De standaardwaarde is uit.

Hiermee bepaal je wanneer de standaard verzendmethode wordt gebruikt. Staat de instelling aan, dan wordt altijd de standaard verzendmethode gebruikt. Staat de instelling uit, dan wordt alleen de standaard gebruikt als de gegevens uit de bronapplicatie geen verzendmethode bevatten. Dit werkt alleen als Enable the use of a default shipping method aan staat. De standaardwaarde is uit.

Gebruik een mappingtabel om de verzendmethode uit de andere applicatie te vertalen naar de waarde die AFAS moet krijgen. De standaard data mapping naar AFAS verstuurt geen verzendmethode, dus dit heeft alleen effect als je de verzendmethode in de data mapping gebruikt. Waarden die niet in de tabel staan, worden afgehandeld volgens What to do with a value that cannot be mapped using the mapping table. Standaard staat dit uit.

De verzendmethode die APIcenter gebruikt als de data uit de bron er geen bevat. De standaard data mapping naar AFAS stuurt de verzendmethode zelf niet mee, dus dit heeft alleen effect als je het in de data mapping of in business rules gebruikt.

Hiermee bepaal je wat er gebeurt met een verzendmethode die niet in de toewijzingstabel staat. Bij Waarde gebruiken wordt de oorspronkelijke waarde gebruikt. Bij Waarde negeren wordt de waarde weggelaten. Bij Standaardwaarde gebruiken wordt de standaardwaarde gebruikt. De standaardwaarde van deze instelling is Standaardwaarde gebruiken.

Enable the use of a default warehouse

Stock & Warehouse Settings

Zet deze instelling aan om een standaardmagazijn te gebruiken. Voor orders die naar AFAS gaan, zet APIcenter dit magazijn dan op de order en op orderregels zonder magazijn. Staat dit aan maar is er geen magazijncode ingevuld, dan wordt de order niet verstuurd. Standaard staat deze instelling uit.

Force the usage of the default warehouse

Stock & Warehouse Settings

Zet aan om altijd het standaardmagazijn te gebruiken, ook als de gegevens al een waarde hebben. Staat de instelling uit, dan gebruikt APIcenter de standaardwaarde alleen als de gegevens geen waarde hebben. Deze instelling hoort bij Enable the use of a default warehouse. Standaard staat hij uit.

Use warehouse mapping table

Stock & Warehouse Settings

Zet aan om de waarde van het magazijn om te zetten met een mappingtabel. APIcenter zoekt de waarde uit de gegevens op in de tabel. Wat er gebeurt als een waarde niet in de tabel staat, bepaal je met What to do with a value that cannot be mapped using the mapping table. Standaard staat de instelling uit.

Value for the default warehouse id

Stock & Warehouse Settings

Hier vul je het standaardmagazijn in. APIcenter zet deze waarde in het magazijnveld van het item (de magazijncode), als Enable the use of a default warehouse aan staat en de gegevens geen magazijn hebben. Met Force the usage of the default warehouse gebruikt APIcenter deze waarde ook als er wel een magazijn is.

Hiermee bepaal je wat er gebeurt met een magazijn die niet in de mappingtabel staat. Bij Waarde negeren wordt de waarde weggelaten. Bij Waarde gebruiken blijft de oorspronkelijke waarde staan. Bij Standaardwaarde gebruiken gebruikt APIcenter de standaardwaarde uit Value for the default warehouse id, als Enable the use of a default warehouse aan staat; anders blijft de waarde leeg. Standaard is dit Standaardwaarde gebruiken.

Zet deze instelling aan om een standaard btw-code te gebruiken als de data er geen bevat. De waarde vul je in bij Set the value for the default taxclass when products are created. Deze standaard wordt ook gebruikt voor de extra orderregels voor kosten als die geen eigen btw-code hebben. Standaard staat deze instelling uit.

Staat deze instelling aan, dan gebruikt APIcenter altijd de standaard btw-code, ook als de data een andere bevat. Staat ze uit (standaard), dan wordt de standaard alleen gebruikt als de data geen btw-code bevat. Voor producten die naar AFAS gaan, betekent dit dat elk nieuw product de standaard btw-code krijgt.

Gebruik een mappingtabel om btw-klassen of -tarieven uit de andere applicatie te vertalen naar btw-codes in AFAS, bijvoorbeeld het tarief van 21% uit een webshop naar de bijpassende AFAS-code. Bij orders, crediteringen en inkooporders wordt de code per orderregel ingevuld; bij financiële mutaties is het ook de btw-code van de boeking. Waarden die niet in de tabel staan, worden afgehandeld volgens What to do when the mapping can not be made?. Standaard staat dit uit.

De btw-code die APIcenter gebruikt als de data er geen bevat. Vul de waarde in zonder %-teken. Met een mappingtabel vertaal je de btw-waarden uit de bron naar de btw-codes van AFAS. Bij producten wordt de btw-code alleen ingesteld als het product in AFAS wordt aangemaakt; later wijzig je die in AFAS zelf.

Bepaalt wat er gebeurt als de btw-mappingtabel geen regel heeft voor een waarde uit de binnenkomende data.

  • Standaardwaarde gebruiken: APIcenter gebruikt de standaard btw-code, als die standaardwaarde aan staat; anders blijft het veld leeg.
  • Waarde gebruiken: de oorspronkelijke waarde gaat ongewijzigd naar AFAS.
  • Waarde negeren (de standaardwaarde voor AFAS): het veld blijft leeg.

Voor producten verwacht AFAS altijd een btw-waarde, dus kies daar Standaardwaarde gebruiken en stel een standaard btw-code in.

Nog vragen?

Stel je vraag aan de supportassistent in je dashboard of maak een supportticket aan.

Naar support