Alles over Asperion
Asperion verbindings- en integratie-instellingen
Instellingen die voor Asperion als geheel gelden, zoals standaardwaarden voor valuta, btw, land en taal, en het bijwerken van bestaande klanten.
Bijgewerkt op 9 november 2026
Deze instellingen gelden voor Asperion 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.
- Of APIcenter bestaande klanten in Asperion bijwerkt, bijvoorbeeld met Update existing customer accounts. Dit geldt voor Klanten naar Asperion sturen en voor de klant van een order in Verkooporders naar Asperion sturen.
Een deel van de instellingen in de lijst is generiek en heeft voor Asperion geen functie.
Wanneer je ze aanpast
- Als je de integratie voor het eerst inricht.
- Als je Asperion-administratie andere standaardwaarden gebruikt, zoals een andere valuta of een ander btw-tarief.
- Als je wel of juist niet wilt dat APIcenter klantgegevens overschrijft die je in Asperion bijhoudt.
Instellingen voor één flow, zoals het type waarmee een order naar Asperion gaat, staan op het tabblad Instellingen van die flow. Het artikel van elke flow legt ze uit, bijvoorbeeld Verkooporders naar Asperion sturen.
De verbindingsgegevens vul je in als je Asperion koppelt. Zie Asperion koppelen aan APIcenter.
Hieronder vind je de verbindings- en integratie-instellingen voor Asperion, elk met een eigen uitleg.
Instellingen
De instellingen die je in het dashboard ziet, met wat elke instelling doet.
API Password
AuthenticationHet 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
AuthenticationDe 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
AuthenticationHet 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
AuthenticationHier 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.
Default currency billing costs
CurrenciesDe 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.
Default currency commission
CurrenciesDe 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.
Default currency payment costs
CurrenciesDe 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.
Default currency prices
CurrenciesDe 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.
Default currency shipping costs
CurrenciesDe 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.
Update billing address of existing customer accounts
Customer SettingsBepaalt of het factuuradres van een bestaand klantaccount mag worden bijgewerkt. Als de instelling uitstaat, wordt dit onderdeel niet aangepast bij bestaande klanten en staat dat in de resultaten van de flow. Standaard staat de instelling aan. Je moet ook Update existing customer accounts aanzetten, anders wordt een bestaande klant helemaal niet bijgewerkt.
Update email address of existing customer accounts
Customer SettingsBepaalt of het e-mailadres van een bestaand klantaccount mag worden bijgewerkt. Als de instelling uitstaat, wordt dit onderdeel niet aangepast bij bestaande klanten en staat dat in de resultaten van de flow. Standaard staat de instelling aan. Je moet ook Update existing customer accounts aanzetten, anders wordt een bestaande klant helemaal niet bijgewerkt.
Update existing customer accounts
Customer SettingsBepaalt of bestaande klantaccounts mogen worden bijgewerkt. Als de instelling uitstaat, wordt een bestaande klant niet bijgewerkt en staat dat in de resultaten van de flow. Alleen nieuwe klanten worden dan aangemaakt. Standaard staat de instelling uit. De instellingen voor losse onderdelen, zoals Update name of existing customer accounts en Update email address of existing customer accounts, werken alleen als deze instelling aanstaat.
Update name of existing customer accounts
Customer SettingsBepaalt of de naam van een bestaand klantaccount mag worden bijgewerkt. Als de instelling uitstaat, wordt dit onderdeel niet aangepast bij bestaande klanten en staat dat in de resultaten van de flow. Standaard staat de instelling aan. Je moet ook Update existing customer accounts aanzetten, anders wordt een bestaande klant helemaal niet bijgewerkt.
Update relation to company of existing contacts
Customer SettingsBepaalt of de relatie van een bestaand contact met een bedrijf mag worden bijgewerkt. Standaard staat de instelling aan.
Update shipping address of existing customer accounts
Customer SettingsBepaalt of het afleveradres van een bestaand klantaccount mag worden bijgewerkt. Als de instelling uitstaat, wordt dit onderdeel niet aangepast bij bestaande klanten en staat dat in de resultaten van de flow. Standaard staat de instelling aan. Je moet ook Update existing customer accounts aanzetten, anders wordt een bestaande klant helemaal niet bijgewerkt.
Default country code
General Integration settingKies 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 settingKies 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 settingKies 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 SettingsDeze instelling heeft geen effect voor Asperion. APIcenter geeft altijd de huidige voorraad (currentStock) van het artikel door.
Default tax rate billing costs
Tax & Tax RatesHet 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 RatesHet 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.
Default tax rate payment costs
Tax & Tax RatesHet 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 RatesHet 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.
Default tax rate shipping costs
Tax & Tax RatesHet standaard btw-percentage voor verzendkosten. Standaard is het percentage 21.