Support: support@tinplate.dev · Zero-Retention Edge Security Support Trust Center DPA GitHub Issues
Compliance & Business Tier 1 All-Access

Invoice Math & EU EN 16931 / Peppol Validator API — Verify Totals & VAT Rules

Audit extracted invoices for line-item math errors, VAT mismatches, and Peppol compliance. Validate extracted invoice JSON for line-item arithmetic, VAT rate compliance, reverse-charge rules, IBAN/VAT syntax, and EU EN 16931 / Peppol conformance.

Interactive Sandbox · No API Key Required 200 OK · Ready
POST /v1/invoice-validatorinput
200 OK sample / live responsejson
{
  "ok": true,
  "data": {
    "valid": true,
    "verdict": "valid",
    "math_valid": true,
    "en16931_conformant": true,
    "computed_totals": {
      "subtotal_net": 100,
      "total_vat": 0,
      "total_gross": 100,
      "vat_breakdown": [
        {
          "vat_rate": 0,
          "taxable_net": 100,
          "vat_amount": 0,
          "gross_amount": 100
        }
      ]
    },
    "issues": []
  },
  "meta": {
    "request_id": "req_inv_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/invoice-validator" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TINPLATE_KEY" \
  -d '{"invoice":{"invoice_number":"INV-2026-0412","issue_date":"2026-11-14","currency":"EUR","seller":{"name":"Acme GmbH","vat_number":"DE123456789","country_code":"DE"},"buyer":{"name":"Client BV","vat_number":"NL123456782B01","country_code":"NL"},"line_items":[{"description":"Cloud API Pro","quantity":2,"unit_price":50,"net_amount":100,"vat_rate":0,"vat_amount":0,"gross_amount":100}],"subtotal_net":100,"total_vat":0,"total_gross":100,"reverse_charge":true},"check_en16931":true}'
import { TinplateClient } from "@tinplate/sdk";

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

const { data, meta } = await tinplate.call("/v1/invoice-validator", {
  "invoice": {
    "invoice_number": "INV-2026-0412",
    "issue_date": "2026-11-14",
    "currency": "EUR",
    "seller": {
      "name": "Acme GmbH",
      "vat_number": "DE123456789",
      "country_code": "DE"
    },
    "buyer": {
      "name": "Client BV",
      "vat_number": "NL123456782B01",
      "country_code": "NL"
    },
    "line_items": [
      {
        "description": "Cloud API Pro",
        "quantity": 2,
        "unit_price": 50,
        "net_amount": 100,
        "vat_rate": 0,
        "vat_amount": 0,
        "gross_amount": 100
      }
    ],
    "subtotal_net": 100,
    "total_vat": 0,
    "total_gross": 100,
    "reverse_charge": true
  },
  "check_en16931": true
});
console.log(`[${meta.ms} ms]`, data);
import requests

response = requests.post(
    "https://api.tinplate.dev/v1/invoice-validator",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_TINPLATE_KEY",
    },
    json={
  "invoice": {
    "invoice_number": "INV-2026-0412",
    "issue_date": "2026-11-14",
    "currency": "EUR",
    "seller": {
      "name": "Acme GmbH",
      "vat_number": "DE123456789",
      "country_code": "DE"
    },
    "buyer": {
      "name": "Client BV",
      "vat_number": "NL123456782B01",
      "country_code": "NL"
    },
    "line_items": [
      {
        "description": "Cloud API Pro",
        "quantity": 2,
        "unit_price": 50,
        "net_amount": 100,
        "vat_rate": 0,
        "vat_amount": 0,
        "gross_amount": 100
      }
    ],
    "subtotal_net": 100,
    "total_vat": 0,
    "total_gross": 100,
    "reverse_charge": true
  },
  "check_en16931": true
}
)
print(response.json())
const response = await fetch("https://api.tinplate.dev/v1/invoice-validator", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_TINPLATE_KEY",
  },
  body: JSON.stringify({
  "invoice": {
    "invoice_number": "INV-2026-0412",
    "issue_date": "2026-11-14",
    "currency": "EUR",
    "seller": {
      "name": "Acme GmbH",
      "vat_number": "DE123456789",
      "country_code": "DE"
    },
    "buyer": {
      "name": "Client BV",
      "vat_number": "NL123456782B01",
      "country_code": "NL"
    },
    "line_items": [
      {
        "description": "Cloud API Pro",
        "quantity": 2,
        "unit_price": 50,
        "net_amount": 100,
        "vat_rate": 0,
        "vat_amount": 0,
        "gross_amount": 100
      }
    ],
    "subtotal_net": 100,
    "total_vat": 0,
    "total_gross": 100,
    "reverse_charge": true
  },
  "check_en16931": true
}),
});
const result = await response.json();
console.log(result);
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tinplate_invoice_validator",
    "arguments": {
      "invoice": {
        "invoice_number": "INV-2026-0412",
        "issue_date": "2026-11-14",
        "currency": "EUR",
        "seller": {
          "name": "Acme GmbH",
          "vat_number": "DE123456789",
          "country_code": "DE"
        },
        "buyer": {
          "name": "Client BV",
          "vat_number": "NL123456782B01",
          "country_code": "NL"
        },
        "line_items": [
          {
            "description": "Cloud API Pro",
            "quantity": 2,
            "unit_price": 50,
            "net_amount": 100,
            "vat_rate": 0,
            "vat_amount": 0,
            "gross_amount": 100
          }
        ],
        "subtotal_net": 100,
        "total_vat": 0,
        "total_gross": 100,
        "reverse_charge": true
      },
      "check_en16931": true
    }
  }
}
OpenAPI 3.0.3 Schema Contract

