# Reviews (Deprecated)


The review endpoint is deprecated, please use the Invoice Message Response endpoint instead.

With review (beta) you can send and receive technical (and hopefully soon business) messages about processing business documents. It is very useful to let the sender know about the internal state of a received document.

When an access point has accepted an inbound message, it does not guarantee that the final recipient has successfully processed the document. That is why the Peppol community came up with the Message Level Response (MLR) and Business Level Response (BLR) in order to return this information to the original sender.

# Send reviews

To notify the original sender about the processing of your received documents use the POST /api/v1-beta/{partyId}/review endpoint.

You could either "accept" or "reject" the document and provide a reason for it. For example, the document is rejected because the given purchase order is not known. The Procurement Service Bus (PSB) will notify the sender about your review via the Peppol network.

   "documentId": "{the inbound documentId}",
   "type": "Technical",
   "verdict": "Reject",
   "reason": "Purchase order PO12389 not known."

It could happen that the receiver of the review (the sender of the original document) doesn’t support this flow. Then the PSB will trigger the hooks with the topic "ReviewSentError". It is advised to implement a fallback flow based on this topic.

# Send review fallback

If you don’t have a flow for the "ReviewSentError", the PSB can send an email to the original sender of the document. To do this, register a mail hook that listens to the "ReviewSentError" like this:

   "id": "tvr-fallback",
   "name": "mail",
   "action": "mailto:[ReceiverEmailAddress]",
   "topics": [
   "isActive": true

# Receiving reviews

To receive reviews you have to register a hook with the topic "ReviewReceived". Note that the webhook will contain a details element with the verdict of the review.

 "topic": "ReviewReceived",
 "hookId": "2",
 "documentId": "bbb84a79-f8b8-48dc-96ef-4d7ad9a80b64",
 "details": {
  "reviewId": "d6fb6485-8350-40f0-b697-0ad1858490b9",
  "verdict": "Reject",
  "type": "Technical",
  "reason": "Purchase order PO12389 not known."
 "createdOn": "2019-06-18T14:06:35.4399175+00:00",
 "sentOn": "2019-06-18T14:06:35.6383675+00:00"

DocumentId refers to the document that is reviewed.

You can download the full application response XML using the reviewId as {documentId} via GET /api/v1-beta/{partyId}/review/{documentId}/download endpoint.

It’s also possible to delete the received review via DELETE /api/v1-beta/{partyId}/review/{documentId}

# Topics

The available topics for the review hooks are:

  • ReviewReceived
  • ReviewReceivedError
  • ReviewSent
  • ReviewSentError
  • ReviewSentRetry

# In-depth

The MLR is a UBL Application Response document that is sent via the regular send flow, i.e. via a SMP lookup. The following document type id is used:


© 2021 eConnect International B.V.