Brancher bexio sur vos outils, ce que son interface documente vraiment

L'interface REST 2.0 de bexio, lue avant d'être branchée

L'interface s'appelle depuis une racine unique, https://api.bexio.com/2.0/, et échange du JSON. L'authentification suit OAuth 2.0 avec OpenID Connect, sur le domaine d'autorisation https://auth.bexio.com/realms/bexio, en flux Authorization Code puis Refresh Token quand une application agit au nom d'un utilisateur. Pour une passerelle qui tourne seule sur un serveur, la documentation de l'éditeur, consultée le 23 août 2026, décrit également des jetons d'accès personnels. Les deux voies n'ouvrent pas le même chemin, et le choix se fait avant la première ligne de code.

Ce choix a des conséquences concrètes. Un jeton personnel est rattaché à un utilisateur du compte bexio et convient à une liaison serveur à serveur qui ne concerne qu'une seule entreprise. Le flux Authorization Code convient à une application appelée à servir plusieurs comptes bexio, chacun donnant son accord de son côté. La documentation publique décrit les deux, ainsi que la mécanique de rafraîchissement des jetons, ce qui permet d'estimer le travail avant de s'engager.

Détail qui a son importance sur la durée, le numéro de version figure dans la racine même de l'interface. Une passerelle est donc écrite contre une version nommée, et non contre une adresse anonyme qui bougerait sans prévenir. C'est le genre de point qu'on note au moment de la conception et qu'on relit trois ans plus tard, quand personne dans l'entreprise ne se souvient de qui a construit quoi.

Les portées décrivent, objet par objet, ce que la passerelle a le droit de voir

bexio découpe les droits d'une application en portées granulaires, une par objet et par niveau d'action. La documentation nomme par exemple contact_show pour la lecture des contacts, kb_invoice_edit pour l'écriture sur les factures, project_show pour les projets. Une passerelle bien conçue ne demande que ce dont elle a besoin, et cette demande se relit plus tard, en clair, le jour où une question se pose sur ce qu'un automate a pu modifier dans le dossier.

C'est aussi le premier arbitrage d'un projet d'intégration. Une liaison en lecture seule vers un tableau de bord ne réclame pas les mêmes portées qu'un automate qui crée des factures depuis une boutique en ligne. Élargir le périmètre plus tard touche l'autorisation elle-même, donc la validation par la personne qui détient le compte. Autant poser la liste dès le cadrage, avec la raison d'être de chaque ligne.

Cinq cents éléments par requête, et une limitation de débit à mesurer

La documentation annonce une pagination plafonnée à 500 éléments par requête et une limitation de débit appliquée aux appels. Le premier chiffre dimensionne toute reprise de données. Une base de plusieurs milliers de contacts, d'articles ou de factures se relit par tranches, avec un curseur tenu du côté de l'intégrateur, et cette découpe se retrouve dans chaque resynchronisation ultérieure, pas seulement le jour de la mise en route.

Le second chiffre ne se lit nulle part sous forme de seuil dans les pages consultées le 23 août 2026. Il se constate en conditions réelles, sur le compte concerné, en observant le comportement des appels quand la cadence monte. Un chantier sérieux commence donc par une mesure plutôt que par une hypothèse, et la cadence retenue s'écrit dans la recette, avec la conduite à tenir lorsque l'interface refuse un appel.

Sans webhook documenté, la fraîcheur des données devient un réglage

La documentation publique lue le 23 août 2026 ne comporte aucune section consacrée aux webhooks ni à un mécanisme d'événements. Toute synchronisation avec un autre outil se construit donc en interrogation périodique. Le point sensible n'est pas la richesse de l'interface, c'est la cadence à laquelle on décide de la questionner.

Cette contrainte se traite. On tient du côté de l'intégrateur la trace de ce qui a déjà été vu, on rejoue les appels sans créer de doublon quand une exécution s'interrompt à mi-parcours, et on choisit une fréquence différente selon les objets. Un catalogue d'articles ne bouge pas au même rythme qu'un journal de factures. La conception de cette mécanique représente une part réelle du travail, et elle mérite d'être décrite noir sur blanc avant la commande.

Il y a une conséquence visible pour les utilisateurs. Une facture créée dans la boutique n'apparaît pas dans bexio à la seconde, elle apparaît au cycle suivant. Ce délai se choisit, se documente et se montre aux personnes concernées, plutôt que d'être découvert un lundi matin par le comptable qui cherche une pièce. C'est une décision de gestion autant qu'un paramètre technique.

Tout ne passe pas par l'interface, et certains flux ont leur propre canal

Pour la reprise initiale, bexio documente des imports par fichiers Excel ou CSV pour les contacts, les produits et le plan comptable, décrits dans les articles d'aide 000001781 et 000001598. Une limite de 15'000 lignes est rapportée pour l'import de produits. Ce canal reste souvent le plus court pour charger un existant, l'interface prenant ensuite le relais pour la vie courante des données.

