Global E-Invoicing with Confidence

Certified Peppol Access Point • POP000991

All systems operational

40+ Countries

Encrypted

Compliant

Real-time

AP • SMP • Network

Documents

-

- sent • - received

Success Rate

-

Delivered

-

Confirmed with receipt

Failed

-

View details →

Document Status

This period

-

Total

Delivered

Sent

Failed

Transaction Volume

Sent

Received

Recent Activity

View All →

Loading recent activity...

Quick Actions

Last activity: -

Document Exchange Architecture

How your documents flow through the Peppol network

ERP Integration Guide →

Your ERP REST API

GoRoute.ai Peppol UBL 2.1 Conversion

AS4 Gateway Digital Signing

Peppol Network Global Delivery

Recipient Trading Partner

Cloud Hosted

Encryption

Digital Signing

Archiving

Compliance

Participants

Manage Peppol participant identifiers

Participant ID	Scheme	Services	SML Status	Actions
Loading participants...

Service Groups

Manage document types and processes for your participants

Total Service Groups

-

Document Types

-

Active Processes

-

Registered Service Groups

Loading service groups...

Endpoints

AS4 access point configuration and transport settings

Total Endpoints

-

Transport Protocols

AS4

Registered Endpoints

Loading endpoints...

Document Archive

Long-term storage and retrieval of exchanged documents

Total Documents

-

Invoices

-

Credit Notes

-

Storage Used

-

Document Type

Date From

Date To

Participant

Document	Type	Sender	Recipient	Date	Actions
Archive is empty Documents will appear here after exchange

Document

Type

Sender

Recipient

Date

Actions

Archive is empty

Documents will appear here after exchange

Showing 0 documents

Reports

Generate compliance reports, transaction logs, and audit trails. Export to CSV, Excel, or PDF.

Popular

Monthly Transaction Summary

Overview of all documents sent and received, grouped by month with delivery status breakdown.

Delivery Report

Detailed delivery status for all AS4 transmissions including timestamps, receipts, and error details.

Failed Transactions

All failed deliveries with error codes, validation failures, and troubleshooting details.

Trading Partner Report

Document volume and delivery stats per trading partner. See your most active recipients.

Document Type Breakdown

Distribution of invoices, credit notes, and other document types with volume trends.

Audit

Compliance & Validation

EN16931 and Peppol BIS 3.0 validation pass rates, error codes, and compliance status.

Reconciliation Report

Match sent invoices against delivery receipts. Identify unreconciled or disputed documents.

Archive & Retention

10-year retention compliance status, storage usage, and archived document inventory.

Export

Full Transaction Log

Complete audit trail of all transactions. Export to CSV, JSON, or XML for your records.

Need a custom report?

Tell us what you need — we'll build it and get back to you within 24 hours.

Connectors

Pre-built billing system connectors — receive invoices via webhook automatically

Z

Zuora

Waiting for first event

Subscription billing · Webhook integration

Choose Integration Method

1

Enable PEPPOL Extract in Zuora

a. In Zuora, go to Billing → E-Invoicing → PEPPOL Extract
b. Create an e-invoice file template — map your Zuora billing fields to PEPPOL BIS 3.0 UBL elements
c. Configure e-invoice settings — set document types (Invoice, Credit Note) and enable auto-generation on posting
d. Zuora will generate PEPPOL-compliant XML files for each billing document automatically

Zuora PEPPOL Extract documentation

2

GoRoute API Endpoint

Push generated BIS 3.0 XML files to GoRoute for validation and Peppol AS4 delivery.

POST/peppol-api/api/v1/invoices/send

Requires X-API-Key header. Get your key from the API Keys page.

3

Automate with Zuora Workflow

a. Go to Platform → Workflows → create a new workflow triggered by Invoice Posted
b. Add a Generate E-Invoice File task to produce the BIS 3.0 XML
c. Add an HTTP callout task — POST the XML to the GoRoute API endpoint above
d. Set headers: X-API-Key: <your-key> and Content-Type: application/xml
e. Activate the workflow — GoRoute will validate and deliver each invoice via Peppol AS4

What GoRoute Handles

