Sales Invoice v1-beta

The /salesInvoice endpoints are used to send sales invoices.

Query recipient party

When a receiver has multiple ids registered in Peppol or other networks, and you're unsure which id to use, or if you want to make sure the id you're sending to is registered in the Peppol network, you can use the POST /api/v1-beta/{partyId}/salesInvoice/queryRecipientParty endpoint. The {partyId} specified in the route should be the sender's partyId. The request body accepts an array of partyIds, in JSON. The response will contain the recipient party that should be used as endpointId in the sales invoice, as well as the delivery channel.

The query parameter ?preferredDocumentTypeId can be used if a specific documentTypeId is preferred. Specifying a preferred documentTypeId will make sure the documentTypeId is prioritized in the lookup.

Additionally, the API can return other available delivery options (channels), which can be used to override the recommended option if issues arise, such as an invalid channel. The query parameter ?includeOptions can be used to retreive the optional channels. By default the options are not included in the response.

Example reponse:

{
  "id": "NL:KVK:12345678",
  "channel": "peppol",
  "description": "default send via peppol delivery",
  "message": "possible error message in case of an issue",
  "options": [
    {
      "channel": "peppol",
      "description": "default send via peppol delivery",
      "identifiers": [
        {
          "partyId": {
            "text": "NL:KVK:12345678",
            "value": "12345678",
            "schemeAuthority": "iso6523-actorid-upis",
            "schemeIdText": "NL:KVK",
            "schemeIdNumber": "0106"
          },
          "message": "possible error message in case of an issue",
          "isValid": true
        }
      ]
    }
  ]
}

In case there are no valid delivery options are found, a 404 response will be returned with optional delivery options.

Example reponse:

{
  "helpLink": "https://psb.econnect.eu/endpoints/v1-beta/SalesInvoice.html#query-recipient-party",
  "message": "Not found.",
  "code": "API404",
  "requestId": "1418f2a91fcba0c3e143ce41181efe46",
  "dateTime": "2025-09-19T09:41:46.2622423+00:00",
  "options": [
    {
      "channel": "peppol",
      "description": "default send via peppol delivery",
      "identifiers": [
        {
          "partyId": {
            "text": "NL:KVK:12345678",
            "value": "12345678",
            "schemeAuthority": "iso6523-actorid-upis",
            "schemeIdText": "NL:KVK",
            "schemeIdNumber": "0106"
          },
          "message": "possible error message in case of an issue",
          "isValid": true
        }
      ]
    }
  ]
}