# Quotation

{% embed url="<https://www.youtube.com/watch?v=uBGB-S1oZog>" %}

<details>

<summary>Step 1: Create a New Quotation</summary>

Navigate to the **Sales** dropdown, select **Quotation**, and click **"Add New"** to create a new quotation.

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

</details>

<details>

<summary>Step 2: Insert Quotation Details</summary>

🔹 **Quotation Date&#x20;*****(Required)***\
Select the date the quotation is issued. This ensures accurate tracking of when the quotation was created.

🔹 **Expiry Date&#x20;*****(Optional)***\
Set the date when the quotation will no longer be valid. Leave this field blank if the quotation has no expiry.

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

</details>

<details>

<summary>Step 3: Insert Client Details</summary>

🔹 **Client Name&#x20;*****(Required)***\
Select or type the customer’s registered name. This will link the quotation directly to the correct client profile.

🔹 **Details**\
This field is auto filled based on the selected client, including the contact person and contact number.

<figure><img src="/files/7Jm35oAPZW1QdKiDDlem" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Step 4: Insert Item Details</summary>

🔹 **Currency&#x20;*****(Required)***\
Select the currency for the quotation (e.g., MYR for Malaysian Ringgit).

🔹 **Items&#x20;*****(Required)***\
Add the products or services being quoted. Complete the following fields for each item:

* **Description:** Name of the product or service.
* **Quantity:** Number of units.
* **Rate:** Price per unit.
* **Tax (%):** Applicable tax rate (e.g., SST 6%).
* **Amount:** Automatically calculated as *(Quantity × Rate) + Tax*.

🔹 **Subtotal**\
Displays the total amount before discounts or additional adjustments.

🔹 **Discount&#x20;*****(Optional)***\
Enter any discount amount or percentage offered to the client.

🔹 **Total Amount**\
Shows the final payable amount after applying discounts.

**Option 1:** If your quotation is in **MYR (Malaysian Ringgit)**, fill in the standard fields as listed.

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

**Option 2:** If your quotation is in **another currency**, an additional **Exchange Rate** field will appear, which you must complete.

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

</details>

<details>

<summary>Step 5: Include Remarks</summary>

🔹 **Notes**\
Add any additional terms, conditions, or special instructions you want to share with your client (e.g., *“Valid for 30 days”*, *“10% downpayment required to confirm”*).

By default, a standard remark will be included automatically. You may click **"Modify"** to edit and personalize the remark as needed.

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

</details>

<details>

<summary>Step 6: Save Quotation Details</summary>

Click the **"Save"** button to store the quotation details. Quotation is created! 🎉

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

</details>

<details>

<summary>Step 7: Modify Quotation Details <em>(Optional)</em></summary>

Once the quotation details are saved, the quotation will be created in **Draft** status, and a quotation number (e.g. QUO-00001) will be automatically assigned.

To make changes, click **"Edit"**, update the details as needed, and then click **"Save"** to store the updates.

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

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

</details>

<details>

<summary>Step 8: Share the Quotation via WhatsApp or Email</summary>

Click the **Share** button to send the quotation directly, either by **WhatsApp** or **Email**

* **WhatsApp** – Contact number and default message autofill. Edit if needed, then **Send**.
* **Email** – Email address and default message autofill. Edit if needed, then **Send**.

💡 **Tip:** Ensure client details (phone & email) are filled in so fields populate automatically.

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

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

</details>

<details>

<summary>Step 9: Convert Quotation to Invoice</summary>

Click the **Convert** button to turn the quotation into an invoice.

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

A confirmation pop-up will appear, reminding you that once the quotation is converted into an invoice, the quotation details can no longer be edited.

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

Once you click **OK**, you will be redirected to the **Invoice Creation** page. Some fields will be automatically populated based on the quotation details.&#x20;

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

For more info, please refer to the [Invoice](/pigeonbook-tutorial/feature-guides/invoice.md#step-1-create-a-new-invoice) section.

</details>


---

# 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://pigeonbook.gitbook.io/pigeonbook-tutorial/feature-guides/quotation.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.
