Cloud Events Document Exchange

The Cloud Events Document Exchange extension connects Business Central to electronic document exchange networks. Send and receive invoices, orders, and other business documents via Advania, Unimaze, and InExchange using the Cloud Events message-based API.

Getting Started

The extension requires Origo Cloud Events Core to be installed. After installation, configure your provider credentials in the Cloud Events Setup page.

  1. Open Cloud Events Setup from the search bar.
  2. Enter your provider API credentials (API key, company ID, or OAuth settings).
  3. Use the Cloud Events Queue API to submit document exchange requests.
  4. Retrieve results from the Cloud Events Data API.

BIS 3.0 Reference Data

Built-in Peppol BIS 3.0 reference data is available without external credentials. Use these message types to look up standard codes for electronic documents.

Message TypeDescription
DocumentExchange.BIS30.CountryCodesISO country codes for Peppol documents
DocumentExchange.BIS30.CurrenciesCurrency codes
DocumentExchange.BIS30.DocumentTypeCodesDocument type identifiers (380=Invoice, 381=Credit Note, etc.)
DocumentExchange.BIS30.DocumentTypesDocument type descriptions
DocumentExchange.BIS30.ElectronicAddressSchemesElectronic address scheme identifiers (EAS)
DocumentExchange.BIS30.InvoicedObjectIdentifiersInvoiced object identifier scheme codes
DocumentExchange.BIS30.MimeCodesMIME type codes for attachments
DocumentExchange.BIS30.ParticipantSchemesParticipant identifier schemes
DocumentExchange.BIS30.UnitCodesUnit of measure codes (UN/ECE Rec 20)
DocumentExchange.BIS30.VatCodesVAT category codes

Advania

Advania is Iceland's primary document exchange platform. The following message types are available for receiving, sending, and managing electronic documents through Advania.

Receive Documents

Message TypeDescription
DocumentExchange.Advania.GetUnreadGet list of unread documents
DocumentExchange.Advania.GetDocumentGet full document content by ID
DocumentExchange.Advania.GetDocumentInfoGet document metadata
DocumentExchange.Advania.GetDocumentLinesGet document line items
DocumentExchange.Advania.GetAttachmentsGet document attachments
DocumentExchange.Advania.GetDocumentHistoryGet document status history

Status Management

Message TypeDescription
DocumentExchange.Advania.UpdateStatusUpdate status of a document
DocumentExchange.Advania.StatusSyncSynchronize statuses for all tracked documents
DocumentExchange.Advania.GetStatusesGet available status values

Send Documents

Message TypeDescription
DocumentExchange.Advania.SubmitDocumentSubmit a document for delivery
DocumentExchange.Advania.CreateInvoiceCreate and send an invoice from BC data

Mailbox Queries

Message TypeDescription
DocumentExchange.Advania.GetInboxGet inbox document list
DocumentExchange.Advania.GetSentGet sent document list
DocumentExchange.Advania.InboxSinceGet inbox documents since a date

Partner Lookup

Message TypeDescription
DocumentExchange.Advania.GetTradingPartnersGet registered trading partners
DocumentExchange.Advania.GetAuthorizedPartnersGet partners authorized to send documents

Document Retrieval

Message TypeDescription
DocumentExchange.Advania.LookupDocumentLook up a document by reference
DocumentExchange.Advania.GetDocumentPdfGet document as PDF
DocumentExchange.Advania.GetPresentationGet formatted document presentation

User and UI Access

Message TypeDescription
DocumentExchange.Advania.GetUserAccessGet user access information
DocumentExchange.Advania.GetWebUIUrlGet URL for web interface
DocumentExchange.Advania.GetSessionUrlGet authenticated session URL

Document Processing

Message TypeDescription
DocumentExchange.Advania.ConvertXmlConvert XML between formats
DocumentExchange.Advania.CompressPdfCompress a PDF document
DocumentExchange.Advania.OcrPdfRun OCR on a PDF document

Additional Services

