Skip to main content

Unibox User Guide

unibox_logo.svg

Unibox version: 2026.9.2
Audience: Unibox users, tenant administrators, and integration teams.

About this guide​

Unibox is a multi-tenant platform for the secure exchange of structured electronic business documents, including invoices and credit notes, through the Peppol network. It also supports tax reporting and controlled integration with external systems.

This guide explains how to:

  • access the appropriate Unibox environment;
  • find, filter, and review business documents;
  • submit XML and XLSX documents;
  • manage company users, API keys, and webhooks;
  • understand the document lifecycle and document statuses.

Contents​

Getting started​

Prerequisites​

Before using Unibox, confirm that you have:

  • an active company profile in the applicable environment (Production or UAT);
  • a modern, up-to-date web browser with JavaScript enabled;
  • the appropriate role (Tenant Admin or User) assigned to your account;
  • for API or webhook integration, access to a system capable of making HTTPS requests.

Environments​

EnvironmentPurposeAccess method
ProductionLive operations and official document exchangeCompany onboarding through the official FTA/EmaraTax flow
UATTesting integrations, features, and user trainingTenant provisioned with assistance from the Unibox support team

Production onboarding​

To prepare a company for live operation:

  1. Open the official EmaraTax portal.
  2. Follow the portal instructions to create or access the company profile.
  3. Complete the required company onboarding and verification steps.
  4. After onboarding is confirmed, sign in to the Unibox Production environment with UAE PASS.

For general information about the national programme, see the FTA's UAE e-Invoicing page.

UAT access​

UAT is separate from Production and does not support self-registration. To request a UAT tenant, provide the Unibox support team with:

  • company legal name;
  • primary contact person;
  • preferred tenant administrator email address.

The support team provisions the testing tenant and sends the applicable access instructions.

User roles​

RoleAccess
Tenant AdminCan use the Document Register and access Company Management to manage users and integrations
UserCan use the document features available to the company, but cannot access Company Management

Left-side navigation​

The left-side panel provides quick access to the main areas of Unibox:

  • Document Register – the main document list (see Document Register).
  • Business Partners – manage saved business partner records, which can be selected to help fill in invoices (see Business Partners).
  • Company Management – available to Tenant Admins only (see Company Management).
  • Documentation – opens this user guide directly from within Unibox.
  • Contact Support – a quick way to reach the Unibox support team without leaving the application.

Screenshot 2026-09-17 at 12.23.30 AM.png

Document Register​

The Document Register is the main Unibox screen. It provides a centralized view of incoming and outgoing business documents.

Document Register showing incoming and outgoing documents

Figure 1. Document Register

Search and filters​

Use the controls above the document list to narrow the displayed results.

Document Register search and filter controls

Figure 2. Search and filter controls

Available search and filter criteria include:

  • Document Number - searches by the business document number;
  • Business Partner - searches by the sender or receiver name;
  • Issue Date - filters documents by their issue date;
  • Status - filters by one or more processing statuses;
  • Document Type - filters by document type, such as invoice or credit note;
  • Direction - shows all, incoming, or outgoing documents;
  • Tax Reported - where available, distinguishes documents by tax-reporting state.

Document list​

The document list can include the following columns:

ColumnDescription
Document NumberBusiness identifier assigned to the document
DirectionIncoming or outgoing
Business PartnerSender for incoming documents or receiver for outgoing documents
Business ID (TIN)Tax identifier of the business partner
Document TypeInvoice, credit note, or another supported type (see Supported document types)
AmountDocument total and currency
Issue DateDate stated on the document
StatusCurrent processing status
Last UpdateTime of the most recent status or data update
Tax ReportedIndicates whether tax reporting has completed successfully

Use Columns to control which supported columns are visible. Select a document row to open its details. Sorting is available for supported columns, and pagination controls appear below the list.

Supported document types​

Unibox document types follow the UAE's PINT AE (Peppol International, UAE localization) specification published by the Ministry of Finance. The following document types are currently defined:

CodeDocument type
380Commercial Invoice
381Credit Note
81Credit Note related to goods and services
389Self-billed Invoice
261Self-billed Credit Note
480Invoice out of scope of tax

Document details​

Select a row in the Document Register to open the Document Details view.

Document Details view with summary, identification, sender, and receiver data

Figure 3. Document Details

Header and available actions​

The header shows the business document number and current status. Depending on the document and its processing stage, the following views or download options may be available:

  • PDF;
  • source XML;
  • Tax Data Document (TDD);
  • processing history.

Summary​

