eKonomi: veelvoorkomende fouten

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

Not all required settings are present!

Oorzaak: Voor deze flow ontbreekt een instelling in de integratie of in de flow. De melding noemt de instellingen die ontbreken. Bij het versturen van producten gaat het om de instellingen voor de eenheid en de artikelcodering, bij het versturen van orders om de manier van versturen, en bij een financiële mutatie ook om de methode en de verzendkosten.

Oplossing:

1. Lees in de melding welke instellingen ontbreken.
2. Kun je ze niet zien in de instellingen van de integratie of de flow, neem dan contact op met de klantenservice. De melding vraagt hierom: de instelling moet voor je worden ingeschakeld.
3. Probeer de flow opnieuw.

Validation of required fields failed

Oorzaak: De gegevens uit de bronapplicatie missen een verplicht veld. De melding noemt het veld. Per flow zijn dit de velden die verplicht zijn:

• Klant: e-mailadres, naam, en adres, landcode en postcode van het factuur- en afleveradres.
• Product: naam, artikelnummer, naam van de eenheid en bruto prijs.
• Voorraad: voorraadsaldo en artikelnummer.
• Order: de klantvelden hierboven, de orderregels, en per orderregel het artikelnummer, de stukprijs en het aantal.

Oplossing:

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

Sending order as ... is not supported

Oorzaak: De instelling Order type van de flow Verkooporders naar eKonomi sturen heeft een waarde die eKonomi niet ondersteunt. De melding verwijst naar de categorie Order settings van de flowinstellingen.

Oplossing:

1. Open de flow Verkooporders naar eKonomi sturen in de integratie.
2. Open het tabblad Instellingen.
3. Zet Order type op Order, Invoice, Quotation of Financial Mutation en sla op.
4. Probeer de order opnieuw.

Product: ... not found

Oorzaak: Een artikelnummer van een orderregel, of het artikelnummer bij een voorraadupdate, bestaat niet in eKonomi. APIcenter zoekt het artikel op artikelnummer en maakt het niet zelf aan.

Oplossing:

1. Zoek het artikelnummer uit de melding op in eKonomi.
2. Bestaat het artikel niet? Maak het aan in eKonomi of stuur het met Producten naar eKonomi sturen.
3. Bestaat het artikel wel, maar onder een ander nummer? Controleer onder Data mapping van de flow welk veld aan het artikelnummer is gekoppeld.
4. Probeer het record opnieuw.

One or more of the order lines has invalid price!

Oorzaak: Je verstuurt een order als Financial Mutation met de methode Complex of Extreme, en een orderregel heeft geen stukprijs of een stukprijs van 0.

Oplossing:

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

UnitName not found

Oorzaak: Bij het versturen van een product vindt APIcenter de eenheid niet in eKonomi. APIcenter zoekt de eenheid op naam. De volledige melding is: "UnitName not found. Please input the correct UnitName/default uom in the setting."

Oplossing:

1. Open in eKonomi de lijst met eenheden en kijk hoe de eenheid precies heet.
2. Zorg dat de naam van de eenheid in je bronapplicatie, of in Value for the default Unit of measurement, daar exact mee overeenkomt.
3. Probeer het product opnieuw.

CodingName not found

Oorzaak: Bij het versturen van een product vindt APIcenter de artikelcodering niet in eKonomi. APIcenter zoekt de codering op naam. De volledige melding is: "CodingName not found. Please input the correct CodingName/default taxId in the setting."

Oplossing:

1. Kijk in eKonomi hoe de artikelcodering precies heet.
2. Zet die naam in Value for the default tax id (exclude '%') of in je mapping.
3. Probeer het product opnieuw.

Fouten van eKonomi

eKonomi geeft bij een fout een foutcode, een melding voor ontwikkelaars en een uniek foutnummer (Error ID) terug. Het foutnummer staat in de activiteit. Heb je hulp van de klantenservice nodig, geef dan dat nummer door.

4010: API calls quota exceeded

Oorzaak: eKonomi staat 600 aanvragen per minuut toe, per klant en per adres. De melding is een HTTP 429 met een tekst als "Try again in 55 seconds."

Oplossing:

