AFAS verbindings- en integratie-instellingen

Het wachtwoord voor de AFAS-koppeling. Je hebt dit alleen nodig als je AFAS-applicatie OAuth als authenticatiemethode gebruikt. De standaardkoppeling met een toegangstoken uit de App connector gebruikt dit veld niet.

De gebruikersnaam voor de AFAS-koppeling. Je hebt deze alleen nodig als je AFAS-applicatie OAuth als authenticatiemethode gebruikt. De standaardkoppeling met een toegangstoken uit de App connector gebruikt dit veld niet.

Een webadres voor de API-verbinding, ingevuld zonder https:// en zonder / aan het eind. De standaard AFAS-koppeling gebruikt dit veld niet: APIcenter maakt het adres op basis van je omgevingsnummer en omgevingstype. Voor AFAS hoef je dit meestal niet in te vullen.

Het toegangstoken (classic token) van de App connector in AFAS Profit, de hoofdautorisatie voor de koppeling. Je maakt het aan in AFAS Profit onder Algemeen > Beheer > App connector: open de APIcenter App connector, ga naar het tabblad Gebruikerstokens en maak een token aan voor een gebruiker die lid is van de gebruikersgroep van de App connector. Die gebruiker moet via de connectoren gegevens kunnen ophalen en versturen. Kopieer alleen het datagedeelte van het token, zonder XML-tags: van <token><version>1</version><data>...</data></token> plak je alleen de waarde tussen <data> en </data>. AFAS toont het token maar één keer, dus kopieer het meteen. AFAS geeft classic tokens een einddatum: maak een nieuw token aan en vul het hier in als je token verloopt.

Bepaalt hoe APIcenter inlogt bij AFAS. Kies OAuth als je App connector OAuth gebruikt, zoals beschreven bij AFAS koppelen aan APIcenter. Token (standaard) is voor een App connector met een classic token. AFAS stopt met classic tokens: vanaf 31 augustus 2027 moet elke koppeling OAuth gebruiken.

Het nummer van je AFAS Online-omgeving: het deelnemersnummer, alleen de cijfers. De naam van je omgeving begint met een letter, bijvoorbeeld O12345AA: het omgevingsnummer is dan 12345. APIcenter gebruikt het nummer samen met het omgevingstype om je AFAS-omgeving te bereiken.

Het type AFAS-omgeving waarmee APIcenter verbinding maakt. Kies het type van de omgeving waarin je de App connector hebt aangemaakt. Je ziet het aan de eerste letter van de omgevingsnaam:

• rest: productieomgeving, de naam begint met een O (standaard)
• resttest: testomgeving, de naam begint met een T
• restaccept: acceptatieomgeving, de naam begint met een A

De valuta die APIcenter gebruikt voor factuurkosten als de gegevens zelf geen valuta bevatten. Staat er wel een valuta in de gegevens, dan blijft die gelijk. Standaard is dit EUR.

De valuta die APIcenter gebruikt voor commissie als de gegevens zelf geen valuta bevatten. Staat er wel een valuta in de gegevens, dan blijft die gelijk. Standaard is dit EUR.

De valuta die APIcenter gebruikt voor betaalkosten als de gegevens zelf geen valuta bevatten. Staat er wel een valuta in de gegevens, dan blijft die gelijk. Standaard is dit EUR.

De valuta die APIcenter gebruikt voor prijzen (op producten, orderregels, prijslijsten enzovoort) als de data geen valuta bevat. Voor AFAS is dit ook de valuta die de productprijzen krijgen die APIcenter uit AFAS ophaalt. Standaard: EUR.

De valuta die APIcenter gebruikt voor verzendkosten als de gegevens zelf geen valuta bevatten. Staat er wel een valuta in de gegevens, dan blijft die gelijk. Standaard is dit EUR.

Bepaalt of APIcenter een debiteur die al als organisatie in AFAS staat bijwerkt als er een klant of order voor binnenkomt. Staat dit aan, dan worden de gegevens van de organisatie, zoals adres en contactgegevens, overschreven met de binnenkomende data. Staat dit uit, dan blijft de bestaande organisatie zoals hij is en wordt een order er gewoon op geboekt. Hetzelfde geldt voor bestaande leveranciers bij inkooporders. Voor AFAS staat dit standaard aan.

Bepaalt of APIcenter een debiteur die al als persoon in AFAS staat, zoals een particuliere klant, bijwerkt als er een klant of order voor binnenkomt. Staat dit uit, dan blijft de bestaande persoon zoals hij is en worden ook geen contactpersoongegevens meegestuurd voor bestaande debiteuren. Hetzelfde geldt voor bestaande leveranciers bij inkooporders. Standaard staat dit uit.

Bepaalt of de naam van een bestaande organisatie in AFAS wordt overschreven met de naam uit de binnenkomende data. Geldt alleen als Update existing companies aan staat. Zet dit uit als je bedrijfsnamen in AFAS beheert en niet wilt dat de schrijfwijze uit een webshop die vervangt. Standaard staat dit aan.

