PINT MY testing

User Guide

Status: Final - Version: 1.0

Last updated: 17.04.2024

OpenPeppol AISBL [email protected]

Rond-point Schuman 6, box 5 www.peppol.eu
1040 Brussels Belgium Last updated: 17.04.2024
 PINT MY Testing
User guide
V1.0 – 17.04.2024

Table of Contents
1 Introduction ........................................................................................................ 2
1.1 Glossary ....................................................................................................... 2
1.2 Process Overview......................................................................................... 3
2 Prerequisites and preparation .......................................................................... 3
2.1 Prerequisites................................................................................................. 3
2.1.1 Peppol PKI Test Certificate ................................................................... 3
2.1.2 Access Point deployment ...................................................................... 3
2.2 Supported browsers ..................................................................................... 4
2.3 Preparation ................................................................................................... 4
3 PINT MY test suite user interface overview .................................................... 4
4 PINT MY Test Suite Walkthrough ................................................................... 10
4.1 PINT MY test suite...................................................................................... 10

1 Introduction
This document provides information related to the Testbed’s PINT MY accreditation test
suite. Its purpose is to demonstrate and to provide a guide on how to use the PINT MY
test suite’s User Interface. It describes the prerequisites as well as the key steps in carrying
out the various test cases. The target audience for this document is Service Providers
(SPs) that are interested in implementing PINT MY and wish to test their implementations
by using the Testbed’s PINT MY test suite.

1.1 Glossary
Abbreviations used in this document:
Abbreviation Meaning
SP Service Provider
AP Access Point
SMP Service Metadata Publisher
UI User Interface

Table 1 glossary

OpenPeppol AISBL [email protected] Page 2 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

1.2 Process Overview

To execute a Peppol PINT MY Process within the Peppol network, there are several
capabilities that the SPs must have. The Testbed makes it easier to verify these
capabilities through a structured predefined testing process.
To achieve this, a test suite for PINT MY specification testing is offered by Peppol, which
requires the completion of test cases that verify the SP’s ability to work with the PINT MY
specification.

2 Prerequisites and preparation

2.1 Prerequisites
SPs must meet the following requirements before doing any testing.

2.1.1 Peppol PKI Test Certificate

SPs are authenticated to the Peppol Testbed Environment using PKI client authentication.
As a result, the SP must have obtained a Peppol PKI test certificate and have it imported
into their browser’s keystore. Test suites are activated depending on which PKI certificate
the SPs use to authenticate.

2.1.2 Access Point deployment

SPs must have an AP deployed; as a result, they need the following:
• AS4 URL available – must refer to HTTPS
• AP must be accessible over the internet
• AP must implement HTTPS with certificate chains to Certificate Authorities (CAs),
which are trusted by Peppol. Self-signed certificates are considered non-compliant and
will not be accepted when using the Testbed.
• AP must have installed the same Peppol PKI AP test certificate used for the client
authentication to the Testbed.
• Participant identifier must have been registered in the Centralized Malaysian SMP1.

1
To obtain access to the Malaysian SMP service, please contact the Malaysian PA

OpenPeppol AISBL [email protected] Page 3 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

2.2 Supported browsers

We can only guarantee that the Testbed website behaves in the correct manner if you are
using any of the below web browsers:
• Google Chrome, version 100.0 and above
• Firefox, version 99.01 and above
• Microsoft Edge, version 101.0 and above

2.3 Preparation
A Peppol PKI AP Test Certificate must be installed in your browser before visiting the PINT
MY accreditation test suite for the first time.
Client certificate authentication must be setup in your browser according to the following
instructions:
Windows Google Chrome
Windows Mozilla Firefox
OS-X Generic

After installing the PKI certificates, go to https://www.testbed.peppol.org/, which is the URL

of the production Testbed.
The browser will prompt you to identify yourself with a certificate; choose your Peppol PKI
AP test certificate.

3 PINT MY test suite user interface overview

The PINT MY test suite is used to help evaluate new AP deployments and ensure
compliance with the Peppol PINT MY specification. It is based on self-initiated tests that
an end-user of the SP system chooses to run. The SP end user enrolls in the PINT MY
test suite, selects which test cases to run, and reviews the results from the from the
Testbed’s user interface.
To create a PINT MY test suite configuration, a user must first select “ENTER MALAYSIA
TEST SUITE” in the landing page, as illustrated in Figure 1.

OpenPeppol AISBL [email protected] Page 4 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

Figure 1 Testbed landing page

When the PINT MY test configuration is created, the user is navigated to the profile page
as shown in Figure 2. The next section provides a general overview of the UI.
The UI consists of the following pages (as shown in Figure 2):
1. PINT MY
2. Documentation
3. Profile