Côté banque, la reprise des données de comptes et de transactions passe par bLink, la plateforme de SIX. Les paiements depuis bexio relèvent de bexio Pay, facturé CHF 14.00 par mois et inclus dans le forfait Ultimate. Les salaires sortent par Swissdec vers les assurances et les autorités, le produit bexio Lohnbuchhaltung figurant au registre officiel en ELM 5.0, 5.1 et 5.3 sous le certificat n° 1142.24. La QR-facture, elle, est générée nativement.

Deux flux méritent une vérification en amont. L'envoi de factures dans l'e-banking du destinataire par eBill passe par une application tierce du Marketplace, eBill de iomarket AG, facturée en sus. Et bexio ne figure pas dans la liste OpenPeppol des Certified Service Providers, mise à jour le 21 août 2026. Une entreprise qui doit facturer un donneur d'ordre exigeant Peppol regarde ailleurs pour ce canal précis, et le sait avant de signer.

Le Marketplace couvre un cas connu, une passerelle couvre le vôtre

Le Marketplace de bexio annonce plus de cent applications, du commerce en ligne à la gestion documentaire. Quand une application publiée correspond exactement au besoin, c'est le chemin le plus court, et il se teste avant tout développement. Le sur-mesure commence ailleurs, là où il faut apparier des identifiants clients entre deux systèmes, appliquer une règle propre à la maison, ou relier un outil métier interne que personne d'autre n'utilise.

Une passerelle a besoin d'un accès au compte, et cet accès se compte. Les forfaits publiés au 23 août 2026 incluent un nombre d'utilisateurs fixe, et le prix d'un accès supplémentaire est publié pour une partie d'entre eux. L'arbitrage se pose au moment de décider si l'automate travaille sous un compte technique dédié, ce qui rend les traces lisibles, ou sous le compte d'une personne, ce qui les mélange avec son travail quotidien.

Entre les deux options, le critère utile est la durée de vie. Une application du Marketplace est un contrat avec un tiers, avec son propre rythme de mises à jour et son propre support. Une passerelle écrite pour l'entreprise suit les portées et la cadence qu'on lui a fixées, et son code appartient au dossier. Les deux se justifient, et le choix se pose flux par flux, pas une fois pour toutes.

La sortie des données se prépare le jour où l'on entre

L'aide de l'éditeur documente des exports en PDF et en Excel ainsi qu'une fonction de sauvegarde. Aucun export complet de la base sous forme de fichier unique n'est documenté dans les pages consultées le 23 août 2026. Dans ce contexte, l'interface elle-même devient un moyen de relecture, et les portées accordées à la passerelle déterminent ce qu'elle peut effectivement reprendre. La question se pose au démarrage d'un projet, pas le jour où l'on souhaite partir.

Un dernier repère utile. Le programme partenaire officiel de bexio s'adresse aux fiduciaires, l'annuaire public annonçant plus de 1'000 sociétés fiduciaires et des statuts allant d'Argent à Platine. Pour la partie technique, l'entreprise s'appuie sur la documentation publique et sur qui sait la lire. Nous ne vendons aucune licence.

• Les objets à synchroniser, et le sens de circulation de chacun
• Les portées strictement nécessaires, lecture et écriture séparées
• La voie d'accès retenue, jeton personnel ou flux OAuth complet
• La cadence de sondage, mesurée sur le compte réel avant d'être figée
• Le compte sous lequel la passerelle travaille, et ce qu'il coûte
• Ce qui doit pouvoir ressortir un jour, et par quel canal

D'où viennent ces réponses

Chaque fait de cette page se vérifie à la source. Les liens ouvrent directement le site de l'éditeur ou de l'organisme concerné.

• bexio, forfaits et prixNoms et prix des quatre forfaits, utilisateurs inclus et prix d'un accès supplémentaire, consultés le 23.08.2026
• Documentation de l'interface bexioRacine api.bexio.com/2.0, OAuth 2.0 et OpenID Connect, jetons d'accès personnels, portées, pagination à 500, limitation de débit, aucune section webhook
• bexio, la QR-factureGénération native de la QR-facture suisse et rapprochement des paiements
• bexio, la facture électroniqueeBill par l'application tierce iomarket AG du Marketplace, facturée en sus
• Registre Swissdec des logiciels certifiésbexio Lohnbuchhaltung certifié ELM 5.0, 5.1 et 5.3, certificat n° 1142.24
• Liste OpenPeppol des Certified Service ProvidersListe mise à jour le 21.08.2026, sans entrée bexio
• Politique de confidentialité de bexioDonnées personnelles des clients stockées et traitées exclusivement en Suisse, serveurs situés en Suisse
• Communiqué de bexio du 18 février 2026100'000 clients, filiale à 100 % de la Mobilière, nouveaux forfaits dès mars 2026
• inside-it, bexio annonce 100'000 clientsMise en perspective par la presse informatique suisse, Swiss21 plus de 80'000 et KLARA 50'000
• Annuaire des fiduciaires partenaires de bexioProgramme partenaire réservé aux fiduciaires, plus de 1'000 sociétés listées, statuts d'Argent à Platine
• inside-it, la Mobilière reprend bexioAnnonce du rachat le 05.07.2018, 100 % des actions

RELEVÉ DU 23.08.2026

Questions fréquentes