# Quick Start Guide

In order to have proper reporting on our property management business, we need to complete full payment collection process.

The steps below will demonstrate how to achieve that after creating new Aqary 247 account.&#x20;

## Step 1: Add a Property

Go to **Properties** module&#x20;

<figure><img src="/files/6wEIEG3WKBeHDL5gi67J" alt=""><figcaption></figcaption></figure>

Click on **New Property** Button&#x20;

<figure><img src="/files/njGNte47vR0FvaycFAZt" alt=""><figcaption></figcaption></figure>

Fill the **Create Property** Form with your property details

<figure><img src="/files/eyiOdMbUURNq10zC1xmQ" alt="" width="563"><figcaption></figcaption></figure>

**Property Form** Fields:

| Field          | Description                  | Example                        |
| -------------- | ---------------------------- | ------------------------------ |
| Name           | Name of your property        | Ocean Heights Building         |
| Description    | Description of your property | Luxurious residential building |
| Address        | Address of the building      | Water Garden                   |
| Property Image | Listing image                |                                |

## Step 2: Add a Unit

After adding a property, now we can go ahead add our first unit under that property.

Go to **Units** module&#x20;

<figure><img src="/files/QZoLdwEpUnmQnzOQOCfa" alt=""><figcaption></figcaption></figure>

Click on **New Unit** Button&#x20;

<figure><img src="/files/voSw6n6WvED7JVwsAojd" alt=""><figcaption></figcaption></figure>

Fill the **Create Unit** Form with your unit details

<figure><img src="/files/KEJ7tizyy7OsGkn4EKmn" alt="" width="506"><figcaption></figcaption></figure>

**Unit Form** Fields:

| Field                | Description                              | Example                |
| -------------------- | ---------------------------------------- | ---------------------- |
| Property             | Select property you have created earlier | Ocean Heights Building |
| Unit Number          | Unique identifier for this unit          | U101                   |
| Unit Type (Optional) | Categorize the unit type                 | Apartment              |

## Step 3: Add a Tenant

Before creating a lease, we need to create a **Tenant** record and populate account, personal or business information about this tenant.

Go to **Tenants** module&#x20;

<figure><img src="/files/vIDk0YNyxcGOvDZdi9Tj" alt=""><figcaption></figcaption></figure>

Click on **New Tenant** Button&#x20;

<figure><img src="/files/sE9v0Mdjy9PXA6aLHZM2" alt=""><figcaption></figcaption></figure>

Fill the **Create Tenant** Form with your tenant Details

<figure><img src="/files/pn8t4DQsBf3bIpdhZTkr" alt=""><figcaption></figcaption></figure>

**Tenant Form** Fields:

{% tabs %}
{% tab title="Account" %}
Main Information related tenant account in Aqary 247

| Field                            | Description | Example |
| -------------------------------- | ----------- | ------- |
| Name                             |             |         |
| Create Tenant Portal             |             |         |
| Email Address                    |             |         |
| Phone Number                     |             |         |
| Preferred Communication Language |             |         |
| {% endtab %}                     |             |         |

{% tab title="Personal" %}
Personal information if the tenant is a person

| Field                    | Description | Example |
| ------------------------ | ----------- | ------- |
| Date of Birth            |             |         |
| Nationality              |             |         |
| Marital Status           |             |         |
| Number of Family Members |             |         |
| Smart Card Number        |             |         |
| Smart Card Expiry Date   |             |         |
| Emergency Contact Name   |             |         |
| Emergency Contact Email  |             |         |
| Emergency Contact Phone  |             |         |
| {% endtab %}             |             |         |

{% tab title="Business" %}
Business information if the tenant is an organization

| Field                    | Description | Example |
| ------------------------ | ----------- | ------- |
| Registration Number      |             |         |
| Registration Expiry Date |             |         |
| Business Type            |             |         |
| Tax ID                   |             |         |
| Alternate Business Phone |             |         |
| Business Address         |             |         |
| {% endtab %}             |             |         |

{% tab title="Employment" %}
Employment information regarding the tenant

| Field             | Description | Example |
| ----------------- | ----------- | ------- |
| Employment Type   |             |         |
| Employer          |             |         |
| Job Title         |             |         |
| Work Email        |             |         |
| Work Phone        |             |         |
| Work Mobile Phone |             |         |
| Supervisor Name   |             |         |
| Supervisor Phone  |             |         |
| {% endtab %}      |             |         |
| {% endtabs %}     |             |         |

## Step 4: Add a Lease

