ViDA TDD Release notes

Version 1.0.0-HotFix

Maintained by Peppol ViDA Pilot Team

Applies to

ViDA Tax Data Document

Release Date

2026-06-01

Status

Final

What’s New in This Release

This is version 1.0.0-HotFix of the ViDA Tax Data Document specification.

The release includes maintenance updates and a validation artefact hotfix to address a specification inconsistency identified during pilot implementation activities.

  • Updated the referenced PINT General specification version to 1.1.3 to align with the latest published code lists and validation artefacts.

  • Updated Self-Billing sample documents to remove UK-specific content and align examples with the European scope of the ViDA Pilot.

  • Temporarily disabled validation rule BR-IC-12.

Reason

  • A specification inconsistency was identified between the ViDA Tax Data Document Syntax Binding and the associated Schematron validation artefacts.

  • Validation rule BR-IC-12 requires the Deliver to country code (BT-80) to be present when the VAT category code (BT-118) is "Intra-community supply".

  • However, the current ViDA Tax Data Document Syntax Binding does not permit representation of the Delivery Location Country information required to satisfy the rule.

  • Consequently, Tax Data Documents generated from valid source invoices may fail validation despite being compliant with the published syntax.

Resolution

  • Validation rule BR-IC-12 has been temporarily disabled pending alignment of the Semantic Model, Syntax Binding, and Validation Artefacts.

Overview

This hotfix release addresses a specification inconsistency identified between the ViDA Tax Data Document Syntax Binding and the associated validation artefacts.

The issue affects validation rule BR-IC-12, which requires the Deliver to country code (BT-80) when the VAT category code (BT-118) is "Intra-community supply".

Although valid source invoices may contain the required delivery country information, the current ViDA Tax Data Document syntax does not provide a mechanism to represent this information. As a result, correctly generated Tax Data Documents can fail validation despite being compliant with the published syntax.

To prevent valid documents from being incorrectly rejected, validation rule BR-IC-12 has been temporarily disabled in this release.

This release also includes maintenance updates to the referenced PINT General specification and Self-Billing sample documents.

Validation Artefacts

  • Schematron Validation Rules:

    • Validation artefacts provide rule-based validation to ensure semantic and technical conformance.

    • The ViDA Tax Data Document Schematron rules validate structural and business-rule compliance.

    • This release introduces a temporary exception to the validation artefacts by disabling validation rule BR-IC-12.

    • The change ensures that documents conforming to the published Syntax Binding are not incorrectly rejected due to an identified specification inconsistency.

Documentation

  • ViDA Tax Data Document Documentation:

    • Updated references to PINT General version 1.1.3.

    • Updated Self-Billing sample documents.

    • Removal of UK-specific references from sample content.

    • Alignment of examples with the European scope of the ViDA Pilot.

Code Lists

  • Standard codelists:

    • Adapted from PINT General 1.1.3.

  • ViDA Tax Data Document:

    • Referenced code lists updated through alignment with PINT General version 1.1.3.

Schematron

Schematron artefacts provide rule-based validation to ensure semantic and technical conformance.

  • ViDA Tax Data Document Schematron:

    • Validation rule BR-IC-12 has been temporarily disabled.

    • The disabled rule is:

[BR-IC-12] In an Invoice with a VAT breakdown (BG-23) where the VAT category code (BT-118) is "Intra-community supply" the Deliver to country code (BT-80) shall not be blank.
  • The rule was disabled because the current Syntax Binding does not support representation of the Delivery Location Country information required by the rule.

  • This change prevents technically compliant Tax Data Documents from being incorrectly rejected.

Technical Details

  • Current Delivery Information Representation:

<cac:Delivery>
    <cbc:ActualDeliveryDate>
</cac:Delivery>
  • Delivery Country Information Required by BR-IC-12:

<cac:DeliveryLocation>
    <cac:Address>
        <cac:Country>
            <cbc:IdentificationCode>
        </cac:Country>
    </cac:Address>
