Alles over Voyado
Voyado: Verkooporders naar Voyado sturen
Stuur orders uit je webshop naar Voyado als order, als transactie of als allebei. APIcenter maakt ook de klant aan en wisselt promoties in.
Bijgewerkt op 9 november 2026
Deze flow stuurt verkooporders uit een andere applicatie, zoals een webshop, naar Voyado. APIcenter maakt de order aan als order, als transactie of als allebei, en zorgt eerst dat de klant in Voyado bestaat.
Zo wordt een order verwerkt
- APIcenter verwerkt eerst de klant. De klant heeft een e-mailadres of een externe ID nodig. Zie hieronder.
- APIcenter controleert of de order betalingsgegevens bevat. Zonder betaalmethode stopt de flow met de melding dat er geen betalingsinformatie is gevonden.
- APIcenter bereidt de order voor: datums, orderregels, wisselkoers, promoties en het veld met extra gegevens.
- APIcenter maakt de order in Voyado aan zoals je hebt ingesteld bij How do you want to handle the order data?. Zie hieronder.
Order, transactie of allebei
Transaction: APIcenter maakt een transactie aan. Het ordernummer wordt het bonnummer en de unieke bon-ID als die ontbreken. Dit is de standaard als je niets kiest.- Order: APIcenter maakt een order aan.
Order & Transaction: APIcenter maakt beide aan.
Promoties worden alleen bij een transactie gebruikt. Zie hieronder.
De klant
- APIcenter zoekt de klant in Voyado. Staat Search debtor by ID instead of Email address aan, dan zoekt APIcenter eerst op externe ID, en daarna op e-mailadres als Fallback to Email when DebtorID not found aanstaat. Staat de eerste instelling uit, dan zoekt APIcenter alleen op e-mailadres.
- Een klant die niet bestaat, wordt aangemaakt.
- Een klant die wel bestaat, wordt alleen bijgewerkt als Update existing customers aanstaat in de verbindings- en integratie-instellingen.
- Op de order koppelt APIcenter de klant met het e-mailadres. Is er geen e-mailadres, dan gebruikt APIcenter de externe ID.
Orderregels en bedragen
- Elke orderregel krijgt het type aankoop (
PURCHASE) of retour (RETURN). Een retour is het als de order of de regel als retour is gemarkeerd. - Bij een retourregel wordt het aantal negatief. Bij een aankoopregel worden aantal, bruto betaalde prijs, belastingbedrag en belastingpercentage altijd positief doorgegeven, ook als de bron een negatief getal geeft. Voyado kan geen negatieve waarden op een aankoopregel verwerken.
- Kortingen op een orderregel gaan als negatieve waarde naar Voyado. Een korting zonder waarde laat APIcenter weg.
- De SKU van de regel is het artikelnummer.
- Heeft de order handelskosten (
handlingFee) met een waarde, dan telt APIcenter die op bij het totaal bruto bedrag. Zonder waarde laat APIcenter het veld weg. - Heeft de order geen valuta, dan gebruikt APIcenter de standaardvaluta voor prijzen, zie Voyado verbindings- en integratie-instellingen. APIcenter rekent de wisselkoers naar de groepsvaluta uit op de datum van de order.
Promoties
Bevat de order promoties met een type-ID, dan zoekt APIcenter bij de klant in Voyado de promoties die nog niet zijn ingewisseld, en zoekt de promotie met dat type. APIcenter kijkt eerst naar promoties met een vervaldatum, de vroegste eerst, en daarna naar promoties zonder vervaldatum.
- Is de promotie gevonden, dan neemt APIcenter hem op in de transactie en wisselt hem na het aanmaken in.
- Is de promotie niet gevonden, of heeft de promotie geen type-ID, dan staat er een waarschuwing in de resultaten en gaat de verwerking van de order door.
- Bij de keuze Order gebruikt APIcenter de promoties niet.
Wat je eerst nodig hebt
- Voyado is gekoppeld. Zie Voyado koppelen aan APIcenter.
- De andere applicatie van de integratie kan verkooporders versturen, met betalingsgegevens en een klant met een e-mailadres of een externe ID.
Tips
- Mislukt de order met de melding over betalingsinformatie? Controleer onder Data mapping dat de betaalmethode van de order is gekoppeld.
- Heb je andere velden nodig, zoals extra gegevens (
extraData) op de order? Voeg ze toe onder Data mapping. Zie Data mapping.
Hieronder vind je alle instellingen van deze flow, elk met een eigen uitleg.
Instellingen
De instellingen die je in het dashboard ziet, met wat elke instelling doet.
Fallback to Email when DebtorID not found
Customer SettingsZoekt de debiteur op e-mailadres als er geen debiteur met het id is gevonden. De instelling werkt alleen als Search debtor by ID instead of Email address aan staat. Zet dit uit als je alleen op id wilt zoeken. Standaard staat deze instelling aan.
Search debtor by ID instead of Email address
Customer SettingsAPIcenter zoekt de klant in Voyado op externe ID in plaats van op e-mailadres. Zet dit aan als de klant in beide systemen dezelfde externe ID heeft. Bij de flow voor klanten in batch is deze instelling nodig om klanten met de status verwijderd te verwijderen: staat hij uit, dan wordt zo'n klant niet gevonden en niet verwijderd. Standaard staat de instelling uit.
What to do with a value that cannot be mapped using the mapping table
Customer SettingsBepaalt wat er gebeurt met een waarde die niet in de mappingtabel staat. Bij Waarde negeren wordt de waarde weggelaten, bij Waarde gebruiken wordt de oorspronkelijke waarde gebruikt en bij Standaardwaarde gebruiken wordt de ingestelde standaardwaarde gebruikt. De instelling werkt alleen als Use a mapping table to map the default payment method id aan staat. De standaardkeuze is Standaardwaarde gebruiken.
Filename Format
File SettingsGeldt alleen voor de flows die een XML-bestand naar de Voyado-server sturen: klanten in batch, producten en producten in batch. De standaardwaarde is ContactImport/{guid} voor klanten en ArticleImport/{guid} voor producten. De bestandsextensie .xml voegt APIcenter zelf toe. Bij het versturen van verkooporders heeft deze instelling geen effect, want orders gaan via de API.
Enable URL Encoding of data in the endpoints of the target application
General flow settingHiermee codeer je de waarden in het adres (de URL) van de doelapplicatie, dus bij flows die gegevens versturen. Dit werkt alleen als Enable URL encoding of data in endpoints aanstaat. Standaard staat dit uit.
Enable URL encoding of data in endpoints
General flow settingZet dit aan als er speciale tekens in de data staan die in het adres (de URL) van een verzoek terechtkomen, zoals in een SKU of categorienaam. De waarden worden dan URL-gecodeerd, zodat het verzoek niet misgaat. Met Enable URL Encoding of data in the endpoints of the source application en Enable URL Encoding of data in the endpoints of the target application bepaal je voor welke kant dit geldt. Standaard staat dit uit.
Use administration mapping table
General flow settingZet dit aan om de administratie om te zetten met een koppeltabel tussen de twee applicaties. Wat er gebeurt met een waarde die niet in de tabel staat, bepaal je met What to do with a value that cannot be mapped using the mapping table. Standaard staat dit uit.
What to do with a value that cannot be mapped using the mapping table
General flow settingHier kies je wat er gebeurt met een administratie die niet in de koppeltabel staat. Bij Waarde negeren wordt de waarde leeggelaten, bij Waarde gebruiken blijft de oorspronkelijke waarde staan en bij Standaardwaarde gebruiken wordt de standaardwaarde uit Default administration id gebruikt, als je die hebt ingeschakeld. Deze instelling werkt alleen als Use administration mapping table aanstaat. Standaard is Standaardwaarde gebruiken gekozen.
Hier kies je wat er gebeurt met een waarde die niet in de koppeltabel van Use a mapping table to map the payment journal staat. Bij Waarde gebruiken blijft de oorspronkelijke waarde staan en bij Waarde negeren wordt de waarde weggelaten. Bij Standaardwaarde gebruiken wordt de standaardwaarde gebruikt die je hebt ingesteld. De standaardwaarde is Standaardwaarde gebruiken.
Notifications Email address
NotificationsVul hier het e-mailadres in waarnaar APIcenter meldingen stuurt over mislukte activiteiten van deze flow. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan gebruikt APIcenter bij Direct het e-mailadres van je account. Er is geen standaardwaarde.
Notifications Slack webhook
NotificationsVul hier de Slack-webhook van je Slack-werkruimte in om meldingen over mislukte activiteiten ook in Slack te ontvangen. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan stuurt APIcenter geen Slack-melding. Er is geen standaardwaarde.
Notifications frequency
NotificationsKies hoe vaak APIcenter meldt dat activiteiten van deze flow zijn mislukt. Bij Direct volgt de melding zodra een activiteit mislukt. Bij Elke 30 minuten, Elk uur, Dagelijks en Wekelijks stuurt APIcenter een overzicht van de mislukte activiteiten die nog niet gemeld zijn. Dit werkt alleen als Receive Notifications aan staat. Standaard is dit Direct.
Receive Notifications
NotificationsZet dit aan om een melding te krijgen als een activiteit van deze flow mislukt. Met Notifications frequency bepaal je hoe vaak je de melding krijgt, en met Notifications Email address en Notifications Slack webhook waar die naartoe gaat. Standaard staat dit uit.
Default order prefix
Order SettingsVul hier een tekst in die APIcenter vooraan zet bij de ordernummer- of orderreferentie. Laat je het veld leeg, dan blijft de waarde ongewijzigd. Dit werkt als de mapping van de orderreferentie de functie voor het voorvoegsel gebruikt. Er is geen standaardwaarde.
Default order suffix
Order SettingsVul hier een tekst in die APIcenter achteraan zet bij de waarde die je in de mapping aan de orderreferentie koppelt. Laat je het veld leeg, dan blijft de waarde ongewijzigd. Dit werkt als de mapping van de orderreferentie de functie voor het achtervoegsel gebruikt. Er is geen standaardwaarde.
How do you want to handle the order data?
Order SettingsBepaalt hoe APIcenter de order naar Voyado stuurt: als Transaction, als Order of als Order & Transaction. Bij Order & Transaction maakt APIcenter beide aan. Alleen bij een transactie worden gebruikte promoties meegestuurd en ingewisseld. Als je niets kiest, gebruikt APIcenter Transaction.
Skip negativity flip process
Product SettingsStandaard zet APIcenter negatieve bedragen bij prijzen, kortingen en belasting om naar positieve bedragen. Bedragen inclusief en exclusief belasting worden dan ook omgewisseld als de belasting negatief is. Zet je deze instelling aan, dan slaat APIcenter deze omzetting over en blijven negatieve waarden negatief. De standaardwaarde is uit.
Maximum number of pages to retrieve
Run behaviourDit is het maximale aantal pagina's dat de flow in één run ophaalt. Het aantal items per pagina stel je in bij Use page size. De standaardwaarde is 20.
Use page size
Run behaviourDit is het aantal items dat de flow per API-verzoek ophaalt. Samen met Maximum number of pages to retrieve bepaalt dit hoeveel items één run kan ophalen. De standaardwaarde is 50.
Enable the use of a default shipping method
Shipment SettingsZet deze instelling aan om een standaard verzendmethode te gebruiken. De waarde vul je in bij Value to use as the default shipping method id. Met Force the use of the default shipping method bepaal je of deze altijd wordt gebruikt of alleen als de bron geen verzendmethode meegeeft. De standaardwaarde is uit.
Force the use of the default shipping method
Shipment SettingsHiermee bepaal je wanneer de standaard verzendmethode wordt gebruikt. Staat de instelling aan, dan wordt altijd de standaard verzendmethode gebruikt. Staat de instelling uit, dan wordt alleen de standaard gebruikt als de gegevens uit de bronapplicatie geen verzendmethode bevatten. Dit werkt alleen als Enable the use of a default shipping method aan staat. De standaardwaarde is uit.
Use a mapping table to map shipping methods
Shipment SettingsZet deze instelling aan om verzendmethoden uit de bronapplicatie via een toewijzingstabel om te zetten naar verzendmethoden van de doelapplicatie. Je vult de toewijzingstabel zelf in. Wat er gebeurt met een waarde die niet in de tabel staat, bepaal je met What to do with a value that cannot be mapped using the mapping table. Er is geen standaardwaarde.
Value to use as the default shipping method id
Shipment SettingsHier vul je de waarde in die als standaard verzendmethode wordt gebruikt. Dit is het id van de verzendmethode in de doelapplicatie. De waarde wordt gebruikt als Enable the use of a default shipping method aan staat. Staat die aan en is hier niets ingevuld, dan geeft APIcenter een melding. Er is geen standaardwaarde.
What to do with a value that cannot be mapped using the mapping table
Shipment SettingsHiermee bepaal je wat er gebeurt met een verzendmethode die niet in de toewijzingstabel staat. Bij Waarde gebruiken wordt de oorspronkelijke waarde gebruikt. Bij Waarde negeren wordt de waarde weggelaten. Bij Standaardwaarde gebruiken wordt de standaardwaarde gebruikt. De standaardwaarde van deze instelling is Standaardwaarde gebruiken.
Enable the use of a default warehouse
Stock & Warehouse SettingsZet aan om een standaardmagazijn te gebruiken. APIcenter vult dan het magazijn in als de gegevens geen magazijn hebben. De waarde stel je in bij Value for the default warehouse id. Standaard staat de instelling uit.
Force the usage of the default warehouse
Stock & Warehouse SettingsZet aan om altijd het standaardmagazijn 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 the use of a default warehouse. Standaard staat hij uit.
Use warehouse mapping table
Stock & Warehouse SettingsZet aan om de waarde van het magazijn om te zetten met een mappingtabel. APIcenter zoekt de waarde uit de gegevens op in de tabel. Wat er gebeurt als een waarde 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 warehouse id
Stock & Warehouse SettingsHier vul je het standaardmagazijn in. APIcenter zet deze waarde in het magazijnveld van het item (de magazijncode), als Enable the use of a default warehouse aan staat en de gegevens geen magazijn hebben. Met Force the usage of the default warehouse gebruikt APIcenter deze waarde ook als er wel een magazijn is.
What to do with a value that cannot be mapped using the mapping table
Stock & Warehouse SettingsHiermee bepaal je wat er gebeurt met een magazijn die niet in de mappingtabel staat. Bij Waarde negeren wordt de waarde weggelaten. Bij Waarde gebruiken blijft de oorspronkelijke waarde staan. Bij Standaardwaarde gebruiken gebruikt APIcenter de standaardwaarde uit Value for the default warehouse id, als Enable the use of a default warehouse aan staat; anders blijft de waarde leeg. Standaard is dit Standaardwaarde gebruiken.
Enable the use of a default tax id
Tax & Tax RatesZet aan om een standaard btw-code te gebruiken. APIcenter vult die dan in als de gegevens geen btw-code hebben. De waarde stel je in bij Value for the default tax id (exclude '%'). Standaard staat de instelling uit.
Force the use of the default tax id
Tax & Tax RatesZet aan om altijd de standaard btw-code 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 the use of a default tax id. Standaard staat hij uit.
Use default tax id mapping table
Tax & Tax RatesZet aan om de btw-code uit de gegevens om te zetten met een mappingtabel. APIcenter zoekt de waarde op in de tabel. Wat er gebeurt als een btw-code 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 tax id (exclude '%')
Tax & Tax RatesHier vul je de standaard btw-code in, zonder het %-teken. APIcenter zet deze waarde in het btw-codeveld, als Enable the use of a default tax id aan staat en de gegevens geen btw-code hebben. Met Force the use of the default tax id gebruikt APIcenter deze waarde ook als er wel een btw-code is.
Hiermee bepaal je wat er gebeurt met een btw-code die niet in de mappingtabel staat. Bij Waarde negeren wordt de waarde weggelaten. Bij Waarde gebruiken blijft de oorspronkelijke waarde staan. Bij Standaardwaarde gebruiken gebruikt APIcenter de standaardwaarde uit Value for the default tax id (exclude '%'), als Enable the use of a default tax id aan staat; anders blijft de waarde leeg. Standaard is dit Standaardwaarde gebruiken.