Find Participants

This tutorial explains how to find participants ("Corner 4" in e-invoicing terminology) to which you can send business documents.

If you prefer importing this tutorial into Postman or Insomnia, download the har archive file and import into your preferred tool.

Prerequisites

Finding participants, ie. to perform a lookup, is open to anyone, no specific role is needed.

To have a specific participant identifier to perform the lookup on start by registering a participant by follow the Create a Participant tutorial.

Step 1. Lookup your Participant

Arratech's API contains a public endpoint for searching (aka. lookup) for participants. This is a general search in such that it looks for participants in the entire Peppol network, not just participants registered in Arratech's SMPs. Note however that participants registered in Arratech's solution may return more, richer, data in the search results compared to participants registered elsewhere.

When calling the lookup endpoint you provide the Peppol identifier and the environment to search in:

/lookup?environment=TEST&participantIdentifier=YOUR_PEPPOL_IDENTIFIER

curl -X GET https://api.arratech.com/orgs/lookup?environment=TEST&participantIdentifier=YOUR_PEPPOL_IDENTIFIER \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/xml" \
  -d 'YOUR SBD XML DOCUMENT'

The call will return a transaction id for the sending process that is initiated by the call above. Note this id as you will use it in the next step for polling the status of your transaction.

Note that embedding the SBD inline an http post request is only viable for small documents, the API contains other methods for sending larger documents.

Peppol specific lookups

For the reader that happens to be a Peppol nerd the calls below can be used to list the SMK and Peppol directory specific lookup results.

Step 2. SMP Lookup

curl -X GET https://smp-test.arratech.com/iso6523-actorid-upis::YOUR_PEPPOL_IDENTIFIER

Step 3. PEPPOL Directory Lookup

If you chose to register the participant for Peppol Directory publishing when creating it, you can search for your participant in the Peppol Directory.

curl -X https://test-directory.peppol.eu/public/locale-en_US/menuitem-search?q=YOUR_PEPPOL_IDENTIFIER

Congratulations! You now know a bit more about finding participants within the Peppol network.