Webhook Integration
Configure TaprNext to push approved invoices to your endpoint via webhooks.
How Webhooks Work
Section titled “How Webhooks Work”The system follows a flow where invoice approval in TaprNext triggers the webhook service, which then sends a POST request to your configured endpoint for further processing in your ERP.
Configuration Steps
Section titled “Configuration Steps”- Navigate to Tapr Settings > Integrations > Webhooks
- Click Add Webhook
- Fill in these fields:
- Name: Descriptive identifier (e.g., “ERP Invoice Sync”)
- URL: Your receiving endpoint (e.g., https://api.yourcompany.com/invoices)
- Events: Select triggers like
invoice.approved - Secret: Auto-generated HMAC signing key
- Active: Enable the webhook
Event Types
Section titled “Event Types”| Event | Trigger | Purpose |
|---|---|---|
invoice.approved | Invoice approval | Send to ERP |
invoice.rejected | Invoice rejection | Vendor notification |
invoice.posted | ERP posting complete | Receipt confirmation |
invoice.created | New invoice arrival | Alerts |
vendor.created | New vendor creation | ERP synchronization |
Payload Structure
Section titled “Payload Structure”Webhooks deliver JSON containing invoice details: vendor information, amounts, line items, dates, PO references, approval metadata, and a cryptographic signature for verification.
Security Options
Section titled “Security Options”HMAC signature (recommended): TaprNext signs requests with X-Tapr-Signature: sha256=<hash> header for verification.
API key header: Include X-API-Key in requests.
Basic auth: Embed credentials in the URL.
Retry Strategy
Section titled “Retry Strategy”Failed deliveries retry at escalating intervals: immediate, 1 minute, 5 minutes, 30 minutes, and 2 hours. The system retries on 5xx errors, timeouts, and connection failures—but not on 4xx errors or invalid responses.
Testing & Monitoring
Section titled “Testing & Monitoring”Use the Test button to send sample payloads. Monitor delivery history in Settings > Integrations > Webhook Logs with filtering options.
Sample Implementations
Section titled “Sample Implementations”Python (Flask) and Node.js (Express) examples demonstrate signature verification and invoice processing workflows.