Fortnox: veelvoorkomende fouten

Deze pagina helpt bij fouten die je in de activiteit van Fortnox ziet. Je opent haar met Hulp bij deze fout. Zoek de melding of de foutcode (bijvoorbeeld 2001103) 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 selected order type: '...' is not supported!

Oorzaak: De instelling voor het ordertype heeft een andere waarde dan Order of Invoice. Fortnox ondersteunt alleen die twee.

Oplossing:

1. Ga naar de integratie en open de flow die de fout geeft.
2. Open het tabblad Instellingen.
3. Zet What type of order should we retrieve? (bij ophalen) of What type of order should be sent? (bij versturen) op Order of Invoice en sla op.
4. Probeer het opnieuw. Zie Verkooporders ophalen uit Fortnox en Verkooporders naar Fortnox sturen.

Too many statuses in filter!

Oorzaak: Bij Process orders with states van de flow Verkooporders ophalen uit Fortnox zijn meer dan één status gekozen. Fortnox filtert op één status.

Oplossing:

1. Open het tabblad Instellingen van de flow.
2. Laat bij Process orders with states één status staan.
3. Sla op en probeer het opnieuw.

The selected filter status does not match the selected order type

Oorzaak: De gekozen status past niet bij het gekozen type. Bij orders kun je kiezen uit cancelled, expired, invoicecreated en invoicenotcreated. Bij facturen uit cancelled, fullypaid, unpaid, unpaidoverdue en unbooked.

Oplossing:

1. Open het tabblad Instellingen van de flow.
2. Kies bij Process orders with states een status die past bij de waarde van What type of order should we retrieve?, of laat de status leeg.
3. Sla op en probeer het opnieuw.

The order with order number: '...' was found! (of: The invoice with invoice number ... was found!)

Oorzaak: Fortnox heeft al een order of factuur met dezelfde referentie als de order. APIcenter maakt hem dan niet nog een keer aan, om dubbele orders te voorkomen.

Oplossing:

1. Zoek de order of factuur in Fortnox op de referentie.
2. Staat hij er al? Dan is er niets meer te doen: de order is al verwerkt.
3. Staat hij er niet, maar krijg je toch deze melding? Controleer onder Data mapping van de flow welke waarde in de referentie (YourReference) terechtkomt. Zie Verkooporders naar Fortnox 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 order is dat de referentie (YourReference). Bij een boeking zijn dat de omschrijving (Description), de boekingsdatum (TransactionDate) en per boekingsregel het type (Type), de rekening (Account) en het bedrag (Amount).

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 het opnieuw.

Failed to create customer with email: '...' (of: Failed to update customer ...)

Oorzaak: Fortnox heeft de klant van de order niet aangemaakt of bijgewerkt. Een nieuwe klant heeft in elk geval een naam (Name) nodig.

Oplossing:

1. Lees in de activiteit welke melding Fortnox bij de klant geeft.
2. Vul het ontbrekende veld in de bronapplicatie, of controleer de koppeling onder Data mapping.
3. Probeer de order opnieuw. Zie Verkooporders naar Fortnox sturen.

The Balance: '...' has a year set on it that is not present or active

Oorzaak: Er is in Fortnox geen boekjaar waar de boekingsdatum in valt.

Oplossing:

1. Controleer in Fortnox of het boekjaar bestaat.
2. Maak het boekjaar aan, of corrigeer de boekingsdatum in de bronapplicatie.
3. Probeer de boeking opnieuw. Zie Balans naar Fortnox sturen.

The Balance: '...' has a verificationseries set on it that is not present or active

Oorzaak: De verificatieserie van de boeking bestaat niet in Fortnox.

Oplossing: Controleer in Fortnox of de serie bestaat. Maak hem aan, of corrigeer de serie (VoucherSeries) in de bronapplicatie of onder Data mapping. Probeer daarna de boeking opnieuw.

The Balance: '...' has a account set on it that is not present or active

Oorzaak: Een rekening uit de boekingsregels bestaat niet in Fortnox.

Oplossing: Controleer in Fortnox of de rekening bestaat en actief is. Maak hem aan, of corrigeer het rekeningnummer in de bronapplicatie of onder Data mapping. Probeer daarna de boeking opnieuw.

