Intégration SmartBill

SmartBill est la principale plateforme de facturation cloud en Roumanie 🇷🇴, conçue spécifiquement pour les exigences fiscales et légales roumaines. Lorsqu'elle est configurée dans CADENSA, vous pouvez émettre des factures légalement valides (facturi fiscale) directement à partir de vos entrées de temps suivies, avec une conformité complète e-Factura / ANAF.

Pays pris en charge

SmartBill est conçu pour les entreprises enregistrées en Roumanie 🇷🇴 (avec un CIF / CUI valide). Il prend en charge les entreprises assujetties et non assujetties à la TVA.

Conformité e-Factura

La Roumanie impose la déclaration e-Factura à l'ANAF pour les transactions B2B (système RO e-Invoice). SmartBill gère automatiquement la transmission à l'ANAF lorsqu'il est configuré en conséquence dans votre compte SmartBill Cloud.

---

Avant de commencer

Vous avez besoin :

• D'un compte SmartBill Cloud actif (cloud.smartbill.ro)
• De votre token API SmartBill (voir ci-dessous)
• De votre CIF / CUI d'entreprise (code d'identification fiscal, ex. RO12345678)
• D'une unité CADENSA avec au moins le rôle Admin

---

Étape 1 — Obtenir votre token API SmartBill

1. Connectez-vous à cloud.smartbill.ro
2. Allez dans Contul Meu (menu en haut à droite)
3. Naviguez vers Integrări (Intégrations)
4. Faites défiler jusqu'à la section API
5. Copiez votre token API — ou générez-en un nouveau

Gardez votre token API secret

Ne partagez jamais votre token API et ne le commettez pas dans un système de contrôle de version. Toute personne ayant le token peut créer et gérer des factures en votre nom.

Pour la documentation officielle de l'API SmartBill, voir : api.smartbill.ro

---

Étape 2 — Configurer dans CADENSA

1. Ouvrez Paramètres → Facturation dans CADENSA
2. Sélectionnez SmartBill 🇷🇴 comme fournisseur
3. Remplissez les champs d'identifiants :

• Clé API → collez votre token API SmartBill
• E-mail du compte (Secret API) → votre adresse e-mail de connexion SmartBill
• ID entreprise → votre CIF/CUI (ex. RO12345678 ou juste 12345678)

4. Cliquez sur Tester la connexion — un vert confirme que les identifiants sont valides
5. Cliquez sur Enregistrer

Deux identifiants requis

SmartBill utilise l'authentification HTTP Basic combinant votre e-mail et votre token API. Les deux champs sont requis. Votre e-mail est stocké comme champ "Secret API" dans CADENSA.

---

Étape 3 — Configurer les valeurs par défaut

Après l'enregistrement, configurez les valeurs par défaut de facturation :

Paramètre	Valeur recommandée
Devise	RON
Taux de TVA	19% (cota normală)
Délai de paiement	30 jours

SmartBill prend en charge plusieurs taux de TVA (TVA) roumains :

Taux TVA	Nom SmartBill	Description
19%	Normala	Cota standard
9%	Redusa	Alimente, medicamente, HoReCa
5%	Redusa1	Cărți, ziare, locuințe sociale
0%	Scutit	Scutit de TVA

CADENSA sélectionne automatiquement le bon nom de TVA SmartBill en fonction du taux de TVA que vous configurez.

---

Étape 4 — Configurer les séries de factures dans SmartBill

SmartBill exige que les séries de factures soient définies dans votre compte Cloud avant d'utiliser l'API :

1. Connectez-vous à cloud.smartbill.ro
2. Allez dans Configurare → Serii
3. Assurez-vous d'avoir au moins une série active pour facturi (ex. FCT)
4. CADENSA utilise FCT comme nom de série par défaut — vous pouvez le modifier pour correspondre à votre configuration

La série doit exister dans SmartBill

Si la série FCT n'existe pas dans votre compte SmartBill Cloud, la création de facture échouera. Vérifiez toujours le nom de la série dans votre compte SmartBill.

---

Détails du client (Facturer à)

L'API REST SmartBill n'expose pas d'endpoint de liste de clients, il n'y a donc pas de sélecteur de partenaires dans la boîte de dialogue Générer une facture lorsque SmartBill est votre fournisseur actif.

Remplissez tous les champs client manuellement :

