Alles over Twinfield
Twinfield verbindings- en integratie-instellingen
Instellingen die voor Twinfield als geheel gelden, zoals de administratiecode, de cluster en de standaardvaluta.
Bijgewerkt op 9 november 2026
Deze instellingen gelden voor Twinfield als geheel, niet voor één flow. Ze bevatten gegevens van de verbinding en standaardwaarden die meerdere flows gebruiken. Je vindt ze in je integratie onder Instellingen.
Waar deze instellingen over gaan
- De administratie waarmee je koppelt: Company ID. Twinfield vraagt deze code bij elk verzoek.
- De cluster van Twinfield: Cluster. APIcenter vult deze zelf in als hij leeg is.
- De standaardvaluta, bijvoorbeeld Default currency prices. Bij het boeken als financiële mutatie is deze valuta verplicht.
- De standaardtaal en landcode, en de btw-tarieven voor prijzen, verzendkosten, betaalkosten, factuurkosten en commissie. Flows gebruiken ze als de gegevens geen waarde bevatten.
Twinfield heeft in APIcenter alleen flows om gegevens naar Twinfield te sturen. Instellingen voor het ophalen van gegevens, zoals de voorraadwaarde, hebben daarom voor Twinfield geen functie.
Wanneer je ze aanpast
- Als je de integratie voor het eerst inricht.
- Als je naar een andere administratie van Twinfield wilt koppelen: pas dan Company ID aan.
- Als je administratie een andere valuta gebruikt dan de standaardvaluta.
Instellingen voor één flow, zoals de manier waarop een order wordt verstuurd, staan op het tabblad Instellingen van die flow. Het artikel van elke flow legt ze uit, bijvoorbeeld Verkooporders naar Twinfield sturen.
De verbindingsgegevens vul je in als je Twinfield koppelt. Zie Twinfield koppelen aan APIcenter.
Hieronder vind je de verbindings- en integratie-instellingen voor Twinfield, 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.
Cluster
AuthenticationHier staat de cluster van Twinfield waarop je administratie draait. Laat het veld leeg: APIcenter vraagt de cluster dan zelf op bij Twinfield en vult de naam in. Is het veld al gevuld, dan vraagt APIcenter het niet nog een keer op.
Company ID
AuthenticationVul hier de code van je Twinfield-administratie in. Twinfield vraagt deze code bij elk verzoek, samen met het toegangstoken. APIcenter gebruikt dezelfde code ook voor de administratie bij het aanmaken van facturen en transacties en bij het ophalen van een klant. Deze instelling is verplicht.
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
CurrenciesBij Financial Mutation is deze valuta verplicht: APIcenter zet haar altijd als valuta in de kop van de boeking, ook als de order zelf een valuta heeft. Bij Invoice gebruikt APIcenter deze instelling niet voor de factuur.
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 existing customer accounts
Customer SettingsDeze instelling heeft geen effect voor Twinfield. De flow Klanten naar Twinfield sturen werkt een bestaande klant niet bij. APIcenter voegt alleen adressen toe die op de bestaande klant ontbreken.
Update name of existing contacts
Customer SettingsDeze instelling heeft geen effect voor Twinfield. APIcenter werkt de naam van een bestaande klant of contactpersoon in Twinfield niet bij.
Update name of existing customer accounts
Customer SettingsDeze instelling heeft geen effect voor Twinfield. APIcenter werkt de naam van een bestaande klant in Twinfield niet bij.
Update relation to company of existing contacts
Customer SettingsDeze instelling heeft geen effect voor Twinfield. APIcenter werkt de relatie van een bestaande klant in Twinfield niet bij.
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 SettingsHiermee kies je welke voorraadwaarde APIcenter gebruikt als voorraad van een product. Je kiest uit Actual, Economic, Stock minus reservations en Available. Standaard is dit Available.
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.