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

  1. APIcenter verwerkt eerst de klant. De klant heeft een e-mailadres of een externe ID nodig. Zie hieronder.
  2. APIcenter controleert of de order betalingsgegevens bevat. Zonder betaalmethode stopt de flow met de melding dat er geen betalingsinformatie is gevonden.
  3. APIcenter bereidt de order voor: datums, orderregels, wisselkoers, promoties en het veld met extra gegevens.
  4. 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

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.

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

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

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

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

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

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

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

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

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

Vul 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

Notifications

Kies 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

Notifications

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

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

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

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

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

Dit 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 behaviour

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Nog vragen?

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

Naar support