# Merchant First Journey

This section guides merchants through managing property rentals using the Ottu Real Estate plugin.

## [Entities Involved](#entities-involved)

**Property**

* **Name**: Greenfield Towers
* **Details**: The property includes: An independent villa with 6 stories (6 units)
* **Unit Type**: Villa
* **Property Classification**: Residential Building or Villa.

**Tenant**

* **Name**: John Doe

**Contract**

* **Name**: Residential Lease Agreement
* **Details**: A rental agreement connecting a tenant to a specific unit.

## [Add a Property](#add-a-property)

1. 🏠 Navigate to the [Property Management](https://docs.ottu.com/user-guide/real-estate/regular-activities/property-management) section on the dashboard.
2. ➕ Click **Add Property**. 
3. 📝 Fill in the [New Property Form](https://docs.ottu.com/user-guide/regular-activities/property-management#new-property-from) with the key details, such as:
   * **Name**: Greenfield Towers
   * **Location**: Downtown City
   * **Classification**:  Residential Building or Villa

The merchant can choose to either save the property or add new units to it.

### [Add New Unit](#add-new-unit)

a. Clicking on **Add Unit Type with Units**, at the bottom of the **New Property From**, opens a form where the property’s unit details can be entered.

b. Click on **ADD OR EDIT UNITS** to specify the number of units associated with the property.

<figure><img src="https://2847651520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiUKrMb9zLt5ZzGPUYDsK%2Fuploads%2Fw7Bm2VF6OJyBvw90ZJth%2Fimage.png?alt=media&#x26;token=de59ac39-887a-4e79-8357-415a952f2112" alt=""><figcaption></figcaption></figure>

c. Click on the **ADD** button to define the details of these units, then fill the required information as illustrated in the below figures.

<figure><img src="https://2847651520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiUKrMb9zLt5ZzGPUYDsK%2Fuploads%2FRm9wIY6kus44gBZsYMH2%2Fimage.png?alt=media&#x26;token=0634f756-4f14-4157-b8f0-38d3d2886c49" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2847651520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiUKrMb9zLt5ZzGPUYDsK%2Fuploads%2Fjl1Sax5DaB3l6WeBJgTl%2Fimage.png?alt=media&#x26;token=360c43ce-7525-4096-8f8b-1b6b7fb30e24" alt=""><figcaption></figcaption></figure>

4. 💾 Save the property to make it available for actions like tenant assignment or contract creation.

Refer to the [Property Management](https://docs.ottu.com/user-guide/real-estate/regular-activities/property-management) section for further details on managing property settings and custom fields.

## [Add a Tenant](#add-a-tenant)

1. 👤 Navigate to the [Tenant and Contract Dashboard](https://docs.ottu.com/user-guide/real-estate/regular-activities/tenant-and-contract-management/tenant-and-contract-dashboard).
2. ➕ Click on **Add Tenant** to register a new tenant.
3. 📝 Provide essential information to the [New Tenant Form](https://docs.ottu.com/user-guide/regular-activities/tenant-and-contract-management/tenant-management#new-tenant-form), such as:
   * **Name**: John Doe
   * **Contact Details**: Email and phone number
   * **Assigned Property**: Link the tenant to a specific unit or property.
4. 💾 Save the tenant's profile.

For a comprehensive guide, refer to the [Tenant Management](https://docs.ottu.com/user-guide/real-estate/regular-activities/tenant-and-contract-management/tenant-management) section.

## [Add a Contract](#add-a-contract)

1. 📜 Access the [Tenant and Contract Dashboard](https://docs.ottu.com/user-guide/real-estate/regular-activities/tenant-and-contract-management/tenant-and-contract-dashboard).
2. ➕ Click on Add **Contract** to create a lease agreement.
3. 📝 Fill in the [New Contract Form](https://docs.ottu.com/user-guide/regular-activities/tenant-and-contract-management/contract-management/add-new-contract#new-contract-form) details:
   * [Property Name](https://docs.ottu.com/user-guide/regular-activities/tenant-and-contract-management/contract-management/add-new-contract#property-name): Greenfield Towers
   * [Tenant Name](https://docs.ottu.com/user-guide/regular-activities/tenant-and-contract-management/contract-management/add-new-contract#tenant-name): John Doe
   * Define the Unit by click on **ADD UNIT** button: in This Example, Unit Number 2. Check [here](https://docs.ottu.com/user-guide/regular-activities/tenant-and-contract-management/contract-management/add-new-contract#add-unit).
   * Contract duration and start date: 20-12-2024 till 19-01-2026
   * [Payment Start Date](https://docs.ottu.com/user-guide/regular-activities/tenant-and-contract-management/contract-management/add-new-contract#payment-start-date): 01-01-2025
   * [Number of invoices for advanced payment](https://docs.ottu.com/user-guide/regular-activities/tenant-and-contract-management/contract-management/add-new-contract#number-of-invoices-for-advanced-payment): 3
   * Payment Period: Monthly
4. ✅ Finalize and save the contract.

Refer to the [Contract Management Guide](https://docs.ottu.com/user-guide/real-estate/regular-activities/tenant-and-contract-management/contract-management) for additional information on editing and managing contracts.

**Invoices While Contracting:**

<figure><img src="https://2847651520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiUKrMb9zLt5ZzGPUYDsK%2Fuploads%2FPfNwcqpVofVOlkRCzC5O%2Fimage.png?alt=media&#x26;token=d9c93ae3-22bb-4310-8397-16c56744bc0d" alt=""><figcaption></figcaption></figure>

## [Print Unit Vacancy Report](#print-unit-vacancy-report)

1. 📄 Access the [Property Management Table](https://docs.ottu.com/user-guide/regular-activities/property-management#property-management-dashboard) in the dashboard.
2. 📊 Click the **Filter** button to define parameters, such as:&#x20;
   1. Unit Type **Villa**
   2. Property Classification, **Residential Building or Villa.**
3. 🔍 Click the **Print** button in the Property Management table to initiate the process.
4. 📄 The system will automatically generate a PDF containing the unit vacancy details for the Unit Type **Villa** and Property Classification **Residential Building or Villa.**
5. 💾 Once the PDF is generated, download it to your device for record-keeping or sharing.

<figure><img src="https://2847651520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiUKrMb9zLt5ZzGPUYDsK%2Fuploads%2FopOjzYGeFm7IEtKNEqVr%2Fimage.png?alt=media&#x26;token=46d976e4-5170-423b-9dfd-9ce55b8d19c2" alt=""><figcaption></figcaption></figure>

## [Print and Generate Invoices](#print-and-generate-invoices)

1. 📄 Navigate to the [Generate Invoice](https://docs.ottu.com/user-guide/real-estate/regular-activities/generate-invoice) section.

2. ➕ Choose the property as **Greenfield Towers.** Specify the desired Period as 2024-12

3. 🔍 Click **Show** button.

4. :receipt: All the relevant invoices will be displayed\
   &#x20;

   <figure><img src="https://2847651520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiUKrMb9zLt5ZzGPUYDsK%2Fuploads%2FJVNucfxMOsSSuRXmyDrS%2Fimage.png?alt=media&#x26;token=0adfe43f-dc7e-4574-9a74-aefee2ae017b" alt=""><figcaption></figcaption></figure>

5. Print Invoices:
   1. Clicking the **Print** button generates a PDF report containing all displayed invoice details, as shown below.
   2. Once generated, the merchant can download it for record-keeping or printing.<br>

      <figure><img src="https://2847651520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiUKrMb9zLt5ZzGPUYDsK%2Fuploads%2FgsFzawbS6aYopA2Zat1e%2Fimage.png?alt=media&#x26;token=f2e57e6d-a25f-4fde-a7c8-6ecc98107cb0" alt=""><figcaption></figcaption></figure>

6. Generate Invoices:&#x20;
   1. Click the **GENERATE INVOICES AND SEND PAYMENT LINKS** button to generate the displayed invoices.
   2. The associated payment links are automatically sent to the respective recipients.

Refer to the [Generate Invoice Guide](https://docs.ottu.com/user-guide/real-estate/regular-activities/generate-invoice) for detailed instructions.

## [Pay on the Invoice Link](#pay-on-the-invoice-link)

1. 🔗The invoice link will be shared automatically with the tenant via email or SMS.
2. 🖱️ The tenant accesses the payment page by clicking the link.<br>

   <figure><img src="https://2847651520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiUKrMb9zLt5ZzGPUYDsK%2Fuploads%2FGedXOog8MbGKCFpytcdz%2Fimage.png?alt=media&#x26;token=d6ea4704-fc04-4dc3-a12c-9e8a92b6f902" alt=""><figcaption></figcaption></figure>
3. 💳 Complete the payment using available methods like cards or wallets.

## [Pay on Manual Payment](#pay-on-manual-payment)

1. :rocket: To trigger a manual payment, access the **Contract Action List**. For detailed instructions on accessing the Contract Action List, please refer to this [guide](https://docs.ottu.com/user-guide/regular-activities/tenant-and-contract-management/contract-management/contract-action#to-trigger-contract-actions).
2. ➕ Select **Manual Payment** for recording an offline payment.<br>

   <figure><img src="https://2847651520-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiUKrMb9zLt5ZzGPUYDsK%2Fuploads%2FfacsvTSUQbX01S8ihcQ8%2Fimage.png?alt=media&#x26;token=d29ee515-14d0-4056-98dc-1eebba7baf56" alt=""><figcaption></figcaption></figure>
3. 🧾 After selecting **Manual Payment**, a [Manual Payment Form](https://docs.ottu.com/user-guide/regular-activities/tenant-and-contract-management/contract-management/contract-action/manual-payment#manual-payment-form) will appear. Fill in the required information to proceed.
4. ✅ Confirm and save the transaction.

Please refer to the [Manual Payment ](https://docs.ottu.com/user-guide/real-estate/regular-activities/tenant-and-contract-management/contract-management/contract-action/manual-payment)for more information.

## [View, and Print Invoices and Payments](#view-and-print-invoices-and-payments)

1. 📊 Access the [Invoices Dashboard](https://docs.ottu.com/user-guide/regular-activities/invoices-management#invoices-management-dashboard).
2. 🔍 Use filters for specific invoices or payments by property, tenant, or date range.
3. 🔎 Review the details.
4. 🖨️ Clicking the **Print** button generates a PDF file containing invoice details, allowing the merchant to easily print it.

By following these steps, merchants can effectively manage their properties, tenants, contracts, and financial transactions, ensuring a smooth workflow and maximizing operational efficiency.