Back to News
Changelog

Received documents we cannot deliver are now reported, and SDK 5.5.0 types the event

peppolwebhooksconsolesdk

A document sent to your account over Peppol can arrive and still not reach you: it is larger than getpeppr can receive (10 MiB), or it cannot be matched to a Legal Entity that is active on your account. Until now nothing told you.

What you get now

  • A webhook, inbound.document.undeliverable, with data.reason (too_large or legal_entity_unresolved) and the provider reference to quote to support. An endpoint subscribed to inbound.invoice.received or inbound.creditnote.received receives it without subscribing to it. Deduplicate on data.undeliverableDocumentId. It does not count toward your usage.
  • A row on the Invoices page with the status Undeliverable, its own detail page, and a failed entry in Activity. Both show a result code and what to do, described in the webhooks documentation.

There is no received document behind this event: nothing to fetch from /v1/received-documents. To receive the document, the sender has to send it again under the size limit, or to a Peppol ID that is active on your account.

SDK 5.5.0 adds inbound.document.undeliverable to WEBHOOK_EVENT_TYPES and the WebhookEventType union, and its README now lists the three reception events. There is no other type or runtime change. If a switch over the event type checks exhaustiveness, it needs a new case when you upgrade.

npm install @getpeppr/sdk@5.5.0

The CLI does not handle webhook events, so it is unchanged.