bexio API: Der komplette 2026 Guide für Schweizer Freelancer

Was ist die bexio API?

Eine API (Application Programming Interface) ermöglicht verschiedenen Softwaresystemen den automatischen Datenaustausch. Die bexio API ist eine RESTful-Schnittstelle, die bexios Kernfunktionen — Kontakte, Rechnungen, Buchhaltung, Inventar — für externe Anwendungen zugänglich macht.

In der Praxis: Statt nach Projektabschluss manuell eine Rechnung in bexio zu erstellen, kann Ihr Projektmanagement-Tool die Rechnungserstellung automatisch auslösen. Statt Kundendaten aus Ihrem Webshop zu kopieren, fliessen Bestellungen direkt in bexio.

Die API verwendet HTTPS und JSON-Format und ist damit mit jeder Programmiersprache kompatibel. bexio bietet aktuell die API-Version 3.0.0 an.

Was Sie automatisieren können

Beliebte Zapier-Automatisierungen für Freelancer

1. Shopify → bexio: Neue Bestellung erstellt automatisch Rechnung
2. Toggl → bexio: Erfasste Zeiteinträge mit Projekt synchronisieren
3. HubSpot → bexio: Neuer CRM-Kontakt erstellt bexio-Kontakt
4. Gmail → bexio: E-Mail-Anhang erstellt Spesenbeleg

Authentifizierung im Detail

bexio verwendet OAuth 2.0, den Industriestandard für API-Autorisierung. Das Verständnis des dualen Autorisierungssystems ist entscheidend.

Zwei Ebenen der Autorisierung

Ebene 1: Anwendungs-Scopes Wenn Benutzer Ihre App verbinden, gewähren sie bestimmte Berechtigungen (Scopes). Fordern Sie nur an, was Sie benötigen — Benutzer sehen diese Berechtigungen im Zustimmungsbildschirm.

Verfügbare Scope-Kategorien:

• contact_show, contact_edit — Kontaktverwaltung
• kb_invoice_show, kb_invoice_edit — Rechnungszugriff
• accounting_show — Buchhaltungsdaten lesen
• article_show, article_edit — Produktverwaltung

Ebene 2: Benutzerrechte API-Anfragen werden mit den Berechtigungen des Benutzers ausgeführt, der die Verbindung autorisiert hat. Wenn dieser Benutzer in bexio keine Berechtigung zum Löschen von Rechnungen hat, kann Ihre API auch keine Rechnungen löschen.

OAuth 2.0 Flow

1. Ihre App leitet den Benutzer weiter zu:
   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. Benutzer meldet sich an und genehmigt Berechtigungen

3. bexio leitet zu Ihrer URL mit Autorisierungscode weiter

4. Code gegen Tokens tauschen bei:
   https://auth.bexio.com/realms/bexio/protocol/openid-connect/token

5. Access Token für API-Anfragen verwenden

Token-Management:

• Access Tokens sind kurzlebig (typischerweise 1 Stunde)
• Refresh Tokens holen neue Access Tokens ohne Benutzerinteraktion
• Speichern Sie Refresh Tokens sicher und implementieren Sie automatische Token-Erneuerung

Workarounds für fehlende Webhooks

• Polling: Regelmässig auf Änderungen prüfen (alle 5-15 Minuten)
• Zapier: Nutzt Polling, übernimmt aber die Infrastruktur
• Drittanbieter-Webhook-Dienste: Einige Integrationsplattformen bieten Pseudo-Webhook-Funktionalität

Umgang mit Rate Limits

Basierend auf Community-Erfahrungen:

• Exponentielles Backoff bei 429-Fehlern implementieren
• Antworten wo möglich cachen
• Anfragen bündeln, wenn die API dies unterstützt
• Unnötig häufiges Polling vermeiden

Begrenzte Client-Bibliotheken

Offizielle SDKs existieren nicht. Community-Bibliotheken sind unvollständig. Für Produktionsanwendungen müssen Sie mit eigenem Code rechnen.

Magic Heidi Invoice API

Die Magic Heidi Swiss Invoice QR Code API ist eine offene Single-Endpoint-API zur Erstellung professioneller Schweizer Rechnungen mit QR-Einzahlungsscheinen. Kein OAuth, kein Token-Refresh, keine Scopes — nur ein API-Key und ein POST-Request.

So funktioniert es

1. Senden Sie einen POST-Request mit Ihren Rechnungsdaten (Absender, Kunde, Positionen)
2. Erhalten Sie eine PDF-Download-URL, die 24 Stunden gültig ist
3. Das war's — kein OAuth-Flow, keine Developer-Portal-Registrierung

Python-Beispiel

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']}")

JavaScript (Node.js) Beispiel

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}`);

Hauptfunktionen

• Schweizer QR-Rechnungen konform mit Schweizer Zahlungsstandards
• Mehrsprachig: Englisch, Deutsch, Französisch, Italienisch
• CHF und EUR Währungsunterstützung
• MWST-Handling mit konfigurierbaren Sätzen und MWST-Nummer
• Eigenes Logo per URL
• Nur-QR-Modus zur Erstellung des reinen Einzahlungsscheins
• Kostenloses Testen ohne API-Key
• Offene Dokumentation auf GitHub

Ressourcen

• Magic Heidi Invoice API — GitHub
• Schweizer QR-Rechnungen programmatisch erstellen — Blog-Beitrag
• bexio Developer Portal
• bexio API-Dokumentation
• bexio Statusseite
• bexio Marketplace — 120+ fertige Integrationen