Inbound notifications
Poll the notifications endpoint to retrieve inbound invoice notifications for Norway.
When Sovos receives an inbound document from the PEPPOL network, it processes it through the inbound pipeline and generates a notification to inform your systems that the document is ready for retrieval. These are the key components:
| Component | Role |
|---|---|
| Trade Service | Receives inbound documents from the PEPPOL network. |
| Network Services | Processes documents and generates notifications. |
| Compliance Service/Notifications | Stores and distributes notifications through the Notifications API. |
Notification delivery method
Norway supports the following notification delivery methods.
- Pull method (polling)
-
Your system actively retrieves notifications by calling the notifications API. This method:
-
Routes notifications to the notification service for client retrieval
-
Generates download URIs for accessing documents
-
Sends optional email notifications to configured recipients
-
Requires your system to poll the API at regular intervals
-
- Notification fields
-
Key notification fields:
Field Description notificationId Unique identifier for this notification correlationId Links notification to original data appPrefix Application prefix (CN = Compliance Network) metadata.productId Norway inbound product identifier: no_invoice_inbound_1.0metadata.transactionId ID for document processing metadata.documentId Unique document identifier metadata.erpSystemId ERP System ID configured on your company endpoint metadata.processType Always Inboundfor inbound documentsmetadata.taxId Company tax identifier metadata.sciCloudStatusCode Document status code. 215= Document is available to the recipientmetadata.sciResponseCode Overall compliance status. AP= Approvedcontent Base64-encoded UBL ApplicationResponse XML createdDate Time stamp when notification was created - Attachment types
-
Type Description Integration Document in the format set up for your ERP system. The name attribute indicates the format: ALL-PEPPOLSCI-1.0-INVOICE-1.0= SCI,ALL-PEPPOLBISUBL-3.0-INVOICE-1.0= PEPPOL BIS3.Legal Original PEPPOLBIS3 document as receivedPDF Human-readable PDF rendering of the document
For setup steps, see Configure network page.
After you inbound invoice notifications, process the document in your system, routing the document to the appropriate internal system using the erpSystemId from the notification.
You can also acknowledge receipt, marking the notification as processed in your system to avoid duplicate processing. Track the notificationId to prevent reprocessing.
