Paramètres du fournisseur de facturation
Chemin : Paramètres → Facture
Configurez le fournisseur utilisé par CADENSA lorsque vous générez des factures à partir des entrées de temps.
Le PDF interne est disponible sur tous les plans (FREE/PRO/ENTERPRISE). Les fournisseurs de facturation externes (Billingo, Lexoffice, Pennylane, Holded, SmartBill) nécessitent un plan PRO ou ENTERPRISE.
Fournisseurs
PDF interne (par défaut)
Aucune intégration externe requise. CADENSA génère localement un document PDF à votre marque.
Fonctionne immédiatement — aucune clé API nécessaire- Adapté aux proformas et aux résumés de travail
N'est pas une facture fiscale légalement valide- Aucune conformité NAV / facture électronique
Billingo
Billingo est une plateforme de facturation en ligne hongroise, conforme à NAV Online Számla 3.0.
- Facture fiscale hongroise légalement valide
- Conforme NAV Online Számla 3.0
- Synchronisation de la liste des partenaires — sélectionnez des clients depuis votre carnet d'adresses Billingo
- Numéro de facture automatique depuis Billingo
- PDF estampillé avec le numéro de facture Billingo
- Requiert : clé API Billingo (v3)
- 📖 Guide de configuration Billingo
Lexoffice
Plateforme de facturation allemande (groupe Haufe) prenant en charge ZUGFeRD / E-Rechnung.
- Facture légalement valide en Allemagne / Autriche / Suisse
- ZUGFeRD / E-Rechnung (obligatoire pour le B2B allemand à partir de 2025)
- Synchronisation de la liste de contacts — sélectionnez des clients depuis votre carnet Lexoffice
- Numéro de facture automatique depuis Lexoffice
- Requiert : clé API Lexoffice (jeton Bearer)
- 📖 Guide de configuration Lexoffice
Pennylane
Plateforme de facturation française prenant en charge Factur-X (PDF/A-3 avec XML intégré), ciblant les marchés FR, BE, LU, CH.
- Facture française légalement valide (Factur-X)
- Factur-X obligatoire à partir de 09/2026 (grandes entreprises) — déploiement progressif jusqu'en 2027
- Recherche ou création automatique de clients
- Codes de taux de TVA français (20 % / 10 % / 5,5 % / exonéré)
- Mode brouillon — crée d'abord des brouillons, finalise à la demande
- Pas d'environnement de test — utilisez le mode brouillon pour tester
- Requiert : jeton API Pennylane (Bearer)
- 📖 Guide de configuration Pennylane
Holded
Plateforme de facturation espagnole prenant en charge la facturation électronique FacturaE, ciblant les marchés ES, PT, IT, FR, DE.
- Facture espagnole légalement valide (compatible FacturaE)
- Recherche ou création automatique de contacts (par numéro de TVA ou nom)
- Correspondance des taux d'IVA espagnols (21 % / 10 % / 4 % / exonéré)
- Factures multilingues (ES, EN, FR, DE, PT)
- Annulation de facture via l'API Holded
- Pas d'environnement de test — utilisez des contacts de test pour le développement
- Requiert : clé API Holded
- 📖 Guide de configuration Holded
SmartBill
Plateforme de facturation roumaine conforme e-Factura / ANAF, conçue pour les entreprises enregistrées en Roumanie.
- Facture roumaine légalement valide (factură fiscală)
- Conformité e-Factura / ANAF (transmission B2B obligatoire de la facture électronique)
- Correspondance des taux de TVA roumains (
Normala19 % /Redusa9 % /Redusa15 % /Scutit0 %) - Annulation de facture (anulare) via l'API SmartBill
- Pas de sélecteur de partenaires — l'API REST de SmartBill n'a pas de point de terminaison de liste de clients ; remplissez les champs client manuellement
- Pas de mode sandbox — utilisez une série de factures de test dans SmartBill Cloud pour le développement
- Requiert : jeton API SmartBill + e-mail du compte + CIF/CUI de l'entreprise
- 📖 Guide de configuration SmartBill
Autres fournisseurs
| Fournisseur | Marché | Statut |
|---|---|---|
| Számlázz.hu | Hongrie (NAV) | Bientôt disponible |
| Fakturoid | République tchèque / Slovaquie | Bientôt disponible |
| Moneybird | Pays-Bas (Peppol) | Bientôt disponible |
| e-conomic | Danemark / Norvège / Suède | Bientôt disponible |
Configuration de Billingo
1. Obtenir votre clé API Billingo
- Connectez-vous sur app.billingo.hu
- Allez dans Integráció → API dans le menu
- Cliquez sur + Új API kulcs létrehozása (Créer une nouvelle clé API)
- Copiez la clé API v3 générée
Gardez votre clé API secrète. Ne la partagez pas et ne la committez pas dans un système de contrôle de version.
2. Configurer dans CADENSA
- Ouvrez Paramètres → Facture dans CADENSA
- Sélectionnez Billingo comme fournisseur
- Collez votre clé API dans le champ Clé API
- Cliquez sur « Tester la connexion » — le bouton Enregistrer ne devient actif qu'après un test réussi (✓ vert)
- (Optionnel) Activez le mode Sandbox pour tester sans émettre de vraies factures
- Cliquez sur « Enregistrer »
Le bouton Enregistrer reste désactivé tant que le test de la clé API n'a pas réussi. Une clé échouée ou non testée ne peut pas être enregistrée. Cela évite qu'une intégration mal configurée ne bloque silencieusement la génération de factures.
3. Définir les valeurs par défaut
Configurez des valeurs par défaut pertinentes pour que la boîte de dialogue de génération de facture soit pré-remplie :
| Paramètre | Description |
|---|---|
| Devise par défaut | Devise utilisée sur les nouvelles factures (ex. HUF, EUR) |
| TVA % par défaut | Taux de taxe pré-rempli dans la boîte de dialogue (ex. 27 pour la Hongrie) |
| Délai de paiement (jours) | Nombre de jours jusqu'à la date d'échéance (ex. 30) |
| Type de document par défaut | Type de document présélectionné (proforma / résumé de travail / facture) |
| Pays de l'émetteur | Le pays de votre entreprise en code ISO 3166-1 alpha-2 (ex. HU, DE, AT). Requis pour la suggestion automatique de TVA (autoliquidation, détection d'exportation). |
Le champ Pays de l'émetteur active les suggestions intelligentes de TVA dans la boîte de dialogue de génération de facture. Sans ce champ, CADENSA applique par défaut le taux de TVA domestique de l'acheteur pour toutes les transactions.
4. Configurer les paramètres spécifiques à Billingo
| Paramètre | Description |
|---|---|
| ID du bloc de factures | Bloc de factures Billingo à utiliser (Billingo → Paramètres → Blocs) |
| ID du compte bancaire | Votre ID de compte bancaire Billingo (optionnel — apparaît sur la facture) |
| Méthode de paiement | Méthode de paiement par défaut sur les factures émises |
| Langue | Langue de la facture (hu, en, de, …) |
5. (Optionnel) Configurer les informations de l'émetteur
La section émetteur (les informations de votre entreprise) sur le PDF provient de Paramètres de l'espace de travail → Facturation :
- Nom de l'entreprise
- Rue, ville, code postal, pays
- Numéro de TVA / d'identification fiscale
- E-mail de facturation
Le champ Pays de l'émetteur (configuré sur cette même page de paramètres) est également utilisé pour la suggestion automatique du taux de TVA dans la boîte de dialogue de génération de facture — il est distinct du pays de l'adresse de facturation.
Routage par type de document
| Type de document | Paramètre du fournisseur | Résultat |
|---|---|---|
| Proforma | PDF interne uniquement | PDF interne |
| Résumé de travail | PDF interne uniquement | PDF interne |
| Facture | PDF interne | PDF interne |
| Facture | Billingo | Envoyé à l'API Billingo → PDF retourné |
| Facture | Lexoffice | Envoyé à l'API Lexoffice → PDF retourné |
| Facture | Pennylane | Envoyé à l'API Pennylane → PDF retourné |
| Facture | Holded | Envoyé à l'API Holded → PDF retourné |
| Facture | SmartBill | Envoyé à l'API SmartBill → PDF retourné |
Lorsqu'un fournisseur externe (Billingo, Lexoffice, etc.) est sélectionné, le sélecteur de type de document passe automatiquement à Facture légale, et les options Proforma / Résumé de travail deviennent indisponibles. Ces types de documents ne sont pris en charge que par le fournisseur PDF interne.
Comparaison des fournisseurs
| Fonctionnalité | PDF interne | Billingo 🇭🇺 | Lexoffice 🇩🇪 | Pennylane 🇫🇷 | Holded 🇪🇸 | SmartBill 🇷🇴 |
|---|---|---|---|---|---|---|
| Marché | Tous | Hongrie | DE / AT / CH | FR / BE / LU / CH | ES / PT / IT | Roumanie |
| Facture légale | | NAV 3.0 | ZUGFeRD / E-Rechnung | Factur-X | FacturaE | e-Factura / ANAF |
| Clé API requise | | | | | | |
| Mode sandbox | — | | | (utiliser le mode brouillon) | (utiliser des contacts de test) | (utiliser une série de test) |
| Sélecteur de partenaires | | | | (recherche/création auto) | (recherche/création auto) | (pas de point de terminaison API) |
| Guide de configuration | — | Guide Billingo | Guide Lexoffice | Guide Pennylane | Guide Holded | Guide SmartBill |
Tester la connexion
Utilisez le bouton « Tester la connexion » après avoir saisi les identifiants. CADENSA appelle l'API du fournisseur et vérifie :
- Que la clé API est valide
- Que le compte est actif
- Que les permissions requises sont disponibles (lecture + écriture des factures)
Un test réussi affiche :
✓ Connexion réussie — Compte Billingo : Votre Entreprise Kft.
Un test échoué affiche la raison de l'échec (clé invalide, expirée, permission refusée, etc.).
Le bouton Enregistrer reste désactivé tant que le test de connexion n'a pas réussi. Vous ne pouvez pas enregistrer une clé API non testée ou en échec. Si vous ne modifiez que d'autres paramètres (devise, % de TVA, conditions de paiement) sans ressaisir la clé, aucun nouveau test n'est nécessaire.
Dépannage
Erreur « INVOICE_NO_BILLABLE_ITEMS »
Toutes les lignes de la plage de dates sélectionnée ont amount = 0. Cela se produit lorsqu'aucun taux horaire n'est configuré pour vos projets.
Solution : Allez dans Paramètres → Taux et configurez des taux horaires pour vos projets.
Erreur « Partner not found »
Les informations du client saisies ne correspondent à aucun partenaire Billingo existant, et la création automatique a échoué.
Solution : Créez d'abord le partenaire manuellement dans Billingo, puis utilisez le sélecteur de partenaires dans la boîte de dialogue de génération de facture.
Le PDF n'a pas de numéro de facture
L'appel à l'API Billingo a réussi, mais la régénération du PDF avec le numéro de facture externe a échoué. Le PDF d'origine (sans numéro) a été conservé.
Solution : Retéléchargez le PDF depuis Facturation → Historique des factures — l'enregistrement stocké contient le numéro de facture correct.
Mode Sandbox
Activez le Sandbox dans les paramètres du fournisseur pour tester sans émettre de vraies factures. Les factures en mode sandbox n'apparaissent ni à la NAV ni dans votre liste officielle de factures Billingo.
Intégrations à venir
Les intégrations suivantes sont en cours de développement :
- Számlázz.hu — Système hongrois NAV Online Számla (alternative à Billingo)
- Fakturoid — République tchèque et Slovaquie
- Moneybird — Pays-Bas et Belgique
- e-conomic — Scandinavie (Danemark, Suède, Norvège)
Si une intégration spécifique vous intéresse, contactez-nous à support@cadensa.io.