OpenPeppol AISBL [email protected] Page 5 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

Figure 2 UI overview after PINT MY configuration

1. The PINT MY page (shown in Figure 3) is used to enroll to the PINT MY test suite.

OpenPeppol AISBL [email protected] Page 6 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

Figure 3 PINT MY test suite enrollment

After enrolling to the PINT MY test suite, the user can choose test cases to execute, as
shown in Figure 4, label 1. As illustrated in Figure 4 label 2, the user may also view details
about the enrolled configuration.

OpenPeppol AISBL [email protected] Page 7 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

Figure 4 example of PINT MY test case selection

2. The Documentation page (shown in Figure 5) collects and makes available useful links
and resources (e.g., environment documentation, user guide, etc.)

OpenPeppol AISBL [email protected] Page 8 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

Figure 5 Documentation page

3. The Profile page (shown in Figure 6) provides details about the user account that the
Testbed creates using the Peppol PKI Test Certificate that was imported into the
browser.

Figure 6 User profile page

OpenPeppol AISBL [email protected] Page 9 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

4 PINT MY Test Suite Walkthrough

This part aims to show you how to use and complete the PINT MY test suite. This part requires
that you have correctly setup your browser by installing a Peppol PKI test certificate as
specified in section 2.3.

4.1 PINT MY test suite

Navigate to https://www.testbed.peppol.org/ after installing a Peppol Test AP certificate in your
browser and select the Malaysian test suite from the landing page, as shown in Figure 1.
If this is your first time using the PINT MY test suite, you must first enroll in the test suite by
providing the following information:
Participant ID and Scheme ID: Give a valid participant identifier. All the test cases available
in the test suite will be carried out by using these identifiers. Note: The participant identifier
and its service metadata must be registered to the Central Malaysian SMP.
Endpoint URL: The participant’s AS4 endpoint URL
Implementation name & version: Give a name and version for your AP implementation.
After filling in the information, click the “ENROLL TEST SUITE” button.
An example filled-in the enrolment form is shown in Figure 7.

OpenPeppol AISBL [email protected] Page 10 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

Figure 7 example AP filled in form

You will be presented with the available test cases for this test suite once you have
successfully enrolled. Figure 8 illustrates this. The following are the test cases included in
the PINT MY test suite:
• PINT-TC-AP1: PINT MY Invoice reception
• PINT-TC-AP2: PINT MY Credit Note reception
• PINT-TC-BISC1-1: PINT MY Invoice submission to MY Recipient
• PINT-TC-BISC1-2: PINT MY Credit Note submission to MY Recipient
• PINT-TC-BISC1-3: PINT MY Self Billing Invoice submission to MY Recipient
• PINT-TC-BISC1-4: PINT MY Self Billing Credit Note submission to MY Recipient
• PINT-TC-MY: PINT MY Business Document Validation

OpenPeppol AISBL [email protected] Page 11 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

It’s worth noting that the PINT MY test suite’s test cases don’t have to be performed in
order. Instead, every test case is ready to be run at any moment. The sole restriction is
that only one test case may run at a time. Once a test case is running, the remainder of
the test cases become unavailable until the current one is finished.

Figure 8 PINT MY available Test cases

Figure 9 provides a complete visual representation of each test case UI element. As shown in
Figure 9, label 2, each test case contains a title, a status, and a description.
When conducting each test case, make sure to follow the test case description. You can start
a test case by pressing the “Start” button showcased in Figure 9, label 3. The configuration
created by the user during the test suite enrolment is shown in Figure 9, label 4. As illustrated
in Figure 9, label 5, audit logs of events are available that comprise the timing of the
occurrence, the action done, a description and a status. Finally, if you wish to re-enrol in a
new PINT MY test suite configuration and reset the current test suite and all of its test case
progress, select the “RESET TEST SUITE” button (Figure 9, label 6) and re-enrol in a new
test suite.

OpenPeppol AISBL [email protected] Page 12 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

Figure 9 Test case overview

In the “PINT-TC-AP1: PINT MY Invoice reception” test case, the Testbed environment
will generate an SBD artifact containing a PINT MY Invoice payload and send it to the
under-test AP using eDelivery.
The participant’s addressing information will be dynamically discovered via the SMK/SMP.
The transaction will be addressed to the receiver identifier provided during the test suite
enrolment (participant id and scheme id). To properly receive the message sent by the
testbed AP, you must register your enrolled participant to the centralized Malaysian SMP2,
with the capabilities of receiving PINT MY specification-based Invoices. More specifically:
Document identifier:
busdox-docid-qns::urn:oasis:names:specification:ubl:schema:xsd:Invoice-
2::Invoice##urn:peppol:pint:billing-1@my-1::2.1

