Pennylane: veelvoorkomende fouten

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

Invalid VAT rates on lines

Oorzaak: Een orderregel heeft een btw-code die Pennylane niet kent. De melding noemt de ongeldige codes en geeft de lijst met geldige codes. Een geldige code bestaat uit een landcode en een getal, bijvoorbeeld FR_200.

Oplossing:

1. Lees in de activiteit welke btw-codes ongeldig zijn.
2. Pas de btw-code aan in de bronapplicatie, of koppel de goede code onder Data mapping van de flow Verkooporders naar Pennylane sturen.
3. Probeer de order opnieuw.

Product: '...' not found!

Oorzaak: Een orderregel heeft een SKU, maar APIcenter vindt in Pennylane geen product met die SKU als externe referentie. De order wordt dan niet aangemaakt.

Oplossing:

1. Zoek het product in Pennylane.
2. Bestaat het niet, maak het dan aan met dezelfde waarde als externe referentie. Bestaat het wel, controleer dan of de externe referentie precies gelijk is aan de SKU in de order.
3. Probeer de order opnieuw. Zie Mislukte records en opnieuw proberen.

The order with order number: '...' was found!

Oorzaak: Pennylane heeft al een factuur met deze externe referentie. APIcenter maakt de factuur dan niet nog een keer aan, om dubbele facturen te voorkomen.

Oplossing:

1. Zoek de factuur in Pennylane.
2. Staat de factuur er al? Dan is er niets meer te doen: de order is al verwerkt.
3. Staat de factuur er niet, maar krijg je toch deze melding? Controleer onder Data mapping van de flow welke waarde in het veld voor de orderreferentie terechtkomt. Zie Verkooporders naar Pennylane sturen.

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

Oorzaak: Een verplicht veld ontbreekt. De melding noemt het veld. Bij het versturen van een klant is het e-mailadres verplicht. Bij een order als factuur is de datum verplicht. Bij een order als boeking zijn de datum, het label en het journaal verplicht.

Oplossing:

1. Vul het veld in de bronapplicatie in.
2. Controleer onder Data mapping van de flow dat het veld aan het juiste veld is gekoppeld.
3. Probeer de order of klant opnieuw.

Ongeldig journaal of ongeldige grootboekrekening bij een boeking

Oorzaak: Bij een order als boeking gebruikt APIcenter het journaal en de grootboekrekeningen uit de lijsten van Pennylane. Een waarde die niet in die lijsten staat, wordt niet geaccepteerd.

Oplossing:

1. Kies het journaal en de grootboekrekeningen uit de lijst die APIcenter laat zien.
2. Staat een journaal of rekening niet in de lijst? Controleer in Pennylane of hij bestaat en of het token de rechten journals:readonly en ledger_accounts:readonly heeft.
3. Probeer de order opnieuw.

Fouten van Pennylane

Pennylane geeft bij een fout een HTTP-statuscode. Die staat in de activiteit.

401 Unauthorized

Oorzaak: Het token ontbreekt of is ongeldig, bijvoorbeeld omdat het is verlopen of verkeerd is gekopieerd.

Oplossing:

1. Maak in Pennylane een nieuw token aan. Zie Pennylane koppelen aan APIcenter.
2. Vul het nieuwe token in bij de Pennylane-verbinding in APIcenter en klik op Testverbinding.

403 Forbidden

Oorzaak: Het token heeft het recht niet dat nodig is voor deze actie. Voor klanten is dat customers:all, voor facturen customer_invoices:all, voor producten products:readonly en voor boekingen ledger_entries:all.

Oplossing:

1. Maak in Pennylane een nieuw token aan met de juiste rechten. Zie Understand Scopes.
2. Vul het nieuwe token in bij de Pennylane-verbinding in APIcenter en probeer het opnieuw.

422 Unprocessable Entity

Oorzaak: Pennylane weigert de gegevens, bijvoorbeeld omdat de bedragen niet kloppen of een btw-code ongeldig is.

Oplossing:

1. Lees in de activiteit wat Pennylane over de gegevens zegt.
2. Pas de gegevens aan in de bronapplicatie, of controleer de koppeling onder Data mapping.
3. Probeer het opnieuw.

429 Too Many Requests

Oorzaak: Pennylane staat 25 verzoeken per 5 seconden per token toe en je zit daarboven.

Oplossing: Wacht even. Pennylane geeft aan hoeveel seconden je moet wachten. APIcenter probeert mislukte records opnieuw. Zie Mislukte records en opnieuw proberen. Gebruik je hetzelfde token voor meer dan één koppeling, maak dan een eigen token voor APIcenter aan.

500 of 503

Oorzaak: Pennylane heeft een tijdelijke storing.

Oplossing: Wacht en probeer het later opnieuw. Zie Mislukte records en opnieuw proberen.

Meer over de fouten van Pennylane staat in Error Handling & Status Codes en Rate Limiting in API v2.