API bexio : Le Guide Complet 2026 pour Indépendants Suisses

Qu'est-ce que l'API bexio ?

Une API (Application Programming Interface) permet à différents logiciels d'échanger des données automatiquement. L'API bexio est une interface RESTful qui expose les fonctionnalités principales de bexio — contacts, factures, comptabilité, inventaire — aux applications externes.

Concrètement : Au lieu de créer manuellement une facture dans bexio après avoir terminé un projet, votre outil de gestion de projet peut déclencher la création automatique de factures. Au lieu de copier les coordonnées clients depuis votre boutique en ligne, les commandes arrivent directement dans bexio.

L'API utilise HTTPS et le format JSON, ce qui la rend compatible avec tout langage de programmation. bexio propose actuellement la version 3.0.0 de l'API.

Ce que vous pouvez automatiser

Automatisations Zapier populaires pour indépendants

1. Shopify → bexio : Nouvelle commande crée une facture automatiquement
2. Toggl → bexio : Entrées de temps synchronisées au projet
3. HubSpot → bexio : Nouveau contact CRM crée un contact bexio
4. Gmail → bexio : Pièce jointe email crée une entrée de dépense

Authentification en détail

bexio utilise OAuth 2.0, le standard de l'industrie pour l'autorisation API. Comprendre le système de double autorisation est crucial.

Deux niveaux d'autorisation

Niveau 1 : Scopes de l'application Quand les utilisateurs connectent votre app, ils accordent des permissions spécifiques (scopes). Ne demandez que ce dont vous avez besoin — les utilisateurs voient ces permissions sur l'écran de consentement.

Catégories de scopes disponibles :

• contact_show, contact_edit — Gestion des contacts
• kb_invoice_show, kb_invoice_edit — Accès aux factures
• accounting_show — Lecture des données comptables
• article_show, article_edit — Gestion des produits

Niveau 2 : Droits utilisateur Les requêtes API s'exécutent avec les permissions de l'utilisateur qui a autorisé la connexion. Si cet utilisateur n'a pas le droit de supprimer des factures dans bexio, votre API ne peut pas supprimer de factures non plus.

Flux OAuth 2.0

1. Votre app redirige l'utilisateur vers :
   https://auth.bexio.com/realms/bexio/protocol/openid-connect/auth
   ?client_id=YOUR_CLIENT_ID
   &redirect_uri=YOUR_REDIRECT_URL
   &response_type=code
   &scope=contact_show kb_invoice_edit

2. L'utilisateur se connecte et approuve les permissions

3. bexio redirige vers votre URL avec le code d'autorisation

4. Échangez le code contre des tokens à :
   https://auth.bexio.com/realms/bexio/protocol/openid-connect/token

5. Utilisez l'access token pour les requêtes API

Gestion des tokens :

• Les access tokens ont une durée de vie courte (généralement 1 heure)
• Les refresh tokens obtiennent de nouveaux access tokens sans interaction utilisateur
• Stockez les refresh tokens de manière sécurisée et implémentez le rafraîchissement automatique

Solutions pour l'absence de Webhooks

• Polling : Vérifiez les changements périodiquement (toutes les 5-15 minutes)
• Zapier : Utilise le polling mais gère l'infrastructure
• Services webhook tiers : Certaines plateformes d'intégration offrent une fonctionnalité pseudo-webhook

Gérer les limites de débit

Basé sur l'expérience de la communauté :

• Implémentez un backoff exponentiel sur les erreurs 429
• Mettez en cache les réponses quand c'est possible
• Groupez les requêtes quand l'API le supporte
• Évitez une fréquence de polling excessive

Bibliothèques clientes limitées

Les SDK officiels n'existent pas. Les bibliothèques communautaires sont incomplètes. Pour les applications en production, attendez-vous à écrire du code personnalisé.

API de facturation Magic Heidi

L'API Magic Heidi Swiss Invoice QR Code est une API ouverte à endpoint unique pour générer des factures suisses professionnelles avec bulletins de versement QR. Pas d'OAuth, pas de rafraîchissement de tokens, pas de scopes — juste une clé API et une requête POST.

Comment ça fonctionne

1. Envoyez une requête POST avec vos données de facture (expéditeur, client, lignes d'articles)
2. Recevez une URL de téléchargement PDF valide 24 heures
3. C'est tout — pas de flux OAuth, pas d'inscription au portail développeur

Exemple Python

import requests

response = requests.post(
    "https://europe-west6-magic-heidi.cloudfunctions.net/create_invoice_abstract_v1d",
    headers={"key": "your_api_key"},
    json={
        "user_details": {
            "name": "Muster GmbH",
            "address": "Bahnhofstrasse 1",
            "zip": "8001",
            "city": "Zurich",
            "iban": "CH93 0076 2011 6238 5295 7"
        },
        "customer_details": {
            "name": "Acme AG",
            "address": "Bundesplatz 3",
            "zip": "3011",
            "city": "Bern"
        },
        "invoice_items": [
            {
                "description": "Web Development",
                "quantity": 10,
                "unit_price": 150
            },
            {
                "description": "Design Review",
                "quantity": 3,
                "unit_price": 120
            }
        ],
        "language": "en",
        "currency": "CHF",
        "vat_enabled": true,
        "vat_percentage": 8.1,
        "vat_number": "CHE-123.456.789 MWST"
    }
)

data = response.json()
print(f"Download your invoice: {data['url']}")

Exemple JavaScript (Node.js)

const axios = require('axios');

const response = await axios.post(
  'https://europe-west6-magic-heidi.cloudfunctions.net/create_invoice_abstract_v1d',
  {
    user_details: {
      name: 'Muster GmbH',
      address: 'Bahnhofstrasse 1',
      zip: '8001',
      city: 'Zurich',
      iban: 'CH93 0076 2011 6238 5295 7'
    },
    customer_details: {
      name: 'Acme AG',
      address: 'Bundesplatz 3',
      zip: '3011',
      city: 'Bern'
    },
    invoice_items: [
      { description: 'Web Development', quantity: 10, unit_price: 150 },
      { description: 'Design Review', quantity: 3, unit_price: 120 }
    ],
    language: 'en',
    currency: 'CHF'
  },
  { headers: { key: 'your_api_key' } }
);

console.log(`Download your invoice: ${response.data.url}`);

Fonctionnalités clés

• Factures QR suisses conformes aux standards de paiement suisses
• Multilingue : anglais, allemand, français, italien
• CHF et EUR pris en charge
• Gestion de la TVA avec taux configurables et numéro de TVA
• Logos personnalisés via URL
• Mode QR uniquement pour générer seulement le bulletin de versement
• Test gratuit sans clé API
• Documentation ouverte sur GitHub

Ressources

• API de facturation Magic Heidi — GitHub
• Générer des factures QR suisses par programmation — Article de blog
• Portail Développeur bexio
• Documentation API bexio
• Page de Statut bexio
• Marketplace bexio — 120+ intégrations pré-construites