Alles over CloudSuite
CloudSuite verbindings- en integratie-instellingen
Instellingen die voor CloudSuite als geheel gelden, zoals de omgeving, standaardwaarden voor valuta, btw, land en taal en de eenheid.
Bijgewerkt op 9 november 2026
Deze instellingen gelden voor CloudSuite als geheel, niet voor één flow. Ze bevatten standaardwaarden die de flow gebruikt. Je vindt ze in je integratie onder Instellingen.
Waar deze instellingen over gaan
- De omgeving waarmee je verbindt: productie of test.
- Standaardvaluta en btw-tarieven.
- De standaardtaal en landcode.
- De standaard eenheid (UOM) en de mapping van eenheden.
- De voorraadwaarde en voorraadlocaties.
CloudSuite heeft alleen een flow om producten te versturen. Een deel van de instellingen in de lijst is generiek en heeft voor CloudSuite geen functie, bijvoorbeeld de instellingen voor het bijwerken van klanten en contactpersonen: CloudSuite heeft geen klantflows.
Wanneer je ze aanpast
- Als je de integratie voor het eerst inricht.
- Als je van de testomgeving naar de productieomgeving van CloudSuite gaat, of andersom.
- Als je producten in CloudSuite een andere standaard eenheid of een ander standaard btw-tarief moeten krijgen.
Instellingen voor de flow zelf, zoals welke bestaande producten worden bijgewerkt, staan op het tabblad Instellingen van de flow. Zie Producten naar CloudSuite sturen.
De verbindingsgegevens vul je in als je CloudSuite koppelt. Zie CloudSuite koppelen aan APIcenter.
Hieronder vind je de verbindings- en integratie-instellingen voor CloudSuite, 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.
Authentication Method
AuthenticationHiermee kies je de omgeving van CloudSuite waarmee APIcenter verbindt: Production voor de productieomgeving of Test voor de testomgeving. CloudSuite heeft voor beide een eigen adres en een eigen inlogadres, en de API-gegevens gelden voor één van de twee. Kies de omgeving die bij je gegevens past.
Server Host
AuthenticationHet adres (host) van de server waarmee APIcenter verbinding maakt. Gebruik de naam of het IP-adres van de server, samen met Server Port en Server Protocol waar die beschikbaar zijn. De waarde is verplicht. Er is geen standaardwaarde.
Server Password
AuthenticationHet wachtwoord van de gebruiker op de server, samen met Server Username. De waarde is verplicht en wordt verborgen getoond. Pas het aan als het wachtwoord op de server is gewijzigd. Er is geen standaardwaarde.
Server Port
AuthenticationHet poortnummer van de server waarmee APIcenter verbinding maakt. Wijzig het alleen als je server een andere poort gebruikt dan de standaardpoort van het protocol. De waarde is verplicht. De standaardwaarde is 21.
Server Protocol
AuthenticationHet protocol waarmee APIcenter verbinding maakt met de server: FTP of SFTP. Kies SFTP als je server een beveiligde verbinding vereist. De waarde is verplicht. De standaardkeuze is FTP.
Server Username
AuthenticationDe gebruikersnaam waarmee APIcenter inlogt op de server, samen met Server Password. De waarde is verplicht. Pas het aan als je met een andere gebruiker wilt inloggen. Er is geen standaardwaarde.
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 address of billing address of existing customer accounts
Customer SettingsBepaalt of het adres zelf van 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. De instelling werkt alleen als Update billing address of existing customer accounts aanstaat.
Update address of shipping address of existing customer accounts
Customer SettingsBepaalt of het adres zelf van 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. De instelling werkt alleen als Update shipping address of existing customer accounts aanstaat.
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 contacts
Customer SettingsBepaalt of het e-mailadres van een bestaand contact mag worden bijgewerkt. Als de instelling uitstaat, wordt dit onderdeel niet aangepast bij bestaande contacten en staat dat in de resultaten van de flow. Standaard staat de instelling uit. Je moet ook Update existing contacts aanzetten, anders wordt een bestaand contact 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 contacts
Customer SettingsBepaalt of bestaande contacten mogen worden bijgewerkt. Als de instelling uitstaat, wordt een bestaand contact niet bijgewerkt en staat dat in de resultaten van de flow. Alleen nieuwe contacten worden dan aangemaakt. Standaard staat de instelling uit. De instellingen voor losse onderdelen, zoals Update name of existing contacts en Update email address of existing contacts, werken alleen als deze instelling aanstaat.
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 billing address of existing customer accounts
Customer SettingsBepaalt of de naam van 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. De instelling werkt alleen als Update billing address of existing customer accounts aanstaat.
Update name of existing contacts
Customer SettingsBepaalt of de naam van een bestaand contact mag worden bijgewerkt. Als de instelling uitstaat, wordt dit onderdeel niet aangepast bij bestaande contacten en staat dat in de resultaten van de flow. Standaard staat de instelling uit. Je moet ook Update existing contacts aanzetten, anders wordt een bestaand contact helemaal niet bijgewerkt.
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 name of shipping address of existing customer accounts
Customer SettingsBepaalt of de naam van 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. De instelling werkt alleen als Update shipping address of existing customer accounts aanstaat.
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 locations
Stock & Warehouse SettingsZet aan als je met voorraad per magazijn of voorraadlocatie werkt. APIcenter telt de voorraad dan per magazijncode bij elkaar op. Staat de instelling uit, dan doet APIcenter dit niet. Standaard staat de instelling uit.
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.
Enable use of default UoM
Unit of MeasurementZet 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 MeasurementZet 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.
Use a mapping table to map the value of the Unit of measurement
Unit of MeasurementZet 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.
Value for the default Unit of measurement
Unit of MeasurementHier 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.