Bepaalt of de naam van een bestaande persoon in AFAS wordt overschreven met de naam uit de binnenkomende data. Geldt alleen als Update existing contacts aan staat. Standaard staat dit uit, zodat de namen die je in AFAS beheert behouden blijven.

Bedoeld om de koppeling tussen een bestaand contact en het bijbehorende bedrijf bij te werken in de ontvangende applicatie. AFAS gebruikt deze instelling niet, dus aanpassen heeft voor AFAS geen effect. Laat hem op de standaardwaarde (aan) staan.

Het land dat APIcenter gebruikt als er een land nodig is om de juiste gegevens op te halen, zoals btw-tarieven. Voor AFAS gebruikt APIcenter dit land om de btw-tarieven op te halen bij het ophalen van producten en prijslijsten. Opties: BE, DE, ES, FR, NL en UK. Standaard: NL.

Kies de standaardtaal van de koppeling als taalcode met land, zoals nl_NL. Applicaties gebruiken deze waarde wanneer ze een taal met landvariant nodig hebben. Standaard is dit nl_NL.

Kies de standaardtaal voor deze koppeling. APIcenter gebruikt deze taal om landnamen in de gegevens te herkennen en weer te geven, en als taal wanneer de gegevens zelf geen taal bevatten. Standaard is dit NL.

Bepaalt hoe APIcenter het AFAS-artikel bij elke orderregel vindt. De productcode van de orderregel wordt vergeleken met:

• SKU (standaard): de Itemcode van het artikel in AFAS.
• Barcode: de barcode van het artikel.
• Alternative ID: het alternatieve artikel-ID in AFAS.

AFAS heeft voor orders, facturen en offertes bestaande artikelen nodig, dus een orderregel zonder bijpassend artikel geeft een foutmelding.

Gebruik dit als je in AFAS voorraad in meerdere magazijnen hebt en met voorraad per locatie wilt werken. Staat dit aan, dan telt APIcenter de voorraad per magazijn en artikel bij elkaar op voor de magazijnen in de mappingtabel voor magazijnen (Use warehouse mapping table). Ondersteunt de ontvangende applicatie geen meerdere locaties, dan wordt de voorraad bij elkaar opgeteld. Standaard staat dit uit.

Bedoeld om te kiezen welk voorraadgetal wordt gebruikt: Actual (de fysieke voorraad), Economic (voorraad min reserveringen plus verwachte leveringen), Stock minus reservations of Available (standaard). De AFAS-flows gebruiken deze instelling op dit moment niet, dus aanpassen heeft geen effect. Laat hem op de standaardwaarde staan.

Het btw-percentage dat APIcenter gebruikt voor factuurkosten, als de gegevens een bedrag hebben maar geen btw-percentage. APIcenter rekent het bedrag met en zonder btw dan met dit percentage uit. Standaard is het percentage 21.

Het btw-percentage dat APIcenter gebruikt voor commissie, als de gegevens een bedrag hebben maar geen btw-percentage. APIcenter rekent het bedrag met en zonder btw dan met dit percentage uit. Standaard is het percentage 21.

Het btw-percentage dat APIcenter gebruikt voor betaalkosten, als de gegevens een bedrag hebben maar geen btw-percentage. APIcenter rekent het bedrag met en zonder btw dan met dit percentage uit. Standaard is het percentage 21.

Het btw-percentage dat APIcenter gebruikt voor prijzen, zoals die van producten, orderregels en prijslijsten, als de gegevens een bedrag hebben maar geen btw-percentage. APIcenter rekent het bedrag met en zonder btw dan met dit percentage uit. Dit percentage is ook de terugvaloptie voor de andere standaard btw-percentages. Standaard is het percentage 21.

Het standaard btw-percentage voor verzendkosten. Standaard is het percentage 21.

Zet deze instelling aan om een standaardeenheid te gebruiken als er geen eenheid is meegestuurd. Een eenheid is verplicht voor nieuwe artikelen en creditregels in AFAS, dus dit is handig als je bron geen eenheden meestuurt. De eenheid vul je in bij Value for the default Unit of measurement. Standaard staat deze instelling uit.

Zet aan om altijd de standaard eenheid 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 use of default UoM. Standaard staat hij uit.

Zet aan om de eenheid uit de gegevens om te zetten met een mappingtabel. APIcenter zoekt de waarde op in de tabel. Wat er gebeurt als een eenheid 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.

Hier vul je de standaard eenheid in, bijvoorbeeld de code van een stuk. APIcenter zet deze waarde in het eenheidsveld, als Enable use of default UoM aan staat en de gegevens geen eenheid hebben. Met Force use of default UoM gebruikt APIcenter deze waarde ook als er wel een eenheid is. Standaard is de waarde STK.