Intégration Lexoffice
Lexoffice (Haufe Group) est une plateforme de comptabilité et de facturation en ligne pour le marché germanophone (DE / AT / CH). Lorsqu'elle est configurée dans CADENSA, vous pouvez émettre des factures légalement valides directement à partir de vos entrées de temps suivies — y compris la génération automatique d'E-Rechnung (ZUGFeRD) pour les factures B2B allemandes, obligatoire depuis 2025.
Lexoffice est conçu pour les entreprises en Allemagne 🇩🇪, Autriche 🇦🇹 et Suisse 🇨🇭.
Avant de commencer
Vous avez besoin :
- D'un compte Lexoffice actif (tout plan — l'API publique est disponible sur tous les plans payants)
- D'une clé API Lexoffice (voir ci-dessous)
- D'une unité CADENSA avec au moins le rôle Admin
Étape 1 — Obtenir votre clé API Lexoffice
- Connectez-vous à app.lexoffice.de
- Dans la barre latérale gauche, cliquez sur Erweiterungen (Extensions)
- Sous la section Weitere Apps, trouvez la carte Public API
- Cliquez sur Verwalten (Gérer)
- Cliquez sur + API-Schlüssel erstellen (Créer une clé API)
- Copiez immédiatement la clé générée — elle n'est affichée qu'une seule fois
Ne partagez jamais votre clé API et ne la commettez pas dans un système de contrôle de version. Toute personne ayant la clé peut créer et gérer des factures en votre nom.
Étape 2 — Configurer dans CADENSA
- Ouvrez Paramètres → Facturation dans CADENSA
- Sélectionnez Lexoffice 🇩🇪 comme fournisseur
- Une boîte d'information apparaîtra :
Trouvez votre clé API Lexoffice dans : Erweiterungen → Weitere Apps → Public API → Verwalten → + API-Schlüssel erstellen
- Collez votre clé API dans le champ Clé API
- Cliquez sur Tester la connexion — un
vert confirme que la clé est valide - Cliquez sur Enregistrer
Étape 3 — Configurer les valeurs par défaut
Configurez les valeurs par défaut pour que la boîte de dialogue Générer une facture soit pré-remplie avec des valeurs adaptées :
| Paramètre | Valeur recommandée (DE) | Description |
|---|---|---|
| Devise par défaut | EUR | Devise utilisée sur les nouvelles factures |
| TVA % par défaut | 19 | Taux de TVA allemand standard (réduit : 7, exonéré : 0) |
| Délai de paiement | 14 ou 30 | Jours jusqu'à la date d'échéance |
| Type de document par défaut | Facture | Présélectionne "Facture" dans la boîte de dialogue |
- Autriche : TVA standard à 20%
- Suisse : TVA standard à 8,1%
Émettre une facture via Lexoffice
Une fois configuré, suivez le flux standard de génération de factures :
- Ouvrez Rapports → appliquez des filtres de plage de dates et de projet
- Cliquez sur Générer une facture
- Dans le champ Type de document, sélectionnez Facture — le canal de sortie affiche
Lexoffice - (Optionnel) Utilisez le sélecteur de partenaires pour sélectionner un client depuis votre carnet d'adresses Lexoffice
- Remplissez les détails du client, TVA % et date d'échéance
- Cliquez sur Aperçu de la facture → vérifiez les lignes et les totaux
- Cliquez sur Émettre la facture (Lexoffice)
CADENSA envoie la facture à l'API Lexoffice, reçoit le numéro de facture et télécharge le PDF.
- Une nouvelle facture est créée à l'état brouillon, puis immédiatement finalisée (ce qui attribue le numéro de facture)
- Les factures finalisées apparaissent dans votre liste de factures Lexoffice
- Les factures B2B allemandes incluent automatiquement une pièce jointe XML ZUGFeRD / E-Rechnung
Sélecteur de partenaires
Lorsque Lexoffice est configuré, la boîte de dialogue Générer une facture affiche un sélecteur de partenaires — une liste déroulante recherchable de vos contacts Lexoffice.
Sélectionner un contact remplit automatiquement :
- Nom de l'entreprise
- Nom du contact
- Rue, code postal, ville, pays
- Numéro fiscal (Steuernummer / USt-IdNr.)
Cela évite de ressaisir les données client pour les factures récurrentes. Les contacts sont récupérés en direct depuis l'API Lexoffice /contacts (rôle client uniquement).
Taux de TVA
Lexoffice impose des taux de TVA valides spécifiques :
| Taux | Cas d'utilisation |
|---|---|
| 19% | TVA allemande standard (Regelsteuersatz) |
| 7% | TVA allemande réduite (ermäßigter Steuersatz) |
| 0% | Exonéré de TVA, livraison intracommunautaire, pays tiers |
Si vous entrez un taux de TVA autre que 0, 7 ou 19, CADENSA arrondit automatiquement à la valeur Lexoffice valide la plus proche. Utilisez 0 pour les factures sans TVA (ex. Kleinunternehmerregelung § 19 UStG).
Routage des documents
| Type de document | Sortie |
|---|---|
| Proforma | PDF interne (jamais envoyé à Lexoffice) |
| Résumé de travail | PDF interne (jamais envoyé à Lexoffice) |
| Facture | Envoyé à l'API Lexoffice → PDF retourné |
Seuls les documents de type Facture sont envoyés à Lexoffice. Les Proformas et Résumés de travail sont toujours générés en interne.
Historique des factures et téléchargement PDF
Après une création de facture réussie :
- La facture apparaît dans Facturation → Historique des factures dans CADENSA
- La facture apparaît également dans votre compte Lexoffice sous Umsätze → Ausgangsrechnungen
- Vous pouvez re-télécharger le PDF à tout moment depuis l'un ou l'autre endroit
Résolution des problèmes
Erreur "401 Unauthorized"
La clé API est invalide ou a été révoquée.
Correction : Générez une nouvelle clé API dans Lexoffice (Erweiterungen → Public API → + API-Schlüssel erstellen) et re-saisissez-la dans CADENSA.
Erreur "INVOICE_NO_ENTRIES"
Aucune entrée de temps n'a été trouvée pour la plage de dates et les filtres de projet sélectionnés.
Correction : Ajustez la plage de dates ou le filtre de projet et réessayez.
Facture bloquée en brouillon / pas de numéro de facture
Lexoffice exige que les factures soient finalisées avant qu'un numéro soit attribué. CADENSA finalise la facture immédiatement à la création (?finalize=true). Si la finalisation échoue (ex. champs requis manquants), la facture peut rester en brouillon.
Correction :
- Connectez-vous à Lexoffice et vérifiez Umsätze → Ausgangsrechnungen pour les brouillons
- Vérifiez les champs manquants (généralement : code pays ou numéro de TVA)
- Complétez la facture manuellement dans Lexoffice, ou supprimez-la et réessayez depuis CADENSA avec des détails client complets
Le téléchargement PDF prend beaucoup de temps
Lexoffice génère les PDFs de manière asynchrone. CADENSA interroge l'API pendant 30 secondes maximum en attendant le PDF. Si le PDF n'est pas prêt à temps, une erreur est affichée.
Correction : Attendez un moment et re-téléchargez depuis Facturation → Historique des factures.
Taux de TVA non accepté
Lexoffice accepte uniquement 0, 7 et 19 comme taux de taxe valides.
Correction : Dans la boîte de dialogue Générer une facture, utilisez l'une de ces valeurs dans le champ TVA %.
Code pays du client non reconnu
Lexoffice nécessite un code pays ISO 3166-1 alpha-2 valide (ex. DE, AT, CH, US). Les noms de pays en texte libre sont convertis automatiquement, mais les noms inhabituels peuvent échouer.
Lexoffice vs. Billingo
| Fonctionnalité | Lexoffice 🇩🇪 | Billingo 🇭🇺 |
|---|---|---|
| Marché | DE / AT / CH | Hongrie |
| Standard légal | ZUGFeRD / E-Rechnung | NAV Online Számla 3.0 |
| Authentification | Bearer token (clé API) | Clé API (v3) |
| Mode sandbox |  Non disponible | Disponible |
| Sélecteur de partenaires | Endpoint /contacts | Endpoint /partners |
| Génération PDF | Asynchrone (polling) | Synchrone |
| Finalisation de facture | Explicite (?finalize=true) | Automatique |
Ressources connexes
- Documentation API Lexoffice
- Connexion Lexoffice
- Fournisseur de facturation →
- Génération de factures →
Besoin d'aide ?
- E-mail : support@cadensa.io