Overview
The Emaar integration is used by companies that must report sales information to Emaar. QBM provides separate tools for Daily Sales, Monthly Sales, and Emaar Transactions review.
QBM calculates sales and refund totals from customer invoice activity for the selected location and period. The user reviews the calculated values, then uploads the values when they are ready.
Setup Required First
Typical setup path: Options > Integrations > Emaar Properties.
| Setup Item | What It Means | Why It Matters |
|---|---|---|
| Enable Emaar | Turns on the Emaar integration. | The Emaar menu and workflows are useful only when the integration is enabled and configured. |
| Location / Store | Maps a QBM location to an Emaar reporting location. | Sales are calculated by selected location. |
| Unit Number | The unit number agreed with Emaar. | QBM sends this value with the sales data. |
| Lease Code | The lease reference agreed with Emaar. | QBM sends this value with the sales data. |
| API / URLs | Connection details used by the integration. | Support or an administrator should confirm these before users upload sales. |
Do not upload before setup is complete. Missing unit number, lease code, API key, or URL information can stop the upload or send incomplete information.
Daily Sales
Typical path: Emaar > Daily Sales.
| Field / Button | What It Does | User Guidance |
|---|---|---|
| Date | The sales date to report. | Select the business date being reported. |
| Location | The configured Emaar location. | Select the location that matches the unit and lease setup. |
| Apply | Calculates sales and refund totals from QBM transactions for the date and location. | Click Apply before uploading so totals are filled from QBM. |
| Sales Amount / Sales Count | Total sales and number of sales transactions found by QBM. | Review these values before upload. |
| Refund Amount / Refund Count | Total refunds and number of refund transactions found by QBM. | Review these to make sure the net value is correct. |
| Amount To Send / Count To Send | Net values prepared for upload. | Normally this equals sales less refunds. Confirm before submitting. |
| Upload | Sends the daily sales data to Emaar. | Use only after totals are reviewed and approved. |
Monthly Sales
Typical path: Emaar > Monthly Sales.
| Field / Button | What It Does | User Guidance |
|---|---|---|
| From Date | Start date for the month. | Must be the first day of the month. |
| To Date | End date for the month. | Must be the last day of the same month. |
| Location | The configured Emaar location. | Select the location that matches the required lease and unit setup. |
| Apply | Calculates monthly sales and refund totals from QBM. | Click Apply before uploading. |
| Description / Remarks | Notes sent or stored with the monthly submission where used. | Use only meaningful notes that support the submission. |
| Upload | Sends the monthly sales data to Emaar. | Upload after totals and date range are confirmed. |
Date rule: Monthly Sales requires one complete month. The From and To dates must be in the same month.
Emaar Transactions
Typical path: Emaar > Transactions.
| Area | What It Shows | How To Use It |
|---|---|---|
| Date | Filters Emaar submissions by date. | Select the date you need to review. |
| Type | All, Daily Sales, or Monthly Sales. | Use the type filter to focus on daily or monthly submissions. |
| Go | Loads the filtered transaction list. | Click after selecting date or type. |
| Grid columns | Count, Sales, Total, Date, From, To, and Description where available. | Use the list to confirm what was submitted or stored. |
| Delete | Deletes allowed Emaar transaction records. | Use carefully. Daily records may be restricted by age; monthly records may not be deleted through the same flow. |
Security and Access
Emaar Daily Sales, Monthly Sales, and Transactions are controlled by security permissions. Users without full access may be able to open a screen but not upload or delete records.
- Daily Sales access controls daily upload.
- Monthly Sales access controls monthly upload.
- Emaar Transactions access controls review and follow-up.
- Delete actions should be limited to trusted users only.
Best Practice
- Complete setup in Options before users start uploading.
- Click Apply and review the calculated totals before Upload.
- Compare QBM daily or monthly sales reports before submitting when the period is important.
- Do not upload the same period twice. QBM checks existing transactions, but users should still review carefully.
- Keep Emaar permissions limited to trained users.