JTL ERP: veelvoorkomende fouten

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

Product: '...' not found!

Oorzaak: Bij het versturen van een order zoekt APIcenter elk product in JTL ERP op SKU. Dit product bestaat daar niet, of de SKU is anders geschreven. In de melding staat de SKU.

Oplossing:

1. Zoek de SKU in JTL ERP.
2. Bestaat het product niet? Maak het aan in JTL ERP, of haal het eerst binnen met een productflow.
3. Heeft het product een andere SKU? Pas de SKU aan in de bronapplicatie of controleer onder Data mapping welk veld naar de SKU gaat.
4. Probeer de order opnieuw. Zie Mislukte records en opnieuw proberen.

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

Oorzaak: JTL ERP heeft al een order met dit externe ordernummer. APIcenter maakt de order dan niet nog een keer aan, om dubbele orders te voorkomen.

Oplossing:

1. Zoek de order in JTL ERP op het ordernummer uit de melding.
2. Staat de order er al? Dan is er niets meer te doen: de order is al verwerkt.
3. Staat de order er niet, maar krijg je toch deze melding? Controleer onder Data mapping van de flow Verkooporders naar JTL ERP sturen welke waarde naar het externe ordernummer gaat.

Validation of required fields failed

Oorzaak: De order mist een verplicht veld. De melding noemt het veld. JTL ERP eist bij het versturen van een order:

• een bedrijf, als ID of als naam;
• een SKU en een aantal bij elke orderregel;
• een ID of een naam van de betaalmethode, als je betaalgegevens meestuurt;
• een ID of een naam van de verzendmethode, als je verzendgegevens meestuurt;
• bij een nieuwe klant: een klantgroep, een taal (ISO-code), een plaats en een landcode in het factuuradres;
• een e-mailadres of debiteurnummer van de klant, om de klant te zoeken.

Oplossing:

1. Vul het ontbrekende veld in de bronapplicatie in.
2. Controleer onder Data mapping van de flow dat het veld aan het juiste veld is gekoppeld.
3. Ontbreekt de klantgroep? Vul die in bij Value to use as default customer group en zet Enable use of a default customer group aan.
4. Probeer de order opnieuw.

No OauthClientId or OauthClientSecret set for the application

Oorzaak: APIcenter mist de gegevens waarmee het bij JTL een toegangstoken aanvraagt. Dit zijn gegevens van APIcenter zelf, niet van jou. Je kunt ze niet zelf invullen.

Oplossing: Neem contact op met APIcenter-support en vermeld de naam van de integratie. Zie ook Verbinding of inloggen mislukt.

Fouten van JTL

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

401 Unauthorized

Oorzaak: Volgens de documentatie van JTL komt dit door een ontbrekend tenant-ID, een ontbrekend of verlopen toegangstoken, of ongeldige inloggegevens. APIcenter vraagt zelf een nieuw token aan als het oude verlopen is.

Oplossing:

1. Probeer de flow nog een keer.
2. Open de JTL ERP-verbinding onder Applicaties en controleer of Tenant ID is ingevuld.
3. Blijft de fout? Koppel JTL ERP opnieuw via de JTL App Store. Zie JTL ERP koppelen aan APIcenter en Verbinding of inloggen mislukt.

403 Forbidden

Oorzaak: Het token is geldig, maar mist het recht voor dit onderdeel van JTL ERP.

Oplossing: Neem contact op met APIcenter-support, met de melding uit de activiteit.

404 Not Found

Oorzaak: JTL ERP kent het gevraagde gegeven niet, bijvoorbeeld omdat het is verwijderd of het ID niet klopt.

Oplossing:

1. Controleer in JTL ERP of het gegeven nog bestaat.
2. Controleer de koppeling onder Data mapping en de standaardwaarden bij de flow-instellingen.
3. Probeer het record opnieuw. Zie Mislukte records en opnieuw proberen.

409 Conflict

Oorzaak: Er bestaat al een gegeven dat je probeert aan te maken, of het gegeven wordt tegelijk door iets anders gewijzigd.

Oplossing: Controleer in JTL ERP of het gegeven al bestaat en probeer het later opnieuw. Zie Mislukte records en opnieuw proberen.

400 Bad Request of 422 Unprocessable Entity

Oorzaak: JTL ERP weigert de gegevens, bijvoorbeeld omdat een verplicht veld ontbreekt of een waarde een verkeerd formaat heeft of niet voldoet aan de regels van JTL.

Oplossing:

1. Lees in de activiteit welk veld JTL noemt.
2. Vul dat veld in de bronapplicatie, of controleer de koppeling onder Data mapping.
3. Probeer het record opnieuw. Zie Mislukte records en opnieuw proberen.

429 Too Many Requests

Oorzaak: Je zit boven de limiet voor het aantal verzoeken van de Cloud API van JTL. JTL geeft de limiet per omgeving door in de antwoordkoppen.

Oplossing: Wacht even. APIcenter probeert mislukte records opnieuw. Zie Mislukte records en opnieuw proberen. Verlaag zo nodig het aantal items per run bij Amount to process.

5xx-fouten

Oorzaak: JTL heeft een storing of is tijdelijk niet bereikbaar.

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

Meer over de fouten van JTL staat in de documentatie van JTL.