1. Wacht het aantal seconden uit de melding.
2. Probeer het opnieuw. Zodra het aantal aanvragen onder de limiet komt, werkt eKonomi weer normaal.
3. Komt de melding vaak terug? Verlaag het aantal items per run, of laat minder flows tegelijk draaien.

4005 of 401: niet geautoriseerd

Oorzaak: eKonomi weigert de aanvraag omdat de toegang niet meer geldig is, bijvoorbeeld omdat de gebruiker zijn wachtwoord heeft veranderd.

Oplossing:

1. Ga naar Applicaties en open de eKonomi-verbinding.
2. Klik op Autoriseren en log in bij eKonomi.
3. Klik op Testverbinding. Zie Verbinding of inloggen mislukt.

4006: geen toegang tot de benodigde rechten

Oorzaak: Een onderdeel van eKonomi vraagt een recht (scope) waarvoor je geen toestemming hebt gegeven.

Oplossing:

1. Ga naar Applicaties en open de eKonomi-verbinding.
2. Klik op Autoriseren en geef alle gevraagde rechten.
3. Probeer het opnieuw. Zie eKonomi koppelen aan APIcenter.

4007: onvoldoende rechten voor deze gebruiker

Oorzaak: De eKonomi-gebruiker waarmee je hebt ingelogd, heeft niet genoeg rechten voor dit onderdeel.

Oplossing: Geef de gebruiker in eKonomi de juiste rechten, of koppel opnieuw met een gebruiker met meer rechten.

4011: gebruiker heeft geen toegang tot eKonomi voor dit bedrijf

Oorzaak: De gebruiker waarmee je hebt ingelogd, heeft geen toegang tot eKonomi voor het gekozen bedrijf.

Oplossing:

1. Geef de gebruiker in eKonomi toegang, of kies een gebruiker die al toegang heeft.
2. Klik in APIcenter op Autoriseren en log opnieuw in.

4012: licentieovereenkomst niet geaccepteerd

Oorzaak: De gebruiker heeft de licentieovereenkomst van eKonomi voor dit bedrijf niet geaccepteerd.

Oplossing: Log in bij eKonomi met dezelfde gebruiker en hetzelfde bedrijf en accepteer de licentieovereenkomst. Probeer het daarna opnieuw.

4003: startgids niet afgerond

Oorzaak: Het bedrijf in eKonomi heeft de startgids niet afgerond.

Oplossing: Rond de startgids af in eKonomi en probeer het opnieuw.

4004: bedrijf niet actief

Oorzaak: Het bedrijf in eKonomi is niet actief.

Oplossing: Controleer in eKonomi de status van het bedrijf. Neem contact op met eKonomi als je het bedrijf niet zelf kunt activeren.

4009 of 4002: geen toegang tot een onderdeel

Oorzaak: Het onderdeel hoort niet bij het abonnement van het bedrijf (foutcode 4009), of het bedrijf mist een module die je in eKonomi kunt aanschaffen (foutcode 4002).

Oplossing: Controleer in eKonomi of je abonnement of modules dit onderdeel bevatten. Zet de flow anders uit.

4013: boeking niet mogelijk

Oorzaak: Het boeken van de factuur of financiële mutatie is gestopt door een controle in eKonomi, zoals een afgesloten boekjaar of een afgesloten boekingsperiode.

Oplossing:

1. Controleer in eKonomi of het boekjaar en de periode van de factuurdatum open zijn.
2. Open ze, of kies een andere orderdatum.
3. Probeer de order opnieuw.

2000: gegevens ongeldig

Oorzaak: eKonomi heeft een regel voor de gegevens niet gehaald. De melding van eKonomi noemt de eigenschap die niet klopt.

Oplossing:

1. Lees in de melding welk veld niet klopt.
2. Pas de waarde aan in de bronapplicatie of onder Data mapping van de flow.
3. Probeer het record opnieuw. Zie Mislukte records en opnieuw proberen.

3000: niet gevonden

Oorzaak: eKonomi kan een object niet vinden waar de aanvraag naar verwijst, zoals een klant of een artikel.

Oplossing: Controleer of het object in eKonomi bestaat, en of de mapping naar het juiste veld verwijst.

Meer informatie over de foutcodes staat in de foutcodes van Visma eAccounting en de limieten.