Zum Hauptinhalt springen

Holded-Integration

Holded ist eine spanische Unternehmensmanagement-Plattform für den spanischen Markt (🇪🇸) und den FacturaE-E-Rechnungsstandard. Zusätzlich wird Portugal 🇵🇹, Italien 🇮🇹, Frankreich 🇫🇷 und Deutschland 🇩🇪 unterstützt.

FacturaE-Pflicht

FacturaE-E-Rechnungen sind für spanische Behördenrechnungen bereits verpflichtend und werden zunehmend auch für B2B-Transaktionen vorgeschrieben. Holded stellt sicher, dass Rechnungen im richtigen Format automatisch ausgestellt werden.

Voraussetzungen​

  • Aktives Holded-Konto (beliebiges Paket)
  • Holded API-Key (siehe unten)
  • CADENSA Rechnungsanbieter muss konfiguriert sein

API-Key generieren​

  1. In Holded-Konto einloggen
  2. Einstellungen → Integrationen → API öffnen
  3. „Neuer API-Key" klicken
  4. Den generierten Schlüssel kopieren — nur einmalig sichtbar!
Sicherheitshinweis

Den API-Key an einem sicheren Ort aufbewahren. Wenn du ihn verlierst, muss ein neuer Schlüssel in Holded generiert und in CADENSA aktualisiert werden.

Holded in CADENSA einrichten​

  1. Einstellungen → Rechnung öffnen
  2. Holded 🇪🇸 als Anbieter wählen
  3. Holded API-Key in das API-Key-Feld einfügen
  4. „Verbindung testen" klicken — bestätigt, dass der Schlüssel gültig ist
  5. Standard-MwSt.-Satz einstellen:
  • 21 — Standard-IVA (tipo general)
  • 10 — Ermäßigter IVA (tipo reducido)
  • 4 — Super-ermäßigter IVA (tipo superreducido)
  • 0 — Steuerbefreit (exento)
  1. „Speichern" klicken

Spanische IVA-Sätze​

SatzRateBeschreibung
IVA 21%21%Tipo general — allgemeine Waren und Dienstleistungen
IVA 10%10%Tipo reducido — Lebensmittel, Gesundheitsprodukte, Unterkunft
IVA 4%4%Tipo superreducido — Grundnahrungsmittel, Medikamente, Bücher
Exento0%Exento — steuerfreie Umsätze, Export, bestimmte Finanzdienstleistungen

Kundensuche​

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

  1. Im Rechnung erstellen-Dialog auf „Kunden suchen" klicken
  2. Kontaktname oder NIF/CIF-Steuernummer eingeben (mindestens 2 Zeichen)
  3. Den passenden Kunden aus der Liste auswählen
  4. Alle Kundenfelder werden automatisch ausgefüllt:
  • Name, Adresse, NIF/CIF-Steuernummer
  • Land (wird mit dem originalen Holded-Namen angezeigt, z. B. „Spain", „Hungary")
Kunde nicht gefunden?

Wenn der Kunde nicht in der Liste erscheint, die Felder manuell ausfüllen. Der Kunde wird nicht automatisch in Holded erstellt — dies muss manuell in der Holded-Oberfläche erfolgen.

Kundensuch-Logik​

CADENSA sucht Kunden in folgender Reihenfolge:

  1. NIF/CIF-Übereinstimmung (wenn die MwSt.-Nummer des Kunden angegeben ist)
  2. Namensübereinstimmung (exakte Übereinstimmung)
  3. Namensteilstring (Teilübereinstimmung)

Rechnung stornieren​

Holded-Rechnungen können im Tab Berichte → Rechnungen in CADENSA storniert werden:

  1. Die zu stornierende Rechnung suchen
  2. „⋯ Aktionen" klicken
  3. „Rechnung stornieren" auswählen
  4. CADENSA ruft den Holded API-void-Endpunkt auf
Hinweis

Eine stornierte Rechnung wird in Holded als „ungültig" markiert. Dies ist buchhalterisch endgültig — sie kann nicht wieder aktiviert werden.

PDF-Download​

  1. Nach der Rechnungserstellung lädt CADENSA das PDF über die Holded API
  2. Der Download-Button erscheint im Tab Berichte → Rechnungen
  3. Das PDF wird direkt von den Holded-Servern heruntergeladen

Unterstützte Märkte​

LandMwSt.-SystemHinweis
SpanienIVAFacturaE für Behördenrechnungen verpflichtend
PortugalIVAStandard-EU-Regelungen
ItalienIVAKompatibel mit dem SDI-E-Rechnungssystem
FrankreichTVAMit Factur-X-Standard
DeutschlandMwSt.Mit ZUGFeRD-Standard

Fehlerbehebung​

Fehler „Ungültiger API-Key"​

  • Prüfen, ob der vollständige Schlüssel kopiert wurde (ohne Leerzeichen)
  • Neuen API-Key in Holded generieren (Einstellungen → Integrationen → API)

„Kunde nicht gefunden" – leere Suchergebnisse​

  • Sicherstellen, dass der Kunde im Holded-Konto vorhanden ist
  • Die Suche erfordert mindestens 2 Zeichen

„Verbindung testen" fehlgeschlagen​

  • Sicherstellen, dass das Holded-Konto aktiv und nicht eingeschränkt ist
  • API-Key-Berechtigungen prüfen: Zugriff auf das invoicing-Modul erforderlich

PDF wird nicht heruntergeladen​

  • Die Holded-API kann gelegentlich verzögern; 30 Sekunden warten und erneut versuchen
  • Falls das Problem weiterhin besteht: support@cadensa.io

Weiterführende Themen​