Support: support@tinplate.dev · Zero-Retention Edge Security Support Trust Center DPA GitHub Issues
Compliance & Business Live on Hub

Peppol BIS 3.0 UBL 2.1 / XRechnung E-Invoice XML Generator & SEPA EPC-QR API

Generate EN 16931 / Peppol BIS 3.0 UBL 2.1 XML and SEPA EPC-QR payloads from JSON, or parse UBL XML to JSON. Convert JSON invoices into EN 16931 / Peppol BIS Billing 3.0 / XRechnung 3.0 compliant UBL 2.1 XML or parse UBL XML back to JSON, with automatic SEPA EPC069-12 QR payment payload generation.

Interactive Sandbox · No API Key Required 200 OK · Ready
POST /v1/peppol-ubl-invoiceinput
200 OK sample / live responsejson
{
  "ok": true,
  "data": {
    "valid": true,
    "verdict": "valid",
    "mode": "json_to_ubl",
    "en16931_conformant": true,
    "math_valid": true,
    "customization_id": "urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0",
    "profile_id": "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0",
    "invoice": {
      "invoice_number": "INV-2026-0042",
      "issue_date": "2026-11-14",
      "due_date": "2026-11-28",
      "currency": "EUR",
      "seller": {
        "name": "Tinplate Labs GmbH",
        "country": "DE",
        "vat_number": "DE123456788",
        "iban": "DE89370400440532013000"
      },
      "buyer": {
        "name": "Example Holding BV",
        "country": "NL",
        "vat_number": "NL123456782B01"
      },
      "line_items": [
        {
          "description": "Tinplate Enterprise API Guardrails",
          "quantity": 1,
          "unit_price": 1000,
          "vat_rate": 0,
          "line_net": 1000
        }
      ],
      "subtotal_net": 1000,
      "discount": 0,
      "total_vat": 0,
      "total_gross": 1000,
      "reverse_charge": true
    },
    "ubl_xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>...",
    "epc_qr_payload": "BCD\n002\n1\nSCT\nCOBADEFFXXX\nTinplate Labs GmbH\nDE89370400440532013000\nEUR1000.00\n\n\nINV-2026-0042",
    "issues": []
  },
  "meta": {
    "request_id": "req_ubl_01",
    "ms": 1
  }
}
OpenAPI 3.0.3 Get All-Access Key ($29/mo) No signup. No payload storage.
Quickstart Code Examples
curl -X POST "https://api.tinplate.dev/v1/peppol-ubl-invoice" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TINPLATE_KEY" \
  -d '{"invoice":{"invoice_number":"INV-2026-0042","issue_date":"2026-11-14","due_date":"2026-11-28","currency":"EUR","seller":{"name":"Tinplate Labs GmbH","country":"DE","vat_number":"DE123456788","iban":"DE89370400440532013000"},"buyer":{"name":"Example Holding BV","country":"NL","vat_number":"NL123456782B01"},"line_items":[{"description":"Tinplate Enterprise API Guardrails","quantity":1,"unit_price":1000,"vat_rate":0,"net_amount":1000}],"subtotal_net":1000,"discount":0,"total_vat":0,"total_gross":1000,"reverse_charge":true},"seller_bic":"COBADEFFXXX","buyer_reference":"04011000-12345-67"}'
import { TinplateClient } from "@tinplate/sdk";

const tinplate = new TinplateClient({
  apiKey: process.env.TINPLATE_API_KEY!,
});

const { data, meta } = await tinplate.call("/v1/peppol-ubl-invoice", {
  "invoice": {
    "invoice_number": "INV-2026-0042",
    "issue_date": "2026-11-14",
    "due_date": "2026-11-28",
    "currency": "EUR",
    "seller": {
      "name": "Tinplate Labs GmbH",
      "country": "DE",
      "vat_number": "DE123456788",
      "iban": "DE89370400440532013000"
    },
    "buyer": {
      "name": "Example Holding BV",
      "country": "NL",
      "vat_number": "NL123456782B01"
    },
    "line_items": [
      {
        "description": "Tinplate Enterprise API Guardrails",
        "quantity": 1,
        "unit_price": 1000,
        "vat_rate": 0,
        "net_amount": 1000
      }
    ],
    "subtotal_net": 1000,
    "discount": 0,
    "total_vat": 0,
    "total_gross": 1000,
    "reverse_charge": true
  },
  "seller_bic": "COBADEFFXXX",
  "buyer_reference": "04011000-12345-67"
});
console.log(`[${meta.ms} ms]`, data);
import requests

