Holded-Integration
Holded ist eine All-in-one-Plattform für die Unternehmensverwaltung, die für den spanischen Markt (ES) entwickelt wurde und zusätzlich Portugal, Italien, Frankreich und Deutschland unterstützt. Wenn Holded in CADENSA konfiguriert ist, können Sie direkt aus Ihren erfassten Zeiteinträgen rechtsgültige Rechnungen ausstellen, kompatibel mit dem spanischen E-Rechnungsstandard FacturaE.
Holded ist in erster Linie für Unternehmen in Spanien 🇪🇸 konzipiert, mit zusätzlicher Unterstützung für Portugal 🇵🇹, Italien 🇮🇹, Frankreich 🇫🇷 und Deutschland 🇩🇪.
Spanien schreibt die Zeiterfassung seit 2019 gesetzlich vor (Real Decreto-ley 8/2019). Die Zeiterfassung von Cadensa in Kombination mit der Holded-Rechnungsstellung bietet spanischen Unternehmen einen vollständigen Arbeitsablauf von der Zeiterfassung bis zur Rechnung.
Voraussetzungen
Sie benötigen:
- Ein aktives Holded-Konto (beliebiges kostenpflichtiges Paket)
- Einen Holded-API-Schlüssel (siehe unten)
- CADENSA-Einheit mit mindestens Admin-Rolle
Schritt 1 — Holded-API-Schlüssel generieren
- Anmelden bei app.holded.com
- Einstellungen öffnen (Zahnrad-Symbol, oben rechts)
- Zu Integrationen → API navigieren
- Auf „+ New API Key" klicken (oder einen vorhandenen Schlüssel kopieren)
- Den generierten Schlüssel kopieren
Teilen Sie Ihren API-Schlüssel niemals und committen Sie ihn nicht in die Versionsverwaltung. Jeder mit dem Schlüssel kann in Ihrem Namen Rechnungen und Kontakte erstellen und verwalten.
Die offizielle Holded-API-Dokumentation finden Sie unter: developers.holded.com/reference
Schritt 2 — In CADENSA konfigurieren
- Einstellungen → Rechnung in CADENSA öffnen
- Holded 🇪🇸 als Anbieter auswählen
- API-Schlüssel in das API Key-Feld einfügen
- Auf Verbindung testen klicken — ein grünes
bestätigt, dass der Schlüssel gültig ist - Auf Speichern klicken
Schritt 3 — Standardwerte festlegen
Standardwerte konfigurieren, damit der Dialog Rechnung generieren mit sinnvollen Werten vorausgefüllt ist:
| Einstellung | Empfohlener Wert (ES) | Beschreibung |
|---|---|---|
| Standardwährung | EUR | Währung für neue Rechnungen |
| Standard-MwSt. % | 21 | Spanischer Regel-IVA-Satz (impuesto sobre el valor añadido) |
| Zahlungsfrist (Tage) | 30 | Tage bis zum Fälligkeitsdatum |
| Standard-Dokumenttyp | Rechnung | Vorauswahl von „Rechnung" im Dialog |
| Ausstellerland | ES | Land Ihres Unternehmens — ermöglicht automatische MwSt.-Vorschläge |
- 21 % — Regelsteuersatz (tipo general) — die meisten Dienstleistungen
- 10 % — ermäßigter Satz (tipo reducido) — Gastgewerbe, Transport, bestimmte Lebensmittel
- 4 % — stark ermäßigter Satz (tipo superreducido) — Bücher, Medikamente, bestimmte Lebensmittel
- 0 % — steuerbefreit — innergemeinschaftliche Lieferung, Export, bestimmte Finanzdienstleistungen
Rechnung über Holded ausstellen
Folgen Sie nach der Konfiguration dem Standardablauf zur Rechnungserstellung:
- Berichte öffnen → Datumsbereich und Projektfilter einstellen
- Auf Rechnung generieren klicken
- Im Feld Dokumenttyp Rechnung auswählen — der Ausgabekanal zeigt
Holded - Kundendaten eingeben (Name, Adresse, Land, USt-IdNr./NIF-Nummer)
- MwSt.-Satz festlegen (Standard: 21 %)
- Auf Vorschau klicken → Positionen und Gesamtbeträge prüfen
- Auf Rechnung ausstellen (Holded) klicken
CADENSA sendet die Rechnung an die Holded-API. Ein Kontaktdatensatz wird automatisch gefunden oder erstellt (zuerst wird anhand der USt-IdNr. gesucht, dann anhand des Namens). Die Rechnung wird erstellt, und die PDF steht zum Download bereit.
- Ein neues Rechnungsdokument wird in Holded unter Facturación → Facturas emitidas erstellt
- Ein Kontakt wird automatisch erstellt, falls keiner gefunden wird
- Die Rechnungs-PDF steht sofort zum Download bereit
Kontaktabgleich
CADENSA sucht in dieser Reihenfolge nach einem bestehenden Holded-Kontakt:
- Nach USt-IdNr./NIF-Nummer — zuverlässigste Übereinstimmung (die USt-IdNr. des Kunden im Rechnungsdialog eingeben)
- Nach Firmenname — exakte Übereinstimmung (ohne Berücksichtigung von Groß-/Kleinschreibung)
- Neu erstellen — wird keine Übereinstimmung gefunden, wird automatisch ein neuer Kontakt erstellt
Geben Sie bei spanischen Kunden immer die NIF/CIF (z. B. B12345678) in das Feld für die USt-IdNr. des Kunden ein. So wird sichergestellt, dass der richtige Holded-Kontakt zugeordnet wird, auch wenn der Firmenname leicht abweicht.
Gespeicherte Partner (Partner-Picker)
Wenn Holded als Rechnungsanbieter konfiguriert ist, zeigt der Dialog Rechnung generieren einen Partner-Picker — ein durchsuchbares Dropdown, das direkt mit Ihren Holded-Kontakten befüllt wird.
So funktioniert es:
- Einen Namen oder Teiltext eingeben, um Ihre Holded-Kontakte in Echtzeit zu durchsuchen
- Die Auswahl eines Partners füllt alle Kundenfelder automatisch aus: Firmenname, Adresse, Postleitzahl, Stadt, Land, USt-IdNr.
- Das Länderfeld zeigt den ursprünglichen Holded-Ländernamen (z. B. „Spain", „Hungary") zur einfachen Wiedererkennung — während intern der ISO-Code (z. B.
ES,HU) für die MwSt.-Berechnung und die Reverse-Charge-Logik verwendet wird
Holded speichert Ländernamen als vollständigen Text („Spain", „Germany" usw.). CADENSA wandelt diese intern automatisch in ISO-3166-1-alpha-2-Codes um, um den korrekten MwSt.-Vorschlag zu ermöglichen (Inland / Reverse Charge / Export). Der vollständige Name wird zur besseren Lesbarkeit in der Oberfläche angezeigt.
Unterstützte Abläufe:
- Einen vorhandenen Partner auswählen → alle Felder werden automatisch ausgefüllt
- Den Partner löschen → Felder manuell bearbeiten
- Kundendaten manuell eingeben, falls der Partner noch nicht in Holded vorhanden ist (bei Rechnungsausstellung wird ein neuer Kontakt erstellt)
MwSt.-Satz-Zuordnung
Holded verwendet benannte Steuerobjekte. CADENSA ordnet Ihren numerischen MwSt.-Satz automatisch zu:
| MwSt.-Satz | Holded-Steuername | Anwendungsfall |
|---|---|---|
| 21 % | IVA 21% | Spanischer Regel-IVA |
| 10 % | IVA 10% | Ermäßigter Satz |
| 4 % | IVA 4% | Stark ermäßigter Satz |
| 0 % | Exento | Steuerbefreit / Export |
Rechnungssprachen
CADENSA wählt die Rechnungssprache automatisch anhand des Ausstellerlands:
| Ausstellerland | Rechnungssprache |
|---|---|
| ES | Spanisch (es) |
| FR | Französisch (fr) |
| DE | Deutsch (de) |
| PT | Portugiesisch (pt) |
| IT | Italienisch (it) |
| Sonstige | Spanisch (es, Standard) |
Belegweiterleitung
| Dokumenttyp | Ausgabe |
|---|---|
| Proforma | Interne PDF (nie an Holded gesendet) |
| Arbeitszusammenfassung | Interne PDF (nie an Holded gesendet) |
| Rechnung | An Holded-API gesendet → PDF zurückgegeben |
Nur Dokumente vom Typ „Rechnung" werden an Holded gesendet. Proforma und Arbeitszusammenfassung werden unabhängig von der Anbieter-Einstellung immer intern erzeugt.
Rechnungsverlauf & PDF-Download
Nach erfolgreicher Rechnungserstellung:
- Die Rechnung erscheint unter Berichte → Rechnungen in CADENSA
- Die Rechnung erscheint auch in Ihrem Holded-Konto unter Facturación → Facturas emitidas
- Sie können die PDF jederzeit von beiden Stellen erneut herunterladen
Verbindung testen
Nutzen Sie die Schaltfläche Verbindung testen nach Eingabe des API-Schlüssels. CADENSA ruft die Holded-Contacts-API auf, um zu prüfen, ob der Schlüssel gültig ist.
Ein erfolgreicher Test zeigt:
✓ Verbindung erfolgreich
Holded verfügt über keine Sandbox-Umgebung. Zum Testen:
- Einen Testkontakt in Holded anlegen (z. B. „Test Client ES")
- Eine kleine Testrechnung in CADENSA erzeugen
- Diese sofort in Holded stornieren (Facturas emitidas → ⋯ → Anular)
Fehlerbehebung
Fehler „401 Unauthorized" / „403 Forbidden"
Der API-Schlüssel ist ungültig, abgelaufen oder verfügt nicht über die erforderlichen Berechtigungen.
Lösung: Einen neuen API-Schlüssel in Holded generieren (Einstellungen → Integrationen → API) und in CADENSA neu eingeben.
Fehler „INVOICE_NO_ENTRIES"
Für den ausgewählten Datumsbereich und die Projektfilter wurden keine Zeiteinträge gefunden.
Lösung: Datumsbereich oder Projektfilter anpassen und erneut versuchen.
Kontakt wird nicht erstellt / falscher Kontakt zugeordnet
Fehlt die USt-IdNr. und stimmt der Firmenname nicht exakt mit einem bestehenden Holded-Kontakt überein, kann ein Duplikat entstehen.
Lösung: Contactos in Holded prüfen und doppelte Datensätze zusammenführen. Für zukünftige Rechnungen immer die NIF/CIF des Kunden in das Feld für die USt-IdNr. eingeben.
PDF-Download schlägt fehl
Holded erstellt PDFs synchron — die PDF sollte unmittelbar nach der Rechnungserstellung verfügbar sein.
Lösung: Erneut von Berichte → Rechnungen herunterladen. Besteht das Problem weiterhin, die Statusseite von Holded prüfen oder den Holded-Support kontaktieren.
Stornierung der Rechnung schlägt fehl
Nur Rechnungen im Status pending oder draft können storniert werden. Bezahlte Rechnungen können über die API nicht rückgängig gemacht werden.
Lösung: Die Rechnung manuell in Holded stornieren (Facturas emitidas → ⋯ → Anular), falls der API-Aufruf fehlschlägt.
Siehe auch
- Rechnungsanbieter-Einstellungen — Überblick über alle Anbieter
- Rechnungsgenerierung — wie Sie Rechnungen aus Zeiteinträgen erstellen
- Rechnungshistorie — vergangene Rechnungen ansehen und erneut herunterladen