Intégration Billingo
Billingo est une plateforme de facturation en ligne hongroise conforme à NAV Online Számla 3.0. Une fois configurée dans CADENSA, vous pouvez émettre des factures fiscales hongroises légalement valides directement depuis vos entrées de temps — avec déclaration NAV automatique et synchronisation de votre carnet d'adresses Billingo.
Prérequis
- Un compte Billingo actif (avec accès API)
- Une clé API Billingo v3 (voir ci-dessous)
- Au moins un bloc de facturation (számlablokk) configuré dans Billingo
- Rôle Admin minimum sur l'unité CADENSA
Étape 1 — Obtenir votre clé API Billingo
- Connectez-vous sur app.billingo.hu
- Dans le menu gauche, cliquez sur Beállítások (Paramètres)
- Cliquez sur API dans le menu des paramètres
- Cliquez sur + Új API kulcs létrehozása (Créer une nouvelle clé API)
- Donnez un nom à la clé (ex.
CADENSA) - Copiez la clé générée immédiatement — elle n'est affichée qu'une seule fois
Ne partagez jamais votre clé API et ne la committez pas dans votre gestionnaire de versions. Toute personne disposant de cette clé peut créer des factures en votre nom.
Étape 2 — Configurer dans CADENSA
- Ouvrez Paramètres → Facture dans CADENSA
- Sélectionnez Billingo 🇭🇺 comme fournisseur
- Un message d'information apparaît :
Trouvez votre clé API Billingo sur : app.billingo.hu → Beállítások → API → API kulcs létrehozása
- Collez votre clé API dans le champ API Key
- Cliquez sur Tester la connexion — un
vert confirme la validité - Cliquez sur Enregistrer
Le bouton Enregistrer reste désactivé jusqu'à ce que le test de connexion réussisse.
Étape 3 — Définir les valeurs par défaut
| Paramètre | Valeur recommandée (HU) | Description |
|---|---|---|
| Devise par défaut | HUF | Devise utilisée sur les nouvelles factures |
| TVA % par défaut | 27 | Taux standard hongrois (ÁFA) |
| Délai de paiement (jours) | 8 ou 30 | Jours avant échéance |
| Type de document par défaut | Facture | Pré-sélectionné dans le dialogue de génération |
| Pays de l'émetteur | HU | Code pays ISO 3166-1 alpha-2 de votre entreprise |
Étape 4 — Paramètres spécifiques à Billingo
| Paramètre | Description |
|---|---|
| ID du bloc de facturation | Le bloc de facturation Billingo à utiliser. CADENSA sélectionne automatiquement le premier bloc actif si ce champ est vide. Pour un bloc spécifique, entrez l'ID depuis Billingo → Beállítások → Bizonylattömbök. |
| ID du compte bancaire | Optionnel. L'ID de votre compte bancaire Billingo — apparaît sur la facture. |
| Mode de paiement | Mode de paiement par défaut (wire_transfer, cash, bankcard, etc.). |
| Langue de la facture | Langue d'émission (hu, en, de, fr, etc.). |
Étape 5 — (Optionnel) Mode Sandbox / Test
Activez le mode Sandbox pour tester la génération de factures sans émettre de vraies factures déclarées à NAV. Les factures sandbox :
- N'apparaissent pas dans votre liste officielle Billingo
- Ne sont pas déclarées à NAV
- Sont ignorées après les tests
Interrupteur : Paramètres → Facture → Sandbox / Mode test
Émettre une facture via Billingo
- Ouvrez Rapports → définissez la plage de dates et les filtres de projet
- Cliquez sur Générer une facture
- Dans le champ Type de document, sélectionnez Facture — le canal de sortie affiche
Billingo - (Optionnel) Utilisez le sélecteur de partenaire pour choisir un client depuis votre carnet Billingo
- Remplissez les coordonnées client, le taux de TVA et la date d'échéance
- Cliquez sur Aperçu → vérifiez les lignes et les totaux
- Cliquez sur Émettre la facture (Billingo)
- Une nouvelle facture est créée et immédiatement finalisée (ce qui attribue le numéro de facture Billingo)
- La facture est automatiquement déclarée à NAV Online Számla 3.0
- La facture apparaît dans Billingo sous Számlák → Kimenő számlák
Sélecteur de partenaire
Quand Billingo est configuré, le dialogue de génération affiche un sélecteur de partenaire — une liste déroulante searchable de vos contacts Billingo.
La sélection d'un contact pré-remplit automatiquement :
- Nom de l'entreprise
- Adresse (rue, code postal, ville, pays)
- Numéro de TVA
- Adresse e-mail
Si le client n'existe pas dans votre carnet Billingo, CADENSA le crée automatiquement.
Taux de TVA
| Taux | Utilisation |
|---|---|
| 27% | TVA standard hongroise (ÁFA) |
| 5% | Taux réduit (certains aliments, médicaments) |
| 0% | Exonéré, livraison intracommunautaire, export |
| AAM | Exonération générale |
| TAM | Exonération objective |
| EU | Livraison intracommunautaire de biens |
| F.AFA | Autoliquidation (reverse charge) |
| K.AFA | TVA sur encaissement |
| KBAUK | Export hors UE |
Factures en devise étrangère
Billingo fonctionne nativement en HUF. Pour les factures en autres devises (EUR, USD, GBP, etc.) :
- CADENSA récupère automatiquement le taux de change HUF actuel depuis l'API Frankfurter (données BCE)
- Le taux de change (
conversion_rate) est inclus dans la requête comme exigé par Billingo - Le taux est enregistré dans le dossier de facture CADENSA à des fins d'audit
Annulation de facture (Storno)
Pour annuler une facture Billingo depuis CADENSA :
- Ouvrez Facturation → Historique des factures
- Trouvez la facture et cliquez sur Annuler la facture
- Confirmez l'annulation
CADENSA appelle POST /documents/{id}/cancel. Une facture d'annulation est automatiquement créée dans Billingo et déclarée à NAV.
Les factures annulées ne peuvent pas être restaurées.
Dépannage
« Clé API invalide » / 401 Unauthorized
La clé API est invalide, expirée ou révoquée.
Solution : Générez une nouvelle clé dans Billingo (Beállítások → API → + Új API kulcs) et saisissez-la à nouveau dans CADENSA.
« Aucun bloc de facturation trouvé »
Aucun bloc de facturation configuré dans Billingo.
Solution : Dans Billingo, allez dans Beállítások → Bizonylattömbök et créez au moins un bloc actif.
Erreur « INVOICE_NO_BILLABLE_ITEMS »
Toutes les lignes ont amount = 0 — aucun taux horaire configuré.
Solution : Ouvrez Paramètres → Tarifs et configurez des taux horaires pour vos projets.
Pages associées
- Paramètres du fournisseur de facturation — comparer tous les fournisseurs, configurer la clé API et les valeurs par défaut
- Génération de factures — générer des factures depuis les entrées de temps
- Plans d'abonnement — quel plan CADENSA est nécessaire