Request Parameters & Response Schema Reference

Request Body Parameters (POST /v1/invoice-validator)

ParameterType & ConstraintsDescription
invoice required object Field 'invoice'
rounding_tolerance optional number
min: 0, max: 1, default: 0.02
Allowed rounding difference per line or total in currency units (default 0.02).
check_en16931 optional boolean
default: true
Verify mandatory EN 16931 / Peppol BIS Billing 3.0 fields (BT-1..BT-115).

Response data Object Fields (200 OK)

FieldTypeDescription
valid boolean Field 'valid'
verdict "valid" | "warnings_only" | "invalid" Field 'verdict'
math_valid boolean Field 'math_valid'
en16931_conformant boolean Field 'en16931_conformant'
computed_totals object Field 'computed_totals'
issues object[] Field 'issues'

What Invoice & EU EN 16931 / Peppol Validator API Detects & Validates

  • Line-item arithmetic: quantity × unit_price - discount = net_amount (with configurable rounding tolerance)
  • Tax breakdown verification: sum of net amounts, per-rate VAT buckets, and net + VAT = gross total
  • EU EN 16931 & Peppol BIS Billing 3.0 mandatory fields (supplier/buyer VAT IDs, issue date, currency, tax exemption reason for 0% VAT)
  • Cross-border EU B2B reverse-charge validation
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 →

  • Validates structured JSON extracted from invoices (e.g. from an LLM or OCR pipeline); does not perform raw PDF/image OCR itself.
  • Tested v1.0.4 (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

Why validate invoices after LLM / Document AI extraction?

Vision LLMs and OCR models frequently misread a digit or hallucinate totals. Running deterministic math and EN 16931 checks catches extraction errors before ERP import.

Does it handle penny-rounding differences?

Yes, you can configure rounding tolerance (default ±0.02) to distinguish rounding conventions from real arithmetic errors.

Does it check supplier IBAN and EU VAT IDs?

Yes, it validates supplier and customer VAT IDs and payment IBANs automatically.

Zero Payload Logging

Data Handling, Privacy & Proxy Disclosure

Stateless in-memory invoice verification. Zero financial data is logged or retained.

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/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.

POST /v1/hu-business-validator Compliance & Business

Hungarian Business Document & NAV Validator API

Validate Hungarian adószám, cégjegyzékszám, GIRO bank accounts, and NAV invoice rules.

POST /v1/locale-value-parser AI Data Prep

Text-to-Structured Date, Money & Unit Parser API

Normalize messy EU/US prices, dates, percentages, and measurements into structured JSON.