Zum Hauptinhalt springen

Billingo-Integration

Billingo ist eine ungarische Online-Rechnungsplattform, die mit NAV Online Számla 3.0 konform ist. Wenn sie in CADENSA konfiguriert ist, können Sie direkt aus Ihren erfassten Zeiteinträgen rechtsgültige ungarische Steuerrechnungen ausstellen — mit automatischer NAV-Meldung und Kontaktsynchronisation aus Ihrem Billingo-Adressbuch.

Unterstützte Länder

Billingo ist für Unternehmen in Ungarn 🇭🇺 konzipiert. Für andere Märkte: Lexoffice (DE/AT/CH), Pennylane (FR/BE), Holded (ES/PT), SmartBill (RO).

Voraussetzungen​

  • Aktives Billingo-Konto (mit API-Zugang)
  • Billingo v3 API-Schlüssel (siehe unten)
  • Mindestens ein konfigurierter Rechnungsblock (számlablokk) in Billingo
  • CADENSA-Einheit mit mindestens Admin-Rolle

Schritt 1 — Billingo-API-Schlüssel generieren​

  1. Anmelden bei app.billingo.hu
  2. Im linken Menü auf Beállítások (Einstellungen) klicken
  3. Auf API im Einstellungsmenü klicken
  4. Auf + Új API kulcs létrehozása (Neuen API-Schlüssel erstellen) klicken
  5. Namen vergeben (z.B. CADENSA)
  6. Den generierten Schlüssel sofort kopieren — er wird nur einmal angezeigt
API-Schlüssel geheim halten

Teilen Sie Ihren API-Schlüssel niemals und committen Sie ihn nicht in die Versionsverwaltung. Jeder mit dem Schlüssel kann Rechnungen in Ihrem Namen erstellen.

Schritt 2 — In CADENSA konfigurieren​

  1. Einstellungen → Rechnung in CADENSA öffnen
  2. Billingo 🇭🇺 als Anbieter auswählen
  3. Ein Infofeld erscheint:

    Ihren Billingo-API-Schlüssel finden Sie unter: app.billingo.hu → Beállítások → API → API kulcs létrehozása

  4. API-Schlüssel in das API Key-Feld einfügen
  5. Auf Verbindung testen klicken — ein grünes bestätigt Gültigkeit
  6. Auf Speichern klicken
Test vor dem Speichern erforderlich

Die Speichern-Schaltfläche bleibt deaktiviert, bis der Verbindungstest erfolgreich war.

Schritt 3 — Standardwerte festlegen​

EinstellungEmpfohlener Wert (HU)Beschreibung
StandardwährungHUFWährung für neue Rechnungen
Standard-MwSt. %27Ungarischer Regelsteuersatz (ÁFA)
Zahlungsfrist (Tage)8 oder 30Tage bis zum Fälligkeitsdatum
Standard-DokumenttypRechnungVorauswahl im Rechnungsdialog
AusstellerlandHUISO 3166-1 alpha-2 Ländercode Ihres Unternehmens

Schritt 4 — Billingo-spezifische Einstellungen​

EinstellungBeschreibung
Rechnungsblock-IDDer zu verwendende Billingo-Rechnungsblock. CADENSA wählt automatisch den ersten aktiven Block. Für einen bestimmten Block: ID aus Billingo → Beállítások → Bizonylattömbök eingeben.
Bankkonto-IDOptional. Ihre Billingo-Bankkonto-ID — erscheint auf der Rechnung als Zahlungsdetail.
ZahlungsmethodeStandard-Zahlungsmethode (wire_transfer, cash, bankcard usw.).
RechnungsspracheSprache der ausgestellten Rechnung (hu, en, de usw.).

Schritt 5 — (Optional) Sandbox / Testmodus​

Aktivieren Sie den Sandbox-Modus zum Testen ohne echte NAV-gemeldete Rechnungen auszustellen. Sandbox-Rechnungen:

  • Erscheinen nicht in der offiziellen Billingo-Rechnungsliste
  • Werden nicht an NAV gemeldet
  • Werden nach dem Test verworfen

