verifactu-validator 0.1.0__tar.gz

verifactu_validator-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FlexiGoTech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

verifactu_validator-0.1.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+include pyproject.toml
+recursive-include src/verifactu_validator py.typed
+recursive-include tests *.py *.xml

verifactu_validator-0.1.0/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: verifactu-validator
+Version: 0.1.0
+Summary: Spanish e-invoice (Veri*Factu / AEAT) validator: NIF/CIF/NIE checksum, SHA-256 chained hash, and QR URL builder per Spanish Tax Agency spec.
+Author-email: FlexiGoTech <comercial@flexigobe.com>
+Maintainer-email: FlexiGoTech <comercial@flexigobe.com>
+License: MIT
+Project-URL: Homepage, https://flexigotech.com/verifactu
+Project-URL: Documentation, https://flexigotech.com/verifactu
+Project-URL: Repository, https://github.com/Flexigobe/verifactu-validator
+Project-URL: Bug Tracker, https://github.com/Flexigobe/verifactu-validator/issues
+Project-URL: Commercial Odoo Module, https://flexigotech.com/verifactu
+Keywords: aeat,verifactu,spain,einvoice,odoo,facturae,compliance,invoice,sii,tributaria
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Accounting
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Natural Language :: Spanish
+Classifier: Natural Language :: English
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4; extra == "dev"
+Requires-Dist: pytest-cov>=4.1; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Dynamic: license-file
+
+# verifactu-validator — Spanish AEAT Veri*Factu Invoice Validator
+
+[![PyPI version](https://img.shields.io/pypi/v/verifactu-validator.svg)](https://pypi.org/project/verifactu-validator/)
+[![Python](https://img.shields.io/pypi/pyversions/verifactu-validator.svg)](https://pypi.org/project/verifactu-validator/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/Flexigobe/verifactu-validator/actions/workflows/ci.yml/badge.svg)](https://github.com/Flexigobe/verifactu-validator/actions/workflows/ci.yml)
+
+> **Days until Veri\*Factu becomes mandatory: 29** (target date: **2026-07-01**)
+>
+> Spanish anti-fraud invoicing law (RD 1007/2023) requires every B2B/B2C invoice
+> issued in Spain to be signed with a chained SHA-256 hash and to embed a QR
+> code pointing to the AEAT verification endpoint.
+
+`verifactu-validator` is a tiny, **zero-dependency** Python library that lets you:
+
+1. Validate Spanish **NIF / CIF / NIE** identifiers (real checksum algorithm).
+2. Build the **SHA-256 chained hash** of an invoice exactly as the AEAT spec
+   requires (previous-hash + invoice fields, hex output).
+3. Build the **Veri\*Factu QR URL** pointing to the AEAT TIKE-CONT endpoint.
+4. Run a **CLI**: `verifactu validate invoice.xml` → prints OK/FAIL per rule.
+
+## Quick start
+
+```python
+from verifactu_validator import validate_nif, build_invoice_hash, build_qr_url
+
+# 1. Validate a Spanish tax ID
+assert validate_nif("12345678Z")            # individual NIF
+assert validate_nif("B12345678")            # company CIF (example)
+
+# 2. Build a chained SHA-256 hash (AEAT Veri*Factu spec)
+h = build_invoice_hash(
+    previous_hash="0" * 64,
+    issuer_nif="B12345678",
+    invoice_number="F2026/0001",
+    issue_date="2026-07-01",
+    total_amount="121.00",
+)
+
+# 3. Build the QR URL embedded in the printed invoice
+url = build_qr_url(
+    issuer_nif="B12345678",
+    invoice_number="F2026/0001",
+    issue_date="2026-07-01",
+    total_amount="121.00",
+)
+print(url)
+# https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=B12345678&numserie=F2026%2F0001&fecha=01-07-2026&importe=121.00
+```
+
+CLI usage:
+
+```bash
+verifactu --help
+verifactu validate path/to/invoice.xml
+verifactu nif 12345678Z
+verifactu hash --prev 000...0 --nif B12345678 --num F2026/0001 --date 2026-07-01 --total 121.00
+verifactu qr   --nif B12345678 --num F2026/0001 --date 2026-07-01 --total 121.00
+```
+
+## Why this library exists
+
+The Veri\*Factu mandate is the biggest compliance shake-up Spanish SMBs have
+seen in a decade. Most accounting / ERP teams need a **drop-in helper** to:
+
+- Pre-flight customer master data (NIF/CIF columns are full of typos).
+- Compute the chained hash before posting an invoice.
+- Generate the QR PNG that goes on the printed PDF.
+
+This library covers exactly that surface. It is **deliberately small** so it
+can be vendored, audited, and certified without pulling a giant dependency
+tree into your ERP.
+
+## Full Odoo module: €369 one-off
+
+This validator is the open-source nucleus of our commercial Odoo app:
+
+> **Veri\*Factu for Odoo 17 / 18 / 19** — full submission to AEAT,
+> chained hash storage, QR on every PDF report, audit log, declarative
+> re-send, multi-company, ready for July 2026.
+>
+> **€369 one-off — flexigotech.com/verifactu**
+
+If you just need the algorithms, this PyPI package is MIT-licensed and free
+forever. If you need the full ERP integration, buy the Odoo module.
+
+## Installation
+
+```bash
+pip install verifactu-validator
+```
+
+Requires Python **3.10+**. Zero runtime dependencies.
+
+## Publishing (for maintainers)
+
+```bash
+pip install build twine
+python -m build
+twine upload dist/*
+```
+
+A GitHub Actions workflow (`.github/workflows/ci.yml`) runs the test suite on
+every push and pull request.
+
+## License
+
+MIT © 2026 [FlexiGoTech](https://flexigotech.com)
+
+---
+
+Made by **FlexiGoTech** in Barcelona. We build Odoo App Store modules for
+Spanish, French, German and EU compliance: Veri\*Factu, France PDP,
+XRechnung, Whistleblowing, Mirakl/Decathlon connectors, AliExpress
+connector. See the full catalogue at [flexigotech.com](https://flexigotech.com).

verifactu_validator-0.1.0/README.md

@@ -0,0 +1,115 @@
+# verifactu-validator — Spanish AEAT Veri*Factu Invoice Validator
+
+[![PyPI version](https://img.shields.io/pypi/v/verifactu-validator.svg)](https://pypi.org/project/verifactu-validator/)
+[![Python](https://img.shields.io/pypi/pyversions/verifactu-validator.svg)](https://pypi.org/project/verifactu-validator/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/Flexigobe/verifactu-validator/actions/workflows/ci.yml/badge.svg)](https://github.com/Flexigobe/verifactu-validator/actions/workflows/ci.yml)
+
+> **Days until Veri\*Factu becomes mandatory: 29** (target date: **2026-07-01**)
+>
+> Spanish anti-fraud invoicing law (RD 1007/2023) requires every B2B/B2C invoice
+> issued in Spain to be signed with a chained SHA-256 hash and to embed a QR
+> code pointing to the AEAT verification endpoint.
+
+`verifactu-validator` is a tiny, **zero-dependency** Python library that lets you:
+
+1. Validate Spanish **NIF / CIF / NIE** identifiers (real checksum algorithm).
+2. Build the **SHA-256 chained hash** of an invoice exactly as the AEAT spec
+   requires (previous-hash + invoice fields, hex output).
+3. Build the **Veri\*Factu QR URL** pointing to the AEAT TIKE-CONT endpoint.
+4. Run a **CLI**: `verifactu validate invoice.xml` → prints OK/FAIL per rule.
+
+## Quick start
+
+```python
+from verifactu_validator import validate_nif, build_invoice_hash, build_qr_url
+
+# 1. Validate a Spanish tax ID
+assert validate_nif("12345678Z")            # individual NIF
+assert validate_nif("B12345678")            # company CIF (example)
+
+# 2. Build a chained SHA-256 hash (AEAT Veri*Factu spec)
+h = build_invoice_hash(
+    previous_hash="0" * 64,
+    issuer_nif="B12345678",
+    invoice_number="F2026/0001",
+    issue_date="2026-07-01",
+    total_amount="121.00",
+)
+
+# 3. Build the QR URL embedded in the printed invoice
+url = build_qr_url(
+    issuer_nif="B12345678",
+    invoice_number="F2026/0001",
+    issue_date="2026-07-01",
+    total_amount="121.00",
+)
+print(url)
+# https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=B12345678&numserie=F2026%2F0001&fecha=01-07-2026&importe=121.00
+```
+
+CLI usage:
+
+```bash
+verifactu --help
+verifactu validate path/to/invoice.xml
+verifactu nif 12345678Z
+verifactu hash --prev 000...0 --nif B12345678 --num F2026/0001 --date 2026-07-01 --total 121.00
+verifactu qr   --nif B12345678 --num F2026/0001 --date 2026-07-01 --total 121.00
+```
+
+## Why this library exists
+
+The Veri\*Factu mandate is the biggest compliance shake-up Spanish SMBs have
+seen in a decade. Most accounting / ERP teams need a **drop-in helper** to:
+
+- Pre-flight customer master data (NIF/CIF columns are full of typos).
+- Compute the chained hash before posting an invoice.
+- Generate the QR PNG that goes on the printed PDF.
+
+This library covers exactly that surface. It is **deliberately small** so it
+can be vendored, audited, and certified without pulling a giant dependency
+tree into your ERP.
+
+## Full Odoo module: €369 one-off
+
+This validator is the open-source nucleus of our commercial Odoo app:
+
+> **Veri\*Factu for Odoo 17 / 18 / 19** — full submission to AEAT,
+> chained hash storage, QR on every PDF report, audit log, declarative
+> re-send, multi-company, ready for July 2026.
+>
+> **€369 one-off — flexigotech.com/verifactu**
+
+If you just need the algorithms, this PyPI package is MIT-licensed and free
+forever. If you need the full ERP integration, buy the Odoo module.
+
+## Installation
+
+```bash
+pip install verifactu-validator
+```
+
+Requires Python **3.10+**. Zero runtime dependencies.
+
+## Publishing (for maintainers)
+
+```bash
+pip install build twine
+python -m build
+twine upload dist/*
+```
+
+A GitHub Actions workflow (`.github/workflows/ci.yml`) runs the test suite on
+every push and pull request.
+
+## License
+
+MIT © 2026 [FlexiGoTech](https://flexigotech.com)
+
+---
+
+Made by **FlexiGoTech** in Barcelona. We build Odoo App Store modules for
+Spanish, French, German and EU compliance: Veri\*Factu, France PDP,
+XRechnung, Whistleblowing, Mirakl/Decathlon connectors, AliExpress
+connector. See the full catalogue at [flexigotech.com](https://flexigotech.com).

verifactu_validator-0.1.0/pyproject.toml

@@ -0,0 +1,86 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "verifactu-validator"
+version = "0.1.0"
+description = "Spanish e-invoice (Veri*Factu / AEAT) validator: NIF/CIF/NIE checksum, SHA-256 chained hash, and QR URL builder per Spanish Tax Agency spec."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [
+    { name = "FlexiGoTech", email = "comercial@flexigobe.com" },
+]
+maintainers = [
+    { name = "FlexiGoTech", email = "comercial@flexigobe.com" },
+]
+keywords = [
+    "aeat",
+    "verifactu",
+    "spain",
+    "einvoice",
+    "odoo",
+    "facturae",
+    "compliance",
+    "invoice",
+    "sii",
+    "tributaria",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Financial and Insurance Industry",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business :: Financial :: Accounting",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Natural Language :: Spanish",
+    "Natural Language :: English",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.4",
+    "pytest-cov>=4.1",
+    "ruff>=0.4",
+    "build>=1.0",
+    "twine>=4.0",
+]
+
+[project.urls]
+Homepage = "https://flexigotech.com/verifactu"
+Documentation = "https://flexigotech.com/verifactu"
+Repository = "https://github.com/Flexigobe/verifactu-validator"
+"Bug Tracker" = "https://github.com/Flexigobe/verifactu-validator/issues"
+"Commercial Odoo Module" = "https://flexigotech.com/verifactu"
+
+[project.scripts]
+verifactu = "verifactu_validator.cli:main"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+verifactu_validator = ["py.typed"]
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+testpaths = ["tests"]
+addopts = "-ra -q"
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "UP"]
+ignore = ["E501"]

verifactu_validator-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

verifactu_validator-0.1.0/src/verifactu_validator/__init__.py

@@ -0,0 +1,35 @@
+"""verifactu_validator — Spanish AEAT Veri*Factu invoice validator.
+
+Public API surface kept deliberately tiny so the library can be vendored,
+audited, and certified by Spanish accountants and ERP integrators.
+
+Exports
+-------
+- validate_nif(value) -> bool
+- validate_cif(value) -> bool
+- validate_nie(value) -> bool
+- validate_tax_id(value) -> bool   (auto-detects NIF / CIF / NIE)
+- build_invoice_hash(...) -> str   (SHA-256 chained hash, hex)
+- build_qr_url(...) -> str         (AEAT TIKE-CONT verification URL)
+"""
+
+from .hash import build_invoice_hash
+from .nif import (
+    validate_cif,
+    validate_nie,
+    validate_nif,
+    validate_tax_id,
+)
+from .qr import build_qr_url
+
+__all__ = [
+    "validate_nif",
+    "validate_cif",
+    "validate_nie",
+    "validate_tax_id",
+    "build_invoice_hash",
+    "build_qr_url",
+    "__version__",
+]
+
+__version__ = "0.1.0"

verifactu_validator-0.1.0/src/verifactu_validator/cli.py

@@ -0,0 +1,201 @@
+"""Command-line interface for verifactu-validator.
+
+Usage examples
+--------------
+    verifactu --help
+    verifactu nif 12345678Z
+    verifactu hash --prev 000...0 --nif B12345678 --num F2026/0001 \
+                   --date 2026-07-01 --total 121.00
+    verifactu qr   --nif B12345678 --num F2026/0001 \
+                   --date 2026-07-01 --total 121.00 [--production]
+    verifactu validate path/to/invoice.xml
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import Path
+from xml.etree import ElementTree as ET
+
+from . import __version__
+from .hash import build_invoice_hash, zero_hash
+from .nif import validate_tax_id
+from .qr import build_qr_url
+
+
+def _cmd_nif(args: argparse.Namespace) -> int:
+    ok = validate_tax_id(args.value)
+    print(f"{args.value}: {'OK' if ok else 'FAIL'}")
+    return 0 if ok else 1
+
+
+def _cmd_hash(args: argparse.Namespace) -> int:
+    prev = args.prev or zero_hash()
+    h = build_invoice_hash(
+        previous_hash=prev,
+        issuer_nif=args.nif,
+        invoice_number=args.num,
+        issue_date=args.date,
+        total_amount=args.total,
+    )
+    print(h)
+    return 0
+
+
+def _cmd_qr(args: argparse.Namespace) -> int:
+    url = build_qr_url(
+        issuer_nif=args.nif,
+        invoice_number=args.num,
+        issue_date=args.date,
+        total_amount=args.total,
+        production=args.production,
+    )
+    print(url)
+    return 0
+
+
+_NS_FACTURAE = {
+    "fe": "http://www.facturae.es/Facturae/2014/v3.2.2/Facturae",
+    "fe322": "http://www.facturae.gob.es/formato/Versiones/Facturaev3_2_2.xml",
+}
+
+
+def _findtext(root: ET.Element, *paths: str) -> str | None:
+    for p in paths:
+        node = root.find(p, _NS_FACTURAE)
+        if node is not None and node.text:
+            return node.text.strip()
+    return None
+
+
+def _cmd_validate(args: argparse.Namespace) -> int:
+    path = Path(args.xml)
+    if not path.is_file():
+        print(f"FAIL: file not found: {path}", file=sys.stderr)
+        return 2
+
+    try:
+        tree = ET.parse(path)
+    except ET.ParseError as exc:
+        print(f"FAIL: malformed XML — {exc}")
+        return 1
+
+    root = tree.getroot()
+
+    results: list[tuple[str, bool, str]] = []
+
+    # Rule 1: file is parseable.
+    results.append(("xml.parseable", True, "XML parsed successfully"))
+
+    # Rule 2: issuer NIF present and valid.
+    issuer_nif = _findtext(
+        root,
+        ".//SellerParty//TaxIdentificationNumber",
+        ".//SellerParty//{*}TaxIdentificationNumber",
+        ".//TaxIdentificationNumber",
+    )
+    if issuer_nif:
+        ok = validate_tax_id(issuer_nif)
+        results.append(("issuer.tax_id", ok, f"value={issuer_nif}"))
+    else:
+        results.append(("issuer.tax_id", False, "not found in XML"))
+
+    # Rule 3: at least one invoice number.
+    inv_num = _findtext(
+        root,
+        ".//InvoiceNumber",
+        ".//{*}InvoiceNumber",
+    )
+    results.append(
+        ("invoice.number", bool(inv_num), f"value={inv_num}" if inv_num else "missing")
+    )
+
+    # Rule 4: issue date present.
+    issue_date = _findtext(
+        root,
+        ".//IssueDate",
+        ".//{*}IssueDate",
+    )
+    results.append(
+        ("invoice.issue_date", bool(issue_date), f"value={issue_date}" if issue_date else "missing")
+    )
+
+    # Rule 5: total amount present.
+    total = _findtext(
+        root,
+        ".//TotalExecutableAmount",
+        ".//InvoiceTotal",
+        ".//{*}TotalExecutableAmount",
+        ".//{*}InvoiceTotal",
+    )
+    results.append(
+        ("invoice.total", bool(total), f"value={total}" if total else "missing")
+    )
+
+    width = max(len(name) for name, _, _ in results)
+    failed = 0
+    for name, ok, detail in results:
+        status = "OK  " if ok else "FAIL"
+        print(f"  [{status}] {name.ljust(width)}  {detail}")
+        if not ok:
+            failed += 1
+
+    print()
+    if failed == 0:
+        print(f"PASS: {len(results)} checks succeeded — {path.name}")
+        return 0
+    print(f"FAIL: {failed}/{len(results)} checks failed — {path.name}")
+    return 1
+
+
+def build_parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(
+        prog="verifactu",
+        description=(
+            "Spanish AEAT Veri*Factu invoice validator. "
+            "Full Odoo module: https://flexigotech.com/verifactu"
+        ),
+    )
+    p.add_argument("--version", action="version", version=f"verifactu-validator {__version__}")
+    sub = p.add_subparsers(dest="command", required=True)
+
+    p_nif = sub.add_parser("nif", help="Validate a Spanish NIF / CIF / NIE.")
+    p_nif.add_argument("value", help="Tax ID to validate")
+    p_nif.set_defaults(func=_cmd_nif)
+
+    p_hash = sub.add_parser("hash", help="Compute the SHA-256 chained invoice hash.")
+    p_hash.add_argument("--prev", default=None, help="Previous SHA-256 hex (default: all zeros).")
+    p_hash.add_argument("--nif", required=True, help="Issuer NIF / CIF / NIE.")
+    p_hash.add_argument("--num", required=True, help="Invoice serial+number.")
+    p_hash.add_argument("--date", required=True, help="Issue date (YYYY-MM-DD or DD-MM-YYYY).")
+    p_hash.add_argument("--total", required=True, help="Invoice total with VAT.")
+    p_hash.set_defaults(func=_cmd_hash)
+
+    p_qr = sub.add_parser("qr", help="Build the AEAT QR URL embedded in the PDF.")
+    p_qr.add_argument("--nif", required=True)
+    p_qr.add_argument("--num", required=True)
+    p_qr.add_argument("--date", required=True)
+    p_qr.add_argument("--total", required=True)
+    p_qr.add_argument(
+        "--production",
+        action="store_true",
+        help="Use the production AEAT endpoint instead of pre-production.",
+    )
+    p_qr.set_defaults(func=_cmd_qr)
+
+    p_val = sub.add_parser("validate", help="Validate a Facturae XML invoice file.")
+    p_val.add_argument("xml", help="Path to invoice .xml")
+    p_val.set_defaults(func=_cmd_validate)
+
+    return p
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    return int(args.func(args) or 0)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    raise SystemExit(main())