Alles over eKonomi

eKonomi verbindings- en integratie-instellingen

Instellingen die voor eKonomi als geheel gelden, zoals standaardwaarden voor valuta, btw, land, taal en eenheid.

Bijgewerkt op 9 november 2026

Deze instellingen gelden voor eKonomi als geheel, niet voor één flow. Ze bevatten standaardwaarden die meerdere flows gebruiken. Je vindt ze in je integratie onder Instellingen.

Waar deze instellingen over gaan

  • Standaardvaluta en btw-tarieven, bijvoorbeeld voor prijzen, verzendkosten, betaalkosten, factuurkosten en commissie.
  • De standaardtaal en landcode.
  • De standaardeenheid voor producten, en of APIcenter eenheden vertaalt met een mappingtabel. Bij het versturen van producten zoekt APIcenter de eenheid in eKonomi op naam. Zie Producten naar eKonomi sturen.
  • Of APIcenter de relatie van bestaande contacten met een bedrijf bijwerkt.

Een deel van de instellingen in de lijst is generiek en heeft voor eKonomi geen functie, bijvoorbeeld de voorraadwaarde. Bij zulke instellingen staat dat in de uitleg.

Wanneer je ze aanpast

  • Als je de integratie voor het eerst inricht.
  • Als je bedrijf in eKonomi andere standaardwaarden gebruikt, zoals een andere valuta of een andere eenheid.

Instellingen voor één flow, zoals het type waarmee een order wordt verstuurd, staan op het tabblad Instellingen van die flow. Het artikel van elke flow legt ze uit, bijvoorbeeld Verkooporders naar eKonomi sturen.

De verbindingsgegevens vul je in als je eKonomi koppelt. Zie eKonomi koppelen aan APIcenter.

Hieronder vind je de verbindings- en integratie-instellingen voor eKonomi, elk met een eigen uitleg.

Instellingen

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

API Password

Authentication

Het wachtwoord waarmee APIcenter zich bij de applicatie aanmeldt, samen met API Username. De waarde is verplicht en wordt verborgen getoond. Pas het aan als je het wachtwoord in de applicatie hebt gewijzigd. Er is geen standaardwaarde.

API Username

Authentication

De gebruikersnaam waarmee APIcenter zich bij de applicatie aanmeldt, samen met API Password. De waarde is verplicht. Pas het aan als je een andere gebruiker wilt gebruiken. Er is geen standaardwaarde.

API url

Authentication

Het adres van de API van de applicatie, zonder https:// en zonder slash aan het einde, bijvoorbeeld mywebshop.com of mywebshop.com/staging. APIcenter gebruikt dit adres voor alle verzoeken aan de applicatie. De waarde is verplicht. Pas het aan als het adres van je omgeving verandert. Er is geen standaardwaarde.

Environment Type

Authentication

Hier staat de omgeving (environment type) van de applicatie waarmee je verbindt. Het veld is verplicht. Bij sommige applicaties vult APIcenter de waarde zelf in nadat je de verbinding hebt gemaakt. Welke waarden mogelijk zijn, hangt af van de applicatie.

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, zoals die op producten, orders en orderregels, 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 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 de relatie van een bestaand contact met een bedrijf mag worden bijgewerkt. Standaard staat de instelling aan.

Default country code

General Integration setting

Kies het land dat APIcenter als standaard gebruikt wanneer een landcode nodig is om de juiste gegevens op te halen, zoals btw-tarieven. Standaard is dit NL.

Default language (local) to use

General Integration setting

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.

Default language to use

General Integration setting

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.

Use stock value

Stock & Warehouse Settings

De koppeling met eKonomi gebruikt deze instelling zelf niet. De standaardmapping van de flow Voorraad ophalen uit eKonomi vult het voorraadsaldo, het beschikbare aantal en het gereserveerde aantal apart. Wil je een ander aantal gebruiken, pas dan de mapping aan.

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.

Default tax rate commission

Tax & Tax Rates

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.

Default tax rate prices

Tax & Tax Rates

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.

Enable use of default UoM

Unit of Measurement

Zet aan om een standaard eenheid te gebruiken. APIcenter vult die dan in als de gegevens geen eenheid hebben. De waarde stel je in bij Value for the default Unit of measurement. Standaard staat de instelling uit.

Force use of default UoM

Unit of Measurement

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.

Bij het versturen van een product zoekt APIcenter de eenheid in eKonomi op naam. Vul dus de naam in zoals die in eKonomi staat, niet een code of id. Bestaat de eenheid niet, dan mislukt het product met de melding dat de eenheid niet is gevonden. De instelling moet beschikbaar zijn, anders mislukt de flow.

Nog vragen?

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

Naar support