The Balance: '...' has a cost center set on it that is not present or active

Oorzaak: APIcenter vindt de kostenplaats niet bij de actieve kostenplaatsen in Fortnox. APIcenter zoekt op de omschrijving van de kostenplaats, niet op de code.

Oplossing:

1. Controleer in Fortnox of de kostenplaats bestaat en actief is.
2. Zorg dat de kostenplaats in de boeking dezelfde omschrijving heeft als in Fortnox.
3. Probeer de boeking opnieuw.

Fouten van Fortnox

Fortnox geeft bij een fout een foutcode terug. Die staat in de activiteit.

2000310 of 2000311

Oorzaak: De toegangssleutel of het geheim van de koppeling ontbreekt of is onjuist.

Oplossing: Klik bij de Fortnox-verbinding op Testverbinding. Lukt dat niet, koppel Fortnox dan opnieuw. Zie Fortnox koppelen aan APIcenter en Verbinding of inloggen mislukt.

2001103

Oorzaak: Het Fortnox-account heeft geen licentie voor de API.

Oplossing: Bestel de licentie in Fortnox (bij Tillägsbeställning of Manage users) en koppel Fortnox daarna opnieuw.

2001101

Oorzaak: Er is in Fortnox geen actieve licentie voor het onderdeel dat de flow nodig heeft. Voor klanten is dat Kundfaktura of Order, voor orders Order.

Oplossing: Controleer in Fortnox of de licentie voor dat onderdeel actief is. Zie Fortnox koppelen aan APIcenter.

2000663

Oorzaak: De koppeling heeft geen toegang tot het onderdeel (scope) dat de flow nodig heeft. Een toegangssleutel houdt de rechten die gelden op het moment van activeren, ook als de rechten daarna zijn aangepast.

Oplossing: Laat een Fortnox-gebruiker met de juiste rechten de koppeling opnieuw activeren. Een boekhouder die via een digitaal kantoor inlogt, doet dat via digital byrå.

2000637

Oorzaak: Klantnummer 1 is al gebruikt en blijft gereserveerd, ook als de klant is verwijderd.

Oplossing: Gebruik een ander klantnummer voor de nieuwe klant.

2000204 of 2000433

Oorzaak: De klant uit de order bestaat niet in Fortnox.

Oplossing: Controleer het klantnummer in de gegevens. Laat APIcenter de klant aanmaken met de flow Klanten naar Fortnox sturen.

2001302 of 2000428

Oorzaak: Een artikel uit een orderregel bestaat niet in Fortnox.

Oplossing: Controleer het artikelnummer in de orderregel en maak het artikel zo nodig aan in Fortnox.

2001304

Oorzaak: Een rekening die in de gegevens staat, bestaat niet in Fortnox.

Oplossing: Controleer het rekeningnummer en maak de rekening zo nodig aan in Fortnox.

2001392, 2000588 of 2001399

Oorzaak: Fortnox weigert de gegevens: de inhoud is leeg of onjuist (2001392), een parameter is ongeldig (2000588) of een veldnaam is ongeldig (2001399).

Oplossing:

1. Lees in de activiteit welk veld Fortnox noemt.
2. Controleer onder Data mapping dat het veld naar het juiste Fortnox-veld gaat en een geldige waarde heeft.
3. Probeer het opnieuw.

429 (te veel verzoeken)

Oorzaak: Fortnox staat 300 verzoeken per minuut toe per koppeling en bedrijf. Daarboven geeft Fortnox een 429-fout.

Oplossing: Wacht even. APIcenter probeert mislukte records opnieuw. Zie Mislukte records en opnieuw proberen. Blijft het gebeuren, vul dan bij Sleep for how many millisecond between API calls een pauze in. Zie Fortnox verbindings- en integratie-instellingen.

1000003

Oorzaak: Fortnox heeft een storing.

Oplossing: Wacht en probeer het later opnieuw. Blijft de fout, neem dan contact op met Fortnox. Zie Mislukte records en opnieuw proberen.

Meer over de fouten van Fortnox staat in de lijst met fouten van Fortnox.