Peppol ViDA Pilot Testing

This repository provides invoices as test data packages for the Peppol ViDA Pilot Testing phase.
It is intended to be used by the Peppol ViDA Pilot participants for testing and validation within the Peppol ViDA Pilot environment.

Key Features

• Invoices in Multiple Formats: The repository contains invoices in multiple formats:
  • XML (PEPPOL BIS Billing 3.0) as the leading data source
  • PDF as a human-readable format for easy review.
• Description: Each invoice test case comes with
  • detailed description of the intended test scenario including the specific aspects under test, and
  • the corresponding expected results.
• Expected results
  • Tax Data Document: buy-side=C3, [TODO] sell-side=C2
  • [TODO] MLS as generated by C3 and both C5s
• Supporting files
  • Validation reports of initial invoice and expected TDD
  • Secondary XML formats: EN16931 CII and EN16931 UBL

Structure

• One directory for each test scenario: Contains the testing files for a specific test scenario.
• Naming convention: The test directory names correspond to the code defined in the Peppol ViDA Pilot Methodology and Testing document available in the Peppol ViDA Pilot Wiki

Usage

To use this repository for Peppol ViDA Pilot Testing process, follow these general steps.
Note that test files need to be customized to be used from your testing environment.

1. Clone the Repository: [TODO] define user access (public=anonymous download)

   git clone https://github.com/OpenPeppol/vida-pilot-testing.git

2. Access Test Files: Navigate to the /[test scenario] directory and find the invoices in various formats.

3. Integrate with Your Project: Use these test files to integrate into your systems for testing and validation.

   • Adapt the invoice files to match your test execution.
   • Sending Endpoint ID: Replace [TODO] placeholder "C2-endpoint-id" with the actual C2 endpoint identifier
   • Receiving Endpoint ID: Replace [TODO] placeholder "C3-endpoint-id" with the desired actual C3 endpoint identifier
   • Test run identifier: Replace [TODO] placeholder "test-run-id" with a identifier for this test run (unique between C2-C3)

   Note: please do not commit/push such integrated files to the public repository.
   To avoid accitdental commits, e.g. modify the files in a branch other than the main branch.

TODO: update with more current instructions once available

4. Testing Results: After running the tests, to share (and receive) full results from the other participants.
   To add your results, use folders [TODO] like /results/[C2-SPID]/[C3-SPID]/[test run id] directory:
   - As a sending service provider (C2), add the TDD as generated and any MLS as received.
   - As a receiving service provider (C3), add the invoice as received, the corresponding MLS, the TDD as generated as well any MLS as received.
   - As a receiving Tax Administration service provider (C5), add the TDD as received and the corresponding MLS generated.
   Push the commit using [TODO] define user access (public=github named committer)

Contact

For enquiries please contact vidapilot@peppol.eu.