README.md

VEFA PEPPOL Lookup

Functionality for looking up participants in PEPPOL.

Features

• Supported SML lookup:
  • PEPPOL SML
  • OASIS BDXL
  • Disabled (static)
• Supported SMP lookup:
  • PEPPOL SMP
  • OASIS BDXR SMP
• Validates signatures.
• Uses peppol-security to verify certificates.
• API for extensions.

Getting started

Include dependency in your pom.xml:

<dependency>
  <groupId>network.oxalis.vefa</groupId>
  <artifactId>peppol-lookup</artifactId>
  <version>1.0.1</version>
</dependency>

Start making lookups:

// Prepare an instance of the client.
LookupClient client = LookupClientBuilder.forProduction().build();

// Fetch document identifiers supported by a participant.
List<DocumentIdentifier> documentTypeIdentifiers = client.getDocumentIdentifiers(
    new ParticipantIdentifier("9908:991825827")
);

// Fetch endpoint directly.
Endpoint endpoint = client.getEndpoint(
    new ParticipantIdentifier("9908:991825827"),
    new DocumentIdentifier("urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:www.cenbii.eu:transaction:biitrns010:ver2.0:extended:urn:www.peppol.eu:bis:peppol4a:ver2.0::2.1"),
    new ProcessIdentifier("urn:www.cenbii.eu:profile:bii04:ver2.0"),
    TransportProfile.AS2_1_0
);

// Fetch service metadata for a given participant and document identifier, then endpoint.
ServiceMetadata serviceMetadata = client.getServiceMetadata(
    new ParticipantIdentifier("9908:991825827"),
    new DocumentIdentifier("urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:www.cenbii.eu:transaction:biitrns010:ver2.0:extended:urn:www.peppol.eu:bis:peppol4a:ver2.0::2.1")
);
Endpoint endpoint = client.getEndpoint(
    serviceMetadata,
    new ProcessIdentifier("urn:www.cenbii.eu:profile:bii04:ver2.0"),
    TransportProfile.AS2_1_0
);
// Note: fetching endpoint directly from service metadata doesn't involve validation of endpoint certificate.