Schematron validation (EN16931 + Peppol BIS)

SMP/SML participant lookup

AS4 message exchange via Peppol network

Delivery receipt + status tracking

4

Verify Connection

Send a test event through the full pipeline to confirm everything is wired correctly.

1

Webhook Endpoint

Copy this URL and paste it into your Zuora notification callout configuration.

POSThttps://euqnjrk7rc.execute-api.us-east-1.amazonaws.com/webhook/zuora/invoice

2

Signing Secret

Used to verify webhook payloads are genuinely from Zuora. Set this as the shared secret in your callout configuration.

HMAC Verification: GoRoute verifies every inbound webhook using HMAC-SHA256. Zuora signs each callout payload with this shared secret and includes the signature in the X-Zuora-Signature header. GoRoute recomputes the HMAC and rejects any request where the signature does not match — preventing spoofed or tampered payloads from being processed.

••••••••••••••••••••••••••••••••

3

Configure Zuora Notification Callout

a. Go to Zuora → Platform → Notifications → Notification Definitions
b. Click + Add New Notification, set Event Type to Invoice Posted
c. Under Callout, select Active, method POST, Content-Type application/json
d. Paste the webhook URL from Step 1 into the Callout Base URL field
e. In the request body, use Zuora merge fields to include full invoice + line items + account data
f. Save and activate the notification — GoRoute converts JSON → UBL 2.1 → validates → delivers via AS4

Production Architecture: Trigger + Fetch

In production, GoRoute treats the webhook as a trigger signal, not the sole data source. When a callout arrives, GoRoute:

Authenticates the webhook (HMAC verification)
Deduplicates the event (idempotency check on invoice ID)
Uses the Zuora REST API to fetch the full invoice object — including line items, taxation items, account details, legal entity, and buyer identifiers
Maps the enriched data into compliant UBL 2.1 / Peppol BIS 3.0
Validates, delivers via AS4, and archives evidence

Why? Peppol/UBL compliance requires more structured data than a lightweight webhook payload alone. The webhook triggers processing; the Zuora API provides the full source of truth.

4

Required Event Subscriptions

Invoice Posted

Primary — triggers UBL conversion + AS4 delivery. Use this over "Invoice Created" — posted invoices are finalized billing documents.

Credit Memo Posted

Optional — sends Peppol credit notes

Notification Filters: Zuora supports filters on notification definitions. You can scope events by entity, business unit, invoice amount, account segment, or custom logic. Use filters to send only relevant invoices to GoRoute — e.g., filter by country = OM for Oman-only compliance, or by amount threshold for phased rollout.

5

Verify Connection

Send a test event to confirm the webhook is configured correctly.

Fallback: Polling Mode — If your environment cannot receive inbound webhooks, GoRoute supports a polling fallback where it queries the Zuora API using object queries and a updatedDate high-water mark. Webhook/callout is the recommended primary pattern; polling should be used only when webhooks are not possible. Contact support to enable polling mode.

Status

Waiting for events

Environment

Test (Sandbox)

Last Event

—

Events Processed

0

Last Successful Sync

—

Failed Events

0

Recent Events

Timestamp	Invoice	Status	Validation	Actions
No events received yet. Complete setup and post an invoice in Zuora, or use Send Test Event to verify.

Zuora → UBL 2.1 Field Mappings

Default transformation rules applied during conversion. Overrides per field coming soon.

Zuora Field	→	UBL Element	Notes
InvoiceNumber	→	cbc:ID	Invoice identifier
InvoiceDate	→	cbc:IssueDate	YYYY-MM-DD
DueDate	→	cbc:DueDate	Payment due date
Currency	→	cbc:DocumentCurrencyCode	Passed through from Zuora as-is/td>
Account.PeppolId	→	cac:AccountingCustomerParty	Receiver endpoint (scheme:id)
Amount	→	cac:LegalMonetaryTotal	TaxExclusiveAmount + TaxInclusiveAmount
TaxAmount	→	cac:TaxTotal/cbc:TaxAmount	Total tax
InvoiceItems[].ChargeAmount	→	cac:InvoiceLine/cbc:LineExtensionAmount	Per-line net amount
TaxationItems[].TaxRate	→	cac:TaxCategory/cbc:Percent	VAT rate (e.g. 5%)
BillToContact.*	→	cac:PostalAddress	Street, city, postal code, country

