ClearTax E-Invoice is an integration that automatically submits RMS tax invoices to the Peppol network via ClearTax, supporting the United Arab Emirates (UAE) mandatory e-invoicing requirement.

Overview

The United Arab Emirates (UAE) is introducing a mandatory electronic invoicing requirement based on the Peppol network. Under guidelines published by the UAE Ministry of Finance, the requirement begins on 1 January 2027 for large businesses (those with annual revenue of AED 50 million or more) and is scheduled to extend to all businesses by July 2027.

RMS supports this obligation through its ClearTax E-Invoice integration. When the integration is active on a Property, RMS transmits tax invoices to ClearTax, which validates them and routes them via the Peppol network. The integration is triggered automatically at the point a tax invoice is created in RMS, so no extra steps are required from the user during daily operations.

This integration applies only to Properties with Country set to United Arab Emirates. It does not affect invoices issued by Properties in other countries.

Prerequisites

• The Property is registered in the United Arab Emirates and the Country field in Property Information is set to United Arab Emirates.
• The business holds a valid UAE VAT registration (Tax Registration Number).
• The business is registered on the Peppol network and has a Peppol ID, obtained through a registered Peppol service provider.
• A ClearTax account with an active Access Token, provisioned directly with ClearTax.
• The E-Invoice module is activated on the Property via the Module Market. Only a System Administrator or the Manager Profile has access to the Module Market.
• Administrative access in RMS to edit Property Options and account profiles.

Information

How the integration works

When a tax invoice is created in RMS for a UAE Property, RMS evaluates the Invoice To party and decides whether to submit the invoice to ClearTax. When submission is required, RMS sends the invoice payload to ClearTax. ClearTax validates the invoice and delivers it via the Peppol network.

If ClearTax rejects the payload, the API error is shown to the user at the point of invoice creation. A notification email is also sent to the address configured against the integration. The invoice is not flagged as e-invoiced in this case, and the user can correct the underlying data and reprint to retry.

Activation conditions

The integration is active for an invoice when all three conditions are true:

• The Property Country is set to United Arab Emirates.
• The E-Invoice module is enabled on the Property.
• ClearTax is selected as the e-invoicing partner on the Property.

Key terms

• Peppol (Pan-European Public Procurement Online) - the network used to transmit structured e-invoices between businesses. The UAE e-invoicing framework uses Peppol as the transmission platform.
• Peppol ID - the network identifier that uniquely identifies a party on the Peppol network. Format: Scheme:Identifier (for example, 0235:1008245654). Required on each Company or Travel Agent account that will receive e-invoices, and on the Property itself.
• VAT Number (Tax Registration Number) - the UAE VAT registration number issued to the business. Stored in the ABN/GST field on Company and Travel Agent profiles in RMS.
• Party Identification Number - an optional additional identifier required by ClearTax for some configurations. Obtained from ClearTax at account setup.
• Access Token - the API authentication token provided by ClearTax, used to authorise each invoice submission from RMS.

Setup

Step 1 - Activate the module

1. Confirm the Property Country is set to United Arab Emirates in Setup > Property Options > Property Information.
2. Select ClearTax as the e-invoicing partner and record the ClearTax API credentials and the error notification email address.

Step 2 - Enter credentials

Once the module is activated, open the module configuration and enter the following credentials provided by ClearTax:

Step 3 - Record Peppol IDs and VAT numbers on Company and Travel Agent accounts

The integration uses the Peppol ID and VAT number recorded on the Invoice To party to decide whether to submit an invoice. Record these values on every Company and Travel Agent account that may be billed for UAE tax invoices. Enter the VAT number in the ABN/GST field, and record the recipient's Peppol ID in the field configured for it on the account.

The Scheme Agency ID and Agency Name can be obtained from Peppol.

To setup the Peppol ID field, go to -

• Setup > Property Options > Labels.

   
  Properties tab -
  Spare Field 2 = Scheme Agency ID:Scheme Agency Name
   
  Company tab -
  Spare Field 4 = Scheme Agency ID:Scheme Agency Name
   
  Travel Agent tab -
  Spare Field 3 = Scheme Agency ID:Scheme Agency Name

Step 4 - Test

1. Create a test reservation in the Training Database and post charges across at least two charge types.
2. Settle the reservation and issue a tax invoice with the Invoice To set to a Company account that has a valid Peppol ID and VAT number recorded.
3. Confirm the invoice is submitted to ClearTax and that no rejection errors are displayed.
4. Repeat the test with a Travel Agent account as the Invoice To party.

Daily Use

Issuing a tax invoice

When a tax invoice is created in RMS, the integration automatically decides whether to submit it to ClearTax based on the Invoice To party's Peppol ID and VAT number. No extra steps are required from the user. The invoice is raised as normal and the submission happens in the background.

If ClearTax rejects the submission, the API error is shown to the user at the point of invoice creation, and a notification email is sent to the address configured against the integration.

Which invoices are submitted

An invoice is submitted to ClearTax when the Invoice To party (Company or Travel Agent) has a valid Peppol ID and VAT number recorded. Where either value is missing, the invoice is not submitted. Accounts Receivable handling is unchanged: the balance is posted to the Invoice To party's account as it would be without the integration.

Error handling

If ClearTax rejects the submission, the API error is shown to the user at the point of invoice creation and an email is sent to the configured notification address. The invoice is not flagged as e-invoiced. After correcting the underlying issue, typically an incorrect Peppol ID, missing VAT number, or invalid credential, the user can reprint the invoice to retry the submission.

Common Setup Issues

• Issue: The E-Invoice module does not appear for activation.
  Fix: Confirm the Property Country is set to United Arab Emirates in Setup > Property Options > Property Information. The module is only available for activation on Properties with Country set to United Arab Emirates when using the ClearTax partner.
• Issue: Invoice is not submitted to ClearTax for a Company account.
  Fix: Confirm that a valid Peppol ID is recorded on the Company profile and that the ABN/GST field contains the VAT number.
• Issue: ClearTax rejects the invoice payload.
  Fix: Check the notification email for the specific error. Common causes are an incorrect Access Token, a mistyped Peppol ID, or a VAT number format error. Correct the credential or account data and reprint to retry.
• Issue: The Access Token is rejected by ClearTax.
  Fix: Access Tokens can expire or be regenerated by ClearTax. Contact ClearTax to confirm the token is still active and update the Access Token field in the module configuration in RMS.

FAQs

Does ClearTax cost extra?

ClearTax is a separately contracted service. The Property must hold its own ClearTax account and API credentials. RMS does not bill for ClearTax usage.

What is the difference between the Peppol ID and the Party Identification Number?

The Peppol ID identifies your Property as the sender on the Peppol network. The Party Identification Number is an optional additional identifier required by ClearTax's platform. Both are provided during ClearTax account setup. If you are unsure which value to enter where, contact ClearTax support.

What if the Property is part of a multi-property group with properties in different countries?

Activation is per Property. Only Properties with Country set to United Arab Emirates and the E-Invoice module enabled use the UAE configuration. Properties in other countries use their own country-specific configuration if e-invoicing is enabled, or are unaffected if it is not.

Can the integration be tested before going live?

Yes. ClearTax provides a sandbox environment with sandbox credentials. Configure the integration using the sandbox Access Token and run end-to-end tests, then switch to production credentials when the Property is ready to go live.

Related Articles

• Modules & Interfaces

• Interface Partners