PEPPOL - Receive

PEPPOL - Receive (ReceivePull Business Function)

Summary

Pull incoming PEPPOL transfers/documents, download mapped_doc documents, and store them as attachments.

Client Usage

Minimal

const result = app.businessFunction({
  functionName: "Peppol",
  methodName: "ReceivePull"
});

With optional inbox override

const result = app.businessFunction({
  functionName: "Peppol",
  methodName: "ReceivePull",
  inboxId: "89c5026c-23ce-4542-b0b1-4b750c5737f2"
});

With optional notBefore

const result = app.businessFunction({
  functionName: "Peppol",
  methodName: "ReceivePull",
  notBefore: "2026-02-10T00:00:00Z"
});

Request Fields

Optional

• inboxId: string - process only one inbox in this run.

• notBefore: string - ISO date/time lower bound for transfer loading.

  • If omitted, backend uses last successful receive from journal.

  • If no history exists, backend uses default initial lookback.

Backend Route

• POST /Peppol/ReceivePull

Response (shape)

{
  "inboxesProcessed": 1,
  "transfersSeen": 2,
  "documentsSeen": 2,
  "documentsImported": 1,
  "documentsSkipped": 1,
  "items": [
    {
      "inboxId": "89c5026c-23ce-4542-b0b1-4b750c5737f2",
      "transferId": "75909014-117c-41a3-b57e-ea3029d563cf",
      "documentId": "a3b622b3-1246-4fd2-9da4-e8ad691eac52",
      "attachmentId": 245,
      "outcome": "Success",
      "httpStatus": 200,
      "message": "Imported"
    }
  ]
}

Notes

• Receive deduplication is document-based (documentId).

• Optional setting PEPPOL Receive Document Type Id is applied when creating attachments.

• Journal entries are written for receive operations and outcomes.