Voyado: veelvoorkomende fouten

Deze pagina helpt bij fouten die je in de activiteit van Voyado ziet. Je opent haar met Hulp bij deze fout. Zoek de melding en volg de stappen.

Gaat het om inloggen in het algemeen, een gepauzeerde of gestopte flow, of opnieuw proberen? Zie dan Verbinding of inloggen mislukt, Flow gepauzeerd of gestopt en Mislukte records en opnieuw proberen.

Fouten van APIcenter

Customer not found in target system!

Oorzaak: Bij Loyaliteitspunten naar Voyado sturen bestaat de klant niet in Voyado. Deze flow maakt zelf geen klant aan.

Oplossing:

1. Controleer of de klant in Voyado bestaat, met hetzelfde e-mailadres of dezelfde externe ID.
2. Bestaat de klant niet? Stuur de klant eerst met Klanten naar Voyado sturen.
3. Zoek je op externe ID? Controleer dan de instellingen Search debtor by ID instead of Email address en Fallback to Email when DebtorID not found van de flow.
4. Probeer het record opnieuw.

No payments info found in the data!

Oorzaak: Bij Verkooporders naar Voyado sturen bevat de order geen betaalmethode. APIcenter heeft de betalingsgegevens nodig om de order in Voyado aan te maken.

Oplossing:

1. Controleer onder Data mapping van de flow dat de velden voor de betaalmethode zijn gekoppeld.
2. Controleer in de bronapplicatie dat de order op het moment van ophalen betalingsgegevens heeft.
3. Probeer de order opnieuw.

Validation of required fields failed

Oorzaak: In de gegevens ontbreekt een verplicht veld. De melding noemt het veld. Voorbeelden uit de flows van Voyado:

• Bij een klant, order of loyaliteitspunten: een e-mailadres of een externe ID ontbreekt. Een e-mailadres met speciale tekens telt als ontbrekend.
• Bij Toestemmingen ophalen uit Voyado: payload, payload.contactId of payload.externalId ontbreekt, of geen van payload.acceptsEmail, payload.acceptsSms en payload.acceptsPostal is aanwezig.

Oplossing:

1. Vul het ontbrekende veld in de bronapplicatie in.
2. Controleer onder Data mapping dat het veld aan het juiste veld is gekoppeld.
3. Probeer het record opnieuw.

Failed to decrypt the payload.

Oorzaak: Bij Toestemmingen ophalen uit Voyado kan APIcenter de versleutelde gegevens van de webhook niet ontsleutelen. De sleutel in APIcenter is niet gelijk aan de sleutel in Voyado.

Oplossing:

1. Vraag de juiste versleutelingssleutel op bij Voyado.
2. Vul de sleutel in bij Webhook encryption key van de flow en sla op.
3. Wacht op de volgende melding van Voyado of laat Voyado de melding opnieuw sturen.

Een webhook-melding wordt niet verwerkt

Oorzaak: APIcenter weigert een melding van Voyado als de handtekening niet klopt of als het tijdstip van de melding meer dan 5 minuten afwijkt van de tijd van APIcenter. De handtekening wordt gemaakt met het ondertekeningsgeheim van Voyado.

Oplossing:

1. Controleer op het tabblad Webhooks van de flow dat het Webhook-geheim gelijk is aan het ondertekeningsgeheim in Voyado. Klik na een wijziging op Bijwerken.
2. Controleer in Voyado dat de webhook de Webhook-URL uit APIcenter gebruikt.
3. Zie Webhooks.

The setting 'use_archive_folder' is enabled but there is no name specified

Oorzaak: Bij Promoties ophalen uit Voyado staat Do you want to archive the promotion files after they are processed? aan, maar Archive folder name is leeg.

Oplossing:

1. Open het tabblad Instellingen van de flow.
2. Vul bij Archive folder name de naam van de archiefmap in, of zet Do you want to archive the promotion files after they are processed? uit.
3. Sla op en probeer het opnieuw.

Selected promotion type is not supported by the source system!

Oorzaak: Bij Promoties ophalen uit Voyado heeft Do you want to use Promotion or Voucher as the source for the promotion? een andere waarde dan Promotion of Voucher.

Oplossing:

1. Open het tabblad Instellingen van de flow.
2. Kies bij Do you want to use Promotion or Voucher as the source for the promotion? een van de twee opties en sla op.
3. Probeer het opnieuw.

Geen klant verwijderd bij Klanten (batch)

Oorzaak: Een klant met de status verwijderd wordt in Voyado gezocht op externe ID. Staat Search debtor by ID instead of Email address uit, of is er geen externe ID, dan wordt de klant niet gevonden. In de resultaten staat dan dat de klant niet gevonden is en niet verwijderd kan worden.

Oplossing:

1. Zet Search debtor by ID instead of Email address aan bij de flow Klanten (batch) naar Voyado sturen.
2. Controleer dat de klant een externe ID heeft die gelijk is aan de externe ID in Voyado.

Fouten van Voyado

Voyado stuurt bij een fout een foutcode en een bericht terug. Die staan in de activiteit.

ContactNotFound of BonusCheckNotFound (404)

Oorzaak: Bij het inwisselen van een promotie bij Verkooporders naar Voyado sturen vindt Voyado de klant of de promotie niet.

Oplossing: Controleer in Voyado of de klant en de promotie bestaan. Probeer het record daarna opnieuw.

BonusCheckAlreadyRedeemed of BonusCheckExpired (409)

Oorzaak: Bij het inwisselen van een promotie bij Verkooporders naar Voyado sturen is de promotie al ingewisseld of verlopen.

Oplossing: Controleer de promotie bij de klant in Voyado. Is de order al verwerkt? Dan is er niets meer te doen. Zie Mislukte records en opnieuw proberen.

MultipleMatches

Oorzaak: Voyado vindt bij het zoeken meer dan één klant met hetzelfde e-mailadres of dezelfde externe ID.

Oplossing: Zorg in Voyado dat de klant maar één keer voorkomt, of zoek op externe ID met Search debtor by ID instead of Email address.

500-fout met de tekst "An error has occurred"

Oorzaak: Voyado geeft deze fout als een verzoek niet het inhoudstype application/json heeft. APIcenter stuurt dit zelf mee. Zie je de fout toch, dan ligt het meestal aan de verbinding.

Oplossing: Controleer de verbinding met Testverbinding. Blijft de fout? Maak een supportticket aan en voeg de melding uit de activiteit toe.

Meer informatie over de API staat in De Engage API van Voyado.