Oman-Specific Compliance Notes

Zuora invoices are passed through in their billing currency. When auto-convert is enabled and the receiver's jurisdiction requires a different currency (e.g., OMR for Oman), GoRoute converts amounts using live Central Bank exchange rates at invoice time. GoRoute validates that the 5% VAT rate matches Oman's standard rate and that tax amounts are mathematically consistent with line totals

VAT Registration

Oman VAT numbers use the 9959 participant identifier scheme. GoRoute validates that the supplier VAT number (e.g., OM3100209729) is present and correctly formatted in cac:AccountingSupplierParty.

B2B vs B2C Determination

GoRoute checks whether the buyer has a VAT/Tax number. If Account.TaxNumber is blank, GoRoute classifies the transaction as B2C and applies appropriate CIUS rules. B2B invoices require a buyer identifier and may need a Peppol endpoint ID for network delivery.

Currency & Tax Handling

Zuora invoices are passed through in their billing currency. When auto-convert is enabled and the receiver's jurisdiction requires a different currency (e.g., OMR for Oman), GoRoute converts amounts using live Central Bank exchange rates at invoice time. GoRoute validates that the 5% VAT rate matches Oman's standard rate and that tax amounts are mathematically consistent with line totals.

Compliance Channels

GoRoute routes Oman invoices to the appropriate channel: Peppol AS4 for network-registered recipients, tax authority reporting when required by Oman regulations, and PDF + UBL archive for audit evidence. GoRoute does not replace the billing system's customer-facing PDF — it generates the structured compliance artifact alongside it.

QB

QuickBooks

Waiting for first event

QuickBooks Online · OAuth 2.0 · Webhook integration

1

Connect QuickBooks Online

a. Click Connect with QuickBooks below to authorize GoRoute via OAuth 2.0
b. Sign in to your Intuit account and select the company file to connect
c. Grant GoRoute read access to Invoices, Customers, and Company Info
d. GoRoute stores an encrypted refresh token — re-authorization is automatic

2

Webhook Endpoint

Intuit sends real-time notifications when invoices are created or updated.

POST/connectors/quickbooks/webhook/quickbooks

Configure this URL in Intuit Developer Portal → Webhooks. Select Invoice and CreditMemo entity events. The connector verifies the intuit-signature header via HMAC-SHA256.

3

Verifier Token

HMAC-SHA256 Verification: Intuit signs each webhook payload with this verifier token. GoRoute validates the intuit-signature header to ensure authenticity and reject tampered requests.

••••••••••••••••••••••••••••••••

What GoRoute Handles

QuickBooks JSON → UBL 2.1 conversion

Schematron validation (EN16931 + BIS)

AS4 delivery via Peppol network

OAuth token refresh & retry logic

4

Verify Connection

Send a test QuickBooks invoice through the GoRoute pipeline.

Status

Waiting for events

Platform

QuickBooks Online

Last Event

—

Events Processed

0

Last Successful Sync

—

Failed Events

0

Recent Events

Timestamp	Invoice	Status	Validation	Actions
No events received yet. Complete setup and create an invoice in QuickBooks, or use Send Test Event to verify.

QuickBooks → UBL 2.1 Field Mappings

Default transformation rules applied when converting QuickBooks invoices to Peppol BIS 3.0.

QuickBooks Field	→	UBL Element	Notes
DocNumber	→	cbc:ID	Invoice number
TxnDate	→	cbc:IssueDate	YYYY-MM-DD
DueDate	→	cbc:DueDate	Payment due date
CurrencyRef.value	→	cbc:DocumentCurrencyCode	ISO 4217 currency
CustomerRef	→	cac:AccountingCustomerParty	Customer lookup via API
TotalAmt	→	cac:LegalMonetaryTotal	Tax-inclusive total
TxnTaxDetail.TotalTax	→	cac:TaxTotal/cbc:TaxAmount	Total tax amount
Line[].Amount	→	cac:InvoiceLine/cbc:LineExtensionAmount	Line net amount
Line[].SalesItemLineDetail	→	cac:Item/cbc:Name	Item description
BillAddr.*	→	cac:PostalAddress	Street, city, postal, country