response = requests.post(
    "https://api.tinplate.dev/v1/peppol-ubl-invoice",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_TINPLATE_KEY",
    },
    json={
  "invoice": {
    "invoice_number": "INV-2026-0042",
    "issue_date": "2026-11-14",
    "due_date": "2026-11-28",
    "currency": "EUR",
    "seller": {
      "name": "Tinplate Labs GmbH",
      "country": "DE",
      "vat_number": "DE123456788",
      "iban": "DE89370400440532013000"
    },
    "buyer": {
      "name": "Example Holding BV",
      "country": "NL",
      "vat_number": "NL123456782B01"
    },
    "line_items": [
      {
        "description": "Tinplate Enterprise API Guardrails",
        "quantity": 1,
        "unit_price": 1000,
        "vat_rate": 0,
        "net_amount": 1000
      }
    ],
    "subtotal_net": 1000,
    "discount": 0,
    "total_vat": 0,
    "total_gross": 1000,
    "reverse_charge": true
  },
  "seller_bic": "COBADEFFXXX",
  "buyer_reference": "04011000-12345-67"
}
)
print(response.json())
const response = await fetch("https://api.tinplate.dev/v1/peppol-ubl-invoice", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_TINPLATE_KEY",
  },
  body: JSON.stringify({
  "invoice": {
    "invoice_number": "INV-2026-0042",
    "issue_date": "2026-11-14",
    "due_date": "2026-11-28",
    "currency": "EUR",
    "seller": {
      "name": "Tinplate Labs GmbH",
      "country": "DE",
      "vat_number": "DE123456788",
      "iban": "DE89370400440532013000"
    },
    "buyer": {
      "name": "Example Holding BV",
      "country": "NL",
      "vat_number": "NL123456782B01"
    },
    "line_items": [
      {
        "description": "Tinplate Enterprise API Guardrails",
        "quantity": 1,
        "unit_price": 1000,
        "vat_rate": 0,
        "net_amount": 1000
      }
    ],
    "subtotal_net": 1000,
    "discount": 0,
    "total_vat": 0,
    "total_gross": 1000,
    "reverse_charge": true
  },
  "seller_bic": "COBADEFFXXX",
  "buyer_reference": "04011000-12345-67"
}),
});
const result = await response.json();
console.log(result);
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tinplate_peppol_ubl_invoice",
    "arguments": {
      "invoice": {
        "invoice_number": "INV-2026-0042",
        "issue_date": "2026-11-14",
        "due_date": "2026-11-28",
        "currency": "EUR",
        "seller": {
          "name": "Tinplate Labs GmbH",
          "country": "DE",
          "vat_number": "DE123456788",
          "iban": "DE89370400440532013000"
        },
        "buyer": {
          "name": "Example Holding BV",
          "country": "NL",
          "vat_number": "NL123456782B01"
        },
        "line_items": [
          {
            "description": "Tinplate Enterprise API Guardrails",
            "quantity": 1,
            "unit_price": 1000,
            "vat_rate": 0,
            "net_amount": 1000
          }
        ],
        "subtotal_net": 1000,
        "discount": 0,
        "total_vat": 0,
        "total_gross": 1000,
        "reverse_charge": true
      },
      "seller_bic": "COBADEFFXXX",
      "buyer_reference": "04011000-12345-67"
    }
  }
}
OpenAPI 3.0.3 Schema Contract

Request Parameters & Response Schema Reference

Request Body Parameters (POST /v1/peppol-ubl-invoice)

ParameterType & ConstraintsDescription
invoice optional object Structured invoice object to validate against EN 16931, convert to Peppol BIS Billing 3.0 UBL 2.1 XML, and generate a SEPA EPC-QR payment payload.
ubl_xml optional string
minLen: 20, maxLen: 262144
Optional raw UBL 2.1 / Peppol BIS Billing 3.0 / XRechnung <Invoice> XML string to parse into JSON and validate.
seller_bic optional string
maxLen: 11
Optional seller BIC/SWIFT code for EPC SEPA QR generation.
buyer_reference optional string
maxLen: 128, default: "BUYER-REF-01"
Peppol BT-10 BuyerReference / German XRechnung Leitweg-ID.