Process identifier:

2
To obtain access to the Malaysian SMP service, please contact the Malaysian PA

OpenPeppol AISBL [email protected] Page 13 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

cenbii-procid-ubl::urn:peppol:bis:billing

Transport profile: AS4 v2

Figure 10, illustrates an unsuccessful attempt to pass the test case in which results in an
error. The error has occurred due to the absence of the appropriate document type
receiving capability registration in the Malaysian SMP.

Figure 10 missing PINT MY Invoice SMP registration error.

Figure 11, shows the successful reception of the message through the eDelivery network
and passing the test.

Figure 11 PINT MY reception passed test

OpenPeppol AISBL [email protected] Page 14 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

In the “PINT-TC-AP2: PINT MY Credit Note reception” test case, the Testbed
environment will generate an SBD artifact containing a PINT MY Credit Note payload and
send it to the under-test AP using eDelivery.
The participant’s addressing information will be dynamically discovered via the SMK/SMP.
The transaction will be addressed to the receiver identifier provided during the test suite
enrolment (participant id and scheme id). To properly receive the message sent by the
testbed AP, you must register your enrolled participant to the centralized Malaysian SMP3,
with the capabilities of receiving PINT MY specification-based Credit Notes. More
specifically:
Document identifier:
busdox-docid-qns::urn:oasis:names:specification:ubl:schema:xsd:CreditNote-
2::CreditNote##urn:peppol:pint:billing-1@my-1::2.1

Process identifier:
cenbii-procid-ubl::urn:peppol:bis:billing

Transport profile: AS4 v2

Figure 12, illustrates an unsuccessful attempt to pass the test case in which results in an
error. The error has occurred due to the absence of the appropriate document type
receiving capability registration in the Malaysian SMP.

Figure 12 missing PINT MY Credit Note SMP registration error

Figure 13, shows the successful reception of the message through the eDelivery network
and passing the test.

3
To obtain access to the Malaysian SMP service, please contact the Malaysian PA

OpenPeppol AISBL [email protected] Page 15 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

Figure 13 Credit Note reception passed test

In the “PINT-TC-BISC1-1: PINT MY Invoice submission to MY Recipient” test case, the

under test AP is expected to send an SBD with a PINT MY compliant Invoice that is
generated according to the test case’s instructions provided by the Testbed, as illustrated in
the test case description in Figure 14, label 1 and “START” audit log instructions shown in
Figure 14, label 2. The sender will be the participant provided during enrolment (participant
id and scheme id), and the receiver will be the Testbed’s environment AP. Start the test
case, and read the information given in the “START” audit log as shown in Figure 14, label
2. The generated PINT MY based Invoice payload needs to contain the instance identifier
from the test case “START” audit log description so that the Testbed environment can
correlate the sent document correctly. Once the document is received, the Testbed
environment performs schematron checks to the received document and provides back the
validation results, as the examples shown in Figure 14, labels 3 (fail) and 4 (pass).

OpenPeppol AISBL [email protected] Page 16 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

Figure 14 PINT MY invoice submission test case example

A failed audit log entry will notify you in the event of a failed test attempt. By pressing the
button labeled 3 in Figure 14, you can get further information about the mistakes that
occurred, like shown in Figure 15. Examine the errors in the audit log, make any necessary
corrections, and restart the test case till successfully passing the test case.

Figure 15 Error details

In the “PINT-TC-BISC1-2: PINT MY Credit Note submission to MY Recipient” test case,

the under test AP is expected to send an SBD with a PINT MY compliant Credit Note that is

OpenPeppol AISBL [email protected] Page 17 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

generated according to the test case’s instructions provided by the Testbed, as illustrated in
the test case description in Figure 16, label 1 and “START” audit log instructions shown in
Figure 16, label 2. The sender will be the participant provided during enrolment (participant
id and scheme id), and the receiver will be the Testbed’s environment AP. Start the test
case, and read the information given in the “START” audit log as shown in Figure 16, label
2. The generated PINT MY based Credit Note payload needs to contain the instance
identifier from the test case “START” audit log description so that the Testbed environment
can correlate the sent document correctly. Once the document is received, the Testbed
environment performs schematron checks to the received document and provides back the
validation results, as the examples shown in Figure 16, labels 3 (fail) and 4 (pass).

Figure 16 PINT MY Credit Note submission test case execution example

