🇯🇴 Jordan
This document describes all necessary configuration for a compliant setup in Jordan.
Local mode is currently not supported. Activating local mode is done at your discretion and risk. We strongly recommend conducting thorough testing of local mode before going live to ensure it aligns with your expectations.
If you require support for local mode in compliance countries, please submit a JIRA development ticket, namely a request for change.
Configuration
In order to configure your store in Jordan 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 Jordanian stores, then that's where these settings should go.
| Setting | Value | Organization unit | Description |
|---|---|---|---|
| Auditing:Provider | WHITE_LABEL | WHITE_LABEL on store OU's when phased go live or country level when big bang go live. | - |
| UseInvoiceOutputFacade | true | Root level or container level | Attaches 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:UseInvoiceCloning | true | Root level or container level | Used to create a duplicate of an original invoice whenever a customer is attached or mutated. |
| Auditing:PublicKeyBlobID | - | Root level or container level | ID of the blob that was uploaded that contains the public key. This setting will be set by us (see below how to request this). |
| Auditing:PrivateKeyBlobID | - | Root level or container level | Part of the key-pair. This setting will be set by us (see below how to request this). |
| Auditing:EnforceTransactionValidation | true | Root level or container level | Enforces validation to happen during the transaction to prevent obvious configuration mistakes. |
Once you're done with all configuration steps. Make sure to use the Validate audit configuration button to check if any compliance-related configurations or data is missing or successfully configured.
Request Public and Private keys
For the Auditing:PublicKeyBlobID and Auditing:PrivateKeyBlobID settings, please reach out to us by submitting a ticket via support.
After we do our part, we will go ahead and set those in your environment.
Do not change the values of those two settings unless explicitly advised by us to do so.
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 Jordanian organization unit(s), a company needs to be attached. If there is no Jordanian 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
It is crucial that you have the CompanyID field filled when creating the organization unit. You can retrieve this ID from the Jordanian 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.
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 Jordanian 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 Jordanian Income and Sales Tax Department (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.
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.