Response data Object Fields (200 OK)

FieldTypeDescription
valid boolean Field 'valid'
verdict "valid" | "warnings_only" | "invalid" Field 'verdict'
mode "json_to_ubl" | "ubl_to_json" Field 'mode'
en16931_conformant boolean Field 'en16931_conformant'
math_valid boolean Field 'math_valid'
customization_id string Field 'customization_id'
profile_id string Field 'profile_id'
invoice object Field 'invoice'
ubl_xml string Generated or normalized Peppol BIS Billing 3.0 UBL 2.1 XML document.
epc_qr_payload string | null EPC069-12 SEPA Credit Transfer QR payload (GiroCode) for EUR invoices with a valid seller IBAN.
issues object[] Field 'issues'

What Peppol UBL 2.1 / XRechnung E-Invoice Converter & EPC-QR API Detects & Validates

  • Generates EN 16931 / Peppol BIS Billing 3.0 / German XRechnung 3.0 compliant UBL 2.1 Invoice XML (380) and CreditNote (381)
  • Computes exact line extension, tax breakdown by category (S, AE, K, Z, E), and payable totals
  • Builds European Payments Council EPC069-12 (GiroCode) SEPA Credit Transfer QR payload string when supplier IBAN and EUR currency are present
  • Bidirectional mode ('ubl_to_json') parses incoming UBL 2.1 XML invoices into normalized JSON
Honest Engineering Boundaries

Known Limitations & Test Verification

Release: v1.0.39 · Verified: 16 November 2026 · Portfolio Median: 0.318 ms in-Worker V8 compute (add 15–65 ms HTTPS RTT) · See Full Portfolio Benchmarks →

  • Generates and parses UBL 2.1 XML structure and EN 16931 mandatory business terms; it does not transmit documents over an AS4 Peppol Access Point.
  • Tested v1.0.6 (14 November 2026).

Direct All-Access & Marketplace Plans

Direct Polar All-Access Keys unlock all 42 APIs (49 endpoints), /v1/pipeline, and /mcp on api.tinplate.dev: Pro ($29/mo · 120 req/min · 100k/mo · 128 KB) or Team ($79/mo · 300 req/min · 500k/mo · 256 KB).

PlanMonthly PriceIncluded RequestsRate LimitMax PayloadBest For
BASIC$0.00 / mo500 / month10 req / min64 KBEvaluation & CI smoke tests
PRO$9.99 / mo15,000 / month60 req / min128 KBSolo devs & production apps
ULTRA$29.99 / mo100,000 / month300 req / min256 KBGrowing SaaS & multi-agent pipelines
MEGA$79.99 / mo500,000 / month1,000 req / min256 KBHigh-volume enterprise workloads

Frequently Asked Questions

How does this pair with API #20 (EN 16931 Invoice Validator)?

Use API #39 to convert ERP JSON into Peppol UBL 2.1 XML (or parse incoming UBL XML), and use API #20 to audit mathematical and BR-CO/BR-S business rule compliance.

Does it support German XRechnung Leitweg-ID?

Yes—pass the Leitweg-ID in buyer_reference (BT-10) and it is emitted directly into <cbc:BuyerReference>.

Zero Payload Logging

Data Handling, Privacy & Proxy Disclosure

Invoice payloads and generated UBL XML are processed statelessly in memory.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Requests via RapidAPI or Zyla traverse marketplace proxies; use a Direct Bearer Key for zero-intermediary routing.

Related Tinplate APIs

POST /v1/invoice-validator Tier 1

Invoice & EU EN 16931 / Peppol Validator API

Audit extracted invoices for line-item math errors, VAT mismatches, and Peppol compliance.

POST /v1/eu-vat-calculator Live

EU Cross-Border VAT Rate & Reverse-Charge Calculator API

Determine exact EU VAT rates, B2B reverse charge, EN 16931 tax category codes, and mandatory invoice legal text.

POST /v1/eu-vat-iban/iban Live

EU VAT & IBAN/BIC Validator API

Validate IBANs, BIC/SWIFT codes, and EU/UK VAT numbers with live EU VIES lookup.