Jortt: veelvoorkomende fouten

Deze pagina helpt bij fouten die je in de activiteit van Jortt ziet. Je opent haar met Hulp bij deze fout. Zoek de melding of de sleutel (bijvoorbeeld scopes.insufficient) 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

Jortt only supports sending orders in as "Sales Invoice". Adjust this in the settings

Oorzaak: Jortt ondersteunt alleen facturen. De instelling Send Order as van de flow Verkooporders naar Jortt sturen staat op een andere waarde dan Sales Invoice.

Oplossing:

1. Ga naar de integratie en open de flow Verkooporders naar Jortt sturen.
2. Open het tabblad Instellingen.
3. Zet Send Order as op Sales Invoice en sla op.
4. Probeer de order opnieuw.

Order is already registered in Jortt

Oorzaak: Jortt heeft al een factuur waarvan de referentie gelijk is aan het ordernummer. APIcenter maakt de factuur dan niet nog een keer aan, om dubbele facturen te voorkomen. Dit controleert APIcenter alleen als het ordernummer minimaal 3 tekens heeft.

Oplossing:

1. Zoek de factuur in Jortt op het ordernummer.
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 referentie terechtkomt. Zie Verkooporders naar Jortt sturen.

No customer id found on the order

Oorzaak: Bij het ophalen van facturen heeft een factuur in Jortt geen klant. APIcenter haalt bij elke factuur de klant op en kan de factuur zonder klant niet doorgeven.

Oplossing:

1. Open de factuur in Jortt.
2. Koppel er een klant aan.
3. De factuur wordt bij een volgende run opnieuw opgehaald. Zie Verkooporders ophalen uit Jortt.

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

Oorzaak: Bij het versturen van een klant ontbreekt het e-mailadres. APIcenter zoekt de klant in Jortt op e-mailadres, dus de klant moet er een hebben. De melding noemt het veld dat ontbreekt.

Oplossing:

1. Vul het e-mailadres van de klant in de bronapplicatie in.
2. Controleer onder Data mapping van de flow Klanten naar Jortt sturen dat het e-mailadres aan het juiste veld is gekoppeld.
3. Probeer de klant opnieuw.

Fouten van Jortt

Jortt geeft bij een fout een vaste sleutel terug. Die staat in de activiteit.

organization.requires_mkb_plan

Oorzaak: Je Jortt-administratie heeft geen jortt MKB of jortt Plus. De API-koppeling zit niet in jortt Starter en jortt ZZP.

Oplossing: Upgrade je abonnement in Jortt en probeer het opnieuw.

organization.blocked

Oorzaak: Jortt heeft de administratie geblokkeerd.

Oplossing: Neem contact op met Jortt om de administratie te laten deblokkeren.

scopes.insufficient

Oorzaak: APIcenter mist een recht in Jortt.

Oplossing:

1. Ga naar Applicaties en open de Jortt-verbinding.
2. Klik op Autoriseren en log in bij Jortt.
3. Geef alle gevraagde rechten. Zie Jortt koppelen aan APIcenter.

access_token.revoked

Oorzaak: De toegang van APIcenter is in Jortt ingetrokken.

Oplossing: Klik bij de Jortt-verbinding opnieuw op Autoriseren en geef toestemming. Zie Verbinding of inloggen mislukt.

access_token.invalid of access_token.expired

Oorzaak: De toegangssleutel is ongeldig of verlopen. Jortt noemt een verlopen sleutel apart en zegt dat de sleutel vernieuwd kan worden.

Oplossing:

1. Probeer de flow nog een keer.
2. Blijft de fout? Klik bij de Jortt-verbinding op Autoriseren en log opnieuw in. Zie Verbinding of inloggen mislukt.

permissions.insufficient

Oorzaak: De Jortt-gebruiker waarmee je hebt ingelogd, heeft in Jortt te weinig rechten voor deze actie.

Oplossing: Laat een beheerder van de administratie de rechten per module geven bij Instellingen > Gebruikers in Jortt. Klik daarna in APIcenter op Testverbinding.

params.invalid of operation.invalid

Oorzaak: Jortt weigert de gegevens, bijvoorbeeld omdat een verplicht veld ontbreekt of een waarde een verkeerd formaat heeft. Een orderregel zonder omschrijving geeft zo'n fout. APIcenter vult de omschrijving met de SKU, maar die is ook leeg als de regel geen SKU heeft. Dat kan bijvoorbeeld bij een regel voor verzendkosten.

Oplossing:

1. Lees in de activiteit welk veld Jortt noemt.
2. Vul dat veld in de bronapplicatie, of controleer de koppeling onder Data mapping.
3. Gaat het om een extra orderregel voor kosten, zoals Require order line for shipping costs? Vul dan ook de omschrijving van die regel in. Zie Verkooporders naar Jortt sturen.

operation.year_closed

Oorzaak: De factuur valt in een afgesloten boekjaar in Jortt, dus Jortt kan hem niet aanmaken.

Oplossing: Open het boekjaar in Jortt en probeer de order opnieuw.

request.throttled

Oorzaak: Jortt staat maximaal 10 verzoeken per seconde toe en je zit daarboven.

Oplossing: Wacht even. APIcenter probeert mislukte records opnieuw. Zie Mislukte records en opnieuw proberen.

server.internal_error, server.maintenance of integration.outage

Oorzaak: Jortt heeft een storing of is tijdelijk offline voor onderhoud.

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

Meer over de fouten van Jortt staat in de documentatie van de Jortt API.