Zum Hauptinhalt springen

SmartBill-Integration

SmartBill ist eine rumänische Rechnungsplattform, die volle e-Factura/ANAF-Konformität für den rumänischen Markt (🇷🇴) bietet.

e-Factura-Pflicht

Rumänien hat die e-Factura-Meldung an die ANAF (Nationale Steuerbehörde) für B2B-Transaktionen verpflichtend gemacht. SmartBill verwaltet die ANAF-Einreichung automatisch, wenn das SmartBill Cloud-Konto entsprechend konfiguriert ist.

Voraussetzungen​

  • Aktives SmartBill Cloud-Konto
  • SmartBill API-Token (siehe unten)
  • CIF/CUI-Steuernummer des Unternehmens
  • Mindestens ein Rechnungsbuch (FCT-Serie) muss in SmartBill konfiguriert sein
  • CADENSA Rechnungsanbieter muss konfiguriert sein

API-Token generieren​

  1. In SmartBill Cloud-Konto einloggen
  2. Contul Meu → Integrări → API öffnen
  3. „Generare token" klicken
  4. Den generierten Token kopieren
Authentifizierungsdaten

SmartBill verwendet HTTP Basic Auth:

  • API-Key (Token): Der generierte API-Token
  • API-Secret (E-Mail): Die SmartBill-Registrierungs-E-Mail-Adresse
  • Company ID (CIF): Die Steuernummer des Unternehmens (z. B. RO12345678)

SmartBill in CADENSA einrichten​

  1. Einstellungen → Rechnung öffnen
  2. SmartBill 🇷🇴 als Anbieter wählen
  3. Die Felder ausfüllen:
  • API-Key: SmartBill API-Token
  • Account-E-Mail (API-Secret): SmartBill-Registrierungs-E-Mail
  • Company ID: CIF-Steuernummer des Unternehmens (z. B. RO12345678)
  1. „Verbindung testen" klicken — prüft Token und CIF
  2. Standard-TVA-Satz einstellen:
  • 19 — Normala cota TVA (Standardsatz)
  • 9 — Redusa cota TVA (ermäßigt)
  • 5 — Redusa1 cota TVA (super-ermäßigt)
  • 0 — Scutit (steuerbefreit)
  1. „Speichern" klicken

Rumänische TVA-Sätze​

SatzRateBeschreibung
Normala19%Standardsatz — allgemeine Waren und Dienstleistungen
Redusa9%Ermäßigt — Lebensmittel, Medikamente, Hotelleistungen
Redusa15%Super-ermäßigt — Bücher, Zeitungen, Sozialwohnungen
Scutit0%Steuerbefreit — Export, bestimmte Gemeinwohlleistungen

Kundensuche​

Bei der Rechnungserstellung ermöglicht die Kundensuche das Durchsuchen von Kunden aus dem SmartBill-Konto:

  1. Im Rechnung erstellen-Dialog auf „Kunden suchen" klicken
  2. Kundennamen oder CIF-Steuernummer eingeben (mindestens 2 Zeichen)
  3. Den passenden Kunden aus der Liste auswählen
  4. Alle Kundenfelder werden automatisch ausgefüllt:
  • Firmenname, Adresse, CIF/CUI-Steuernummer
  • TVA-Pflicht-Status
Kunde nicht gefunden?

Wenn der Kunde nicht in der Liste erscheint, die Felder manuell ausfüllen. Der Kunde wird nicht automatisch in SmartBill erstellt.

Rechnungsbuch (FCT-Serie)​

SmartBill erfordert, dass jede Rechnung zu einem vorher konfigurierten Rechnungsbuch (Serie) gehört:

  • Rechnungsbücher müssen in SmartBill Cloud erstellt werden (Documente → Serii Documente)
  • Der Standardserienname ist normalerweise FCT
  • Für ANAF-Einreichungen muss die FCT-Serie verwendet werden

Wenn die Rechnungserstellung mit dem Fehler „Ungültige Serie" scheitert, die konfigurierten Serien im SmartBill-Konto prüfen.

Rechnung stornieren (anulare)​

Hinweis

SmartBill unterscheidet zwischen Stornierung (anulare) und Löschung (stergere):

  • Stornierung (anulare): Die Rechnung erhält den Status „anulata" und erscheint auch bei der ANAF — buchhalterisch endgültig
  • Löschung: Nur bei Entwurfs-Rechnungen möglich

CADENSA ruft den Stornierung (anulare)-API-Endpunkt auf: PUT /invoice/cancel.

TVA-pflichtige und nicht TVA-pflichtige Unternehmen​

Die SmartBill-Integration funktioniert in beiden Fällen:

TypBeschreibungEinstellung
TVA-pflichtigNormale TVA-Sätze anwendbarStandardkonfiguration
Nicht TVA-pflichtig0% TVA (Scutit) erforderlichStandard-Satz: 0

PDF-Download​

  1. Nach der Rechnungserstellung lädt CADENSA das PDF über die SmartBill API
  2. Der Download-Button erscheint im Tab Berichte → Rechnungen
  3. Die SmartBill API ist synchron — das PDF ist normalerweise sofort verfügbar

Fehlerbehebung​

Fehler „Ungültige Anmeldedaten"​

  • Prüfen, ob die richtige E-Mail-Adresse und der richtige API-Token angegeben wurden
  • Neuen API-Token in SmartBill generieren (Contul Meu → Integrări → API)

Fehler „Ungültige CIF"​

  • CIF-Format prüfen: RO-Präfix + Zahlen (z. B. RO12345678) oder nur Zahlen (z. B. 12345678)
  • Prüfen, ob die im ANAF-Register eingetragene CIF angegeben wurde

Fehler „Ungültige Serie"​

  • Prüfen, ob mindestens eine FCT-Serie in SmartBill eingerichtet ist
  • Documente → Serii Documente → Adaugă serie

„Verbindung testen" fehlgeschlagen​

  • Prüfen, ob das SmartBill-Konto aktiv ist
  • Alle Anmeldedaten prüfen (E-Mail, Token, CIF)

PDF wird nicht heruntergeladen​

  • 30 Sekunden später erneut versuchen
  • Falls das Problem weiterhin besteht: support@cadensa.io

Weiterführende Themen​