A failed audit log entry will notify you in the event of a failed test attempt. By pressing the
button labeled 3 in Figure 16, you can get further information about the mistakes that
occurred, like shown in Figure 17. Examine the errors in the audit log, make any necessary
corrections, and restart the test case till successfully passing the test case.

OpenPeppol AISBL [email protected] Page 18 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

Figure 17 Error Details

In the “PINT-TC-BISC1-3: PINT MY Self Billing Invoice submission to MY Recipient” test

case, the under test AP is expected to send an SBD with a PINT MY Self Billing compliant
Invoice that is generated according to the test case’s instructions provided by the Testbed,
as illustrated in the test case description in Figure 18, label 1 and “START” audit log
instructions shown in Figure 18, label 2. The sender will be the participant provided during
enrolment (participant id and scheme id), and the receiver will be the Testbed’s environment
AP. Start the test case, and read the information given in the “START” audit log as shown in
Figure 18, label 2. The generated PINT MY based Invoice payload needs to contain the
instance identifier from the test case “START” audit log description so that the Testbed
environment can correlate the sent document correctly. Once the document is received, the
Testbed environment performs schematron checks to the received document and provides
back the validation results, as the examples shown in Figure 18, labels 3 (fail) and 4 (pass).

OpenPeppol AISBL [email protected] Page 19 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

Figure 18 PINT MY self billing invoice submission test case example

A failed audit log entry will notify you in the event of a failed test attempt. By pressing the
button labeled 3 in Figure 18, you can get further information about the mistakes that
occurred, like shown in Figure 19. Examine the errors in the audit log, make any necessary
corrections, and restart the test case till successfully passing the test case.

Figure 19 Error details

OpenPeppol AISBL [email protected] Page 20 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

In the “PINT-TC-BISC1-4: PINT MY Self Billing Credit Note submission to MY Recipient”

test case, the under test AP is expected to send an SBD with a PINT MY Self Billing
compliant Credit Note that is generated according to the test case’s instructions provided by
the Testbed, as illustrated in the test case description in Figure 20, label 1 and “START”
audit log instructions shown in Figure 20, label 2. The sender will be the participant provided
during enrolment (participant id and scheme id), and the receiver will be the Testbed’s
environment AP. Start the test case, and read the information given in the “START” audit log
as shown in Figure 20, label 2. The generated PINT MY based Invoice payload needs to
contain the instance identifier from the test case “START” audit log description so that the
Testbed environment can correlate the sent document correctly. Once the document is
received, the Testbed environment performs schematron checks to the received document
and provides back the validation results, as the examples shown in Figure 20, labels 3 (fail)
and 4 (pass).

Figure 20 PINT MY self billing credit note submission test case example

A failed audit log entry will notify you in the event of a failed test attempt. By pressing the
button labeled 3 in Figure 20, you can get further information about the mistakes that

OpenPeppol AISBL [email protected] Page 21 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

occurred, like shown in Figure 21. Examine the errors in the audit log, make any necessary
corrections, and restart the test case till successfully passing the test case.

Figure 21 Error details

The “PINT-TC-MY: Business Document Validation” test case, verifies that the under test
AP has configured mechanisms to validate outgoing PINT MY specification based Invoices
and Credit Notes and reject sending invalid ones. Download the zip package, containing
ready-to-send XML artifacts, as marked in Figure 22, label 1. The zip package includes 15
XML artifacts to be sent. Please send them in any order you like and be observant if any errors
occur. Some of the 15 XML artifacts contain schematron errors and your AP implementation
should be able to recognize those invalid artifacts and reject sending them. Before sending
the files, do not alter them in any way, as the Testbed environment may have trouble
correlating them appropriately.

OpenPeppol AISBL [email protected] Page 22 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

Figure 22 Business document validation test case execution example

The Testbed environment will inform the user every time it receives a file as shown in Figure
23. The test case will automatically be completed when all expected files are received.

OpenPeppol AISBL [email protected] Page 23 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).
 PINT MY Testing
User guide
V1.0 – 17.04.2024

Figure 23 audit log example

If the Testbed environment receives any invalid artifact the test case execution will fail and
you’ll have to examine the error, correct it and then restart the test case, as shown in Figure
24.

Figure 24 Invoice validation, example of fail audit log

When the test suite is complete (all test cases have been passed) you may also download a
pdf report as shown in Figure 22, label 2.

OpenPeppol AISBL [email protected] Page 24 of 24

Rond-point Schuman 6, box 5, 1040 Brussels, Belgium www.peppol.eu
Corporate identification number 0848.934.496 (Register of Legal Entities Brussels).