Skip to main content

🇦🇪 United Arab Emirates

This document describes all necessary configuration for a compliant setup in the United Arab Emirates (UAE).

Configuration​

In order to configure your store in the UAE to be compliant, the following configurations need to take place.

Settings​

All settings below should be set on the most convenient level possible. In other words, if your organization structure has a country organization which houses all your Emirati stores, then that's where these settings should go.

SettingValueOrganization unitDescription
Auditing:ProviderWHITE_LABELWHITE_LABEL on store OU's when phased go live or country level when big bang go live.-
UseInvoiceOutputFacadetrueRoot level or container levelAttaches the Certified Invoice PDF when emailing the Invoice from POS & EVA Sales / Companion App. This setting enables the use of the CertifiedInvoice stencil with destination Mail
Auditing:UseInvoiceCloningtrueRoot level or container levelUsed to create a duplicate of an original invoice whenever a customer is attached or mutated.
Auditing:PublicKeyBlobID-Root level or container levelID of the blob that was uploaded that contains the public key. This key and this setting will be provided to you by us (see below).
Auditing:PrivateKeyBlobID-Root level or container levelPart of the key-pair. This key and this setting will be provided to you by us (see below).
Auditing:EnforceTransactionValidationtrueRoot level or container levelEnforces validation to happen during the transaction to prevent obvious configuration mistakes.
Checking missed configuration(s)

Once you're done with all configuration steps. Make sure to run the service: AuditingValidateConfiguration which should return any step(s) that you may have missed or possibly undocumented.

Public and private key​

You'll need to reach out to us to generate a public and private key. Once you have these, you can follow the steps below.

Private key​

To set the private key the service AuditingSetPrivateKey can be used. This will upload the private key file and also increment the version setting automagically. It will also update the setting Auditing:PrivateKeyBlobID. We will have this setup done for you at the start of the project.

Public key​

The public key should be uploaded to EVA via the StoreBlob service. Please note that the blob needs to have an "OriginalName" otherwise, it'll expire immediately. We will get this done for you at the start.

The public key should be shared with the authorities whenever they ask for it, so they can verify signatures.

Infrastructure​

Cosmos DB will be set up by us, as this is required to keep track of the technical event log and the X/Z reports. If this is not set up, you won't be able to see any details in the technical event log section of Admin.

Company​

When configuring your Emirati organization unit(s), a company needs to be attached. If there is no Emirati company present yet, a new one can be created within Admin Suite under the Companies chapter. The following fields need be filled:

  • Name
  • VatNumber
  • RegistrationNumber
  • Address (VisitorAddress)
    • Street
    • HouseNumber
    • ZipCode
    • City
    • CountryID

Organization units​

Once a company is in place, you need to attach it to an organization unit.

Make sure the following fields are filled when creating an organization unit:

  • Name
  • BackendID (store number)
  • BranchNumber
  • Address
    • Street
    • ZipCode
    • City
    • CountryID
  • CompanyID
note

It is crucial that you have the CompanyID field filled when creating the organization unit. You can retrieve this ID from the Emirati company you created/have. This is the legal entity under which this OU/store is operating and will be referred to when filling in the details on the invoices and receipts.

Stations​

You can find steps on adding a new station here.

When creating a station, make sure the following fields are filled in:

  • Station name.
  • The checkmark This station is a fiscal station and will be used for transactions needs to be checked.
note

All payment types must have a category, otherwise the payment can't be correctly mapped, and ShipOrders would fail.

Fiscal archiving and audit files​

There are no compulsory regulations set by Emirati authorities when it comes to creation of Audit files. However, tax registered entites are obligated to maintain comprehensive records. This includes the retention of detailed information regarding all goods and services rendered to taxable parties.

To facilitate swift retrieval of such records for submission to the Emirati Federal Tax Authority (if needed), our white label audit files can be used. The audit file(s) include an overview of underlying tax information/operations readily available upon any requests from the authorities (file is in JSON format).

Stencil for Certified invoices​

For configuration and more details about Certified Invoices please refer to the general concepts section under Certified invoice stencil for thermal &/or PDF . A separate stencil is required to set up the email in which a certified invoice would be attached to. Configurations for such stencil can be found under Email invoice stencil.

Sample PDF and thermal receipts