Umschalter: Einstellungen → Rechnung → Sandbox / Testmodus

Rechnung über Billingo ausstellen​

  1. Berichte öffnen → Datumsbereich und Projektfilter einstellen
  2. Auf Rechnung generieren klicken
  3. Im Feld Dokumenttyp Rechnung auswählen — der Ausgabekanal zeigt Billingo
  4. (Optional) Über den Partner-Picker einen Kunden aus dem Billingo-Adressbuch auswählen
  5. Kundendaten, MwSt.-Satz und Fälligkeitsdatum ausfüllen
  6. Auf Vorschau klicken → Positionen und Gesamtbeträge prüfen
  7. Auf Rechnung ausstellen (Billingo) klicken
Was in Billingo passiert
  • Eine neue Rechnung wird erstellt und sofort abgeschlossen (wodurch die Billingo-Rechnungsnummer vergeben wird)
  • Die Rechnung wird automatisch an NAV Online Számla 3.0 gemeldet
  • Die Rechnung erscheint in Billingo unter Számlák → Kimenő számlák

Partner-Picker​

Wenn Billingo konfiguriert ist, zeigt der Rechnungsdialog einen Partner-Picker — ein durchsuchbares Dropdown Ihrer Billingo-Kontakte.

Bei Auswahl eines Kontakts werden automatisch ausgefüllt:

  • Firmenname
  • Adresse (Straße, PLZ, Stadt, Land)
  • Steuernummer
  • E-Mail-Adresse

Wenn der Kunde nicht in Ihrem Billingo-Adressbuch existiert, erstellt CADENSA ihn automatisch.

MwSt.-Sätze​

SatzVerwendung
27%Ungarischer Regelsteuersatz (ÁFA)
5%Ermäßigter Satz (bestimmte Lebensmittel, Medikamente)
0%Steuerfrei, innergemeinschaftliche Lieferung, Export
AAMAllgemeine Steuerbefreiung
TAMSachliche Steuerbefreiung
EUInnergemeinschaftliche Warenlieferung
F.AFAReverse-Charge-Verfahren
K.AFAKassenbuchhaltungs-MwSt.
KBAUKExport außerhalb der EU

Rechnungen in Fremdwährung​

Billingo arbeitet nativ in HUF. Bei Rechnungen in anderen Währungen (EUR, USD, GBP usw.):

  • CADENSA ruft automatisch den aktuellen HUF-Wechselkurs von der Frankfurter API ab (EZB-Daten)
  • Der Wechselkurs (conversion_rate) wird wie von Billingo gefordert in die Rechnungsanfrage aufgenommen
  • Der Kurs wird im CADENSA-Rechnungsdatensatz für Prüfzwecke gespeichert

Rechnungsstorno​

So stornieren Sie eine Billingo-Rechnung aus CADENSA:

  1. Abrechnung → Rechnungsverlauf öffnen
  2. Rechnung suchen und auf Rechnung stornieren klicken
  3. Stornierung bestätigen

CADENSA ruft POST /documents/{id}/cancel auf. In Billingo wird automatisch eine Stornorechnung erstellt und an NAV gemeldet.

Storno ist unwiderruflich

Stornierte Rechnungen können nicht wiederhergestellt werden.

Fehlerbehebung​

„Ungültiger API-Schlüssel" / 401 Unauthorized​

Der API-Schlüssel ist ungültig, abgelaufen oder widerrufen.

Lösung: Neuen Schlüssel in Billingo generieren (Beállítások → API → + Új API kulcs) und in CADENSA neu eingeben.

„Keine Rechnungsblöcke gefunden"​

Kein Rechnungsblock in Billingo konfiguriert.

Lösung: In Billingo unter Beállítások → Bizonylattömbök mindestens einen aktiven Rechnungsblock erstellen.

„INVOICE_NO_BILLABLE_ITEMS"-Fehler​

Alle Positionen haben amount = 0 — es sind keine Stundensätze konfiguriert.

Lösung: Einstellungen → Tarife öffnen und Stundensätze für Projekte konfigurieren.

Verwandte Seiten​