</cac:DeliveryLocation>
  • Impact:

    • The source invoice may be valid.

    • The Tax Data Document mapping may be correct.

    • The generated Tax Data Document may conform to the published Syntax Binding.

    • The document may still fail validation against BR-IC-12.

  • Temporary Resolution:

    • The corresponding Schematron assertion has been disabled.

    • The rule may be reintroduced in a future release once the Semantic Model, Syntax Binding, and Validation Artefacts have been aligned.

Action Items for Implementers

Implementers SHALL perform the following actions to ensure conformance:

  • Update validation artefacts to Version 1.0.0-HotFix.

  • Update referenced PINT General artefacts and code lists where applicable.

  • Update Self-Billing sample documents and associated test scenarios where applicable.

  • Continue validating implementations against the published validation artefacts, including:

    • XML Schema Definitions (XSD).

    • Updated Schematron rules.

  • No changes to existing Tax Data Document mappings are required as a result of this hotfix.

  • Monitor future releases for the reintroduction of BR-IC-12 following alignment of the Semantic Model, Syntax Binding, and Validation Artefacts.

Support

For support and clarification:

Version 1.0.0

Maintained by Peppol ViDA Pilot team

Applies to

ViDA Tax Data Document

Release Date

2026-03-24

Status

Final

What’s New in This Release

This is version 1.0.0 of the ViDA Tax Data Document specification. The release includes the following components:

  • Tax Data Document BIS Documentation.

  • Semantic Model.

  • Syntax Binding.

  • Normative Codelists.

  • Tax Data Document-specific Schematron rules.

  • Referenced Schematron artefacts in use.

  • Changes in this version:

    • Enhanced Schematron validation logic for improved accuracy and maintainability.

    • Added support for Self-Billing scenarios.

    • Provided updated and improved sample documents for both Billing and Self-Billing.

    • Updated BIS identifiers, namespaces, and data types to align with the latest specifications.

    • Renamed tax data element from pxs:DocumentTypeCode to pxs:TaxDataTypeCode for improved clarity.

    • Fields updated from Mandatory to Optional (Peppol and CEN Schematron rules have been updated accordingly):

      • BG-05 (Supplier’s postal address).

      • BG-08 (Buyer’s postal address).

      • BT-110 (Invoice total VAT amount in document currency).

      • BG-23 (VAT BREAKDOWN).

      • BT-117 (VAT category tax amount).

      • BT-118 (VAT category code).

      • BG-30 (LINE TAX INFORMATION).

    • Included a sample demonstrating the transition of these fields from mandatory to optional.

Overview

This release introduces the first official version of the ViDA Tax Data Document Specification.

The specification defines:

  • The Semantic Model (business information requirements).

  • The Syntax Binding (technical representation).

  • BIS documentation and implementation guidance.

  • Applicable normative codelists.

  • Validation artefacts, including Schematron rules.

The objective of this release is to establish a clear and governable framework that ensures semantic consistency, validation accuracy, and implementation certainty for all stakeholders.

Data Model

  • Semantic Model:

    • A Semantic Model in Peppol is a structured, technology-independent representation of the business information, constraints, and relationships required for electronic document exchange, forming the authoritative source for syntax binding, validation rules, and conformance profiles.

      • Business Terms (what the information means).

      • Cardinality rules (how many times information may occur).

      • Data types and formats (how information is represented conceptually).

      • Business rules and constraints (conditions governing usage).

      • Relationships between business elements.

  • Syntax Binding:

    • A Syntax Binding in Peppol is the formally governed, technology-specific mapping of a Semantic Model to a concrete document syntax, defining the exact structural representation, cardinalities, data types, and validation constraints required for an implementation.

      • Technology-Specific Representation.

      • Deterministic Mapping.

      • Normative for Implementation.

      • Constrained by Peppol Governance.

