Alles over Voyado

Voyado verbindings- en integratie-instellingen

Instellingen die voor Voyado als geheel gelden, zoals de standaardvaluta, het standaardland, de standaardtaal en het bijwerken van bestaande klanten.

Bijgewerkt op 9 november 2026

Deze instellingen gelden voor Voyado 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. Flows gebruiken ze als de gegevens geen waarde bevatten. Bij verkooporders gebruikt APIcenter de standaardvaluta voor prijzen als de order geen valuta heeft. Daarmee rekent APIcenter ook de wisselkoers naar de groepsvaluta van Voyado uit.
  • De standaardtaal en het standaardland.
  • Of APIcenter bestaande klanten in Voyado bijwerkt. Dit geldt voor Klanten naar Voyado sturen en voor de klant bij Verkooporders naar Voyado sturen.

Een deel van de instellingen in de lijst is generiek en heeft voor Voyado geen functie, bijvoorbeeld de voorraadwaarde: Voyado heeft geen voorraadflows.

Wanneer je ze aanpast

  • Als je de integratie voor het eerst inricht.
  • Als je Voyado andere standaardwaarden laat gebruiken, zoals een andere valuta.
  • Als je wel of juist niet wilt dat APIcenter klantgegevens overschrijft die je in Voyado bijhoudt.

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 Voyado sturen.

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

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

Instellingen

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

API Key

Authentication

De API-sleutel waarmee APIcenter zich bij de applicatie aanmeldt. De waarde is verplicht en wordt verborgen getoond. Je maakt of vindt de sleutel in de applicatie zelf. Als de sleutel is ingetrokken of vervangen, vul je hier de nieuwe in. 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.

Company ID

Authentication

Het bedrijfs-ID (company ID) dat APIcenter bij de verzoeken aan de applicatie meestuurt in een header. De waarde is niet verplicht. Vul het alleen in als je applicatie een bedrijf of administratie vraagt. Er is geen standaardwaarde.

Server Host

Authentication

Het 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

Authentication

Het 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

Authentication

Het 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 Username

Authentication

De 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.

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.

Update existing customers

Customer Settings

Bepaalt of APIcenter een bestaande klant in Voyado bijwerkt. Staat de instelling uit, dan wordt een bestaande klant niet bijgewerkt: de flow voor één klant eindigt dan met een waarschuwing, en bij een verkooporder gaat de verwerking gewoon door. Gebruik je ook de flow voor klanten in batch, zet deze instelling dan uit, zodat alleen die batchflow klanten bijwerkt. Standaard staat de instelling uit.

Deze instelling heeft geen effect voor Voyado. APIcenter gebruikt hem alleen bij andere applicaties. Je kunt hem laten staan zoals hij is.

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.

Initial run done

Run behaviour

Hier staat of de eerste run voor het importeren van items klaar is. Zolang deze instelling uit staat, stoppen flows die dit controleren met een melding dat de eerste run nog niet is gedaan. De standaardwaarde is uit.

Use stock locations

Stock & Warehouse Settings

Zet 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 Settings

Hiermee 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.

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.

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.

Nog vragen?

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

Naar support