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.
• Sample results
  • Tax Data Document: buy-side (=C3), [TODO] sell-side (=C2)
  • [TODO] MLS as generated by C3 and both C5s
  • [TODO] SBDH-wrapped files as generated by C2 / C3 and both C5s to demonstrate message UUID handling
• Supporting files
  • Validation reports of initial invoice and expected TDD
  • Secondary XML formats: EN16931 CII and EN16931 UBL
• Upload of test results: offer a method to upload test results for sharing with other pilot participants
• Contribute test data packages: Each contributing service provider is invited to upload own test data

Structure

• One directory for each test scenario: Contains the test data package 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
• Participants and contributed test data packages: Each contributing service provider adds its own contact information and a "SP test data package home" directory under /participants

Usage

To use this repository for Peppol ViDA Pilot Testing process, follow these general steps.

Use provided test data packages to execute test scenarios

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 id] 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 placeholder "C2-endpoint-id" with the actual C2 endpoint identifier
   • Receiving Endpoint ID: Replace placeholder "C3-endpoint-id" with the desired actual C3 endpoint identifier
   • Test run identifier: Replace placeholder "test-run-id" with an identifier for this test run (choose a value unique between C2-C3)

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

Contribute test results and test data packages

TODO: update with more current instructions once available

4. Setup participant directory: Create a directory for you as a pilot participant in the /participants directory and add yourself to PARTICIPANTS.mdoverview list.
   Commit and push this directory to this repository.

5. Testing Results: After running tests, share (and receive) full results from the other participants.
   To add your results, use folders like /participants/[SPID-SPName]/results/[other-SPID-SPName]/[test scenario 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)

6. Test data package: To contribute test data packages, follow the steps as outlined in the PARTICIPANTS.md file.

Contact

For enquiries please contact vidapilot@peppol.eu.