Documentation

  • Peppol Model for Tax Data Document:

    • Introduction and Scope.

    • Audience and Benefits.

    • Business processes.

    • Technical details:

      • BIS Identifiers.

      • Data types.

      • XML Schemas and Namespaces.

      • Glossary.

  • Compliance:

    • Sending Compliance to TDD.

    • Receiving Compliance to TDD.

    • Enveloping Compliance.

Code Lists

  • Standard codelists:

    • UNCL5189 (Allowance reason code).

    • UNCL7161 (Charge reason code).

    • ISO3166-1:Alpha2 (Country codes).

    • ISO4217 (Currency codes).

    • UNCL2005 (Date/Time/Period code).

    • UNCL1001 (Credit note type code).

    • UNCL1001 (Invoice type code).

    • EAS (Electronic address scheme).

    • ICD (ISO 6523 ICD list).

    • UNCL7143 (Item type identification code).

    • UNCL4461 (Payment means code).

    • UNECERec20 (Unit codes).

    • VATEX (VATEX code list).

  • ViDA:

    • ViDATaxCat (ViDA VAT category codes).

  • Tax Data Document:

    • TDD-RR (Tax Data Document Reporting Role).

    • TDD-DS (Tax Data Document Scope).

    • TDD-DTC (Tax Data Document Type Code).

Schematron

Schematron artefacts provide rule-based validation to ensure semantic and technical conformance.

  • CEN EN 16931:

    • The CEN EN 16931 Schematron rules define automated validation constraints aligned with the European semantic data model for electronic invoices.

    • These rules verify:

      • Compliance with mandatory business terms.

      • Cardinality constraints.

      • Code list validity.

      • Mathematical consistency (e.g. VAT calculations, totals).

    • Their purpose is to ensure legally compliant cross-border electronic invoicing within the EU.

  • Peppol EN 16931:

    • The Peppol EN 16931 Schematron rules extend the core CEN EN 16931 validation set with additional interoperability and network-specific constraints required for Peppol participants.

    • These rules enforce:

      • Additional usage restrictions.

      • Peppol-specific code list limitations.

      • Network-level business rules.

    • Their purpose is to ensure consistent semantic interpretation and interoperability across the Peppol network.

  • Tax Data Document Choreography:

    • The Tax Data Document Choreography Schematron rules validate structural and choreography-level compliance.

    • These rules ensure that:

      • The document strictly follows the defined Syntax Binding.

      • Only permitted elements and structures are used.

      • No undefined or non-conformant elements are introduced.

    • Their purpose is to guarantee technical conformance to the specified document structure.

Action Items for Implementers

Implementers SHALL perform the following actions to ensure conformance:

  • Review and understand the Semantic Model and the associated Syntax Binding before implementation.

  • Ensure that all code values strictly comply with the applicable normative codelists.

  • Validate implementations against the published validation artefacts, including:

    • XML Schema Definitions (XSD).

    • Schematron rules.

  • Develop the Tax Data Document in full compliance with the Semantic Model, Syntax Binding, and validation artefacts.

  • Notify the relevant Peppol Authority of any identified critical defects, inconsistencies, or required change requests.

Support

For support and clarification:

Version 0.9.0

Maintained by Peppol ViDA Pilot team

Release Date

2025-12-12

Status

Review

What’s new in this release?

  • XSD Schema and Schematron improvements.

  • Documentation: Peppol ViDA model for Tax Data Document updates.

  • Bug fixes.

  • cbc:DocumentCurrencyCode (TDT-008) Removed from TDD part.

  • TDD namespace aligned with ViDA.

  • Enhancements to the semantic model and associated syntax bindings.

  • Updates to documentation, including compliance guidance.

  • Introduction of standardized code lists.

  • Addition of XSD schemas and Schematron validation artifacts.

  • Improved traceability by linking business rules to the TDD structure.

Version Information

ViDA Tax Data Document 0.9.0

Applies to

ViDA Tax Data Document

Reviewed

-