Holded mit WooCommerce zu verbinden ist der Schritt, der deinen Shop von einem einfachen Warenkorb in ein echtes Verwaltungssystem verwandelt: Jede bezahlte Bestellung wird ohne manuelles Eingreifen zu einer korrekten Rechnung in deinem Holded-Konto. In diesem Praxisleitfaden konzentrieren wir uns auf den konkreten Verbindungsprozess — API-Key erstellen, Plugin installieren, Rechnungsstellung zuordnen und die erste Rechnung ausstellen — damit du den Ablauf an einem einzigen Nachmittag zum Laufen bringst und am Monatsende keine buchhalterischen Überraschungen erlebst.
Holded mit WooCommerce verbinden: Was du vor dem Start brauchst
Bevor du irgendeine Einstellung anfasst, solltest du das Terrain vorbereiten. Die meisten Probleme entstehen nicht durch das Plugin, sondern durch unvollständige Steuerdaten oder einen falsch erzeugten API-Key. Wenn du diese Liste durchgehst, klappt die Verbindung beim ersten Versuch:
- Ein aktives Holded-Konto mit Administratorrechten (Pläne mit elektronischer Rechnungsstellung sind ideal).
- WooCommerce aktualisiert und mit den Steuerdaten deines Unternehmens ausgefüllt (NIF, Adresse und Firmenname).
- Mindestens eine in Holded definierte Rechnungsserie, getrennt von deinen manuellen Rechnungen oder anderen Kanälen.
- Das Plugin EHERO Woo Holded para facturación, das jede Bestellung automatisch an Holded überträgt.
- Die Steuern deines Shops (allgemeine MwSt., ermäßigter Satz, ggf. Zuschlag für die Ausgleichssteuer) korrekt in WooCommerce konfiguriert.
Dieser Beitrag ergänzt unseren allgemeinen Leitfaden zur Integration von Holded mit WooCommerce: Hier geht es nicht um Strategie, sondern um das technische Vorgehen Schritt für Schritt.
Erstelle den API-Key in Holded
Der API-Key ist die Zugangsdaten, die deinem Shop erlauben, Rechnungen in deinem Namen zu erstellen. Melde dich im offiziellen Holded-Panel an, öffne das Kontomenü und gehe zu Einstellungen > Entwickler (je nach Plan erscheint es als „API“ oder „Integrationen“). Klicke auf einen neuen Schlüssel erstellen, gib ihm einen eindeutigen Namen — zum Beispiel „WooCommerce tienda“ — und kopiere ihn an einen sicheren Ort.
Beachte einen wichtigen Punkt: Holded zeigt den vollständigen Schlüssel nur einmal an. Wenn du das Fenster schließt, ohne ihn zu kopieren, musst du ihn widerrufen und einen neuen erzeugen. Speichere ihn in deinem Passwortmanager, niemals in einer E-Mail oder einer geteilten Notiz.
Installiere das Plugin EHERO Woo Holded
Lade die ZIP-Datei des Plugins in WordPress unter Plugins > Neu hinzufügen > Plugin hochladen hoch und aktiviere es. Du siehst einen neuen Einstellungsbereich, in den du den gerade erzeugten API-Key einfügst. Beim Speichern führt das Plugin einen Validierungsaufruf an Holded aus: Wenn die Zugangsdaten korrekt sind, erhältst du eine grüne Bestätigung. Das ist der Moment, in dem du deine Shop-Verbindung zu Holded auf Zugangsdaten-Ebene wirklich abgeschlossen hast.
So verbindest du Holded mit WooCommerce Schritt für Schritt
Mit validiertem Schlüssel geht es nur noch darum, das Verhalten festzulegen. Um die Verbindung sauber einzurichten, folge dieser Reihenfolge in den Plugin-Einstellungen:
- API-Key einfügen und speichern, um die Verbindung zu prüfen.
- Die Rechnungsserie auswählen, die der Shop verwenden soll (idealerweise eine Serie für den Online-Kanal).
- Den Auslöser festlegen: Rechnung erstellen, wenn die Bestellung auf „In Bearbeitung“ oder „Abgeschlossen“ wechselt.
- Entscheiden, ob die Rechnungsnummer von Holded vergeben oder von der Bestellung übernommen wird.
- Falls nötig, den automatischen Versand des PDFs an den Kunden aktivieren.
Rechnungsstellung zuordnen: Serien, Steuern und Steuerdaten
Das Mapping ist der Teil, der den Unterschied zwischen einer korrekten Rechnung und einer Rechnung macht, die dein Steuerberater ablehnen wird. Stelle sicher, dass die MwSt.-Sätze in WooCommerce mit denen in Holded übereinstimmen; wenn du im Shop 21 % hast und dieser Steuersatz in Holded nicht mit demselben Wert existiert, wird die Rechnung mit falschen Beträgen erstellt. Prüfe auch das Kontakt-Mapping: Das Plugin sucht den Kunden über NIF oder E-Mail und legt ihn an, wenn es ihn nicht findet. So vermeidest du Dubletten in deiner Holded-Kontaktdatenbank.
Für Unternehmen, die der Anti-Betrugs-Regelung unterliegen, ist diese Verbindung die Grundlage, auf der du später ein TPV para WooCommerce con VeriFactu aufbaust. EHERO Woo Holded ist mit VeriFactu kompatibel, sodass die erzeugten Rechnungen die geforderten Rückverfolgbarkeitsanforderungen erfüllen.
Stelle deine erste Testrechnung aus
Vertraue die erste Ausstellung nicht einer echten Bestellung an. Erstelle eine Testbestellung mit einem Produkt mit geringem Betrag, markiere sie als bezahlt und beobachte, was passiert. Wenn alles korrekt zugeordnet ist, erscheint die Rechnung innerhalb von Sekunden in Holded mit der richtigen Serie, Steuer und dem richtigen Kontakt. Prüfe drei Dinge: dass die Seriennummer wie vorgesehen ist, dass der Gesamtbetrag mit der Bestellung übereinstimmt und dass der Kunde ohne Dubletten angelegt oder verknüpft wurde. Wenn diese Testbestellung sauber durchläuft, ist die Verbindung abgeschlossen und du kannst beruhigt in den Produktivbetrieb gehen.
Typische Verbindungsfehler und wie man sie behebt
Auch wenn die Verbindung beider Plattformen ein kurzer Prozess ist, gibt es drei Fehler, die fast alle Supportanfragen ausmachen. Das sind sie und so werden sie gelöst.
Ungültiger API-Key oder fehlende Berechtigungen
Wenn beim Speichern ein Fehler bei den Zugangsdaten erscheint, prüfe, ob du keine Leerzeichen am Anfang oder Ende des Schlüssels mitkopiert hast. Der zweithäufigste Grund ist ein Schlüssel mit eingeschränkten Berechtigungen: Einige Holded-Pläne erzeugen nur-Lese-Schlüssel, die keine Rechnungen erstellen können. Erzeuge einen neuen mit Schreibrechten und validiere erneut.
Fehler bei der Rechnungsserie
Wenn die Rechnung nicht erstellt wird und im Protokoll die „Serie“ erwähnt wird, fehlt fast immer die Auswahl einer gültigen Serie oder sie wurde in Holded gelöscht. Erstelle eine exklusive Serie für den Online-Kanal, trenne sie von der, die du für manuelle Rechnungen verwendest, und wähle sie im Plugin erneut aus. So vermeidest du Nummerierungssprünge, die später den Quartalsabschluss erschweren.
| Aspekt | Manuelle Rechnungsstellung | Verbindung mit EHERO Woo Holded |
|---|---|---|
| Zeit pro Bestellung | 3-5 Minuten Daten kopieren | Automatisch, null Minuten |
| Fehlerrisiko | Hoch (Beträge, NIF, Serie) | Niedrig, Daten von der Bestellung übernommen |
| Seriennummerierung | Manuell, mit häufigen Sprüngen | Fortlaufend und kontrolliert |
| VeriFactu-Kompatibilität | Hängt von der Methode ab | Ja, integriert |
Häufig gestellte Fragen
Brauche ich technische Kenntnisse, um diese Verbindung herzustellen?
Nein. Der Prozess reduziert sich darauf, einen API-Key zu erzeugen, das Plugin zu installieren und den Schlüssel einzufügen. Das gesamte Mapping erfolgt über einen Einstellungsbildschirm, ohne Code oder Datenbanken anzufassen.
Synchronisiert das Plugin auch den Bestand zwischen Holded und dem Shop?
Nein. EHERO Woo Holded konzentriert sich auf die Rechnungsstellung: Es wandelt jede Bestellung in eine Rechnung innerhalb von Holded um. Die Bestandsverwaltung ist ein anderer Ablauf und gehört nicht zu dieser Verbindung.
Kann ich KI-Funktionen in der Rechnungsstellung verwenden?
Jede KI-gestützte Funktion arbeitet im BYOK-Modus, also mit deinem eigenen Schlüssel des Anbieters. Du kontrollierst den Schlüssel und die Kosten; das Plugin enthält keinen Drittverbrauch auf eigene Rechnung.
Was passiert, wenn ich den API-Key später ändere?
Es reicht, den neuen Schlüssel in den Einstellungen einzufügen und zu speichern, damit das Plugin ihn erneut validiert. Wenn du den alten in Holded widerrufst, tue das erst, nachdem du bestätigt hast, dass die neue Verbindung korrekt reagiert.
Fazit
Holded mit WooCommerce zu verbinden geht schneller, als es scheint, wenn du den API-Key vorbereitest, eine eigene Serie definierst und mit einer Testbestellung validierst, bevor du in den Produktivbetrieb gehst. Mit diesen vier Punkten — korrekte Zugangsdaten, abgestimmte Steuern, dedizierte Serie und echter Test — läuft deine Rechnungsstellung unbeaufsichtigt und konform mit VeriFactu. Mach den Schritt mit dem Holded-Rechnungs-Plugin für WooCommerce von EHERO und verwandle jede Bestellung in eine Rechnung, ohne jemals wieder Daten manuell zu kopieren.