IB InvoiceBridge API
GitHub Run locally
E-invoicing compliance API

Mandates are coming. Your billing system can stay.

Turn existing invoice JSON into country-specific e-invoice workflows: mandate checks, validation, structured transformation, routing, status tracking, and audit evidence. Belgium is implemented first.

View API docs See pricing
Belgium profile implemented Country roadmap built in Idempotent send flow
JSON
invoice_be_2026_0001.json
EUR 295.00 - B2B - Belgium
accepted
POST /v1/invoices/send
-> profile: BE_B2B_PEPPOL_MVP
-> format: PEPPOL_BIS_BILLING_3_UBL_LIKE
-> network: PEPPOL_MOCK

STATUS accepted
provider_reference MOCK-PEPPOL-9A42F7C13B10

AUDIT
invoice_received
validation_passed
transformed
submitted
accepted
21tests passing
5audit event types
0production compliance claims
Process

Existing invoice JSON, workflow added.

Three steps from your billing system to a structured e-invoice workflow.

01
BE

Check the mandate

Look up country and transaction metadata before transformation. The MVP supports Belgium B2B Peppol-style invoices.

02
XML

Validate and transform

Validate VAT IDs, buyer routing ID, VAT rates, line totals, tax totals, and payable totals, then generate sandbox UBL-like XML.

03
API

Route, track, audit

Submit through a deterministic mock Peppol provider, track status, and store chronological audit events with payload hashes.

Country mandates

Clickable compliance paths, by country.

The product promise is not "generate an invoice." It is a reusable workflow for each mandate: know the rule, validate before rejection, transform into the required structure, route to the right network, and keep evidence when finance asks what happened.

Implemented sandbox profile

Belgium B2B Peppol

Official source
Mandate snapshot Mandatory from January 1, 2026 for nearly all Belgian VAT-liable B2B transactions.
Network or channel Peppol-style network routing
Format direction EN 16931 / Peppol BIS Billing 3.0 UBL-style XML
The pain

PDF and email workflows do not solve structured B2B exchange. Platforms need buyer routing IDs, tax-total validation, delivery status, and evidence without replacing the billing system.

How InvoiceBridge solves it

The implemented Belgium MVP validates normalized invoice JSON, transforms valid invoices into sandbox UBL-like XML, submits through a mock Peppol provider, and stores status plus audit hashes.

  • Mandate check endpoint for Belgium B2B
  • Buyer routing ID and VAT ID validation
  • Structured XML transformation
  • Mock provider status and audit trail

Snapshot as of May 17, 2026. Country rules need legal review before production. This repository currently implements Belgium only; the other country cards show the product roadmap and why the architecture is valuable beyond one mandate.

Features

Everything the workflow needs, nothing it should fake.

01

Structured validation errors

Machine-readable codes for missing VAT IDs, invalid VAT rates, routing gaps, and total mismatches.

02

UBL-like transformation

XML is generated with structured APIs and clearly marked as sandbox output, not certified production UBL.

03

Provider abstraction

The mock provider preserves the shape needed for real access point integration later.

04

Audit trail evidence

Invoices, validation results, transformed XML, submissions, and audit events are persisted with SHA-256 hashes where practical.

Infrastructure

Built like infrastructure, scoped like an MVP.

FastAPI, Pydantic v2, SQLAlchemy, Alembic, PostgreSQL, Docker Compose, pytest, ruff, mypy, API key auth, request IDs, and OpenAPI docs. 

DATA MODEL
Invoice
InvoiceSubmission
ValidationResult
AuditEvent
CountryProfile

SECURITY NOTES
X-API-Key required on /v1
VAT IDs masked in logs
Payload size checks
No secrets in code
Pricing

Simple, transparent API pricing.

Start free in the sandbox. Upgrade when you are ready to integrate the workflow into a real product. Billing and metering are not implemented in this repository yet.

Sandbox
$0 /month

For developers evaluating the workflow locally.

  • Local/demo use
  • Belgium MVP profile
  • Validation and transform
  • Mock send
  • OpenAPI docs
Start free
Most popular
Launch
$249 /month

For SaaS teams testing e-invoicing readiness.

  • 5,000 workflows/month
  • API key access
  • Audit trail
  • Idempotency
  • Email support
Review Launch scope
Growth
$799 /month

For platforms preparing production integration.

  • 25,000 workflows/month
  • Webhook status events when available
  • Longer audit retention
  • Priority support
  • Integration planning
Review Growth scope
Platform
Custom

For ERP, marketplace, and multi-country platforms.

  • Custom volume
  • Provider integration planning
  • Additional country profiles
  • Security review
  • SLA planning
Discuss Platform scope
Compare

Plan details, side by side.

Feature Sandbox Launch Growth Platform
Monthly invoice workflowsDemo/local5,00025,000Custom
Belgium B2B MVP profileYesYesYesYes
UBL-like transformYesYesYesYes
Mock Peppol submissionYesYesYesYes
Audit trailYesYesYesYes
Webhook deliveryNoPlannedPlannedCustom
Real Peppol providerNoNoPlanningCustom integration
SupportDocsEmailPriorityCustom
FAQ

Common questions.

Is this production-certified for Peppol?

No. The current version is a sandbox MVP with UBL-like XML and a mock Peppol provider.

Who is this for?

ERP systems, accounting SaaS, billing platforms, B2B marketplaces, and cross-border sellers.

Why not just generate PDFs?

The MVP treats PDF as not compliant for the Belgium B2B profile. This is about structured invoice workflows.

Can this support KSeF later?

The architecture is designed for additional profiles, but Poland KSeF is not implemented in this repository.

Prototype your compliance workflow before the country-by-country rebuild.

Validate invoice JSON, transform it into sandbox UBL-like XML, simulate routing, track status, and store audit evidence.

View API docs Run locally