Champ	Description
Nom de l'entreprise	Requis. Raison sociale enregistrée du client
Nom du contact	Optionnel. Personne de contact individuelle
E-mail	Optionnel. Utilisé pour envoyer la facture par e-mail
Pays	Requis. Sélectionnez dans la liste déroulante de pays (code ISO, ex. RO, HU, DE)
Rue / Adresse	Requis
Code postal	Requis
Ville	Requis
TVA / Numéro fiscal	Optionnel, mais requis pour les factures d'autoliquidation UE (B2B)

Liste déroulante Pays

Le champ Pays est une liste déroulante recherchable — tapez le code ISO (RO), le nom hongrois (Románia) ou le nom anglais (Romania) pour filtrer la liste.

Les données client que vous entrez sont envoyées directement à SmartBill dans le cadre de la requête POST /invoice. SmartBill peut optionnellement enregistrer le client dans votre base de données de contacts — c'est contrôlé par le paramètre saveToDb (activé par défaut dans CADENSA).

---

Comment les factures sont créées

Lorsque vous cliquez sur Générer une facture, CADENSA :

1. Prend les détails client que vous avez saisis manuellement dans la boîte de dialogue
2. Mappe vos entrées de temps → lignes SmartBill (products)
3. Envoie POST /invoice à l'API SmartBill (y compris les infos client — SmartBill peut les sauvegarder dans votre base de données de contacts via saveToDb)
4. SmartBill attribue le prochain numéro disponible sur la série configurée
5. CADENSA stocke le {série}-{numéro} retourné comme référence externe (ex. FCT-0023)
6. Le PDF de la facture est disponible via Télécharger le PDF dans l'historique des factures

Mappage des lignes

Champ CADENSA	Champ SmartBill
Description	name
Quantité (heures)	quantity
Prix unitaire	price
Unité (heure/jour/item)	measuringUnitName (ora/zi/buc)
Taux de TVA	taxName + taxPercentage
Projet / tâche	productDescription

Tous les prix sont envoyés nets (hors TVA) — SmartBill calcule automatiquement les montants de TVA.

---

Annuler une facture

Pour annuler une facture dans CADENSA :

1. Allez dans Rapports → Historique des factures
2. Trouvez la facture et cliquez sur Annuler
3. CADENSA envoie PUT /invoice/cancel à SmartBill (annulation douce — la facture est marquée comme annulée mais reste dans le système)

Différence entre supprimer et annuler

SmartBill prend en charge à la fois la suppression (uniquement pour la dernière facture d'une série) et l'annulation (anulare, pour n'importe quelle facture). CADENSA utilise toujours l'annulation pour préserver la piste d'audit.

---

Résolution des problèmes

"401 Unauthorized"

• Vérifiez que le token API est correct et non expiré
• Vérifiez que l'adresse e-mail correspond au compte SmartBill utilisé pour générer le token
• Vérifiez que le CIF correspond exactement à l'entreprise dans votre compte SmartBill Cloud

"Serie inexistenta" (Série introuvable)

• La série par défaut FCT n'existe pas dans votre compte SmartBill
• Allez dans Configurare → Serii documente dans SmartBill Cloud et créez une série FCT (type : Factura)

"Cota TVA nu a fost gasita" (Taux de TVA introuvable)

• La combinaison de taux de TVA (nom + pourcentage) doit être définie dans Configurare → Cote TVA dans SmartBill Cloud
• Exemple : si vous utilisez 19%, assurez-vous que Normala à 19% est activé dans votre compte

"403 Forbidden" (Limite de débit)

• SmartBill limite les requêtes à 30 appels par 10 secondes. Si cette limite est dépassée, l'accès est bloqué pendant 10 minutes
• CADENSA est conçu pour rester bien dans cette limite lors d'une utilisation normale

Le test de connexion échoue mais les identifiants semblent corrects

• Assurez-vous que votre entreprise a un abonnement SmartBill Cloud actif
• Vérifiez que l'utilisateur API a les permissions nécessaires (création de factures, accès en lecture)
• Contactez le support SmartBill à api@smartbill.ro si les problèmes persistent

---

Ressources connexes

• Documentation API SmartBill
• Connexion SmartBill Cloud
• Informations e-Factura / ANAF
• Fournisseur de facturation →
• Génération de factures →

---

Besoin d'aide ?

• E-mail : support@cadensa.io