X

Xero

Waiting for first event

Accounting · OAuth 2.0 · Webhook integration

1

Connect Xero Organisation

a. Click Connect with Xero below to authorize GoRoute via OAuth 2.0 (PKCE)
b. Sign in to your Xero account and select the organisation to connect
c. Grant GoRoute read access to Invoices, Contacts, and Organisation scopes
d. GoRoute handles token refresh automatically — connections persist until revoked

2

Webhook Endpoint

Xero fires notifications when invoices are created, updated, or approved.

POST/connectors/xero/webhook/xero

Configure in Xero Developer Portal → Webhooks. GoRoute responds to the Intent to Receive validation automatically. Payloads are verified via x-xero-signature HMAC-SHA256.

3

Webhook Signing Key

HMAC-SHA256 Verification: Xero signs each webhook with the key displayed below. GoRoute verifies the x-xero-signature header to ensure payload authenticity.

••••••••••••••••••••••••••••••••

What GoRoute Handles

Xero JSON → UBL 2.1 conversion

Schematron validation (EN16931 + BIS)

AS4 delivery via Peppol network

Multi-org tenant isolation

4

Verify Connection

Send a test Xero invoice through the GoRoute pipeline.

Status

Waiting for events

Platform

Xero

Last Event

—

Events Processed

0

Last Successful Sync

—

Failed Events

0

Recent Events

Timestamp	Invoice	Status	Validation	Actions
No events received yet. Complete setup and approve an invoice in Xero, or use Send Test Event to verify.

Xero → UBL 2.1 Field Mappings

Default transformation rules applied when converting Xero invoices to Peppol BIS 3.0.

Xero Field	→	UBL Element	Notes
InvoiceNumber	→	cbc:ID	Invoice identifier
Date	→	cbc:IssueDate	YYYY-MM-DD
DueDate	→	cbc:DueDate	Payment due date
CurrencyCode	→	cbc:DocumentCurrencyCode	ISO 4217 currency
Contact	→	cac:AccountingCustomerParty	Contact name + tax number
Total	→	cac:LegalMonetaryTotal	Tax-inclusive total
TotalTax	→	cac:TaxTotal/cbc:TaxAmount	Total tax amount
LineItems[].LineAmount	→	cac:InvoiceLine/cbc:LineExtensionAmount	Line net amount
LineItems[].TaxType	→	cac:TaxCategory/cbc:Percent	Tax rate from tax type lookup
Contact.Addresses[0]	→	cac:PostalAddress	Street, city, postal, country

Odoo

Waiting for first event

Invoicing · Accounting · XML-RPC / REST API

Choose Integration Method

1

Odoo Connection Details

Odoo URL

Database Name

Username / Email

API Key

GoRoute uses these credentials to call account.move via XML-RPC. Credentials are encrypted at rest.

2

Polling Configuration

a.GoRoute polls Odoo every 5 minutes for newly posted invoices (state = 'posted')
b.Uses a high-water mark on write_date to pick up only new/changed records
c.Fetches invoice lines, partner data, and tax details in a single batch call
d.Converts to Peppol BIS 3.0 UBL, validates, and delivers via AS4

What GoRoute Handles

Odoo account.move → UBL 2.1 conversion

Schematron validation (EN16931 + BIS)

AS4 delivery via Peppol network

Multi-company & multi-currency support

3

Verify Connection

Send a test Odoo invoice through the GoRoute pipeline.

Status

Waiting for events

Platform

Odoo 17+

Last Event

—

Events Processed

0

Last Successful Sync

—

Failed Events

0

Recent Events

Timestamp	Invoice	Status	Validation	Actions
No events received yet. Complete setup and post an invoice in Odoo, or use Send Test Event to verify.

Odoo → UBL 2.1 Field Mappings

Default transformation rules applied when converting Odoo invoices to Peppol BIS 3.0.

