Webhook-Integration konfigurieren

Ziel

Jedes von POP erzeugte Dokument (XML oder PDF) automatisch an ein externes Tool senden: Zapier, Make (Integromat), ein CRM, Google Drive oder einen benutzerdefinierten Endpoint.

Voraussetzungen

• POP Basic-Plan oder höher — Webhook-Zustellung ist im kostenlosen Plan nicht verfügbar.
• Ein lauschender HTTP-Endpoint (die Ziel-Webhook-URL).

Schritte

1. Gehen Sie auf popapi.io zu Mein Konto > Integrationen > POP to Webhook > Verbinden.
2. Konfigurieren Sie:
   • einen aussagekräftigen Namen
   • die Ziel-Webhook-URL
   • das Datenformat: JSON oder XML
   • den Aktivierungsschalter
3. Unter WordPress: gehen Sie im POP-Plugin zu Erweitert > Webhook, geben Sie die im vorherigen Schritt erstellte Webhook-ID ein, aktivieren Sie sie und aktivieren Sie zusätzlich den automatischen Versand per CRON, wenn Sie einen Hintergrundversand statt synchronen Versand wünschen.
4. Unter Shopify: geben Sie die Webhook-ID in den App-Einstellungen ein; in der Rechnungsliste erscheint dann ein Symbol zum Senden der Daten.

Formate

• JSON — für No-Code-Plattformen (Zapier, Make) konzipiert: die Daten werden automatisch in eine leicht zu mappende, flache Struktur gebracht.
• XML — geeignet für Archivierung oder Systeme, die den FatturaPA-Standard benötigen; kann auch als Anhang gesendet werden.

Sie können mehrere Webhooks mit unterschiedlichen URLs und Formaten gleichzeitig konfigurieren.

Häufige Fehler

• Ungültige Webhook-URL — prüfen Sie, ob die URL öffentlich erreichbar ist und erfolgreich antwortet (syntaktische Korrektheit allein reicht nicht aus).
• Nicht unterstütztes Datenformat — verwenden Sie ausschließlich JSON oder XML; andere Formate werden abgelehnt.
• Der Webhook empfängt in der Sandbox nichts — erwartete Einschränkung: die Webhook-Zustellung ist in der Sandbox-Umgebung nicht verfügbar (siehe use-sandbox-environment).

Zugehörige Konfiguration

Für den speziellen Fall der Weiterleitung an n8n mit einem dedizierten Connector (z. B. Zoho), siehe api/connectors und n8n.