The summary identifies the business partner and shows the business ID (TIN), issue date, amount, and currency.

Identification​

The identification section can include:

  • internal Unibox document ID;
  • business document number;
  • direction;
  • business document type;
  • Peppol process ID;
  • document type identifier;
  • SBDH instance ID.

Sender and receiver​

The sender and receiver sections can include:

  • Peppol ID;
  • company name;
  • Tax Identifier Number (TIN);
  • Tax Registration Number (TRN);
  • legal company identifier.

Access Point and delivery information​

When available, the document details also show the Peppol Access Point endpoint and the submission and delivery timestamps.

Business Partners​

The Business Partners area, available from the left-side panel, stores reusable records for the companies you regularly exchange documents with.

Screenshot 2026-09-17 at 12.25.06 AM.png

Figure 10. Business Partners list

Add a business partner​

Screenshot 2026-09-17 at 12.25.27 AM.png

Figure 11. Add Partner dialog

  1. Open Business Partners from the left-side panel.
  2. Select Add Partner.
  3. Enter the partner's company name and identifying details (such as TIN, TRN, or Peppol ID).
  4. Confirm to save the record.

Using a business partner in Create Document​

When manually filling in an invoice through Create Document, you can select a saved business partner from the list instead of entering their details by hand. This pre-fills the relevant sender/receiver fields and helps reduce data-entry errors.

Screenshot 2026-09-17 at 12.27.13 AM.png

Figure 12. Selecting a saved business partner in Create Document

Submit a document​

From the Document Register, authorized users can submit a structured document by selecting Upload XML or Upload XLSX.

Upload XML, Upload XLSX, and Create Document options

Figure 4. Document submission options

Note: This section covers file-based XML and XLSX submission. The Create Document option opens a separate guided document-entry flow when that feature is enabled for the tenant, and lets you select a saved Business Partner instead of entering details manually.

Upload an XML document​

Screenshot 2026-09-17 at 12.28.57 AM.png

Figure 5. Upload XML dialog

  1. Select Upload XML.
  2. Enable Non-Peppol sending only when the document is intended for reporting mode and must not be delivered through the Peppol network.
  3. Browse for the XML file or drag it into the upload area.
  4. Select Upload XML to submit the document.

The XML must be a supported UBL document that complies with the applicable PINT AE schema and business rules.

Upload an XLSX document​

!Screenshot 2026-09-17 at 12.29.37 AM.png

Figure 6. Upload XLSX dialog

  1. Select Upload XLSX.
  2. If needed, select Download Template to get the current official XLSX template.
  3. Browse for the completed XLSX file or drag it into the upload area.
  4. Select Upload XLSX to submit the document.

Use the official Unibox spreadsheet template and do not rename or remove required columns. Each XLSX submission can contain one invoice per file; because only a single invoice is ever uploaded at a time, there is no separate file size limit.

What happens after submission​

Unibox performs the following processing steps:

  1. validates the file structure and applicable business rules;
  2. creates the internal document record;
  3. processes and enriches the document data;
  4. routes a standard outgoing document through the Peppol Access Point, or processes a non-Peppol submission in reporting mode;
  5. updates the document status as processing continues.

Invalid files are rejected with an appropriate validation status. Open the document details to review the available error information.

Company Management​

Company Management is available only to users with the Tenant Admin role. It contains the Accounts, API Keys, and Webhooks areas.

Manage users​

Screenshot 2026-09-17 at 12.30.02 AM.png

Figure 7. User management

Tenant administrators can:

  • view users within the company;
  • filter by name, email, role, and status;
  • assign roles and manage access;
  • review whether an account is active or inactive.

Invite a user​

  1. Open Company from left side panel and select Accounts.
  2. Select Add Account.
  3. Enter the user's email address.
  4. If an authentication-method selector is shown, select the method applicable to the environment. Production uses UAE PASS; test credentials may be enabled for UAT.
  5. Assign the appropriate role.
  6. Confirm the invitation.

The invited user receives an email with the next steps.

Manage API keys​

API keys allow an external system, such as an ERP, to authenticate to the Unibox Integration API.

API Keys area in Company Management

Figure 8. API key management

The API key list shows information such as:

  • label;
  • masked key value;
  • creation timestamp;
  • last-used timestamp;
  • expiration timestamp;
  • status.

Create an API key​

  1. Open Company Management and select API Keys.
  2. Select Add API Key.
  3. Enter a meaningful label that identifies the integration.
  4. Select an expiration date.
  5. Confirm the creation.
  6. Copy the full API key and store it in a secure secrets manager.