Odoo Field	→	UBL Element	Notes
name	→	cbc:ID	Invoice number (e.g., INV/2026/0001)
invoice_date	→	cbc:IssueDate	YYYY-MM-DD
invoice_date_due	→	cbc:DueDate	Payment due date
currency_id.name	→	cbc:DocumentCurrencyCode	ISO 4217 currency
partner_id	→	cac:AccountingCustomerParty	Partner name + VAT number
amount_total	→	cac:LegalMonetaryTotal	Tax-inclusive total
amount_tax	→	cac:TaxTotal/cbc:TaxAmount	Total tax amount
invoice_line_ids[].price_subtotal	→	cac:InvoiceLine/cbc:LineExtensionAmount	Line net amount
invoice_line_ids[].tax_ids	→	cac:TaxCategory/cbc:Percent	Tax rate from account.tax
partner_id.street/city/zip/country	→	cac:PostalAddress	Partner address fields

More Connectors

SAP

Coming Soon

S/4HANA · Business One · IDoc/BAPI

ORC

Oracle / NetSuite

Coming Soon

SuiteScript · Cloud ERP · Multi-subsidiary

MS

Microsoft Dynamics 365

Coming Soon

Business Central · Finance · Power Automate

How Connectors Work

1

Billing System

Invoice posted in Zuora / ERP

2

Webhook Fires

Invoice payload sent to GoRoute endpoint

3

Convert & Validate

Mapped to Peppol BIS 3.0 UBL, Schematron validated

Delivered via Peppol

AS4 message sent, receipt confirmed

API & ERP Integrations

Connect your ERP system to GoRoute.ai Peppol for automated document exchange

Pre-Built Connectors Available

Zuora connector is live! Send invoices with one click — no coding needed.

View Connectors →

REST API Integration

GoRoute.ai Peppol provides a comprehensive REST API for seamless integration with any ERP system. Send invoices, receive documents, and manage participants programmatically.

Get API Key View API Docs

Quick Start Guide

1

Get API Key

Generate an API key from the API Keys section

2

Configure ERP

Set the API endpoint and credentials in your ERP

3

Test Connection

Send a test document to verify the integration

Go Live!

Start sending and receiving Peppol documents

API Endpoint

/peppol-api/api/v1

Compatible ERP Systems

GoRoute.ai Peppol integrates with any ERP that supports REST API webhooks. Pre-built connectors are available for:

SAP

S/4HANA, Business One

Oracle

NetSuite, Cloud ERP

QB

QuickBooks

Online, Desktop

MS

Microsoft

Dynamics 365

Xero

Accounting

Sage

Intacct, X3

Odoo

All Versions

Request

New Integration

Code Examples

Send Invoice (cURL)

curl -X POST /peppol-api/api/v1/documents \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"recipient": "0192:123456789", "document": "..."}'

Lookup Recipient (JavaScript)

const response = await fetch('/peppol-api/api/v1/lookup/0192:123456789', {
  headers: { 'Authorization': `Bearer ${apiKey}` }
});
const participant = await response.json();

Transactions

Track all sent and received documents

Total

0

Sent

0

Delivered

0

Failed

0

Transaction ID	Direction	Status	Participant	Document Type	Created â–¼	Actions
Loading transactions...

Showing 0 transactions

Lookup Recipient

Search the Peppol network for participants and their capabilities

Scheme

Participant Identifier

Send Test Document

Verify your Peppol configuration by sending a test document

Test Your Configuration

This sends a sample invoice through the Peppol production network. Use this to verify your SMP registration and AS4 endpoint are correctly configured.

Test Configuration

Your Peppol ID (Sender)

Loading...

✓ Registered

Loopback Test

This test sends a document to your own Peppol ID to verify your complete configuration: SMP registration, AS4 gateway, document validation, and webhook delivery.

Test Document Type

A pre-configured sample document will be sent

Test documents are clearly marked and won't affect production

Recent Test Results

No test documents sent yet

Send a test document to verify your configuration

API Keys

Configure your API key for document exchange

Your API Key

The API key you save here is used for all dashboard features including CSV Import, Transactions, and programmatic API access via the X-API-Key header.

View API Documentation →

