De Webhook-integratie configureren

Doel

Elk door POP gegenereerd document (XML of PDF) automatisch verzenden naar een externe tool: Zapier, Make (Integromat), een CRM, Google Drive of een aangepast endpoint.

Vereisten

• POP Basic-abonnement of hoger — webhook-aflevering is niet beschikbaar in het gratis abonnement.
• Een luisterend HTTP-endpoint (de doel-webhook-URL).

Stappen

1. Ga op popapi.io naar Mijn account > Integraties > POP to Webhook > Verbinden.
2. Configureer:
   • een herkenbare naam
   • de doel-webhook-URL
   • het gegevensformaat: JSON of XML
   • de activeringsschakelaar
3. Op WordPress: ga in de POP-plugin naar Geavanceerd > Webhook, voer de in de vorige stap aangemaakte webhook-ID in, schakel deze in en schakel — als u verzending op de achtergrond wilt in plaats van synchroon — ook automatische verzending via CRON in.
4. Op Shopify: voer de webhook-ID in bij de app-instellingen; er verschijnt dan een icoon in de factureringslijst om de gegevens te verzenden.

Formaten

• JSON — ontworpen voor no-code-platforms (Zapier, Make): de gegevens worden automatisch platgeslagen tot een structuur die eenvoudig te mappen is.
• XML — geschikt voor archivering of systemen die de FatturaPA-standaard vereisen; kan ook als bijlage worden verzonden.

U kunt meerdere webhooks met verschillende URL’s en formaten tegelijk configureren.

Veelvoorkomende fouten

• Ongeldige webhook-URL — controleer of de URL publiekelijk bereikbaar is en succesvol reageert (syntactisch correct zijn is niet voldoende).
• Niet-ondersteund gegevensformaat — gebruik alleen JSON of XML; andere formaten worden geweigerd.
• De webhook ontvangt niets in de sandbox — verwachte beperking: webhook-aflevering is niet beschikbaar in de sandbox-omgeving (zie use-sandbox-environment).

Gerelateerde configuratie

Voor het specifieke geval van doorsturen naar n8n met een dedicated connector (bijv. Zoho), zie api/connectors en n8n.