# VeriFactura — Complete Technical, Normative & API Reference (`llms-full.txt`) > Canonical Origin: `https://verifactura.eu` (legacy `https://facturx.openeurotech.com` redirects via HTTP 301) > Provider: OpenEuroTech (`https://openeurotech.com`) | Companion PDF Suite: Atelier Cloud (`https://ateliercloud.eu`) > Pricing: EUR 0 / forever ($0), zero signup, zero API keys, zero watermarks (`https://verifactura.eu/pricing.md`) > Last Verified: 2026-11-17 --- ## 1. Architecture & Data Custody Contract VeriFactura is a dual-tier European electronic invoicing workbench for **CEN EN 16931-1**: 1. **Tier 1 — Default 100% Client-Side Browser Engine (`web/`):** - Executes XML extraction (`pdfjs-dist`), dual-syntax UN/CEFACT CII D16B & OASIS UBL 2.1 validation (45+ localized diagnostic rules), multi-page ISO 19005-3 PDF/A-3b generation (`pdf-lib` + subsetted Arimo Regular/Bold TrueType Unicode fonts + sRGB IEC61966-2.1 ICC profile), custom visual PDF hybrid wrapping (`embedFacturxInExistingPdf`), vector EPC069-12 SEPA QR ("GiroCode") encoding, nested ANAF SPV `.zip` + `semnatura_*.xml` unpacking (`fflate`), and persistent archiving inside the browser's **Origin Private File System (OPFS)** (`factur-cloud/`). - **Zero network upload** occurs during browser validation, conversion, generation, or vault storage. 2. **Tier 2 — Opt-In Stateless Pure-Rust Verification Server (`server/`, `facturx-server`):** - Invoked only when a user clicks the normative verification button or calls `POST /api/v1/verify` or `POST /mcp` programmatically. - Evaluates up to **15 MiB** payloads strictly in volatile RAM with zero JVM dependencies and discards all document bytes immediately upon response serialization (`Cache-Control: no-store`, `X-Data-Custody: stateless-in-memory-discarded`). - Runs 7 verification engines over 35 embedded normative schema files: - `xsd_w3c`: `uppsala` W3C XSD 1.1 grammar & XXE rejection (CII D16B, UBL 2.1 Invoice & CreditNote) - `en16931_semantic`: `en16931` 334 fixed-point decimal business rules + FR SIREN/TVA Luhn/mod-97, DE Leitweg-ID MOD 97-10, RO CUI mod-11 & CIUS-RO 1.0.1 + OASIS SVRL generation - `schematron_cen`: Official CEN EN 16931-1 XPath 3.1 ISO Schematron (CII & UBL) - `schematron_facturx`: FNFE-MPE Factur-X 1.0.07 / ZUGFeRD 2.2 profile Schematron - `schematron_fr`: French AFNOR `XP Z12-012` (`BR-FR-*`) Schematron - `schematron_de`: German KoSIT `XRechnung 3.0.2` (`BR-DE-*`) Schematron - `pdfa3_iso19005`: Binary `lopdf` + `ttf-parser` ISO 19005-3 PDF/A-3b inspector (`/AF`, `/AFRelationship`, `/EmbeddedFiles` `/Subtype`, XMP `pdfaid` + `pdfaExtension`, ICC `acsp` sRGB `OutputIntents`, embedded font streams & Unicode CMaps, zero encryption/LZW/JS) 3. **Entity Disambiguation:** - VeriFactura (`https://verifactura.eu`) is an EN 16931 European e-invoicing suite and has **no relation** to Spain's AEAT *Veri\*factu* POS fiscalization framework (Real Decreto 1007/2023). --- ## 2. REST API & Streamable HTTP MCP Quickstart ### 2.1 `GET https://verifactura.eu/api/health` Returns server liveness, version, origin, and endpoint paths. ### 2.2 `GET https://verifactura.eu/api/v1/engines` Returns all 7 active Rust verification engines, embedded schema counts (`35`), `maxUploadBytes` (`15728640`), and `rateLimitPerMinute` (`60`). ### 2.3 `POST https://verifactura.eu/api/v1/verify` - **Accepted Content-Types:** - `multipart/form-data` with field `file` (`.pdf` or `.xml`) - `application/pdf` (raw binary hybrid PDF/A-3b) - `application/xml` or `text/xml` (raw UTF-8 CII D16B or UBL 2.1 XML) - **Query Parameters:** - `checks`: `all` (default) or comma-separated subset of `xsd,en16931,cen,facturx,fr,de,pdfa3` - `includeSvrl`: `true` | `false` (default `false`; includes full OASIS SVRL XML report string) - **Example (`curl`):** ```bash curl -fsS -F "file=@invoice.pdf" "https://verifactura.eu/api/v1/verify?includeSvrl=true" ``` - **JSON Response Fields:** - `isValid` (`boolean`), `containerType` (`"PDF"` | `"XML"`), `syntax` (`"CII"` | `"UBL"`), `detectedProfile` (`string`), `sha256` (`64-char hex`), `custodyPolicy` (`"stateless-in-memory-discarded"`), `durationMs` (`number`), `engines[]`, `violations[]` (`code`, `severity`, `engine`, `message`, `location`), and optional `svrlXml`. ### 2.4 `POST https://verifactura.eu/mcp` (Streamable HTTP JSON-RPC 2.0) - **Authentication:** None (`EUR 0`, public stateless endpoint). - **MCP Client Config (`.mcp.json`):** ```json { "mcpServers": { "verifactura": { "type": "http", "url": "https://verifactura.eu/mcp" } } } ``` - **Tools:** - `verify_einvoice`: `{ "xml"?: string, "content_base64"?: string, "filename"?: string, "checks"?: string, "include_svrl"?: boolean }` - `list_normative_engines`: `{}` --- ## 3. European E-Invoicing Mandate Timeline (Verified November 2026) - **Romania (In Effect — OUG 120/2021, Law 296/2023, OUG 69/2024):** Mandatory ANAF RO e-Factura (`CIUS-RO 1.0.1` OASIS UBL 2.1) clearance for domestic B2B since July 1, 2024 and domestic B2C since January 1, 2025 (5 calendar days submission deadline). - **Germany (Phased 2025–2028 — Wachstumschancengesetz, § 14 UStG):** - Jan 1, 2025: Universal B2B e-invoice reception mandate for all German businesses (including § 19 UStG Kleinunternehmer). - Jan 1, 2027: Mandatory B2B structured e-invoice issuance (`ZUGFeRD 2.2` EN 16931+ or `XRechnung 3.0.2`) for companies with prior-year turnover > EUR 800,000. - Jan 1, 2028: Universal B2B issuance mandate for all remaining German businesses. - **France (Phased 2026–2027 — Ordonnance 2021-1190, Art. 91 Loi de finances 2024):** - Sep 1, 2026: Universal reception mandate for all French VAT-liable / SIREN entities + mandatory issuance & e-reporting for Grandes Entreprises and ETI (`Factur-X`, `UBL`, `CII` via PA/PDP & PPF). - Sep 1, 2027: Mandatory issuance & e-reporting extended to all French PME, TPE, and micro-entrepreneurs (`Art. 293 B CGI`). - **European Union ViDA (2030+ — VAT in the Digital Age):** Harmonized EN 16931 intra-EU cross-border e-invoicing and real-time digital reporting. --- ## 4. High-Frequency Diagnostic Rules & Canonical Reference URLs Every diagnostic rule below has a dedicated reference page with CII D16B and UBL 2.1 XML examples at `https://verifactura.eu/standards/rules/` (and `/de/...`, `/fr/...`, `/ro/...`): - `br-01`..`br-16`: Core mandatory invoice header, seller/buyer names, and minimum 1 invoice line (`BT-1`, `BT-2`, `BT-27`, `BT-44`, `BG-25`). - `br-co-09`: Seller/Buyer VAT identifier (`BT-31` / `BT-48`) must carry an ISO 3166-1 alpha-2 prefix (or `EL` for Greece). - `br-co-10` / `br-co-13` / `br-co-15` / `br-dec-12`: Exact 2-decimal Monetary Summation equations (`BT-106`, `BT-109`, `BT-110`, `BT-112`, `BT-115`). - `br-s-08` / `br-s-09`: Standard-rate (`S`) taxable base sum and VAT calculation matching. - `br-co-19` / `br-e-05` / `br-ae-02` / `br-ic-02`: VAT exemption reason (`BT-120`) and reverse-charge / intra-community VAT ID couplings. - `br-55`: Credit note (`TypeCode 381`) mandatory preceding invoice reference (`BT-25`). - `br-fr-04` / `br-fr-10`: French 9-digit SIREN Luhn checksum (`schemeID="0002"`) and French VAT modulo-97 key check. - `br-de-01` / `br-de-15` / `br-de-17` / `br-de-21`: German KoSIT XRechnung payment instructions (`BG-16`), `BuyerReference` / `Leitweg-ID` (`BT-10`), seller contact (`BG-6`), and profile customization ID. - `br-ro-001` / `br-ro-030` / `br-ro-100` / `br-ro-110` / `br-ro-cui`: Romanian `CIUS-RO 1.0.1` customization URN, foreign-currency `RON` `BT-6`/`BT-111`, ISO 3166-2:RO county codes (`RO-B`, `RO-CJ`), Bucharest `SECTOR1`..`SECTOR6`, and CUI modulo-11 check digit. - `pdf-a3-af` / `pdf-a3-xmp` / `pdf-a3-icc` / `pdf-a3-font`: ISO 19005-3 `/AF` embedded XML relationship, XMP `pdfaid` + `pdfaExtension`, sRGB `OutputIntents`, and embedded TrueType font CMap compliance.