Important: The full API key is displayed only once. Never store it in source code, screenshots, tickets, or ordinary documents. Revoke a key immediately if it may have been exposed.

Manage webhooks​

Webhooks notify an external system about relevant document events without requiring continuous polling.

Webhooks area in Company Management

Figure 9. Webhook management

Tenant administrators can configure HTTPS endpoints and monitor each webhook's status and most recent delivery attempt.

Note: Your receiving endpoint should verify that incoming requests genuinely originate from Unibox and should handle retried or duplicate deliveries safely.

Add a webhook​

  1. Open Company Management and select Webhooks.
  2. Select Add Webhook.
  3. Enter the receiving endpoint URL. Only HTTPS endpoints are accepted.
  4. Enter a description if the field is available.
  5. Confirm the configuration.

The receiving system should process duplicate notifications safely and return a successful HTTP response only after accepting the event.

Document lifecycle​

A typical outgoing document follows this lifecycle:

  1. Submission - the user, UI, or integration submits the document.
  2. Validation - Unibox checks the schema and business rules.
  3. Processing - Unibox creates the document record and performs required enrichment.
  4. Exchange - Unibox routes the document through the Peppol Access Point when Peppol delivery applies.
  5. Tax reporting - the TDD is reported to C5 when required.
  6. Tracking - Unibox records acknowledgements, delivery events, errors, and status updates.

Incoming documents enter Unibox through the Peppol Access Point, are validated and stored, and then become available in the Document Register.

Tax reporting is asynchronous. A successful Peppol exchange does not by itself mean that tax reporting has completed.

Status definitions​

Statuses do not always occur in a single sequence. The applicable path depends on document direction, delivery mode, and whether tax reporting is required.

StatusMeaningApplies toRecommended user action
InitialThe document record exists, but validation or processing has not started.Incoming & outgoingWait briefly and refresh the document status.
NewUnibox accepted or received the document and queued it for further processing.Incoming & outgoingNo action is normally required.
ExchangedThe document was transmitted through Peppol and acknowledged by the receiving Access Point. Tax reporting may still be pending or may not apply.OutgoingMonitor the status if tax reporting is required.
Validation ErrorThe document failed schema or business-rule validation, such as XSD, Schematron, or PINT AE validation.Incoming & outgoingOpen the error details, correct the document, and submit it again.
Receiver Validation ErrorDelivery completed, but the receiver reported a validation problem.OutgoingReview the receiver's error information and coordinate a corrected document if required.
Tax ReportedThe applicable tax report or TDD was accepted by C5/FTA.Incoming & outgoingNo action is normally required.
Sending ErrorValidation succeeded, but Unibox or the Access Point could not complete transmission to the intended destination.OutgoingReview the error details and retry or contact support.
Tax Report ErrorPeppol processing may have completed, but C5 rejected the TDD or tax reporting otherwise failed.Incoming & outgoingReview the tax-reporting error and correct or resubmit as instructed.

Glossary​

TermMeaning
Access Point (AP)A Peppol service component used to send and receive business documents over the Peppol network
C5The UAE tax-reporting platform or service that receives tax data from service providers
EmaraTaxThe UAE Federal Tax Authority's digital tax services portal, used for company onboarding
FTAFederal Tax Authority, the UAE government body responsible for tax administration, including e-invoicing
PeppolAn international network and standard framework for exchanging business documents electronically between systems
PINT AEThe UAE specialization of the Peppol International Invoice specification
Reporting modeSubmission mode used for documents that are reported for tax purposes but not delivered through the Peppol network
SBDHStandard Business Document Header used to carry routing and document metadata
TDDTax Data Document submitted for tax reporting
TenantA company's dedicated, isolated instance within Unibox
TINTax Identifier Number
TRNTax Registration Number
UAE PASSThe UAE's national digital identity and signing platform, used to sign in to Unibox Production

Support​

You can also reach support directly from Unibox by selecting Contact Support in the left-side panel.

If a problem cannot be resolved from the status and error details, contact your Unibox support representative and provide:

  • company or tenant name;
  • internal document ID;
  • business document number;
  • current status;
  • time when the issue occurred;
  • relevant error message.

Do not send API keys, passwords, or other secrets in a support request.

Changelog​

VersionDateSummary
0.1.4—Previous release
0.1.52026-09-15Removed country selection from XML/XLSX upload; added XLSX template download step and single-invoice/no-file-size-limit note; added Supported document types table; added Business Partners section and left-side navigation overview; added Prerequisites, expanded Glossary, and Applies-to column on Status definitions