Now since we have the unit and tenant ready, we can link those two by creating a lease record.

Go to **Leases** module&#x20;

<figure><img src="/files/Ub3zaK7cvqumbcGP2s9p" alt=""><figcaption></figcaption></figure>

Click on **New Lease** Button&#x20;

<figure><img src="/files/yJNUIrnkZe0f4IL1VUiR" alt=""><figcaption></figcaption></figure>

Fill the **Create Lease** Form with your tenant Details

<figure><img src="/files/QNEWzbSlo1nC3X8MGWBg" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/YyNDRMV2yUe3yGAw1xlH" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/aTieLc49vUdbNvfjdml5" alt=""><figcaption></figcaption></figure>

**Lease Form** Fields:

| Field                  | Description                                                                                                                                                                                                                                                                                                                         | Example                                        |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| Property               | Earlier created property                                                                                                                                                                                                                                                                                                            | Ocean Heights Building                         |
| Unit                   | Earlier created unit                                                                                                                                                                                                                                                                                                                | U101                                           |
| Tenant                 | Earlier created tenant                                                                                                                                                                                                                                                                                                              | Ali Abdulla                                    |
| Lease Start Date       | <p>Date when the lease starts<br><br><mark style="background-color:yellow;">Note: Unit status will be <strong>Occupied</strong> starting from his date</mark></p>                                                                                                                                                                   | 01/12/2025                                     |
| Lease End Date         | <p>Date when the lease ends<br><br><mark style="background-color:yellow;">Note: Unit status will be <strong>Vacant</strong> starting from his date</mark></p>                                                                                                                                                                       | 30/11/2026                                     |
| Rent Amount            | Amount to be charged after each frequency cycle                                                                                                                                                                                                                                                                                     | 350                                            |
| Deposit Amount         | Insurance deposit amount by the tenant                                                                                                                                                                                                                                                                                              | 100                                            |
| Late Fees Amount       | Penalty fees charged in the end of the **Grace Period**                                                                                                                                                                                                                                                                             | 50                                             |
| Grace Period (Days)    | days allowed before the late fees are charged                                                                                                                                                                                                                                                                                       | 7                                              |
| First Payment Due Date | <p>The date when the invoice will be frequently generated.</p><p></p><p>If you want to charge the tenant in the beginning of the month then just select 1st day of that month (you can select past date).<br><br><mark style="background-color:yellow;">Note: This date will be set as recurring invoice's next run date</mark></p> | 01/12/2025                                     |
| Payment Frequency      | The repeating period of invoice generation                                                                                                                                                                                                                                                                                          | Monthly                                        |
| Electricity Included   | If lease amount includes electricity charge                                                                                                                                                                                                                                                                                         | Yes                                            |
| Water Included         | If lease amount includes water charge                                                                                                                                                                                                                                                                                               | Yes                                            |
| Notes                  | Internal notes about the lease                                                                                                                                                                                                                                                                                                      | Deposit to be returned in the end of the lease |
| Documents              | Lease related documents                                                                                                                                                                                                                                                                                                             |                                                |

## Step 5: Add a Tenant Payment

Now since we have created the lease. An invoice should be automatically created based on **First Payment Due Date** (Usually 1st day of the month).

Let's assume, the tenant paid his rent and you went to go and record this payment.

Go to **Invoices** module payment, follow these steps:

<figure><img src="/files/B7y7b84XTGoFqfzyqQ7B" alt=""><figcaption></figcaption></figure>

Select the invoice which to be paid then scroll down until you see **New Invoice Payment**

<figure><img src="/files/L93waRCtvGjK6dbk9e1e" alt=""><figcaption></figcaption></figure>

Click on **New Invoice Payment** Button&#x20;

<figure><img src="/files/nvlRzLDWCCDNgUbTq48l" alt=""><figcaption></figcaption></figure>

Fill the **Create Invoice Payment** Form with received payment details

<figure><img src="/files/f7oeCWhpbvHXmj8vpEcT" alt=""><figcaption></figcaption></figure>

| Field                 | Description                                        | Example       |
| --------------------- | -------------------------------------------------- | ------------- |
| Amount Paid           | Amount received by tenant for this invoice         | 350           |
| Payment Date          | The actual date of receiving the payment           | 04/12/2025    |
| Payment Method        | How was the payment was made                       | Bank Transfer |
| Transaction Reference | Reference number or code that identify the payment | ETF123456     |
| Notes                 | Internal Payment Notes                             | No Notes      |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://value-ocean.gitbook.io/aqary-247/getting-started/quick-start-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
