Alles over Bexio

Bexio: veelvoorkomende fouten

Veelvoorkomende fouten bij Bexio, zoals een onbekend product, een bestaand document of een verlopen token, met de oorzaak en de oplossing.

Bijgewerkt op 9 november 2026

Deze pagina helpt bij fouten die je in de activiteit van Bexio 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: Een orderregel heeft een artikelcode (intern_code) die niet in Bexio bestaat. APIcenter zoekt elk artikel van de order in Bexio en maakt het niet zelf aan.

Oplossing:

  1. Zoek het artikel in Bexio op de artikelcode uit de melding.
  2. Bestaat het niet? Maak het artikel aan in Bexio, of stuur het met Producten naar Bexio sturen.
  3. Bestaat het wel, maar heeft het een andere code? Controleer onder Data mapping van de flow Verkooporders naar Bexio sturen welke waarde als artikelcode wordt doorgegeven.
  4. Probeer de order opnieuw.

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

Oorzaak: Bexio heeft al een document met de orderreferentie of het documentnummer van deze order. De tekst begint met "The order", "The invoice" of "The quote", naar gelang het type document dat je hebt gekozen. APIcenter maakt het document dan niet nog een keer aan, om dubbele documenten te voorkomen.

Oplossing:

  1. Zoek het document in Bexio, bij het type document dat je hebt gekozen bij How should the order data be handled?.
  2. Staat het er al? Dan is er niets meer te doen: de order is al verwerkt.
  3. Staat het er niet, maar krijg je toch deze melding? Controleer onder Data mapping welke waarden in de orderreferentie en het documentnummer terechtkomen. Zie Verkooporders naar Bexio sturen.

Bexio failed executing getPaymentMethods

Oorzaak: De betaalmethode van de order staat niet in Bexio. APIcenter zoekt de betaalmethode in Bexio op naam. De naam moet precies overeenkomen.

Oplossing:

  1. Kijk in de activiteit welke naam APIcenter heeft gezocht.
  2. Controleer in Bexio of er een betaalmethode met precies die naam bestaat. Maak de betaalmethode aan, of pas de naam aan.
  3. Probeer de order opnieuw.

Bexio failed executing getProperties

Oorzaak: De taal van de order staat niet in Bexio. APIcenter zoekt de taal in Bexio op de taalcode (ISO 639-1, bijvoorbeeld nl).

Oplossing:

  1. Kijk in de activiteit welke taalcode APIcenter heeft gezocht.
  2. Controleer onder Data mapping van de flow Verkooporders naar Bexio sturen dat de taal een geldige taalcode van twee letters is.
  3. Probeer de order opnieuw.

Not Allowed to update Customer

Oorzaak: In de flow Klanten naar Bexio sturen bestaat de klant al in Bexio. APIcenter werkt bestaande klanten in deze flow niet bij. Dit is geen fout: de klant is niet gewijzigd.

Oplossing: Wil je de klant toch wijzigen, pas hem dan in Bexio aan.

Payment could not be registered. Missing data for invoice

Oorzaak: A payment can be added to the order when it is created. (Does noting with quotations). staat aan, maar de bronapplicatie heeft geen betaling meegestuurd. De factuur is wel aangemaakt, maar APIcenter heeft er geen betaling bij gezet.

Oplossing:

  1. Controleer onder Data mapping van de flow Verkooporders naar Bexio sturen of de velden voor de betaling zijn gevuld: bedrag, datum, betaalmethode en bankrekening.
  2. Boek de betaling zo nodig zelf in Bexio.

Not finalizing ... Order finalization setting is turned off

Oorzaak: Use order finalization staat uit. APIcenter heeft het document wel aangemaakt, maar niet afgerond. Dit is geen fout.

Oplossing: Wil je dat APIcenter het document afrondt, zet de instelling dan aan. Rond bestaande documenten zelf af in Bexio.

Fouten van Bexio

Bexio geeft bij een fout een HTTP-code en een bericht terug. Het bericht heeft de velden error_code en message.

401: ongeldige token

Oorzaak: De toegangstoken van APIcenter is ongeldig, verlopen of ingetrokken. Een Personal Access Token is 60 dagen geldig.

Oplossing:

  1. Maak, als je met een Personal Access Token werkt, op developer.bexio.com/pat een nieuw token.
  2. Vul het in bij de Bexio-verbinding in APIcenter en klik op Testverbinding.
  3. Zie ook Bexio koppelen aan APIcenter en Verbinding of inloggen mislukt.

403: geen toegang

Oorzaak: De verbinding heeft geen recht op deze gegevens. Bexio controleert twee dingen: de rechten (scopes) van de app en de rechten van de Bexio-gebruiker die de koppeling heeft gemaakt. Mist een van beide, dan geeft Bexio geen toegang.

Oplossing:

  1. Controleer of de app de rechten heeft voor de gegevens van de flow. Zie Bexio koppelen aan APIcenter.
  2. Controleer in Bexio of de gebruiker die de koppeling heeft gemaakt het recht heeft om deze gegevens te zien of te wijzigen.
  3. Klik daarna in APIcenter op Testverbinding.

404: niet gevonden

Oorzaak: Bexio kent de gevraagde gegevens niet. Het artikel, het contact of het document bestaat niet (meer).

Oplossing: Controleer in Bexio of het gegeven nog bestaat en probeer het opnieuw.

422: kan niet worden opgeslagen

Oorzaak: Bexio kan de gegevens niet opslaan. Het bericht van Bexio noemt de reden.

Oplossing:

  1. Lees in de activiteit het bericht van Bexio.
  2. Vul het genoemde veld in de bronapplicatie, of controleer de koppeling onder Data mapping.
  3. Probeer het opnieuw.

429: te veel verzoeken

Oorzaak: Bexio begrenst het aantal verzoeken dat een bedrijf per minuut mag doen. Zit je daarboven, dan geeft Bexio de code 429.

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

500 of 503: storing of onderhoud

Oorzaak: Bexio heeft een storing, of de server is tijdelijk niet beschikbaar wegens onderhoud.

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

Meer over de codes en de berichten van Bexio staat in de documentatie van de Bexio API.

Nog vragen?

Stel je vraag aan de supportassistent in je dashboard of maak een supportticket aan.

Naar support