Xero: veelvoorkomende fouten

Deze pagina helpt bij fouten die je in de activiteit van Xero 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 following fields are required and need to be present in the data

Oorzaak: In de order ontbreekt een verplicht veld. De melding noemt het veld. Bij het versturen van een order naar Xero zijn dit het e-mailadres, de voornaam en de achternaam van de klant. Staat Use order finalization aan, dan zijn ook de vervaldatum en de rekeningcode op elke orderregel verplicht.

Oplossing:

1. Vul het ontbrekende veld in de bronapplicatie in.
2. Controleer onder Data mapping van de flow Verkooporders naar Xero sturen dat het veld aan het juiste veld is gekoppeld.
3. Probeer de order opnieuw.

At least one of the following fields needs to be present

Oorzaak: Staat Use order finalization aan en heeft de order betalingen? Dan moet elke betaling een rekening hebben, in het veld Account.AccountId of Account.Code.

Oplossing:

1. Vul de rekening bij de betaling in de bronapplicatie in, of koppel hem onder Data mapping.
2. Probeer de order opnieuw.

Account not found

Oorzaak: De code van de rekening van een betaling staat niet in de lijst met rekeningen van Xero. De melding noemt de code die APIcenter heeft gezocht.

Oplossing:

1. Open in Xero de lijst met rekeningen en controleer de code.
2. Pas de waarde onder Data mapping aan, zodat die gelijk is aan een code uit Xero.
3. Probeer de order opnieuw.

The invoice with invoice number ... was found! / The quote with quote number ... was found!

Oorzaak: In Xero staat al een factuur met dezelfde referentie als de order, of een offerte met hetzelfde offertenummer. Een factuur met de status DELETED telt niet mee. APIcenter maakt het document dan niet nog een keer aan, om dubbele facturen te voorkomen.

Oplossing:

1. Zoek het document in Xero op de referentie of het offertenummer.
2. Staat het er al? Dan is er niets meer te doen: de order is al verwerkt.
3. Staat het er niet, maar krijg je toch deze melding? Controleer onder Data mapping welke waarde in de referentie of het offertenummer terechtkomt.

Setting validation failed

Oorzaak: De flow Producten of Voorraad ophalen heeft een verplichte instelling niet. Het gaat om From what date do you want to retrieve product information?.

Oplossing:

1. Ga naar de integratie en open de flow.
2. Open het tabblad Instellingen.
3. Vul een datum in bij From what date do you want to retrieve product information? en sla op.
4. Start de flow opnieuw.

No Products to process. / No StockItems to process.

Oorzaak: Dit is geen fout. Xero heeft geen items die zijn gewijzigd na de datum bij From what date do you want to retrieve product information?.

Oplossing: Is dat niet wat je verwacht? Controleer de datum bij From what date do you want to retrieve product information?. Zet je de datum terug, dan haalt de flow de items opnieuw op.

Finalizing is turned off / Order finalization setting is turned off

Oorzaak: Dit is geen fout. Use order finalization staat uit, dus APIcenter heeft het document in Xero niet afgerond.

Oplossing: Wil je dat APIcenter het document wel afrondt? Zet Use order finalization aan op de flow Verkooporders naar Xero sturen.

Fouten van Xero

HTTP 429: te veel verzoeken (too many requests)

Oorzaak: Xero begrenst het aantal verzoeken per organisatie: 5 tegelijk, 60 per minuut en 5000 per dag. Is een grens bereikt, dan geeft Xero de status 429 en in de header Retry-After hoeveel seconden je moet wachten. Zie de limieten van Xero.

Oplossing:

1. Wacht de tijd die Xero in de header Retry-After meegeeft en start de flow daarna opnieuw.
2. Is de limiet per dag bereikt? Dan werkt de koppeling pas weer als die wachttijd voorbij is.
3. Laat minder flows tegelijk draaien op dezelfde Xero-organisatie.

Geen toegang tot de organisatie

Oorzaak: APIcenter heeft het ID van de organisatie nodig om verzoeken naar Xero te sturen. Dat vult APIcenter in aan de hand van de naam bij Organisation Name. Komt de naam niet overeen met een organisatie waartoe je toegang hebt gegeven, dan blijft Tenant ID (will be auto-filled) leeg.

Oplossing:

1. Controleer de naam van de organisatie in Xero.
2. Vul dezelfde naam in bij Organisation Name, precies zoals in Xero.
3. Test de verbinding opnieuw. Zie Xero koppelen aan APIcenter.