Message TypeDescription
DocumentExchange.Advania.CheckUniversalServiceCheck universal service availability
DocumentExchange.Advania.GetDocumentSupportGet supported document types for a partner
DocumentExchange.Advania.GetDocumentTypesGet all available document types
DocumentExchange.Advania.GetDocumentLightGet lightweight document summary
DocumentExchange.Advania.GetUnreadRemittanceGet unread remittance advices

Unimaze

Unimaze is a Nordic document exchange network supporting electronic invoicing across Scandinavia.

Receive Documents

Message TypeDescription
DocumentExchange.Unimaze.GetUnreadGet unread documents
DocumentExchange.Unimaze.GetDocumentGet full document by ID
DocumentExchange.Unimaze.GetDocumentInfoGet document metadata
DocumentExchange.Unimaze.GetDocumentHistoryGet document history

Status Management

Message TypeDescription
DocumentExchange.Unimaze.UpdateStatusUpdate document status
DocumentExchange.Unimaze.StatusSyncSynchronize document statuses

Send Documents

Message TypeDescription
DocumentExchange.Unimaze.CreateInvoiceCreate and send an invoice
DocumentExchange.Unimaze.SubmitTransactionSubmit a transaction
DocumentExchange.Unimaze.SubmitXmlSubmit raw XML document

Queries

Message TypeDescription
DocumentExchange.Unimaze.GetInboxGet inbox contents
DocumentExchange.Unimaze.LookupDocumentLook up document by reference
DocumentExchange.Unimaze.GetPresentationGet document presentation
DocumentExchange.Unimaze.GetPartyInfoGet party/partner information

Operations

Message TypeDescription
DocumentExchange.Unimaze.AddAttachmentAdd attachment to a document
DocumentExchange.Unimaze.GetValidationsGet validation results
DocumentExchange.Unimaze.RetryMessageRetry a failed message

Workflow

Message TypeDescription
DocumentExchange.Unimaze.RegisterPaymentRegister payment for a document
DocumentExchange.Unimaze.RegisterRejectionRegister document rejection
DocumentExchange.Unimaze.GetPendingActionsGet actions pending user decision

Additional

Message TypeDescription
DocumentExchange.Unimaze.CreateGenericMessageCreate a generic message
DocumentExchange.Unimaze.GetDocumentOriginalGet original document file
DocumentExchange.Unimaze.GetDocumentTransformedGet transformed document
DocumentExchange.Unimaze.GetDocumentSupportGet supported document types

InExchange

InExchange is a Swedish electronic invoicing network used across the Nordics.

Receive Documents

Message TypeDescription
DocumentExchange.InExchange.GetIncomingGet incoming documents
DocumentExchange.InExchange.GetDocumentGet full document by ID
DocumentExchange.InExchange.GetDocumentInfoGet document metadata

Status and Send

Message TypeDescription
DocumentExchange.InExchange.MarkHandledMark document as handled
DocumentExchange.InExchange.SendDocumentSend a document
DocumentExchange.InExchange.GetOutboundStatusTrack outbound document status

Partner Discovery

Message TypeDescription
DocumentExchange.InExchange.BuyerLookupLook up a buyer in the network
DocumentExchange.InExchange.SellerLookupLook up a seller in the network

UBL Rendering

Generate standards-compliant UBL 2.1 XML documents directly from Business Central data. No external credentials are required.

Message TypeDescription
DocumentExchange.UBL.RenderBillingRender invoice or credit note as UBL XML
DocumentExchange.UBL.RenderOrderRender order as UBL XML
DocumentExchange.UBL.RenderDespatchAdviceRender despatch advice as UBL XML
DocumentExchange.UBL.RenderStatementRender statement as UBL XML

Help

Message TypeDescription
Help.DocumentExchange.GetGet help documentation for document exchange message types

Error Handling

When a provider operation fails (authentication error, network issue, invalid request), the response contains a structured JSON error object with:

Check the Cloud Event Message status field for task completion state.

Support

For assistance, contact Origo.