# securibox/facturx architecture

> Architecture diagram of the GitHub repository securibox/facturx, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/securibox/facturx
- Repository: https://github.com/securibox/facturx

## Overview

Securibox.FacturX is a .NET library for hybrid Factur-X invoices: profile-specific invoice data is serialized into XML and embedded in a PDF, while import extracts the embedded XML and can deserialize it. Validation covers the embedded XML’s XSD and Schematron rules, plus PDF/A-3 and XMP checks. The README documents all five invoice profiles. Source excerpts show exporter validation and PDF assembly; importer dependencies are supported by the SOURCE INDEX. Profile models and some validation internals are represented at their existing directories because their implementations were not sampled.

Main entry points: [`Securibox.FacturX/FacturxImporter.cs`](https://github.com/securibox/facturx/blob/main/Securibox.FacturX/FacturxImporter.cs) (PDF importer), [`Securibox.FacturX/FacturxExporter.cs`](https://github.com/securibox/facturx/blob/main/Securibox.FacturX/FacturxExporter.cs) (PDF exporter), [`Securibox.FacturX/Core/InvoiceBuilder`](https://github.com/securibox/facturx/tree/main/Securibox.FacturX/Core/InvoiceBuilder) (Invoice model builder), [`Securibox.FacturX/Schematron/Types/Assert.cs`](https://github.com/securibox/facturx/blob/main/Securibox.FacturX/Schematron/Types/Assert.cs) (Schematron assertions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_creation["Invoice creation"]
  node_exporter["PDF exporter<br/>[FacturxExporter.cs]"]
  node_invoice_builder["Invoice model builder<br/>[InvoiceBuilder]"]
end

subgraph group_formats["Invoice formats"]
  node_profile_models["Profile invoice models"]
  node_profile_levels["Profile levels"]
  node_xml_models["Invoice XML models"]
  node_enumeration["Enumeration support<br/>[Enumeration.cs]"]
end

subgraph group_reading["Import and validation"]
  node_importer["PDF importer<br/>[FacturxImporter.cs]"]
  node_xml_converter["XML deserialization"]
  node_pdf_services["PDF and XMP checks<br/>[FacturxImporter.cs]"]
  node_compatibility["Compatibility helpers"]
end

subgraph group_rules["Validation rules"]
  node_xsd_validator["XSD validation"]
  node_schematron_validator["Schematron validation"]
  node_schematron_assert["Schematron assertions<br/>[Assert.cs]"]
  node_schematron_schema["Schematron schema<br/>[Schema.cs]"]
  node_validation_report["Validation reports"]
end

node_caller(("Library consumer"))

node_caller -->|"creates PDF"| node_exporter
node_caller -->|"imports invoice"| node_importer
node_caller -.->|"builds invoice"| node_invoice_builder
node_invoice_builder -.->|"builds models"| node_xml_models
node_exporter -->|"serializes profile"| node_profile_models
node_exporter -->|"validates XML"| node_xsd_validator
node_exporter -->|"validates XML"| node_schematron_validator
node_exporter -->|"selects profile"| node_profile_levels
node_exporter -->|"returns PDF stream"| node_caller
node_importer -->|"checks PDF metadata"| node_pdf_services
node_importer -->|"validates XML"| node_xsd_validator
node_importer -->|"validates XML"| node_schematron_validator
node_importer -.->|"deserializes XML"| node_xml_converter
node_importer -->|"collects findings"| node_validation_report
node_schematron_validator -.->|"evaluates rules"| node_schematron_assert
node_schematron_assert -->|"uses schema"| node_schematron_schema
node_schematron_validator -.->|"reports findings"| node_validation_report
node_enumeration -->|"supports levels"| node_profile_levels
node_importer -->|"uses helpers"| node_compatibility

click node_profile_models "https://github.com/securibox/facturx/tree/main/Securibox.FacturX/SpecificationModels"
click node_profile_levels "https://github.com/securibox/facturx/blob/main/Securibox.FacturX/Models/Enums/FacturXConformanceLevelType.cs"
click node_exporter "https://github.com/securibox/facturx/blob/main/Securibox.FacturX/FacturxExporter.cs"
click node_xml_models "https://github.com/securibox/facturx/tree/main/Securibox.FacturX/SpecificationModels"
click node_importer "https://github.com/securibox/facturx/blob/main/Securibox.FacturX/FacturxImporter.cs"
click node_xml_converter "https://github.com/securibox/facturx/blob/main/Securibox.FacturX/Core/Xml2ModelConverter.cs"
click node_xsd_validator "https://github.com/securibox/facturx/blob/main/Securibox.FacturX/FacturxXsdValidator.cs"
click node_schematron_assert "https://github.com/securibox/facturx/blob/main/Securibox.FacturX/Schematron/Types/Assert.cs"
click node_schematron_schema "https://github.com/securibox/facturx/blob/main/Securibox.FacturX/Schematron/Types/Schema.cs"
click node_validation_report "https://github.com/securibox/facturx/blob/main/Securibox.FacturX/Schematron/Helpers/ValidationReport.cs"
click node_pdf_services "https://github.com/securibox/facturx/blob/main/Securibox.FacturX/FacturxImporter.cs"
click node_invoice_builder "https://github.com/securibox/facturx/tree/main/Securibox.FacturX/Core/InvoiceBuilder"
click node_enumeration "https://github.com/securibox/facturx/blob/main/Securibox.FacturX/Core/Enumeration.cs"
click node_compatibility "https://github.com/securibox/facturx/blob/main/Securibox.FacturX/Compatibility/CompatibilityExtensions.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_exporter,node_invoice_builder toneBlue
class node_profile_models,node_profile_levels,node_xml_models,node_enumeration toneAmber
class node_importer,node_xml_converter,node_pdf_services,node_compatibility toneMint
class node_xsd_validator,node_schematron_validator,node_schematron_assert,node_schematron_schema,node_validation_report toneRose
class node_caller toneIndigo
```

## Components

### Invoice creation

- [PDF exporter](https://github.com/securibox/facturx/blob/main/Securibox.FacturX/FacturxExporter.cs): `Securibox.FacturX/FacturxExporter.cs`
- [Invoice model builder](https://github.com/securibox/facturx/tree/main/Securibox.FacturX/Core/InvoiceBuilder): `Securibox.FacturX/Core/InvoiceBuilder`

### Invoice formats

- [Profile invoice models](https://github.com/securibox/facturx/tree/main/Securibox.FacturX/SpecificationModels): `Securibox.FacturX/SpecificationModels`
- [Profile levels](https://github.com/securibox/facturx/blob/main/Securibox.FacturX/Models/Enums/FacturXConformanceLevelType.cs): `Securibox.FacturX/Models/Enums/FacturXConformanceLevelType.cs`
- [Invoice XML models](https://github.com/securibox/facturx/tree/main/Securibox.FacturX/SpecificationModels): `Securibox.FacturX/SpecificationModels`
- [Enumeration support](https://github.com/securibox/facturx/blob/main/Securibox.FacturX/Core/Enumeration.cs): `Securibox.FacturX/Core/Enumeration.cs`

### Import and validation

- [PDF importer](https://github.com/securibox/facturx/blob/main/Securibox.FacturX/FacturxImporter.cs): `Securibox.FacturX/FacturxImporter.cs`
- [XML deserialization](https://github.com/securibox/facturx/blob/main/Securibox.FacturX/Core/Xml2ModelConverter.cs): `Securibox.FacturX/Core/Xml2ModelConverter.cs`
- [PDF and XMP checks](https://github.com/securibox/facturx/blob/main/Securibox.FacturX/FacturxImporter.cs): `Securibox.FacturX/FacturxImporter.cs`
- [Compatibility helpers](https://github.com/securibox/facturx/blob/main/Securibox.FacturX/Compatibility/CompatibilityExtensions.cs): `Securibox.FacturX/Compatibility/CompatibilityExtensions.cs`

### Validation rules

- [XSD validation](https://github.com/securibox/facturx/blob/main/Securibox.FacturX/FacturxXsdValidator.cs): `Securibox.FacturX/FacturxXsdValidator.cs`
- **Schematron validation**
- [Schematron assertions](https://github.com/securibox/facturx/blob/main/Securibox.FacturX/Schematron/Types/Assert.cs): `Securibox.FacturX/Schematron/Types/Assert.cs`
- [Schematron schema](https://github.com/securibox/facturx/blob/main/Securibox.FacturX/Schematron/Types/Schema.cs): `Securibox.FacturX/Schematron/Types/Schema.cs`
- [Validation reports](https://github.com/securibox/facturx/blob/main/Securibox.FacturX/Schematron/Helpers/ValidationReport.cs): `Securibox.FacturX/Schematron/Helpers/ValidationReport.cs`

### Other components

- **Library consumer**

## Connections

- Library consumer → PDF exporter: creates PDF
- Library consumer → PDF importer: imports invoice
- Library consumer → Invoice model builder: builds invoice
- Invoice model builder → Invoice XML models: builds models (evidence: `Securibox.FacturX/Core/InvoiceBuilder/InvoiceBuilder.cs`)
- PDF exporter → Profile invoice models: serializes profile (evidence: `Securibox.FacturX/FacturxExporter.cs`)
- PDF exporter → XSD validation: validates XML (evidence: `Securibox.FacturX/FacturxExporter.cs`)
- PDF exporter → Schematron validation: validates XML (evidence: `Securibox.FacturX/FacturxExporter.cs`)
- PDF exporter → Profile levels: selects profile (evidence: `Securibox.FacturX/FacturxExporter.cs`)
- PDF exporter → Library consumer: returns PDF stream
- PDF importer → PDF and XMP checks: checks PDF metadata (evidence: `Securibox.FacturX/FacturxImporter.cs`)
- PDF importer → XSD validation: validates XML (evidence: `Securibox.FacturX/FacturxImporter.cs`)
- PDF importer → Schematron validation: validates XML (evidence: `Securibox.FacturX/FacturxImporter.cs`)
- PDF importer → XML deserialization: deserializes XML
- PDF importer → Validation reports: collects findings (evidence: `Securibox.FacturX/FacturxImporter.cs`)
- Schematron validation → Schematron assertions: evaluates rules
- Schematron assertions → Schematron schema: uses schema (evidence: `Securibox.FacturX/Schematron/Types/Assert.cs`)
- Schematron validation → Validation reports: reports findings
- Enumeration support → Profile levels: supports levels (evidence: `Securibox.FacturX/Models/Enums/FacturXConformanceLevelType.cs`)
- PDF importer → Compatibility helpers: uses helpers (evidence: `Securibox.FacturX/FacturxImporter.cs`)