Loading API keys...

Webhooks

Get notified when documents are delivered or received

Webhook Integration Guide

What are Webhooks?

Webhooks are automated HTTP POST requests that GoRoute sends to your server when events occur. Instead of polling our API, you get instant notifications when invoices are delivered, received, or fail.

Available Events

transaction.delivered

Fires when your outgoing invoice is successfully delivered to the recipient's Peppol Access Point.

transaction.failed

Fires when invoice delivery fails (validation error, recipient not found, network issue).

transaction.received

Fires when you receive an incoming invoice from another Peppol participant.

Setup Steps

1

Create an HTTPS endpoint on your server

Your endpoint must accept POST requests and return a 2xx status code.

2

Register your webhook URL here

Click "Add Webhook", enter your URL, and select which events to subscribe to.

3

Save your webhook secret

Copy the whsec_... secret shown after creation. Use it to verify webhook signatures.

4

Test your webhook

Click the "Test" button to send a test.ping event and verify your endpoint is working.

Example Payload

{
  "id": "evt_abc123xyz",
  "event_type": "transaction.received",
  "created_at": "2026-01-25T14:30:00Z",
  "data": {
    "transaction_id": "550e8400-e29b-41d4-a716-446655440000",
    "sender_id": "0088:7300010000001",
    "document_type": "invoice",
    "document_id": "INV-2026-001"
  }
}

Request Headers

Header	Description
X-Webhook-Signature	HMAC-SHA256 signature for verification
X-Event-Type	Event type (e.g., transaction.received)
X-Event-ID	Unique event ID for idempotency
X-Webhook-ID	Your webhook subscription ID

Signature Verification (Python Example)

import hmac
import hashlib

def verify_webhook(payload: bytes, signature: str, secret: str) -> bool:
    expected = hmac.new(
        secret.encode(),
        payload,
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", signature)

No activity yet

Events will appear here as invoices are sent, received, and processed

Webhook

Status

Event Type

Time	Event	Webhook	Status	HTTP	Latency	Actions
No delivery history Webhook deliveries will appear here when events are triggered

Time

Event

Webhook

Status

HTTP

Latency

Actions

No delivery history

Webhook deliveries will appear here when events are triggered

Showing 0 deliveries

Global E-Invoicing with Confidence

Document Status

Transaction Volume

Recent Activity

Quick Actions

Document Exchange Architecture

Participants

Service Groups

Registered Service Groups

Endpoints

Registered Endpoints

Document Archive

Reports

Monthly Transaction Summary

Delivery Report

Failed Transactions

Trading Partner Report

Document Type Breakdown

Compliance & Validation

Reconciliation Report

Archive & Retention

Full Transaction Log

Need a custom report?

Custom Report Request

Connectors

Zuora

Choose Integration Method

PEPPOL Extract

Webhook Callout

Enable PEPPOL Extract in Zuora

GoRoute API Endpoint

Automate with Zuora Workflow

What GoRoute Handles

Verify Connection

Webhook Endpoint

Signing Secret

Configure Zuora Notification Callout

Production Architecture: Trigger + Fetch

Required Event Subscriptions

Verify Connection

Recent Events

Zuora → UBL 2.1 Field Mappings

Oman-Specific Compliance Notes

VAT Registration

B2B vs B2C Determination

Currency & Tax Handling

Compliance Channels

QuickBooks

Connect QuickBooks Online

Webhook Endpoint

Verifier Token

What GoRoute Handles

Verify Connection

Recent Events

QuickBooks → UBL 2.1 Field Mappings

Xero

Connect Xero Organisation

Webhook Endpoint

Webhook Signing Key

What GoRoute Handles

Verify Connection

Recent Events

Xero → UBL 2.1 Field Mappings

Odoo

Choose Integration Method

XML-RPC / REST API

Odoo Webhook Module

Odoo Connection Details

Polling Configuration

Webhook Endpoint

Install GoRoute Module

What GoRoute Handles

Verify Connection

Recent Events

Odoo → UBL 2.1 Field Mappings

More Connectors

SAP

Oracle / NetSuite

Microsoft Dynamics 365

How Connectors Work