Yuki: veelvoorkomende fouten

Deze pagina helpt bij fouten die je in de activiteit van Yuki 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

The session identifier was not retrieved

Oorzaak: APIcenter vroeg Yuki om een sessie met je API-sleutel, maar Yuki gaf geen sessie-ID terug. De API-sleutel is dan niet meer geldig of is niet goed ingevuld.

Oplossing:

1. Maak in Yuki een nieuwe API-sleutel aan met Alle webservices. Zie Yuki koppelen aan APIcenter.
2. Open in APIcenter de Yuki-verbinding en vul de nieuwe sleutel in bij API Key.
3. Klik op Testverbinding.

The following fields are required and need to be present in the data

Oorzaak: Bij het versturen van een order ontbreekt een verplicht veld. De melding noemt het veld. Er zijn twee velden die Yuki hier nodig heeft: het e-mailadres van de klant (EmailAddress) en de btw-code op elke orderregel (Product.VATType).

Oplossing:

1. Lees in de melding welk veld ontbreekt.
2. Ontbreekt het e-mailadres? Vul het in de bronapplicatie in en controleer onder Data mapping dat het is gekoppeld.
3. Ontbreekt de btw-code? Controleer onder Data mapping dat de btw-klasse van de orderregel aan de btw-code is gekoppeld. Of vul een standaardwaarde in bij Value for the default tax id (exclude '%'), of gebruik Use default tax id mapping table. Zie Verkooporders naar Yuki sturen.
4. Probeer de order opnieuw.

Found multiple contacts with the same email!

Oorzaak: In Yuki hebben meerdere relaties hetzelfde e-mailadres. APIcenter weet dan niet bij welke relatie de factuur hoort.

Oplossing:

1. Zoek in Yuki de relaties met dit e-mailadres.
2. Zorg dat het e-mailadres bij één relatie hoort, bijvoorbeeld door een dubbele relatie te verwijderen of het e-mailadres te wijzigen.
3. Probeer de order opnieuw.

Failed to create customer with email

Oorzaak: De klant bestond nog niet in Yuki en APIcenter heeft hem aangemaakt, maar Yuki gaf geen ID van de nieuwe relatie terug. De relatie is dus niet aangemaakt.

Oplossing:

1. Open de activiteit en lees het antwoord van Yuki. Dat noemt vaak het veld dat niet klopt.
2. Vul dat veld in de bronapplicatie, of controleer de koppeling onder Data mapping.
3. Probeer de order opnieuw.

Failed to create SaleInvoice

Oorzaak: Yuki heeft de factuur niet aangemaakt. Het antwoord van Yuki in de activiteit zegt waarom. Yuki annuleert een factuur die onvolledig is, bijvoorbeeld bij een nieuw product zonder prijs of btw-tarief, of bij een nieuwe relatie zonder adresgegevens.

Oplossing:

1. Open de activiteit en lees de melding van Yuki.
2. Vul het genoemde veld in de bronapplicatie, of controleer de koppeling onder Data mapping.
3. Probeer de order opnieuw. Zie Mislukte records en opnieuw proberen.

Fouten van Yuki

Yuki beschrijft de meest voorkomende fouten in de Yuki API-documentatie.

API-key has no rights to access this web service

Oorzaak: De API-sleutel heeft geen toegang tot alle webservices die APIcenter gebruikt.

Oplossing: Maak in Yuki een nieuwe API-sleutel aan en kies Alle webservices. Vul de nieuwe sleutel in bij API Key. Zie Yuki koppelen aan APIcenter.

Daily limit exceeded

Oorzaak: Het domein heeft de 1.000 gratis webservice-aanroepen van vandaag gebruikt. Alle applicaties die aan het domein gekoppeld zijn, delen die ruimte.

Oplossing: Wacht tot de volgende dag. APIcenter probeert mislukte records opnieuw, zie Mislukte records en opnieuw proberen. Heb je meer aanroepen nodig? Volgens Yuki kan de accountant de accountantfeature Webservice toevoegen (tot 5.000 aanroepen per dag) of Webservice Uitgebreid (tot 10.000).

Domain has no active database

Oorzaak: Het domein in Yuki is gearchiveerd.

Oplossing: Vraag je accountant of er een nieuw, actief domein met dezelfde naam is, en maak daarvoor een nieuwe API-sleutel aan. Anders kan Yuki-support uitzoeken welk domein niet actief is.

The domain is not licensed for this functionality

Oorzaak: Bij het aanmaken van een factuur: het domein in Yuki heeft de verkoopfunctie niet.

Oplossing: Upgrade de bundel naar Small of hoger, of laat de accountant de accountantfeature Yuki Sales Webservice activeren. Probeer de order daarna opnieuw.

The TotalDigits constraint failed

Oorzaak: Een bedrag op de factuur, bijvoorbeeld de prijs (SalesPrice), heeft meer dan twee decimalen. Yuki accepteert maximaal twee decimalen.

Oplossing:

1. Controleer in de activiteit welk bedrag Yuki noemt.
2. Zorg dat het bedrag in de bron maximaal twee decimalen heeft, of rond het af onder Data mapping.
3. Probeer de order opnieuw.