# Create a new quotation Source: https://docs.zuper.co/Accounting/Create_New_Quote A quotation, also known as an estimate, is a formal document provided to a customer that details the expected costs for a specific service or project. It includes a breakdown of services, materials, labor, and any additional expenses. As a preliminary agreement, a quotation helps set clear expectations for the scope of work and associated costs. **Navigation**: *Accounting* *->* *Quotes* -> *+ New (Quote)* 1. Click the “**Accounting**” module from the left navigation menu and select "**Quotes.**" ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-10.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=76d2c8d74aea8ff367b9df05fc126223) 2. Click “**+ New Quote**” to create a new quote. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/quotes-3.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=9287258c2f9da8edca98dec5c689f593) 3. Select either "**Customer** ", " **Organization**", or "**Property**" to associate with the quotation. 4. Click "**+ Add**" to associate the various modules. > [!NOTE] > > You can now associate multiple assets with a quote. 5. A side panel will appear. Select the required module and click the "**Proceed**" button. 6. The billing and service contact details are automatically populated based on the selected customer or organization. 7. Fill in the mandatory fields in the **Quote Details** section: * **Quote Date** * **Expiry Date** * **Quote Template** > [!NOTE] > > The **Created By** field is automatically set to the user who creates the quote and cannot be changed after the quote is saved. If a different team member takes over the quote, the **Created By** field will continue to display the original creator's name. To reflect updated ownership, use the **Quote Sold By** field to assign the team member actively handling the quote. This field can be updated at any time and is used for ownership tracking, filtering, and sales performance reporting. **Important:** If a specific user needs to appear as the creator of a quote, they must create it themselves from their own login. The **Created By** field cannot be reassigned after creation. > [!NOTE] > > **Note: Remarks field and PDF templates**\ > The **Remarks** field on a quote lets you add custom notes that appear on the quote record. However, whether these remarks appear in the generated PDF depends on how the quote template is configured.\ > \ > If the Remarks section in the PDF template is **hard-coded** (contains static text set during template creation), any changes made to the Remarks field on the quote will not be reflected in the PDF — the template's fixed text will display instead.\ > \ > To have the Remarks field value appear dynamically in the PDF, the template must be updated to use the dynamic Remarks field variable. Contact [**support@zuper.co**](mailto:support@zuper.co) to request this change.\ > \ > **Note:** Custom template changes affect all quotes using that template. Before requesting a change, confirm that updating the Remarks behavior will not affect other quotes currently relying on the static text. 8. Click "**+ Add**" in the **Parts & Services** section and select an option to add parts, products, or services to the quotation, such as *Line Item*, *Bundle*, [*Section*](https://docs.zuper.co/Accounting/Sections), *Item Group*, or *Custom Line Item*. ![Sect4 1](https://mintcdn.com/zuperinc/r_ueXa0MUhgIBr_E/images/sect4-1.png?fit=max\&auto=format\&n=r_ueXa0MUhgIBr_E\&q=85\&s=52ee8986438ad6fff168b55a0c7ca7e0) > [!TIP] > > If **Mandate asset association to line items** is enabled in the **Settings** and your quote includes one or more assets, ensure every line item has an asset selected. Otherwise, you won’t be able to save the quote. > [!NOTE] > > When you add a non-billable item directly to a quote, its cost is included in the total, ensuring proper tracking. However, if a non-billable item is part of a transaction (such as a job or contract) and that document is later converted into a quote, the item will not appear on the invoice. This is because non-billable items are excluded from the billable total. > [accordion] Updating markup and discount for Parts, Products, and Services > > After adding parts, products, and services, you can edit or update the Markup value and its discount by following these steps: > > 1. Locate the line item in the list of added parts, products, or services. > 2. Click the **context menu** (three-dot ellipsis) next to the item you want to update. > 3. Choose the **Edit** option. An **Edit Line Item** pop-up will open. > > ![Quotes 5](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/quotes-5.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=26b0806f71245f20bdb230eda4389b33) > > * Adjust the markup type to **Flat (+)**, **Percentage (%)**, or **Multiplier (x)** based on your requirement and enter the desired value for the selected markup condition. > > * Edit the discount as either a **percentage (%)** or a **fixed amount (USD)** and enter the desired value in the **Discount** field. > > 4. Click **Update** Line Item to apply the changes. > > ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/quotes-6.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=22a9195613a5f1799f0da7d987018d1f) 9. If **Track Serial Number** is enabled and **Mandate Serial No** is turned on in Settings, you must need to enter a serial number before proceeding. 10. You can [add rebates](/Accounting/Rebates) to show your customer the potential savings available to them. Zuper uses the rebate amount to calculate and display the customer’s Net Investment without changing the quote Total or Amount Due. 11. After adding parts and services to the quote, transactional discounts and global taxes will be applied. > [!NOTE] > > **Notes:** > > * If a line item includes a custom tax, transactional discounts, and global taxes cannot be applied. > * Transactional-level discounts apply only when all parts and services in the quote are either fully taxable or fully non-taxable. > * If a line item includes a custom tax, transactional discounts, and global taxes cannot be applied. > * Transactional-level discounts apply only when all parts and services in the quote are either fully taxable or fully non-taxable. > * When any line item on the quote has a custom tax applied, the **Transaction Level** option will not appear in the discount type selector. Removing the custom-tax line item, or updating it to be non-taxable or taxable without a custom tax, restores the **Transaction Level** option. > [!NOTE] > > **Tax display in templates** > > The way taxes appear on your quote PDF — for example, whether tax is shown separately per line item or as a single total — is controlled by your document template settings. Some regional billing standards, such as Canadian invoicing requirements, require taxes to be displayed separately from each line item on the document. If you need to change how taxes appear on your quote or proposal templates, contact [Support ](mailto:support@zuper.co) > > Your administrator cannot change this setting directly. 11. Adjust the [margin percentage](/Accounting/Profit_Margin) to instantly recalculate markup % and the total selling price for all line items. 12. **Payment Methods:** Select the [payment methods](/Zuper-pay/Settings#configure-the-payment-methods-your-customers-can-see) you want to offer the customer for this quote. You can turn individual payment methods on or off as needed. 13. Enter the details for any custom fields configured in the settings. 14. Click "**+ Add Attachments"** to upload any quotation-related files. 15. Click " **Save as Draft"** to temporarily save the quotation. In the confirmation pop-up, click " **Save as Draft"** again to confirm. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/quotes-4.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=3f362f2648b5d383dec9b7a5ba026ecc) 15. The quotation is created successfully. ## Send a quotation After you save a quotation, you can send it to the customer for review and acceptance. 1. Open the quotation from the **Quotes** listing page. 2. Select **Send** at the top right of the details page. 3. A send dialog appears. Before you send, review the **Document Template** field in the dialog. > [!WARNING] > > The **Document Template** field in the send dialog controls which template is used to generate the PDF the customer receives. This is separate from the template you selected when you created the quote. If you change the template here, the PDF layout and content will reflect the newly selected template — not your original selection. Always confirm that the correct template is selected before sending. > [!NOTE] > > **Email attachment size limit** When sending a quote by email, attachments are included directly in the email up to a combined size of **20MB**. If the total attachment size exceeds 20MB, Zuper automatically converts attachments to inline download links in the email body rather than sending them as attachments. Recipients can still access the files by clicking the links, but the files will not appear as standard email attachments. **Workaround:** If you need attachments to be delivered as standard email attachments, ensure the total size of all attached files is under 20MB before sending. Consider compressing large files or splitting them across multiple sends if needed. 4. Make any other adjustments to the email details, then select **Send**. The customer receives the quotation as a PDF based on the template selected at send time. > [!NOTE] > > **Note:** If you have recently edited a quote, wait at least one minute before sending the email. Sending immediately after making changes may result in the PDF attachment showing outdated values. The electronic signing link will always reflect the latest version. > > If you have edited the **Remarks** field, ensure the quote is explicitly saved (via **Save as Draft**) before exporting or sending the PDF. Remarks edits that are not saved prior to PDF generation may revert to the previously saved version. ### Set a default document template To avoid selecting the wrong template each time you send, you can configure a default document template in your settings. The default template pre-populates the **Document Template** field whenever you send a quotation. 1. Go to **Settings**. 2. Go to **Accounting**, then select **Document Templates**. 3. Locate the template you want to set as the default. 4. Select the context menu (three-dot ellipsis) next to the template. 5. Select **Set as Default**. The selected template now pre-populates the **Document Template** field each time you send a quotation. > [!NOTE] > > **Note**: Setting a default template does not prevent you from selecting a different template at send time. Always review the **Document Template** field before sending to confirm that the correct template is selected. > [!NOTE] > > **Note:** Setting a default template here only affects quotes sent or printed from the **Quotes** module. If you print or save a quote-related document from within a **Job** record, that document uses the **Job Card Template** assigned to the job instead — see [Configuring Job Card Templates](/Settings/Modules/Jobs/Configuring-job-card-template). > [!WARNING] > > **Reversing an accepted quote:** A quote cannot be moved backward from > **Accepted** to **Sent**, and it cannot be returned to **Draft** from the > Quote Details page. Status transitions on quotes move forward only. > > If a customer changes their mind after approving a quote, you have two > options: > > * **Clone the quote** and send the copy, keeping the original accepted record > intact for audit purposes. > * **Contact [Zuper Support](mailto:support@zuper.co)** with the quote number > if the original record itself must be reverted. Quotations are sent to customers for their review and acceptance before the job begins. Once the customer accepts the quotation, technicians can proceed with the services or replacement of parts listed in the document. ## Frequently asked questions > [accordion] Does adding a rebate reduce the quote Total or Amount Due? > > No. The rebate is shown separately and is used only to calculate the customer's **Net Investment**. > [accordion] Can I add multiple rebates to a quote? > > Yes. You can add multiple rebates to a quote, up to the supported limit. Zuper combines them when calculating **Net Investment**. > [accordion] What happens if I edit a rebate template after adding it to a quote? > > The rebate already added to the quote does not change. Edit the rebate directly on the quote if you need to update it. > [accordion] Who can see purchase tax fields > > Users see **Pre-Tax Cost** and **Purchase Tax %** only when their custom role has **View Purchase Tax** turned on. These fields appear only for stocked materials, and only when your organization has purchase tax enabled. The permission applies to both the web app and the Zuper Field Service app. > > To give a role access: > > 1. Select **Settings** from the left navigation menu, then select **Users & Teams** > **Custom Roles**. > 2. Select the role, then select **Products** from the **List of Modules**. > 3. Turn on **View Purchase Tax**, then click **Update Role**. # Difference Between Proposals and Quotes Source: https://docs.zuper.co/Accounting/Difference_Between_Proposals_and_Quotes The following table outlines the key differences between **Proposals** and **Quotes** in Zuper, helping you understand their unique purposes and features. | Feature | Proposal | Quote | | - | - | - | | **Purpose** | A preliminary document designed to showcase service offerings, pricing options, and flexibility during negotiations. | A formal document that finalizes the agreed-upon services, pricing, and terms. | | **Customization** | Allows adding multiple service options with flexible pricing to let customers choose what suits them best. | Contains fixed details with no room for customization after customer approval. | | **Negotiation** | Enables back-and-forth communication between the business and the customer to finalize terms and services. | Represents final, agreed-upon terms that are ready for execution without further negotiation. | | **Approval Process** | Requires explicit customer approval before being converted into a quote. | Indicates services and pricing already approved by the customer and ready for execution. | | **Uses** | Can present options like different service packages (e.g., basic, premium) for customer review and decision-making. | When the customer has selected an option, and the details are ready to move forward as a job or project. | | **Workflow in Zuper** |
  1. Navigate to the **Proposals** section.
  2. Create a proposal by adding service options, pricing, and terms.
  3. Send it to the customer for review and approval.
  4. Convert it into a quote after approval.
|
  1. Navigate to the **Quotes** section.
  2. Create a quote with finalized details.
  3. Share it with the customer for execution.
| | **Examples** |
  1. A service business presents multiple repair package options (e.g., **Basic Repair** vs. **Comprehensive Repair**) for the customer to choose from.
  2. A facility maintenance company sends a proposal with pricing for weekly, bi-weekly, and monthly maintenance plans for review.
|
  1. After the customer approves the selected package, a finalized quote is created for the **Comprehensive Repair**.
  2. A quote for a fixed monthly maintenance plan is issued after the customer’s approval.
| | **Associated Actions in Zuper** |
  1. Send reminders to customers for proposal review.
  2. Update the proposal status (e.g., Draft, Sent, Approved, Declined).
  3. Convert a proposal into a quote for execution.
|
  1. Track the status of the quote (e.g., Draft, Sent, Accepted).
  2. Clone quotes for similar jobs.
  3. Archive or cancel outdated quotes.
| # Discounts Source: https://docs.zuper.co/Accounting/Discounts Discounts help you offer promotions, reward customers, match competitor pricing, or make approved price adjustments on quotes and invoices. In Zuper, you can apply a discount to the entire quote or invoice or to a specific line item. Zuper automatically updates the subtotal, tax, and total based on the discount you apply. You can also add multiple discounts to the same quote or invoice when transaction-level discounts are enabled. There are two ways to add discounts: * **Transaction-level discounts** apply to the entire quote or invoice. Use them to stack multiple discounts such as promotions, loyalty discounts, or manager-approved adjustments. * **Line-item discounts** apply to a specific product, part, or service. Use them when only certain items need a price adjustment. You can add discounts in the Zuper web app and the Zuper Field Service app. > [accordion] **Things to know** > > * Your organization can use either transaction-level discounts or line-item discounts. Only one discount method can be enabled at a time. Your admin set "**Apply discount at?**" in **Settings → Modules → Quotes and Invoices → General**. > * To select from saved discounts, create them first in **Settings → Modules → Quotes and Invoices → Discount & Fees**. Learn more in Configuring Quotes and Invoices. > * Role and trade-type restrictions determine which discounts users can access. [https://drive.google.com/file/d/17ihETP5r8bdmM6EX58CELatDaZhkbCPm/preview](https://drive.google.com/file/d/17ihETP5r8bdmM6EX58CELatDaZhkbCPm/preview) ## Transaction-level discounts A homeowner qualifies for a spring promotion and a veteran discount, and your sales manager approves an additional 5% discount. You can add each discount separately below the **Sub-Total** by clicking "Add Discount?", which makes it easy for your team to understand how the final price was calculated. Zuper applies each discount to the remaining amount after the previous discount has been applied. Tax is calculated last, using the **Subtotal after discount**. #### **To apply a discount to your quote or invoice:** 1. Create a quote or invoice, or navigate to an existing quote or invoice.  2. Add your line items. 3. Below **Sub-Total**, click **Add Discount?**. 4. Click **Enter label** and select a saved discount, or enter a name for a new discount. 5. Enter or update the value. Select **USD** for a fixed amount or **%** for a percentage. 6. Click outside the row to apply the discount. This discount will be deducted from the sub-total. 7. To add another discount, click **Add Discount?** again and repeat the process. ![SCR 20261007 Pyxm](https://mintcdn.com/zuperinc/gNu_KsIpmGJCI4-i/images/SCR-20261007-pyxm.png?fit=max\&auto=format\&n=gNu_KsIpmGJCI4-i\&q=85\&s=b7cce1672d6ade062379ec2392ba1402) > [!WARNING] > > **Important**: Transaction-level discounts are applied sequentially. Each percentage discount is calculated on the remaining amount after previous discounts have been applied. Changing the order of discounts can change the final total. ## Line-item discounts Line-item discounts are useful when only one product or service requires a price adjustment. For example, you may offer a discount on a specific part, or provide a one-time reduction on a service without affecting the rest of the quote. Zuper strikes through the item's original total and displays the discounted total below it. The **Sub-Total** reflects the discounted line totals, and tax is calculated on that amount. ### To add a line-item discount 1. From your quote or invoice, click **Add line item**. If you are editing an already created quote or invoice, click (...) in the **Actions** column and select **Edit**. 2. In **Discount**, select **USD** or **%**. 3. Enter the discount value. 4. Click **Update Line Item**. ![SCR 20261007 Qame](https://mintcdn.com/zuperinc/gNu_KsIpmGJCI4-i/images/SCR-20261007-qame.png?fit=max\&auto=format\&n=gNu_KsIpmGJCI4-i\&q=85\&s=bc99dab9243b2a952281cd7bbccf3976) Zuper strikes through the original line total and displays the discounted total below it. ![SCR 20261007 Pszp](https://mintcdn.com/zuperinc/gNu_KsIpmGJCI4-i/images/SCR-20261007-pszp.png?fit=max\&auto=format\&n=gNu_KsIpmGJCI4-i\&q=85\&s=b933e090e11ac82c42e47bdde313d93c) ## Frequently asked questions > [accordion] Why don't I see Add Discount? > > Your account is configured for line-item discounts. Use **Edit Item** on individual line items instead. > [accordion] Why can't I find a saved discount in the Enter label list? > > Your admin may have restricted the discount to specific roles or trade types. The discount appears only when your user role and trade type match the configured restrictions. > [accordion] Does my customer see individual discounts? > > Your team can view each discount separately on the quote or invoice details page. In the generated PDF, discounts are combined and displayed as a single **Discount** value. > [accordion] Why did my total change when I added the same discounts in a different order? > > Percentage discounts are calculated on the remaining amount after previous discounts have been applied. Because of this, changing the order of discounts can change the final total. > [accordion] Can I change a saved discount's value on one quote? > > Yes. After selecting a saved discount, you can edit its value before applying it to the quote or invoice. # Managing accounts receivable Source: https://docs.zuper.co/Accounting/Invoices/AR_management Accounts Receivable (AR) represents the money owed to your business by customers for goods or services delivered but not yet paid for.   With Zuper, you can now efficiently track and manage your accounts receivable by gaining clear visibility into customers and organizations with outstanding invoice balances. Zuper also provides detailed aging information, helping you understand how long payments have been overdue.  By effective management of accounts receivable, you can reduce outstanding balances, improve liquidity, and minimize financial risks, contributing to better cash flow and overall financial health.  ## Managing accounts receivable    To manage your account receivables, follow these steps:  1. Select the Accounting module from the left navigation menu and choose “**Invoices**.” 2. You will land on the invoices summary page, which displays details such as the Invoice Number, Invoice Date, Due Date, Customer, and more for each invoice.  3. Click “**AR management**” at the top right of the screen. This will take you to the AR Management dashboard, where you can access an overview and the AR Aging Summary.  ![](https://mintcdn.com/zuperinc/55Qa433qzSjowzFB/Accounting/Invoices/16.png?fit=max\&auto=format\&n=55Qa433qzSjowzFB\&q=85\&s=c73ece5aaa86d60923142e1c96877581) ### Dashboard insights  On the AR Management Dashboard (Overview), you can view the following key metrics and insights, providing a centralized view for efficiently monitoring overdue payments. The dashboard also includes clear prioritization indicators through charts and a list of the most overdue invoices.  ![](https://mintcdn.com/zuperinc/55Qa433qzSjowzFB/Accounting/Invoices/2.png?fit=max\&auto=format\&n=55Qa433qzSjowzFB\&q=85\&s=78fcdb1583e487749a047ae51a0fd33a) * **Outstanding Balance**: Total amount owed by customers or total accounts receivable. This includes both current and overdue amounts.  * **Delinquent Accounts**: No. of customer/organization accounts that fall under an aging bucket, representing overdue invoice payments.  * **Bad Debt**: Amount that is considered unlikely to be collected.  * **Aging period**: Displayed as a donut chart, this provides a clear overview of payment statuses. It categorizes outstanding accounts receivable into time intervals based on how long they have been overdue. This includes:  1. **Current**: Payments not yet overdue. 2. **1–30 Days**: Payments overdue by 1 to 30 days. 3. **31–60 Days**: Payments overdue by 31 to 60 days.  4. **61–90 Days**: Payments overdue by 61 to 90 days.  5. **90+ Days**: Payments overdue for more than 90 days * **Most overdue invoice**: Highlights the top 10 delinquent invoices that require urgent attention. This section includes key details such as actual due date, number of days overdue, invoice number, due amount, and the responsible customer’s name & phone number. ![](https://mintcdn.com/zuperinc/55Qa433qzSjowzFB/Accounting/Invoices/3.png?fit=max\&auto=format\&n=55Qa433qzSjowzFB\&q=85\&s=9e757b48157925fa25cfdc532453e089) > [!NOTE] > > **Note**: From here, you can quickly send payment reminders to customers linked to selected invoices. Additionally, you can mark invoices as bad debt, if considered uncollectible, using the icon. ### A/R aging summary The AR Aging Summary provides a detailed breakdown of accounts receivable categorized by aging periods. You can switch between different summary views to focus on data specific to:  ![](https://mintcdn.com/zuperinc/55Qa433qzSjowzFB/Accounting/Invoices/4.png?fit=max\&auto=format\&n=55Qa433qzSjowzFB\&q=85\&s=23d3eb9b1ef077bd90a5eea9567db486) 1. Invoice  2. Customer/Organization ### Invoice view:  When you switch to the invoice view, the table includes the following details based on the filter applied. The filter criteria include customer, due date, and aging period. ![](https://mintcdn.com/zuperinc/55Qa433qzSjowzFB/Accounting/Invoices/5.png?fit=max\&auto=format\&n=55Qa433qzSjowzFB\&q=85\&s=b378978ca2381c784deb2bab3e37c5f1) 1. **Invoice Number**: A unique identifier for each invoice.  2. **Due Date**: The date by which the invoice payment is expected. 3. **Customer Name**: The name of the customer responsible for the invoice.  4. **Customer Phone Number**: The contact number of the customer for easy communication.  5. **Days Overdue**: The number of days the payment has been overdue since the due date.  6. **Aging Period**: The time interval categorizing the overdue status (e.g., 1–30 days, 31–60 days, 61-90 days, and >90 days).  7. **Amount Due**: The total outstanding balance on the invoice.  > [!NOTE] > > **Note**: You can also customize the columns or fields displayed on the table to suit your needs. To do this, click the “**Columns**” option at the top right of the table and select or deselect the fields you want to show or hide. ![](https://mintcdn.com/zuperinc/55Qa433qzSjowzFB/Accounting/Invoices/6.png?fit=max\&auto=format\&n=55Qa433qzSjowzFB\&q=85\&s=836169792fc2dbe15ed8d9872590675e) In addition to viewing the AR Aging Summary by invoice, you can multi-select invoices and perform the following bulk actions. These options streamline account receivable management, saving time and enhancing efficiency.  ![](https://mintcdn.com/zuperinc/55Qa433qzSjowzFB/Accounting/Invoices/7.png?fit=max\&auto=format\&n=55Qa433qzSjowzFB\&q=85\&s=a324ead1b2aa3438434bf44ca6ac6876) * **Send Reminder**: Quickly send payment reminders to customers associated with the selected invoices to prompt timely payments. The reminders by default, include the attached invoices, ensuring customers have all the necessary details for easy reference and seamless payment processing.  ![](https://mintcdn.com/zuperinc/55Qa433qzSjowzFB/Accounting/Invoices/8.png?fit=max\&auto=format\&n=55Qa433qzSjowzFB\&q=85\&s=c728d6f91c5817d32ce761ab436793eb) * **Mark as Bad Debt**: Designate selected invoices as bad debt if they are deemed uncollectible, ensuring accurate financial reporting.  > [!NOTE] > > **Note**: You can also use the icon next to an invoice to "**Send Reminder"** or "**Mark as Bad Debt"** for that specific invoice. ![](https://mintcdn.com/zuperinc/55Qa433qzSjowzFB/Accounting/Invoices/10.png?fit=max\&auto=format\&n=55Qa433qzSjowzFB\&q=85\&s=e1f2fa7b3543f950a6851b8dcc6b0204) ### Customer/Organization view:  When you switch to the customer/organization view, the table displays the following details based on the filter applied.  ![](https://mintcdn.com/zuperinc/55Qa433qzSjowzFB/Accounting/Invoices/11.png?fit=max\&auto=format\&n=55Qa433qzSjowzFB\&q=85\&s=327f3d6582a70059ca0fb1a0d183a9e1) 1. **Customer/Org Name**: The name of the customer or organization associated with the account.  2. **Current**: The amount owed by the customer that has not yet passed the due date.  3. **1-30 Days**: The amount of accounts receivable overdue by 1 to 30 days.  4. **31-60 Days**: The amount overdue by 31 to 60 days. 5. **61-90 Days**: The amount overdue by 61 to 90 days.  6. **> 90 Days**: The amount overdue for more than 90 days.  7. **Amount Due**: This is the total amount owed by the customer/organization, including amounts from all aging periods.  In addition to viewing this information, you can send an aging report summarizing overdue amounts and their corresponding aging periods.  Use the "" icon next to an individual customer or organization to send the report. Alternatively, select multiple customers or organizations using the checkboxes and choose "**Send Aging Report**" to send the reports in bulk.  ![](https://mintcdn.com/zuperinc/55Qa433qzSjowzFB/Accounting/Invoices/12.png?fit=max\&auto=format\&n=55Qa433qzSjowzFB\&q=85\&s=70dae323a7746a74531429a519efa8bd) ## More actions Along with viewing the A/R Aging Summary, you have access to additional features that provide more detailed insights and make managing accounts receivable more convenient. Below are the available actions:  ### View specific aging period insights on the table To drill down into specific time periods, click on any of the Key Performance Indicators (KPIs) — such as **Current, 1-30 days, 31-60 days, 61-90 days, or >90 days**. The table will then display detailed insights for the selected metric, helping you analyze overdue payments within a defined time range.  ![](https://mintcdn.com/zuperinc/55Qa433qzSjowzFB/Accounting/Invoices/13.png?fit=max\&auto=format\&n=55Qa433qzSjowzFB\&q=85\&s=057e4e1aab7ec3246da003ef246350c9) ### Export You can export the data currently displayed in the table to various formats for further analysis or sharing. The available formats are **PDF, Excel (XLSX), or Print**. This functionality is useful for generating reports or sharing data with other teams for follow-up actions. To do this, click "**Export**" at the top right of the screen and choose the format you prefer to export the data. ![](https://mintcdn.com/zuperinc/55Qa433qzSjowzFB/Accounting/Invoices/14.png?fit=max\&auto=format\&n=55Qa433qzSjowzFB\&q=85\&s=44bbaec67b33e708240bfef6f2809d7d) > [!NOTE] > > **Note**: Statement templates, also known as AR aging templates, are not available as a self-serve option. An AR aging template is a formatted document that summarizes a customer's outstanding invoice balances, grouped by how long each balance has been overdue. If your business needs a statement or AR aging template, contact [Zuper Support](mailto:support@zuper.co) to request a custom build. # Creating a new invoice Source: https://docs.zuper.co/Accounting/Invoices/Create_new_invoice An invoice is a financial document that a field service business issues to its clients to request payment for services provided. It details the work completed, parts used, labor costs, and any applicable taxes or discounts. Invoices help track revenue, manage payments, and maintain clear financial records between your business and customers. ## To create an Invoice **Navigation**: *Accounting ->Invoices -> + New Invoice* 1. Select the “**Accounting**” module from the left navigation menu and choose “**Invoices**.” ![Invoice17 Pn](https://mintcdn.com/zuperinc/WWRryQiWANaj5aW3/images/invoice17.png?fit=max\&auto=format\&n=WWRryQiWANaj5aW3\&q=85\&s=bbeade9bbf660bce4440583635965f38) The Invoices page displays existing invoices and details such as invoice number, invoice date, due date, and status. 2. Select **+ New Invoice** in the top-right corner. ![Invoice18 Pn](https://mintcdn.com/zuperinc/WWRryQiWANaj5aW3/images/invoice18.png?fit=max\&auto=format\&n=WWRryQiWANaj5aW3\&q=85\&s=34aad8921ad9f389ff337135b8db347c) 3. Select "**Customer**," "**Organization**," or "**Property**" to associate with the invoice. 4. To link the invoice to a job, property, quote, or project, select **+ Add** in the associations section. Select the required module and record, then select **Proceed**. If the selected job has a linked quote, the **Set Up Invoice Line items** dialog appears. Choose how to handle the quote's line items before proceeding. For details, see [Choose how quote line items carry over](#choose-how-quote-line-items-carry-over). > [accordion] Choose how quote line items carry over > > When a job has a linked quote, the **Set Up Invoice Line items** dialog lets you choose how the quote's line items are handled. The dialog also appears when you create an invoice from the job details page by selecting **+** and then **Invoice**. **Do not associate the quote** is selected by default. > > ![SCR 20261016 Pkxb](https://mintcdn.com/zuperinc/frsvbNccj7AhULST/images/SCR-20261016-pkxb.png?fit=max\&auto=format\&n=frsvbNccj7AhULST\&q=85\&s=787311f8e8255e2accacad582d297830) > > * **Replace Job’s line items with the Quote’s line items:** Adds *only* the quote’s line items to the invoice and adds the quote to **Association(s).** > * **Merge Quote’s line items:** Combines both the job’s and the quote’s line items together on the invoice and adds the quote to **Association(s)**. > * **Only associate the quote:** Keeps *only* the job's line items on the invoice while still linking the quote to **Association(s)**. The quote's line items are not added. > * **Do not associate the quote:** Keeps *only* the job’s line items on the invoice and does *not* link the quote to **Association(s)**. > > Select an option and click **Proceed**, or select **Cancel** to close the dialog without taking any action. You can still add, edit, or remove line items afterward. > > > [!NOTE] > > > > **Note:** To remove the quote later, select the **x** on the quote in **Association(s)**. If the invoice has line items from that quote, the **Remove Line Items** dialog opens. Select **Remove** to remove the quote and its line items. 5. The billing and service contact details are automatically populated based on the selected customer or organization. ![Invoice19 Pn](https://mintcdn.com/zuperinc/WWRryQiWANaj5aW3/images/invoice19.png?fit=max\&auto=format\&n=WWRryQiWANaj5aW3\&q=85\&s=1f0cfe27a05b5031ae81b64a9633839c) 6. Fill in the mandatory fields in the **Invoice Details** section: 1. **Invoice Date** 2. **Payment Term** 3. **Due Date** 4. **Invoice Template** 7. Click "**+ Add**" in the **Parts & Services** section and select an option to add parts, products, or services to the invoice, such as *Line Item*, *Bundle*, [*Section*](https://docs.zuper.co/Accounting/Sections), *Item Group*, or *Custom Line Item*. > [!NOTE] > > **Note:** When you add a non-billable item directly to an invoice, the cost of that item will be included in the total. This ensures that non-billable items are tracked when manually added to the invoice. However, if you include a non-billable item in a transaction (such as a job or contract) and later convert that document into an invoice, the non-billable item will not appear on the invoice. This is because non-billable items are excluded from the billable total. > [accordion] Updating markup for Parts, Products, and Services > > After adding parts, products, and services, you can edit or update the Markup value and its discount by following these steps: > > * Locate the line item in the list of added parts, products, or services. > > * Click the icon next to the item you want to update. > > ![Invoice20 Pn](https://mintcdn.com/zuperinc/WWRryQiWANaj5aW3/images/invoice20.png?fit=max\&auto=format\&n=WWRryQiWANaj5aW3\&q=85\&s=518efb77bb1cc6f6cbf7987172beba2d) > > * Choose the **Edit** option. An **Edit Line Item** pop-up will open. > > * Adjust the markup type to **Flat (+)**,**Percentage (%)**, or **Multiplier (x)** based on your requirement and enter the desired value for the selected markup condition. > > ![](https://mintcdn.com/zuperinc/55Qa433qzSjowzFB/Accounting/Invoices/invoice5.png?fit=max\&auto=format\&n=55Qa433qzSjowzFB\&q=85\&s=3868e265e9230a0a066924d254ff7da2) > > * Click **Update Line Item** to apply the changes. 8. If **Track Serial Number** is enabled and **Mandate Serial No** is turned on in Settings, you must enter a serial number before proceeding. 9. After adding parts and services to the invoice, transactional discounts and global taxes will be applied. > [!NOTE] > > **Note**: > > * If a line item includes a custom tax, transactional discounts, and global taxes cannot be applied. > * Transactional-level discounts apply only when all parts and services in the quote are either fully taxable or fully non-taxable. 10. **Payment Methods:** Select the [payment methods](/Zuper-pay/Settings#configure-the-payment-methods-your-customers-can-see) you want to offer the customer for this invoice. You can turn individual payment methods on or off as needed. 11. Enter the details for any custom fields configured in the settings. 12. Click "**+ Add Attachments**" to upload any invoice-related files. 13. Click "**Save as Draft**" in the top-right corner of the page to temporarily save the invoice. In the confirmation pop-up, click "**Save as Draft**" again to confirm. ![Invoice21 Pn](https://mintcdn.com/zuperinc/WWRryQiWANaj5aW3/images/invoice21.png?fit=max\&auto=format\&n=WWRryQiWANaj5aW3\&q=85\&s=d38105af44f1935d59d09816de29d4c7) The invoice is created successfully. ## Handle zero-amount invoices A zero-amount invoice, such as one created for a warranty visit or a fully discounted job, does not automatically move to **Paid** status. On the web app, payment may need to be recorded manually even when the amount due is \$0. On the mobile app, use **Mark as Paid** to close a zero-amount invoice without recording a payment transaction. **Collect Payment** is not available for zero-amount invoices in Android v4.1.27 and the equivalent iOS version onward. # Managing your invoices Source: https://docs.zuper.co/Accounting/Invoices/Managing_invoices Efficient invoice management is essential for maintaining accurate financial records and ensuring timely payments. Zuper provides a comprehensive platform to create, track, and manage invoices seamlessly. With robust features, businesses can streamline their billing processes, monitor payment statuses, and maintain transparency in financial transactions. By centralizing invoice management, you can efficiently handle customer billing, track outstanding balances, and ensure smooth cash flow. This guide will help you understand how to access the Invoices listing page, perform key actions, and manage invoice details effectively. **Navigation**: *Accounting ->Invoices -> Invoices listing page* -> *Invoice Details* ## Accessing the Invoices listing page * Select the “**Accounting**” module from the left navigation menu and choose “**Invoices**.” You will land on the invoices listing page. * On the **Invoices Listing** page, you can view an overview of existing invoices, including **Invoice No., Invoice Date, Due Date,** and more, based on the period selected at the top right corner of the page. ![Invoice17 Pn](https://mintcdn.com/zuperinc/WWRryQiWANaj5aW3/images/invoice17.png?fit=max\&auto=format\&n=WWRryQiWANaj5aW3\&q=85\&s=bbeade9bbf660bce4440583635965f38) ### Exploring the listing page The invoices listing page is designed to help you stay organized and quickly access the information you need. **Summary Cards:** On the top of the listing page, you’ll see summary cards displaying high-level information about your invoices. Each card highlights details such as: * Total number of invoices * Sent, paid invoices, and their total value * Overdue, Partially Paid, and Bad Debt. ![IV2 Pn](https://mintcdn.com/zuperinc/7c8zIUr-S2RA6c55/images/IV2.png?fit=max\&auto=format\&n=7c8zIUr-S2RA6c55\&q=85\&s=36b069367143fa0948c6cf7c3c8c2855) Use the "**Hide or Show KPIs**" option. These cards provide a quick overview of your progress and help you identify areas that may need attention. ## Invoice Listing Views Customize the Invoices listing by adding/removing or reordering columns, then Update View to overwrite or save it as a new view. Control visibility and sharing. **Update View** * Click Update View to modify the current view after changes. **Save as a new view** * Use the dropdown beside Update View → Save as new view. **Create View dialog** * Enter the View Name (mandatory), choose Share with (User/Team) and add users, toggle Visibility to all users, and click Create. **Reset View** * Click Reset View to restore the current view to the default. **Permissions** * **Edit**: Add/remove/reorder columns; save as new or overwrite existing views. * **View-only**: Apply views but can’t edit; can Save as new view to copy without altering the original. * **Manage view**: Rename, adjust Visibility (Only Me/User/Team or global toggle), Duplicate, or Delete (creator only; reverts to default/another saved view). > [!NOTE] > > Not all columns in the invoice listing support sorting. Columns such as **Organization** can be added to your view, but do not support click-to-sort. To narrow invoices by organization, use the **Filter** option and select **Organization** as your filter criterion. You can pin this filter for quick access across sessions. For more details, see [Pinned filters](#pinned-filters). ## Pinned filters Zuper's Invoices module lets you use pinned filters to streamline your filter experience. Pinned filters keep your most-used criteria readily accessible for quick application. Pin up to 3 filters in any module. **Navigation**: *Accounting ->Invoices -> Filters -> Pinned Filters* 1. Select the “**Accounting**” module from the left navigation menu and choose “**Invoices**.” ![Pin Inv1 Pn](https://mintcdn.com/zuperinc/uWJXnqMkUObW6Xs-/images/pin-inv1.png?fit=max\&auto=format\&n=uWJXnqMkUObW6Xs-\&q=85\&s=b36647889fe9af74f81ed3cfb1ba3c66) 2. **Pin Filters for Quick Access** * Once your filters are set, click the **Pin Filters** button in the dialog box to save them as pinned. * Pinned filters appear in the dialog box's "**Pinned Filters**" section, allowing you to apply them with one click in future sessions. ![Pin Inv2 Pn](https://mintcdn.com/zuperinc/uWJXnqMkUObW6Xs-/images/pin-inv2.png?fit=max\&auto=format\&n=uWJXnqMkUObW6Xs-\&q=85\&s=fdf8a031ee2570610354df55bb1fa8ea) 3. To Unpin the filter: * To unpin, select a pinned filter and click **Remove**. * To apply pinned or default filters, open the dialog box and select them. * Use **Clear All** to remove active filters. ![Pin Inv3 Pn](https://mintcdn.com/zuperinc/uWJXnqMkUObW6Xs-/images/pin-inv3.png?fit=max\&auto=format\&n=uWJXnqMkUObW6Xs-\&q=85\&s=142be2e49d34d7dcb1ed62ddcc82a053) Not all columns in the Invoice listing support sorting. Columns such as **Organization** can be added to your view, but do not currently support click-to-sort. To group or narrow invoices by organization, use the **Filter** option and filter by Organization. You can pin this filter for quick reuse across sessions **Open invoice details** * After filtering, click an Invoice Number or Invoice Title to view and manage details. **Note** * Item/service changes within an invoice apply only to that specific invoice and will not be added to the master list. ![IV1 Pn](https://mintcdn.com/zuperinc/7c8zIUr-S2RA6c55/images/IV1.png?fit=max\&auto=format\&n=7c8zIUr-S2RA6c55\&q=85\&s=14e57422f3c0341280d0e92599730ace) ## Managing invoice details  Once an invoice is created or accessed from the listing page, the **Invoice Details Page** becomes your central hub for managing its lifecycle. The page follows a two-column layout—**the left panel** displays primary details, while **the right panel** provides contextual insights and quick actions for efficient invoice management. ![Invoice25 Pn](https://mintcdn.com/zuperinc/WWRryQiWANaj5aW3/images/invoice25.png?fit=max\&auto=format\&n=WWRryQiWANaj5aW3\&q=85\&s=6fd5c564a25d7cc7635f3a1e88d139c8) ### **Left Panel** The left panel is the primary section where details are displayed. It includes the following elements * **Customer information**: You can view the billing details of the customer, including address and contact person's details. * **Associated Records:** View the **Job and Quote** linked to the invoice. * **Invoice Status:** Check and update the invoice status as needed. * **Addresses:** Access the **Billing Address** and **Customer Address**. * **Invoice Details:** View key invoice information such as **Total Invoice Amount, Invoice No., Invoice Date,** and **Due Date**. * **View Parts Consumed:** Review the parts used for job completion, along with any applicable taxes, discounts, and payment terms. ### Right Panel The **Right Panel** provides contextual information and quick actions related to the invoices. It is divided into collapsible sections for better organization: **Organization and Contact** * **Organization**: Displays the company name and location associated with the invoice. * **Contact**: Displays the main contact person’s details, including their address, contact information, and credits & receivables. **Payment History** The **Payment History** section provides a detailed record of all payments associated with an invoice. It includes the following details: * **Payer information** — The name of the person or organization that made the payment. * **Date and time** — The exact date and time when the payment was recorded. * **Payment method** — The mode of payment used, for example, credit card, bank transfer, or cash. * **Payment status** — The current status of the payment: **Success**, **Pending**, **Failed**, or **Voided**. From the **Payment History** section, you can void a manually recorded payment using the context menu (three-dot icon) next to the payment. Voiding cancels the payment and restores the invoice balance. For full steps, see [Recording payments](https://docs.zuper.co/Accounting/Invoices/Recording_payments). > [!NOTE] > > Note: The invoice status is not updated immediately when a refund is initiated. The Partially Paid status will appear on the invoice only after the refund has been successfully transmitted to the customer's bank account in real time. ![Inv Refund](https://mintcdn.com/zuperinc/A5oxd-qvglfYBqlW/images/Inv_refund.png?fit=max\&auto=format\&n=A5oxd-qvglfYBqlW\&q=85\&s=ef7541365865ffebb631061e916af90d) * **Payment status** — The current status of the payment: * **Success** — Payment was collected and confirmed. * **Pending** — Payment is awaiting processing or confirmation. * **Failed** — Payment attempt was made but unsuccessful. * **Voided** — A manually recorded payment that has been cancelled. * **Cancelled** — A payment intent was created when the customer opened the payment link, but no payment was initiated before leaving the page. No transaction details are available from Stripe for these entries. This is expected behavior and does not indicate a billing error. > [!NOTE] > > Cancelled payment entries appear when a customer opens a quote or invoice payment link but exits without completing payment. These records are retained intentionally for transaction tracking and audit purposes and cannot be deleted. To monitor payment activity, use the **Transaction Status** filter on the Invoices Listing page to view only successful or pending transactions. **Associated Records** You can view or associate various modules with the invoice. These include Property, Project, Job, and more. To associate a module, use the “**+**” icon next to the desired module. ## More Actions Managing invoices doesn’t stop at viewing details. You can take various actions to keep things moving. Things you can do are: ![Invoice26 Pn](https://mintcdn.com/zuperinc/WWRryQiWANaj5aW3/images/invoice26.png?fit=max\&auto=format\&n=WWRryQiWANaj5aW3\&q=85\&s=e60190c3051998d6758789f06bea520f) > [accordion] New Job Creation > > To create a new job directly from the invoice to address additional service requests or follow-ups, use the "**New**" button at the top right of the details page. > > > [!NOTE] > > > > Note: If a job is already associated with the invoice, the "New" button will not be visible. Instead, you can view the associated job under the Job section. > > For step-by-step instructions on how to create a new job, see the [Creating a new job](https://docs.zuper.co/Work_Order_Management/Jobs/creating_a_new_job) article. > [accordion] Print Invoice > > Use the "**Print**" button at the top right of the page to generate a physical copy of the invoice for record-keeping or customer reference. > [accordion] Download Invoice > > To download or share the invoice as a PDF document, use the "**PDF**" button. > [accordion] Email Invoice > > To email the invoice directly to the customer, use the "**Send**" button at the top right of the details page. > > > [!NOTE] > > > > **Email attachment size limit** When sending a quote by email, attachments are included directly in the email up to a combined size of **20MB**. If the total attachment size exceeds 20MB, Zuper automatically converts attachments to inline download links in the email body rather than sending them as attachments. Recipients can still access the files by clicking the links, but the files will not appear as standard email attachments. > > > > **Workaround:** If you need attachments to be delivered as standard email attachments, ensure the total size of all attached files is under 20MB before sending. Consider compressing large files or splitting them across multiple sends if needed. > [accordion] Edit Invoice Details > > To modify invoice details if any updates are required, use the "**Edit**" button at the top right of the page. > [accordion] Record Payments > > To log received payments and update the invoice status, click the "**More Actions**" button at the top right corner of the page and select "**Record Payment**." For more details, see the [Recording Payments article](https://docs.zuper.co/Accounting/Invoices/Recording_payments). > [accordion] Mark as Bad Debt > > If an invoice remains unpaid after being sent to the customer, you can mark it as bad debt for accounting purposes. To do this, click the "**More Actions**" button at the top right corner of the page and select the "**Mark as Bad Debt**" option. > [accordion] Share Invoice/Payment Link > > To generate and share a payment or invoice link to the customer for easy online transactions, follow these steps: > > * Click the "**More Actions**" button at the top right corner of the page and select the "**Share Link"** option. > * A dialog will appear with the **Invoice Link** and **Payment Link** (available after the invoice has been sent to the customer). You can copy and share the link or send it using third-party apps. > [accordion] Archive/Cancel/Delete > > You can also archive an invoice to retain its record while moving it to archives. If the invoice is no longer valid, you can cancel it. If removal is necessary, you can permanently delete the invoice using the desired options under the "**More Actions**" button. > > > [!NOTE] > > > > A **deleted** invoice can be restored from **Settings → Data Administration → [Recovery](/Settings/Data_Adminstration/Recovery)** within 90 days. A **cancelled** invoice cannot be restored. If you want to keep the option to recover an invoice, delete it rather than cancelling it. > [accordion] # Overview Source: https://docs.zuper.co/Accounting/Invoices/Overview In Zuper, the Invoices module simplifies the billing process by enabling businesses to create, manage, and track invoices efficiently. It ensures accurate financial records, timely payments, and seamless cash flow management while maintaining transparency with customers. Invoices serve as formal requests for payment, detailing the services provided, associated costs, and applicable taxes or discounts. With Zuper, businesses can get real-time visibility into payment statuses, outstanding balances, and historical transactions, helping businesses stay organized and proactive in their financial operations. Whether it's sending invoices, recording payments, or tracking overdue amounts, Zuper’s invoicing tools empower businesses to streamline their financial workflows with ease. **Main Benefits are:** **Real-Time Invoice Tracking:** Monitor invoice statuses from creation to payment completion, ensuring better financial control and timely follow-ups. **Comprehensive Invoice Activity Logs:** Maintain a detailed history of each invoice, including updates, modifications, and payments, for complete financial transparency and easy reference. **Flexible Payment Management:** Record **partial, full, or multiple payments** for an invoice while maintaining a **clear transaction history**, ensuring accurate financial reporting. **Credits & Receivables Tracking:** Easily identify **credits and outstanding receivables** for each customer, ensuring accurate account reconciliation and financial clarity. **Automated Payment Reminders:** Set up **auto-reminders** for upcoming or overdue payments, reducing delays and improving collection rates effortlessly. **Customizable Invoice Templates:** Personalize invoices with your **company logo, branding, and payment terms** to maintain a professional and consistent appearance. **Multiple Payment Methods:** Accept payments via **credit cards, bank transfers, and digital wallets**, providing customers with convenient and flexible options. **Aging Reports for Better Insights:** Get a **detailed breakdown of outstanding invoices** by aging periods (e.g., 30, 60, 90+ days) to track overdue payments and take necessary actions. **User Roles & Permissions Control:** Define **access permissions** and approval workflows to ensure secure and efficient invoice management based on team roles and responsibilities. With **Zuper’s Invoicing Module**, businesses can **streamline billing operations, enhance financial accuracy, and improve cash flow management—boosting efficiency and customer satisfaction** # Recording payments Source: https://docs.zuper.co/Accounting/Invoices/Recording_payments Managing payments efficiently is crucial for maintaining accurate financial records. In this article, we will guide you through the process of recording payments for invoices sent to customers. In Zuper, you can manually log payments received for an invoice after it has been sent to the customer. This ensures that the invoice status is updated and helps maintain transparency in financial transactions. **Navigation**: *Accounting -> Invoices -> Invoice Listing Page -> Invoice Details -> More Actions-> Record Payment* ## **To Record a Payment** * Navigate to the **Invoice Details** page of the invoice where you want to manually log the payment received. * Click the "**More Actions"** button at the top right corner. * Select "**Record Payment"** from the dropdown menu. ![Invoice27 Pn](https://mintcdn.com/zuperinc/WWRryQiWANaj5aW3/images/invoice27.png?fit=max\&auto=format\&n=WWRryQiWANaj5aW3\&q=85\&s=73fc8119e43293ac13fa440e3ba71131) * A dialog box will appear where you need to enter the payment details. ![Invoice28 Pn](https://mintcdn.com/zuperinc/WWRryQiWANaj5aW3/images/invoice28.png?fit=max\&auto=format\&n=WWRryQiWANaj5aW3\&q=85\&s=28c1b6bb18e8df0a012e027f80f3125b) 1. **Choose Payment Mode** (*Mandatory*): Select the method used for the transaction. This includes Card, Bank Transfer, Check, Zuper Pay, Offline Cash, and Other third-party payment apps. 2. **Enter Amount Paid (In USD)** (*Mandatory*): Specify the exact amount received from the customer. 3. **Payment Reference Number**: Enter a reference number associated with the payment, such as a transaction ID or check number. 4. **Payment Date** (*Mandatory*): Choose the date of the payment using the date picker. 5. **Remarks**: Add any additional notes related to the payment, if necessary. 6. **Send Receipt / Thank You Note**: Check this box if you want to send a confirmation receipt or thank you message to the customer. 7. After entering the necessary details, click the "**Mark as Paid"** button to successfully record the payment. Once the payment is recorded, the invoice status will update accordingly, reflecting the recorded transaction and ensuring the customer’s commitment is accurately tracked. > [!NOTE] > > Note: The invoice status is not updated immediately when a refund is initiated. The Partially Paid status will appear on the invoice only after the refund has been successfully transmitted to the customer's bank account in real time. ![Inv Refund](https://mintcdn.com/zuperinc/A5oxd-qvglfYBqlW/images/Inv_refund.png?fit=max\&auto=format\&n=A5oxd-qvglfYBqlW\&q=85\&s=ef7541365865ffebb631061e916af90d) ## Voiding a payment When a payment has been recorded by mistake or entered with incorrect details, you can void it. Voiding cancels the payment record on that invoice and restores the outstanding balance. The invoice status updates automatically to reflect the change. > **Note:** Voiding applies only to payments recorded manually in Zuper — for example, cash, check, or bank transfer. For payments processed through Zuper Pay, you need to issue a refund instead. See [Issuing refunds](https://docs.zuper.co/Zuper-pay/Refunds) for steps. **Navigation:** *Accounting → Invoices → Invoice Details → Payment History* 1. Select the **Accounting** module from the left navigation menu and choose **Invoices**. 2. Select the invoice that contains the payment you want to void. 3. On the **Invoice Details** page, go to the **Payment History** section in the right panel. 4. Locate the payment you want to void. 5. Select the context menu (three-dot icon) next to the payment. 6. Select **Void**. 7. A confirmation dialog appears. Select **Confirm** to void the payment. The payment status updates to **Voided**. The invoice balance is restored to reflect the outstanding amount. ## Deleting a payment mode You can delete a payment mode from Zuper when it is no longer in use. Deleting a payment mode removes it from the list of available options across all invoices and quotes. This action cannot be undone. > **Note:** Deleting a payment mode from Settings is different from voiding a payment on an invoice. Voiding cancels a specific payment transaction. Deleting a payment mode removes the payment method itself from your Zuper configuration. **Navigation:** *Settings → Modules → Quotes & Invoices → Payment Modes & Terms* 1. Select **Settings** from the left navigation menu. 2. Under **Modules**, select **Quotes & Invoices**. 3. Select **Payment Modes & Terms**. 4. Under **Payment Mode**, locate the payment mode you want to delete. 5. Select the context menu (three-dot icon) next to the payment mode. 6. Select **Delete**. 7. A confirmation dialog appears. Select **Delete** to permanently remove the payment mode. The payment mode is removed and will no longer appear as an option when recording payments. # Collecting a Partial Payment Source: https://docs.zuper.co/Accounting/Invoices/collecting-partial-payments Learn how to request a partial payment from a customer, resend or cancel a payment link A partial payment splits the total invoice into staged instalments, letting you collect a specific amount from a customer at each stage instead of the full balance at once. This helps your business stabilize cash flow and limits out-of-pocket costs so you can start work on time. In Zuper, instead of sending a payment request for the total invoice amount, you can request a specific amount from your customer and send them a secure payment link. ## Before you begin * Your organization must have **Zuper Pay** enabled. Please contact Zuper Support for details. * The **Request Payment** button only appears on invoices in **Sent** status. It is not available on draft or unsent invoices. ## Request a partial payment 1. Select the **Accounting** module from the left navigation menu and choose **Invoices**. 2. Open the invoice from the Invoices listing page. 3. Click **Request Payment**. Click **Request Payment**. ![Partialpayment 03](https://mintcdn.com/zuperinc/kSzEIStfqsRcEj_X/images/partialpayment-03.png?fit=max\&auto=format\&n=kSzEIStfqsRcEj_X\&q=85\&s=cdaaaa2b6803165560916d23c8b86d9c) \ The **Request Payment** dialog opens. Review the following fields: 4. **From** - Displays your sender email. 5. **To** - Enter the customer's email address. This field is required. 6. **Cc / Bcc** - Optionally add additional recipients. 7. **Total Amount Due** - Shows the full outstanding balance on the invoice. This is read-only. 8. In the **Amount Requested** field, enter the partial amount you want to collect. The **Remaining Due** value updates automatically to show what will still be owed after this payment. 9. In the **Note (Optional)** field, enter a short message to your customer explaining what this payment is for. 10. Click **Send**. \ Zuper sends the customer a secure payment link for the requested amount. ![Partialpayment 02](https://mintcdn.com/zuperinc/kSzEIStfqsRcEj_X/images/partialpayment-02.png?fit=max\&auto=format\&n=kSzEIStfqsRcEj_X\&q=85\&s=af47c974d21bcd39c6f7f93066378b41) ## Resend or cancel a payment request After you send a payment request, you can manage it directly from the invoice. 1. Click the context menu (three-dot icon) next to the **Requested Amount**. 2. Choose one of the following actions: * **Resend Payment Link** - Sends the same payment link to the customer again. Use this if the customer did not receive the original email. * **Cancel Payment Request** - Cancels the active payment link immediately. The customer can no longer use the link to pay. The Requested Amount row is removed from the invoice. ![Partialpayment 01](https://mintcdn.com/zuperinc/kSzEIStfqsRcEj_X/images/partialpayment-01.png?fit=max\&auto=format\&n=kSzEIStfqsRcEj_X\&q=85\&s=fbca4719a3d4d116f79eefddea6b953a) ## Frequently asked questions > [accordion] What happens if I cancel a payment request? > > The link is deactivated immediately. Your customer can no longer use it to pay. The Requested Amount row is removed from the invoice. You can send a new payment request at any time. > [accordion] Can I have more than one active payment link on an invoice at the same time? > > No. Only one payment link can be active on an invoice at a time. Cancel the existing link before sending a new one. > [accordion] What happens if the customer pays through the original invoice instead of the partial payment link? > > If the customer clicks **Pay Now** on the original invoice and completes the payment, the full outstanding invoice amount is charged. Any active partial payment links are automatically cancelled once the payment is successfully processed. > [accordion] What happens if I send a new payment request after cancelling the previous one? > > A new payment request can be sent for any amount at any time, as long as the invoice is in **Sent** status and no other active payment link exists. > [accordion] Can I make a partial payment for a quote deposit? > > No. Partial payments are not supported for quote deposits. The deposit amount must be paid in full. # Edit Paid & Partially Paid Invoices Source: https://docs.zuper.co/Accounting/Invoices/edit-paid-and-partially-paid-invoices ## Overview Once you record a payment against an invoice, Zuper locks it to protect your financial records. That protection creates one specific situation to plan for. For example, if a technician collects 80 instead of 80.50 due, the invoice remains in **Partially Paid** status. You then need to resolve that small mismatch. Until now, resolving it meant refunding the payment, canceling the invoice, and recreating it from scratch adding extra steps to your accounting records every time. The edit flow closes that gap. Admins can now edit a paid or partially paid invoice directly, without a refund or cancellation standing in the way. Think of it like adjusting a receipt after checkout: the payment already collected stays exactly where it is, while Zuper calculates what the customer still owes or what they overpaid once you save your changes. That recalculation works the same way across all invoice types, including standalone invoices and those generated from jobs, quotes, contracts, and projects. **Navigation:** *Accounting → Invoices → Invoice Details → Edit invoice* *** ## Before you begin This capability is admin-gated. The following conditions must be met before you can use it. * **Setting:** The **Enable Edit Invoices** setting must be turned on at the organization level (**Allow editing paid and partially paid invoices)**. Only then does the edit flow become available to anyone, regardless of role. * **Role:** You need the **Admin** role, or a custom role with the **Edit Paid Invoices** permission enabled. This permission controls the **Edit invoice** button on the **Invoice Details** page and on the **Invoices** listing page. To enable this permission, go to **Settings**, select **Users & Teams**, select the custom role, then enable **Edit Paid Invoices** under **Payments**. * **Invoice status:** The invoice must already be in **Paid** or **Partially Paid** status. *** ## Edit a paid or partially paid invoice With the right permissions in place, here is how to reopen a locked invoice for editing. 1. Select the **Accounting** module from the left navigation menu, then select **Invoices**. 2. Select the invoice you want to edit. ![Edip0 1](https://mintcdn.com/zuperinc/6t_4dG4WSCod3ivI/images/edip0-1.png?fit=max\&auto=format\&n=6t_4dG4WSCod3ivI\&q=85\&s=d8621fbe8005d26c52a369756057fba8) 3. The **Invoice Details** page opens. Select **Edit invoice**. The invoice enters edit mode. > [!NOTE] > > Zuper does not save any changes until you select **Save**. *** ## Make your changes Once you are in edit mode, the invoice behaves much like a draft again. 1. Add, remove, or update line items as needed. 2. Update tax and discount fields if the revised amount requires it. 3. Review the running total at the top of the page as you go. It updates with every change, so you always know where the invoice stands before you commit. 4. Select **Save & Send** to apply your changes. > [!NOTE] > > Payments already recorded on the invoice stay read-only during edit mode. The edit flow is meant to correct the invoice, not the payment. To change a recorded payment amount, void or refund the payment instead. See [Recording Payments](https://docs.zuper.co/Accounting/Invoices/Recording_payments#recording-payments) or [Issuing Refunds](https://docs.zuper.co/Zuper-pay/Refunds#issuing-refunds). > [!NOTE] > > Edit mode does not offer a **Save as Draft** option, and you cannot set the invoice status to **Sent** while editing. Because the invoice already has a payment recorded against it, Zuper keeps it out of the draft and unsent states. *** ## What happens after you save Zuper compares the revised invoice total to the amount already paid, then walks you through one of three outcomes based on how the two numbers compare. **New total matches the amount paid** Zuper suggests marking the invoice as **Paid**. Select **Confirm** to apply this status. **New total is higher than the amount paid** The customer now owes more than they already paid. A previously **Partially Paid** invoice stays in that status, with Zuper updating the outstanding balance automatically. A previously **Paid** invoice moves to **Partially Paid**, since the payment on file no longer covers the full amount. Select **Request Payment** to collect the new **Balance Due** from the customer. ![Edip1](https://mintcdn.com/zuperinc/6t_4dG4WSCod3ivI/images/edip1.png?fit=max\&auto=format\&n=6t_4dG4WSCod3ivI\&q=85\&s=eff374dfaa06bb67f22cb0391f2ad34b) ![Edip2](https://mintcdn.com/zuperinc/6t_4dG4WSCod3ivI/images/edip2.png?fit=max\&auto=format\&n=6t_4dG4WSCod3ivI\&q=85\&s=8d0c7452f428b5eb4e6284fde10df42c) ![Edip3](https://mintcdn.com/zuperinc/6t_4dG4WSCod3ivI/images/edip3.png?fit=max\&auto=format\&n=6t_4dG4WSCod3ivI\&q=85\&s=87d1bc40d2a722255ddffdf20eadabca) **New total is lower than the amount paid** The customer has effectively overpaid. Zuper issues a credit note for the extra amount. The credit note stays attached to the customer's profile and can be reused. The same amount also appears in the **Credits** section of the customer's profile, where you can apply it to another open invoice or issue a refund. ![Edip4](https://mintcdn.com/zuperinc/6t_4dG4WSCod3ivI/images/edip4.png?fit=max\&auto=format\&n=6t_4dG4WSCod3ivI\&q=85\&s=6e44af9f0deb07b4ac00964ecca768f1) > [!NOTE] > > Zuper never changes invoice status on its own. Whatever the outcome, you confirm the change before it takes effect. Saving your changes also updates the invoice amount in QuickBooks Online (QBO), if your organization uses the two-way sync. Your accounting records stay aligned with what you just edited. *** ## Credits on the customer account When a revised invoice total is lower than what the customer already paid, Zuper gives that overpayment a home in two places. On the invoice, you see the credit note that was issued. On the customer's profile, the same amount appears in the **Credits** section, ready for you to apply or refund. Zuper holds this amount as a credit against the customer — not as revenue — until you decide where it should go. *** ## Related articles * [Recording Payments](https://docs.zuper.co/Accounting/Invoices/Recording_payments#recording-payments) * [Issuing Refunds](https://docs.zuper.co/Zuper-pay/Refunds#issuing-refunds) # Managing your proposals and quotes Source: https://docs.zuper.co/Accounting/Managing_Quotes Efficiently managing quotes and proposals is crucial for seamless customer engagement and effective project planning. Zuper provides a unified platform to create, customize, and track quotes and proposals effortlessly. These tools help businesses outline their service offerings, streamline the approval process, and transform opportunities into actionable tasks. With a centralized approach, you can efficiently handle your quotes and proposals while maintaining visibility over their status and progress. This guide will help you understand how to access the Proposals and Quotes listing page, perform key actions, and manage proposal details effectively. ## Accessing the Quotes/Proposal listing page **Navigation**: *Accounting -> Quotes --> Quotes listing page* 1. Select the “**Accounting**” module from the left navigation menu and choose “**Quotes**.” ![Qt1](https://mintcdn.com/zuperinc/G1zx-bzUT-zwewE8/images/Qt1.png?fit=max\&auto=format\&n=G1zx-bzUT-zwewE8\&q=85\&s=06193ebc2b17210ed613326dfc6aa800) 2. You will land on the **Listing** page. The listing page provides a comprehensive view of all your quotes and proposals, including essential details such as their creation date, customer information, and status. ![Qt2](https://mintcdn.com/zuperinc/G1zx-bzUT-zwewE8/images/Qt2.png?fit=max\&auto=format\&n=G1zx-bzUT-zwewE8\&q=85\&s=5fa734bfacad3b365084b985fb7094aa) ## Exploring Listing Page The quotes and proposals listing page is designed to help you stay organized and quickly access the information you need. It includes the following elements. **Summary Cards:** On the top of the listing page, you’ll see summary cards displaying high-level information about your proposals and quotes. Each card highlights details such as: * Total number of quotes * Drafts, sent quotes, and their total value * Approved, declined, and canceled proposals. These cards provide a quick overview of your progress and help you identify areas that may need attention. ![QV2 Pn](https://mintcdn.com/zuperinc/Bzn1x2gjyxnd_FWi/images/QV2.png?fit=max\&auto=format\&n=Bzn1x2gjyxnd_FWi\&q=85\&s=911968dd52424e25de7e0b121dce311f) ## Listing Views Customize the Quotes listing by adding/removing or reordering columns, then Update View to overwrite or save it as a new view. * **Update View**: Click Update View to modify the current view after changes. * **Save as new view**: Use the dropdown beside Update View → Save as new view. * **Create View dialog**: Enter the View Name (mandatory); choose Share with (User/Team) and add users; toggle Visibility to all users; click Create. * **Reset View**: Click Reset View to restore the current view to the default. * **Permissions**: * **Edit**: Add/remove/reorder columns; save as new or overwrite existing views. * **View-only**: Apply views but can’t edit; can Save as new view to copy without altering the original. * **Manage view**: Rename, adjust Visibility (Only Me/User/Team or global toggle), Duplicate, or Delete (creator only; reverts to default/another saved view). * **Open quote details**: After filtering, click a Quote Number or Quote Title to view and manage details. Note: Item/service changes within a quote apply only to that specific quote and will not be added to the master list. ![QV1 Pn](https://mintcdn.com/zuperinc/Bzn1x2gjyxnd_FWi/images/QV1.png?fit=max\&auto=format\&n=Bzn1x2gjyxnd_FWi\&q=85\&s=ca3e0db5b3f8ac125a55f6e89541d39b) ## Pinned filters Zuper's Quotes module lets you use pinned filters to streamline your filter experience. Pinned filters keep your most-used criteria readily accessible for quick application. Pin up to 3 filters in any module. **Navigation**: *Accounting -> Quotes --> Filters --> Pinned Filters* 1. Select the “**Quotes**” module from the left navigation menu. ![Pin Pq1 Pn](https://mintcdn.com/zuperinc/uWJXnqMkUObW6Xs-/images/pin-pq1.png?fit=max\&auto=format\&n=uWJXnqMkUObW6Xs-\&q=85\&s=2339e3caae3fca0829c42d3f417eefcc) 2. **Pin Filters for Quick Access** * Once your filters are set, click the **Pin Filters** button in the dialog box to save them as pinned. * Pinned filters appear in the dialog box's "**Pinned Filters**" section, allowing you to apply them with one click in future sessions. ![Pin Pq2 Pn](https://mintcdn.com/zuperinc/uWJXnqMkUObW6Xs-/images/pin-pq2.png?fit=max\&auto=format\&n=uWJXnqMkUObW6Xs-\&q=85\&s=dd29bb905b297fd6aacc9b9ee65ee0c8) 3. To Unpin the filter: * To unpin, select a pinned filter and click **Remove**. * To apply pinned or default filters, open the dialog box and select them. * Use **Clear All** to remove active filters. ![Pin Pq3 Pn](https://mintcdn.com/zuperinc/uWJXnqMkUObW6Xs-/images/pin-pq3.png?fit=max\&auto=format\&n=uWJXnqMkUObW6Xs-\&q=85\&s=eb18ccedd8a7cd4826c1078fb9717cb0) **Creating a new proposal or quote:** You can use the "**+ New"** button on the **Listing** page to create either a proposal or a quote. Select Proposal or Quote. From there, you can enter all the details you need, like customer or organization information, parts, services, and more. Once everything is filled in, you’re all set to save and share the proposal/quote with your client for their approval. If you need a more detailed guide on creating a quote, see Create a new proposal and a new Quote for a step-by-step walkthrough. ## Managing Proposal details Once a proposal is created, the Proposal Details page becomes your go-to space for managing its lifecycle. The page is laid out in two columns, with the left side highlighting primary details and the right side offering contextual insights and quick actions. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-26.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=3bd084f82fba852d91a3cbce59bdb881) ### Left Panel The left panel is the primary section where details are displayed. It includes the following elements. * **Status update:** You can view the current status of the proposal (e.g., Draft, Sent, Accepted) and manually update it as needed. * **Customer information**: You can review the billing details of the customer, including their address and the contact person’s information. * **Proposal Options**: You can view the options available to the customer, allowing them to choose between different configurations. * **Templates and Notes**: You can see the template used to create the proposal and review any additional notes. ### Right panel The **Right Panel** provides you with contextual information and quick actions, organized into collapsible sections for easy navigation: * **Quote Status:** You can track the proposal’s status changes through timestamps and see who performed each action. * **Organization and Contact:** You can view the company information associated with the proposal. * **Associated Records:** You can view or associate various modules (e.g., Property, Project, and so on) with the proposal. Use the **“**+**”** icon to add a module. You can quickly navigate to or manage associated records like organizations, properties, or projects using the provided links or icons. ### More actions Managing proposals doesn’t stop at viewing details—you can take various actions to keep things moving. Things you can do are: ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-16.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=219ade616a38e46f83f98a049fc2f28d) > [accordion] Quick actions > > * **Send:** You can share the proposal to the respective customer for your acceptance. > * **Edit Proposal**: You can modify the proposal, including package details or other information, by clicking **Edit**. > * **Save as Draft**: You can save changes to the proposal without sending it immediately by clicking **Save as Draft**. > * **Mark as Accepted**: Once the customer agrees to the proposal, click **Mark as Accepted** to finalize the proposal. This marks the proposal as accepted and ready for the next steps. After marking the proposal as accepted, the proposal is automatically converted into a **Quote**, which means the proposal has been confirmed and the process is moving forward. > * **Mark as declined**: You can record the customer’s decision to decline the proposal by clicking **Mark as Declined**. > * **Archive/Delete**: You can archive or delete the proposal. ## Managing Quote details: The **Quote Details Page** provides a comprehensive view of all information related to a specific quote, including customer details, product specifications, and associated records. The page uses a two-column layout: the **Left Panel** and the **Right Panel**, designed for easy navigation and quick actions. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-14.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=513c4b284a3caa5b9ea3bd2f63b108f0) ### Left panel The **Left panel** serves as the primary area for viewing the detailed breakdown of the quote. It includes the following sections: * **Status Update**: You can see the current status of the quote (e.g., Draft, Sent, Accepted) and manually update it. * **Customer/Organisation Details:** You can view the **Billing Address** for the customer and contact details of the customer or organization. * **Product table:** You can review a detailed breakdown of all items included in the quote, along with their prices. ### Right panel The **Right Panel** displays contextual information and quick actions related to the quote. It includes the following sections: * **Quote Status:** You can view a timeline of the quote’s lifecycle, including timestamps and the user who performed each action. * **Organization Details:** You can see the company associated with the quote, along with the number of contacts and their location. * **Associated Records:** You can view or associate various modules (e.g., Property, Project, etc.) with the quote. Use the **“+”** icon to add a module. You can quickly navigate to or manage associated records using the provided links or icons. ### More Actions You can perform the following actions to manage quotes effectively: ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-15.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=dea8a3299efa1a458695816979eaf55f) > [accordion] Quick actions > > * **New**: You can create Job, Contract, and Project via Quote. > * **Print**: You can generate a physical copy of the quote for record-keeping or customer reference. > * **Send**: You can send to customers for their review and acceptance before the job begins. > * **Share Link**: You can generate and share a link to the quote. > * **Clone**: You can duplicate the quote to create similar records. > * **Archive**: You can archive the quote for record-keeping purposes. > * **Cancel/Delete**: You can cancel or delete the quote as necessary. ### Pending option selection If a line item in your proposal has options configured, but the option value is empty for any line item, Zuper marks the converted quote as **Pending option selection**. You can update or fill in the option value for each line item directly from the quote details page. While a quote is in **Pending option selection** state: * It cannot be converted to an invoice. * Creation of a material request and purchase order is restricted. ![Option New2](https://mintcdn.com/zuperinc/rQnrZwxw5mP6JfJG/images/Option_new2.png?fit=max\&auto=format\&n=rQnrZwxw5mP6JfJG\&q=85\&s=1806739ed6cad0a14d0e6ef7833580a5) > [!NOTE] > > If a customer opens a payment link on a quote but exits without completing payment, two separate records are created: a **"quote viewed"** entry in the Activity log and a Canceled entry in the Payments report. This is expected behavior. The Cancelled payment entry does not indicate an error — it reflects that a Stripe payment intent was created when the payment page loaded, but no transaction was completed. > [!NOTE] > > **Editing accepted quotes:** An accepted quote remains editable only until it is converted into an invoice. Once a quote has been converted, editing is disabled, and the Edit option no longer appears on the Quote Details page. This is expected behavior; it preserves the integrity of the quote record from which the invoice was generated. If you need to make changes after conversion, update the invoice directly or clone the quote to create a new editable copy. # Monitor pending quotes and set up sales alerts When quotes are sent to customers but remain unanswered, your sales team needs a way to catch them before they go cold. Zuper doesn't have a single built-in "pending quote alert" button, but you can set up monitoring using a combination of approaches depending on how much automation you need. > [accordion] Option 1 — Quotes listing pinned filter (manual, instant) > > The quickest approach. Filter the Quotes listing to show only sent quotes created before a specific date, then pin the filter for daily use. > > **1. Open the Quotes listing** > > Go to **Accounting → Quotes**. > > **2. Apply filters** > > Click **Filters** and set: > > * **Status** = Sent > * **Created Date** = more than 3 days ago (or your preferred threshold) > > **3. Pin the filter** > > Click **Pin Filters** to save it. It will appear in one click on every future session. > > > [!NOTE] > > > > You can also add a **Created Date** column to your listing view so quote age is visible at a glance without opening each record. > [accordion] Option 2 — Scheduled Report (automated daily email) > > Set up a Quote report that runs automatically and emails the Sales team each morning with a list of quotes that have been in Sent status for more than 3 days. > > **1. Open Report Builder** > > Go to **Reports** from the left navigation menu and click **+ New Report**. > > **2. Select the Quotes module** > > Choose **Quotes** as the primary module. > > **3. Add fields** > > Include: Quote Number, Customer Name, Quote Amount, Created Date, Expiry Date, Assigned To, and Quote Status. > > **4. Apply filters** > > Filter by: > > * **Status** = Sent > * **Created Date** = older than 3 days (relative date filter) > > **5. Schedule the report** > > Click **Schedule**, set frequency to **Daily**, choose your preferred send time, and add the Sales team members as recipients. > > > [!NOTE] > > > > The Report Builder is available under **Reports** in the left navigation. Legacy reports (pre-built) are available under **Legacy Reports** in the same section. > [accordion] Option 3 — Workflow Builder (automated internal notification) > > For teams that want a proactive push notification rather than a report email, the Workflow Builder can send an internal alert to Sales each day listing quotes that have gone unanswered. > > The general setup: > > 1. **Trigger:** Scheduled Trigger — daily at your preferred time (e.g., 9 AM) > 2. **Get Records node:** Fetch Quotes where Status = Sent and Created Date is older than 3 days > 3. **Condition node:** Check if the result list is non-empty > 4. **Notification node:** Send an Internal Notification or email to the Sales team with the list of pending quotes > > Refer to the [Workflow Builder Overview](/Workflow_builder/Workflow_overview), [Triggers](/Workflow_builder/Triggers), and [Nodes](/Workflow_builder/workflow_builder_nodes) articles for full configuration steps. > [accordion] Option 4 — Dashboard expiry KPI (passive monitoring) > > The Zuper Dashboard includes a built-in KPI under the Quotes module that surfaces **quotes approaching their expiry date**. If your quotes are configured with expiry dates, this gives the Sales team a daily visual signal without any setup. > > Navigate to your **Dashboard** and look for the Quotes section — the expiring quotes card will highlight records that need attention. # Overview Source: https://docs.zuper.co/Accounting/Overview In Zuper, Quotes and Proposals play a vital role in simplifying the process of presenting cost estimates and service options to customers. Together, they offer a seamless experience for creating, managing, and tracking estimates while maintaining transparency and professionalism. Whether it's drafting a proposal to explore multiple service options or finalizing a quote to confirm costs, these ensure an efficient workflow and smooth transitions across various stages of customer interaction. With Proposals, you can present customized service plans or multiple pricing options, making them ideal for scenarios that require flexibility or negotiation. Quotes, on the other hand, allow you to provide customers with detailed cost breakdowns for labor, parts, and services, helping them understand the pricing structure clearly. **Main benefits are:** * **Clear Cost Presentation**: Whether through a Quote or Proposal, provide detailed and transparent pricing to set the right expectations for your customers. * **Personalization**: Add your branding, item descriptions, and custom templates for a consistent, professional presentation. * **Seamless Workflow Integration**: Convert approved Quotes or Proposals into jobs, contracts, or projects effortlessly, eliminating the need for manual data entry. * **Collaboration and Updates**: Attach files, add comments, and share updates to ensure all stakeholders remain informed throughout the process. * **Status Visibility**: Instantly view the current status of Quotes and Proposals, helping you prioritize follow-ups and approvals. For example, if a customer needs an itemized breakdown of services for comparison, you can start with a Proposal offering multiple pricing tiers or service options. Once the customer selects their preferred option, you can convert the approved Proposal into a finalized Quote with clear costs, ready for approval and conversion into a job or project. Whether you're managing high-value negotiations or handling everyday cost estimates, Zuper ensures that Quotes and Proposals work together to provide a comprehensive and efficient solution for your business needs. To learn the difference between proposals and quotes, click [here](Accounting/Overview). # Payments Overview Source: https://docs.zuper.co/Accounting/Payments The Payments module in Zuper helps you track & manage payments you received across invoices & quote deposits through the platform **Navigation**: *Accounting* -> *Payments* 1. Click the “**Accounting**” module from the left navigation menu and select "**Payments.**" ![/Accounting/images/PA1.png+\_existingInIndexedDbMintlify](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/PA1.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=52d2668162c1ad6459624ad53b530c6a) 2. Under the"**Payments**" module, let us explore the "**Dashboard**." ![/Accounting/images/PA2.png+\_existingInIndexedDbMintlify](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/PA2.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=85ac2558b43dbcfbb162e8da25f155da) 3. Use the "**Calendar Picker**" to select a date range. The latest transactions are displayed based on that date range. ![/Accounting/images/PA3.png+\_existingInIndexedDbMintlify](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/PA3.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=3d92319a3bfa4c592f4064101df9cb64) 4. Use the icon to view the transaction details. ![/Accounting/images/PA4.png+\_existingInIndexedDbMintlify](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/PA4.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=468934b53ca51ca2a52dc1687170cb70) 5. The transaction details are displayed. ![/Accounting/images/PA5.png+\_existingInIndexedDbMintlify](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/PA5.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=6e1b8d65c6a1b3212db72b116789a1a8) 6. Click the "**Void Transaction**" button. ![/Accounting/images/PA6.png+\_existingInIndexedDbMintlify](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/PA6.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=9e8c267705c18800a8b27bb566925ce8) 7. Click the "**Void**" button to void the transaction. ![/Accounting/images/PA7.png+\_existingInIndexedDbMintlify](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/PA7.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=53a9f5e6154a555b18638bb2b8907427) 8. The payment is canceled successfully. ![/Accounting/images/PA8.png+\_existingInIndexedDbMintlify](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/PA8.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=7f392c76da333d4141e81fbef266f996) * Switch to the "**Payment**s" tab. Then, use the "**Filters and Calendar Picker**" to view the details according to your selected criteria. * Click the "**Export**" button to download Excel. * Use the icon to view the transaction details. ![/Accounting/images/PA9.png+\_existingInIndexedDbMintlify](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/PA9.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=1b5a1b81c6555ad37ad54ee0124c063f) > [!NOTE] > > Note: The invoice status is not updated immediately when a refund is initiated. The Partially Paid status will appear on the invoice only after the refund has been successfully transmitted to the customer's bank account in real time. ![Inv Refund](https://mintcdn.com/zuperinc/A5oxd-qvglfYBqlW/images/Inv_refund.png?fit=max\&auto=format\&n=A5oxd-qvglfYBqlW\&q=85\&s=ef7541365865ffebb631061e916af90d) The Payments module in Zuper provides a seamless way to track and manage payments received across invoices and quote deposits, ensuring better financial transparency and control. By centralizing payment processing within the platform, businesses can streamline transactions, reduce manual efforts, and improve cash flow management. If you are looking for a comprehensive Account Receivables (AR) management, please check out our [AR Management Guide](https://docs.zuper.co/Accounting/Invoices/AR_management) # Profit Margin Slider Source: https://docs.zuper.co/Accounting/Profit_Margin Zuper offers a **Profit Margin Slider** that allows you to adjust the profit margin dynamically across *Quotes*, *Proposals*, and *Service* *Packages*. This feature removes the need for manual recalculations by enabling immediate adjustments to meet specific profit targets. ![Margin 1](https://mintcdn.com/zuperinc/LticKvc904jE5UcS/images/margin-1.png?fit=max\&auto=format\&n=LticKvc904jE5UcS\&q=85\&s=86cdaa0b6335d3ec103478a1578705eb) **Prerequisites:** To access and use the **Profit Margin Slider**, the following conditions must be met: * **Job Profitability** must be enabled for your account. To enable it, contact your account administrator or email [**support@zuper.co**](mailto:support@zuper.co). * By default, *Admins* and *Team Leads* can view and manage the Profit Margin slider. However, if your business requires different visibility, you can configure access for specific roles.\ To do this, navigate to: **Settings** module > **Users & Teams** > **Quotes** > enable the **Manage Profit Slider** toggle. ![Margin 1](https://mintcdn.com/zuperinc/LticKvc904jE5UcS/images/margin-2.png?fit=max\&auto=format\&n=LticKvc904jE5UcS\&q=85\&s=35f8b6085fd123cd78c252b960cc7be3) * Add at least one **billable line item** (part, product, service, or bundle) to a Quote, Proposal, or Service Package to make the slider visible. * Define the allowable range for profit margin adjustments under:\ **Settings** module > **Quotes & Invoices** > **Quote and Invoice General Settings** > **Quote** tab > **Define Minimum and Maximum Profit Margin**. ![Margin 1](https://mintcdn.com/zuperinc/LticKvc904jE5UcS/images/margin-3.png?fit=max\&auto=format\&n=LticKvc904jE5UcS\&q=85\&s=7792f710c2cb7c4cd1a6a9130bf62ca8) ### To use the Profit Margin Slider 1. Open a **Quote**, **Proposal**, or **Service Package** via one of the following paths: * Accounting module > Quotes * Accounting module > Proposals * Settings module > Quotes & Invoices > Service Packages 2. Click **“+ Add”** to include *parts*, *products*, *services*, or *bundles* from the **Parts** & **Services** section. Once at least one **billable item** is added, the **Profit Margin Slider** automatically appears. > [!NOTE] > > **Note**: Items with a **Cost Price of \$0** and **negative line items** are also included in the profit margin calculation. ![Margin 1](https://mintcdn.com/zuperinc/e3lGmJ6isV61N8aQ/images/margin-4.png?fit=max\&auto=format\&n=e3lGmJ6isV61N8aQ\&q=85\&s=897fad3a5b4981a4bf26f5bcec2338f5) 3. The slider displays the current overall profit margin percentage, calculated using the formula: ```markdown wrap theme={null} Profit Margin% = (Total Sell Price-Total Cost Price/Total Sell Price)\* 100 ``` > [!TIP] > > **Important**: **Fees** are excluded from the actual profit calculation and do not influence the slider’s behavior. 4. Drag the slider to your desired profit margin within the preconfigured minimum and maximum range. > [!NOTE] > > **Note:** If you adjust the slider below the minimum or above the maximum predefined values, it turns red to indicate that the selected profit margin is outside the allowed range. 5. As you adjust the slider, Zuper instantly recalculates and updates: * **Markup %** for each line item * **Total Sell Price** across the document ![Margin 1](https://mintcdn.com/zuperinc/e3lGmJ6isV61N8aQ/images/margin-5.png?fit=max\&auto=format\&n=e3lGmJ6isV61N8aQ\&q=85\&s=6975fdf6930cf26a56391025d42b3efc) Zuper applies a change factor to proportionally adjust item prices, ensuring consistent and balanced profit distribution across all line items. **View Cost and Profit Breakdown** Let’s expand the **Cost & Profit Breakdown** panel beneath the slider to view a comprehensive summary, which includes: * **Parts & Services cost** * **Labor cost** * **COGS** (combined cost of parts and labor) * **Quote Total** * **Profit Amount** = Sell Price – Cost Price ![Margin 1](https://mintcdn.com/zuperinc/e3lGmJ6isV61N8aQ/images/margin-6.png?fit=max\&auto=format\&n=e3lGmJ6isV61N8aQ\&q=85\&s=6025f8e2b7690df94668e3a0884d04d7) ## **Frequently Asked Questions** > [accordion] How do I give a field technician access to the Profit Margin Slider? > > By default, only Admins and Team Leads can view and manage the Profit Margin Slider. To let a field user use it, assign them a custom role with the following permissions enabled: > > **Quotes module** > > * **Create Quote / Update Quote** > * **Update Line Item Price** > * **Manage Profit Slider** > > **Product module** > > * **Show Selling Price in Transactions** > * **Edit Selling Price** > > ![Margin 1](https://mintcdn.com/zuperinc/LticKvc904jE5UcS/images/margin-2.png?fit=max\&auto=format\&n=LticKvc904jE5UcS\&q=85\&s=35f8b6085fd123cd78c252b960cc7be3) > [accordion] Can I use the Profit Margin Slider if some items have zero cost?  > > Yes. Items with a Cost Price of \$0 and even negative line items are included in the profit margin calculation. The slider will still function and adjust pricing accordingly. > [accordion] Are fees included in the profit margin calculation?  > > No. Fees are excluded from the profit calculation and do not influence the slider's behavior. Only billable parts, products, services, and bundles are included in the calculation. > [accordion] What happens if I adjust the profit margin beyond the allowed range?  > > If you drag the slider below the minimum or above the maximum predefined values, the slider turns red to indicate that the selected profit margin is outside the allowed range. You'll need to adjust it back within the configured limits to proceed. ![Margin 1](https://mintcdn.com/zuperinc/e3lGmJ6isV61N8aQ/images/margin-8.png?fit=max\&auto=format\&n=e3lGmJ6isV61N8aQ\&q=85\&s=ca2924c6aa81c680ab8cb63a1f4abc69) > [accordion] Can I view Cost & Profit breakdowns on the Quote Details page?  > > Yes, you can view cost & profit metrics directly on the Quote details page without opening the quote for editing. The **Cost & Profit breakdowns** display:  > > * **Profit Margin %** – The overall profit margin percentage for the quote  > * **COGS** – The combined cost of goods sold. You can hover over this field to see a detailed breakdown of **Product/Parts** and **Service/Labor** costs. > * **Quote Total** – The total quoted amount based on all item costs and configured profit margin.  > * **Profit** – The calculated profit amount (Sell Price – Cost Price) > > ![Margin 1](https://mintcdn.com/zuperinc/e3lGmJ6isV61N8aQ/images/margin-7.png?fit=max\&auto=format\&n=e3lGmJ6isV61N8aQ\&q=85\&s=955c5eb3fc8328b6b7e2d741770a1004) # Create a new proposal Source: https://docs.zuper.co/Accounting/Proposal In Zuper, a **Proposal** is a preliminary document that businesses can send to potential clients before providing an official quote or estimate. It helps define the project scope, outline service offerings, and align expectations before finalizing pricing. Zuper streamlines this process by enabling you to: * Create structured **Service Packages** that bundle products and services. * Use **Proposal Templates** to standardize and simplify proposal creation. * Create, modify, and manage **Proposals** before converting them into quotes. This guide provides step-by-step instructions on configuring service packages, creating proposal templates, and generating proposals within the Zuper app. Let's get started! **Navigation**: *Accounting* -> *Payments* ## **Add-ons:** Zuper **Add-ons** allows you to offer optional products or services within a proposal. Customers can choose these add-ons during proposal acceptance. This helps you upsell services and increase quote value without modifying the base scope of work. Add-ons are configured at the **Proposal Template** level and appear directly in proposals once enabled. Configuring Add-ons: [**Service Package**](https://docs.zuper.co/Accounting/Proposal#add-ons-in-the-service-package) [**Standard Template**](https://docs.zuper.co/Accounting/Proposal#add-ons-in-the-proposal-template) [**CPQ Template**](https://docs.zuper.co/Zuper_for_Roofing/Proposal_Template_with_CPQ#add-ons) [Presenting Proposal to the Customer](https://docs.zuper.co/Settings/Modules/Quotes-Invoices/Proposal_Layout_builder#add-ons) > [!NOTE] > > Note: The Add-ons are applicable only to those using [Proposal Layouts](https://docs.zuper.co/Settings/Modules/Quotes-Invoices/Proposal_Layout_builder). ## **Multi-Signer** Once a proposal is created using a proposal layout, any [preconfigured co-signers and company authorization](https://docs.zuper.co/Settings/Modules/Quotes-Invoices/Proposal_Layout_builder#multi-signer-co-signer-%26-counter-signer) are automatically prefilled. The customer associated with the proposal is set as the primary signer by default. You can add or remove additional signers as needed; however, the primary signer cannot be removed. Signatures are collected sequentially. After the primary signer selects their preference and signs, the proposal moves to **Awaiting Signature** status and becomes non-editable until all required signers have completed signing. If the proposal includes only the primary signer, it will automatically be converted into an **Accepted Quote** as soon as the primary signer signs. The Signers & Authorization section controls who must review and electronically sign a proposal. *  Primary Signer (Pre-filled and non-editable). * Co-Signers (Additional signers | up up toto 3 persons). * Internal Signers (Your team members for company authorization). **1. Managing Signers (Add / Delete)** **Add a Signer** * Go to Signers & Authorization section. * Click the + button (top-right corner). ![MS9](https://mintcdn.com/zuperinc/0qJ0iWc2ESMlSr-X/images/MS9.png?fit=max\&auto=format\&n=0qJ0iWc2ESMlSr-X\&q=85\&s=b13348d39fe73507a4e7b2f9fa827bb0) **Choose tab:** **Co-Signer → Enter Full Name + Email.** ![MS71](https://mintcdn.com/zuperinc/0qJ0iWc2ESMlSr-X/images/MS71.png?fit=max\&auto=format\&n=0qJ0iWc2ESMlSr-X\&q=85\&s=fc69d18b82f311b393fb44381c93098b) * Internal Signer → Select user from dropdown (company team member). ![MS8](https://mintcdn.com/zuperinc/0qJ0iWc2ESMlSr-X/images/MS8.png?fit=max\&auto=format\&n=0qJ0iWc2ESMlSr-X\&q=85\&s=43dfe50c8ca40bd47210e32e2c2498de) * Click Add Signer. **Delete a Signer** * Click the 🗑 trash icon next to any Co-Signer or Internal Signer. ![MS12](https://mintcdn.com/zuperinc/0qJ0iWc2ESMlSr-X/images/MS12.png?fit=max\&auto=format\&n=0qJ0iWc2ESMlSr-X\&q=85\&s=47902756250a61e13b8982dcabea3254) Confirm in the dialog box by clicking Delete. > [!NOTE] > > **Note**: Primary Signer cannot be deleted. ![MS6](https://mintcdn.com/zuperinc/0qJ0iWc2ESMlSr-X/images/MS6.png?fit=max\&auto=format\&n=0qJ0iWc2ESMlSr-X\&q=85\&s=1c5e01d0c7675236096ea780fd7ff63f) ## **Full Signing Workflow (After Sending)** Here’s what happens step by step once the proposal is ready: **1. Send the Proposal** * Click the **Send** button at the top of the screen. * The proposal status changes to **Sent**. **2. Primary Signer Notification** * The primary signer (customer) receives an email notification to review and sign the proposal. **3. Primary Signer Signs** * The customer reviews the proposal, selects their preferred option, and signs. **4. If There Are Additional Signers** * If co-signers or internal signers are included, the next signer in the sequence automatically receives an email notification. * The proposal status has been updated to **Awaiting Signature**. * Any pending signature remains visible in the signer list. **5. Once Everyone Has Signed** * After all required signers have completed signing, the quote is fully approved. | Stage | Status Shown | What Happens | | :- | :- | :- | | Before sending | Draft | You can edit signers, pricing, and details. | | After clicking **Send** | Sent | Email notifications are sent to all signers. | | Only primary signer (no co-signers) | Accepted | Proposal converts to a live Quote immediately. | | Co-signer(s) still pending | Awaiting Signature | Quote waits until remaining signers complete. | | All signatures completed | Approved | Fully signed and ready for next steps. | ## **A. Service Packages** A **Service Package** is a proposed structured offering of specific solutions or services for a customer/client. You must define the **Service Package** before proceeding. **To create a service package:** 1. Select the **Settings menu** from the left navigation menu. 2. Under **Configuration Settings**, click **Quotes & Invoices**. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-17.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=3186000f51142d9d5444d519e31c134d) 3. Select **Service Packages** and click **+ New Package**. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-18.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=c4e9fd58159e4abf533fb979452de4b7) 4. Under **Service Package Details,** enter: * **Name**: Enter the package name. * **Description**: Enter a brief description. * **Remarks**: Add any additional remarks. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-19.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=c1f8a6e2e5ff04dd0c2772be3c7fec63) 5. Click the "**+ Add Item**" button to add individual parts, products, and services. Alternatively, use the dropdown menu next to the "**+ Add Item**" button to: * **Line Item**: Add a part, product, or service as an individual item. * **Bundle**: Add a part, product, or service bundle. Note that bundles added here will not appear as a product type in the filter menu. * [**Section**](https://docs.zuper.co/Accounting/Sections): Add a section to help organize line items within the package. * **Item Group**: Select a predefined group of items to include in the package. ![Sect36](https://mintcdn.com/zuperinc/r_ueXa0MUhgIBr_E/images/Sect36.png?fit=max\&auto=format\&n=r_ueXa0MUhgIBr_E\&q=85\&s=a411d9fbc5a4e58db489fc88fb6c239c) 10. Adjust the [margin percentage](/Accounting/Profit_Margin) to instantly recalculate markup % and the total sell price for all line items. 11. You can **[add rebates](/Accounting/Rebates)** to individual proposal options to show your customer the potential savings for each option. Zuper calculates a separate Net Investment for each option based on the rebates applied.\ For more information, see **Rebates and Net Investment**. 12. Click "**Create Package"** to successfully finalize and create the service package. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-21.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=2f4f8e1480a4f25f287985fc43c07efe) > [accordion] Managing service packages > > Once you have created a service package, you can manage it using the following functions available on the **Service Packages** listing page: > > ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-36.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=1fb5deff4ebc5f69dbadf4ed70e506d1) > > * **Reorder**: Click the **Reorder** button to rearrange items in the package. > * **Clone**: Click the **Clone** icon to duplicate a package. > * **Edit**: Click the **Edit** icon to modify the details of the package. > * **Deactivate**: Click the **Deactivate** icon to disable the package. ## **Add-ons in the Service Package** Once Add-ons are enabled in Quote settings, you can associate them with **Service Packages**. This allows you to configure optional Add-ons or services alongside a base package. * In the service package editor, select the **Add-ons** tab. ![Addon3](https://mintcdn.com/zuperinc/iiHGH2bTOPeZq_2m/images/addon3.png?fit=max\&auto=format\&n=iiHGH2bTOPeZq_2m\&q=85\&s=8bb6287aa8f24b9e5983bf15d57cbb97) * Add the necessary Add-ons and click save. ![Addon4](https://mintcdn.com/zuperinc/Ig8bDDGGWSV4RlLX/images/addon4.png?fit=max\&auto=format\&n=Ig8bDDGGWSV4RlLX\&q=85\&s=3c1407996a3cb2a67252f509fafd3f13) ## **B. Proposal Templates** A **Proposal Template** is a predefined format for linking service packages in a proposal. It serves as a basic structure for quotations, which can be customized. **To create a proposal template:** 1. Navigate to **Settings** -> **Configuration Settings** -> **Quotes & Invoices**. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-17.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=3186000f51142d9d5444d519e31c134d) 2. Select **Proposal Template** from the available options and click the **+ New Proposal Template** button to create a new template. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-22.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=043d386c8f8cf39cedc9b24bf1152925) 3. Enter a descriptive name and description for your proposal template and click **Create** to proceed. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-23.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=b5e6185e652c55d23448d4bcacdcb55a) 4. Enter a **Label Name** and short description for the proposal template. 5. Add the Service Packages: * Click the **+ Add Package** button to include a **Service Package** in your template. * Choose the desired **Service Package** from the list and click **Save** to confirm. > [!NOTE] > > Note: Recommended estimate options' image size: 720 × 240 px (3:1 ratio) — ensures the best fit in the proposal and proposal layout PDF. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-24.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=741859b532185444e3556896827d11c9) 6. Once added, click **Save Template** to finalize the template creation process. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-25.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=8895e3bb08d3d4b240ae5bf1463b4083) After creating the template, you can navigate to **Accounting > Quotes & Invoices > + New > Proposal** to use this template while drafting proposals for your customers. ## **Add-ons in the Proposal Template** When Add-ons are configured and linked to service packages, they automatically appear within proposal templates as **optional Add-ons**. **Where Add-ons Appear?** * Add-ons are displayed within each **proposal option card**, under a dedicated **Add-ons** section. * They are grouped separately from the base service charges to clearly indicate that they are optional. ![Addon8](https://mintcdn.com/zuperinc/8_goo6XRrYpGqfJg/images/addon8.png?fit=max\&auto=format\&n=8_goo6XRrYpGqfJg\&q=85\&s=b2ec8256519ada89b15b1bdae452e839) ## **C. Create a New Proposal** A **Proposal** is created before sending an estimate to a customer. Once the **Service Package** and **Proposal Template** are set up, you can send a proposal. **Navigation** : *Accounting* --> *Quotes* --> *+ New (Proposal)* **To create a proposal** 1. Click the “**Accounting**” module from the left navigation menu and select "**Quotes**". ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-10.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=76d2c8d74aea8ff367b9df05fc126223) 2. Click the **+ New button** and select **Proposal**. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/quotes-7.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=c670c533b37e05f22b209e96c6d21f4e) 3. Select the appropriate template for your proposal and click the **“Choose Template”** button. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/quotes-8.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=2439d1b8e98820a34d41eb1d55301799) 4. A new **Proposal Creation** page will appear. 5. Select either "**Customer**" or "**Organization**" to associate with the proposal. 6. Click "**+Add**" to associate the various modules. 7. A side panel will appear. Select the required module and click the "**Proceed**" button. 8. The billing and service contact details are automatically populated based on the selected customer or organization. 9. Fill in the mandatory fields in the **Proposal Details** section: * **Proposal Title** * **Proposal Date** * **Expiry Date** * **Quote Template** 10. You can **edit** or **delete** any selected packages as needed in the **Estimate Options** section. 11. The administrator can prefill the options by editing a product with predefined attributes. ![Optipro16](https://mintcdn.com/zuperinc/laQSbOu9vtacFVQJ/images/Optipro16.png?fit=max\&auto=format\&n=laQSbOu9vtacFVQJ\&q=85\&s=07a1bd8dd693fc705d009df014e3dbcc) 12. Click **+ Add Attachments** to upload any relevant quotation-related attachments to the proposal. 13. Click the **Save & Send** button to save the proposal and proceed with sending it. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/quotes-9.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=4d2d48c66f3e41445a3cbb1d15a05933) 14. In the pop-up, confirm the **From ID**, **Email**, **Subject**, and **Body** of the email. Once confirmed, click **Send** again to send the proposal to the selected recipient. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/quotes-1.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=aed0f3937fece6efcd44c359f8901206) > [accordion] Functions on the Proposal Details page > > The following perform following functions in the Proposal Details page. > > * **Edit Proposal**: Click the **Edit** button to modify the proposal, including package details and any other changes. > * **Save as Draft**: After making changes, click **Save as Draft** to save the updated proposal without sending it immediately. > * **Mark as Accepted**: Once the customer agrees to the proposal, click **Mark as Accepted** to finalize the proposal. This marks the proposal as accepted and ready for the next steps. After marking the proposal as accepted, the proposal is automatically converted into a **Quote**, which means the proposal has been confirmed and the process is moving forward. > > ### **Add-ons in the Proposal - Create / Edit** > > **Add-ons** let you include optional products or services in the proposal that are not part of the primary items. These are displayed under the **Additional Items** section of the proposal option.  > > > [!NOTE] > > > > **Note:** If the Add-ons are enabled in the settings and configured in the standard or CPQ template, they are auto-fetched under the proposal options. Additionally, if any adjustments or changes are required before presenting to the customer, the items under the add-ons section can be updated in the proposal edit page. ## Frequently asked questions > [accordion] Can different proposal options have different rebates? > > Yes. Each proposal option can have its own rebates and **Net Investment**. > [accordion] What happens to rebates when the customer accepts a proposal option? > > The proposal retains the rebates associated with the accepted option. > [accordion] What happens to rebates when I convert a quote to a proposal? > > Zuper adds the quote's rebates to the first proposal option. > [accordion] Why can't the customer see the rebates on the proposal? > > Make sure **Show Rebates** is enabled in the Proposal Layout used by the proposal. # Rebates Source: https://docs.zuper.co/Accounting/Rebates A rebate is an incentive offered to your customer by a manufacturer, utility provider, or another third-party organization. In Zuper, your team can add rebate amounts directly to quotes and proposals to show customers their potential savings. Zuper displays each rebate separately and calculates the customer's estimated cost after rebates. This helps your team communicate available incentives during the sales process while giving customers a clearer understanding of their potential out-of-pocket cost. > [!NOTE] > > **Info**: Rebates are for informational purposes only. They do not reduce the quote or proposal total, taxes, deposit, amount due, or the amount your business charges or collects from the customer. ## How rebates work When a rebate is added to a quote or proposal option, Zuper displays the rebate separately below the **Total** and calculates the value shown as **Net Investment**. ```nushell theme={null} Net Investment = Total − Total rebate amount ``` For example, if the Total is \$10,000 and the customer receives a \$1,000 manufacturer rebate, Zuper displays: **Total**: \$10,000.00\ **Manufacturer Rebate**: \$1,000.00\ **Net Investment:** \$9,000.00 You can also add more than one rebate when multiple incentives apply. Zuper combines all rebate amounts and subtracts the total from the quote or proposal Total. > [!NOTE] > > **Note**: Rebates are available as fixed amounts only, and the combined value of all rebates cannot exceed the Total. > [accordion] **Rebate rules and limitations** > > Before you start using rebates, keep these points in mind: > > * Rebates are available as fixed amounts only. Percentage-based rebates are not supported. > * You can add up to 10 rebates to a quote or proposal option. > * The combined rebate amount cannot exceed the Total. > * Rebates affect only the Net Investment value. They do not change the Total, taxes, deposit, Amount Due, or the amount your business collects. > * Rebates are available only on quotes and proposals. They are not supported on invoices. > * Rebates on a quote apply to the entire quote. Each proposal option can have its own rebates and Net Investment. > * When you convert a quote containing rebates to a proposal, Zuper adds those rebates to the first proposal option. > * Updating a rebate template does not change rebates that have already been added to existing quotes or proposals. > * You can select a saved rebate template or add a one-time rebate directly to a quote or proposal option. ## Enable rebates **Navigation**: Settings → Modules → Quotes and Invoices → Quotes and Invoices General Settings 1. Open the **Quote** tab. 2. Turn on **Enable Rebates?**. 3. *(Optional)* In **Show Total After Rebates As**, enter a custom label for the net investment value. If you leave blank, Zuper displays **Net Investment** by default. 4. Click **Save**. ![SCR 20261001 Ntal](https://mintcdn.com/zuperinc/tnVJfzXmXdFtgJ4g/Accounting/images/SCR-20261001-ntal.png?fit=max\&auto=format\&n=tnVJfzXmXdFtgJ4g\&q=85\&s=46a1f08821fef272d048680c0dba8c56) When **Enable Rebates?** is turned off, users cannot add or manage rebates. Any existing rebates are retained and become available again if you re-enable the setting. > [!TIP] > > **Tips:** You can choose to hide rebates from customer-facing proposals. To do this, first turn off the "**Show Rebates**" option in the applicable Proposal Layout before disabling "Enable Rebates." ## Create a rebate template Create rebate templates for rebates your team applies frequently. Templates help users quickly apply a predefined rebate name and default amount when creating quotes or proposal options. **Navigation**: Settings → Modules → Quotes and Invoices → Discount & Fees 1. Click **+ New Discount/Fee**. 2. In **Type**, select **Rebate**. 3. Enter a **Name** (up to 26 characters). This name appears on the quote or proposal. 4. Enter the **Amount**. 5. *(Optional)* In **Restrict to Custom Roles**, select the custom roles that can use the rebate. If your company uses business units, you can also limit the rebate to specific business units. 6. Click **Create**. ![SCR 20261001 Nxah](https://mintcdn.com/zuperinc/tnVJfzXmXdFtgJ4g/Accounting/images/SCR-20261001-nxah.png?fit=max\&auto=format\&n=tnVJfzXmXdFtgJ4g\&q=85\&s=7baa72240ddd16e5ad7be993f0435cc0) ## Add rebates to a quote or proposal Once rebates are enabled, your team can add them from the pricing summary of a quote or proposal option. > [tab] Web > > 1. Open or create the quote or proposal. > > 2. For a proposal, open the option you want to update. > > 3. Below **Total**, click **Add rebate?**. > > 4. Click **Add rebate?**. > > 5. Select an existing rebate template or enter a name for a one-time rebate. > > 6. Enter or update the rebate amount. > > 7. To add another rebate, click **Add rebate?** again and repeat the steps. > > ![SCR 20261001 Ocmm](https://mintcdn.com/zuperinc/tnVJfzXmXdFtgJ4g/Accounting/images/SCR-20261001-ocmm.png?fit=max\&auto=format\&n=tnVJfzXmXdFtgJ4g\&q=85\&s=06d2b2c6964eb8ab2ef1d1be1e486afe) > > 8. Save the quote or update the proposal option. > > > [!NOTE] > > > > **Info**: To edit a rebate, hover over it and click the pencil icon. To remove a rebate, click the trash icon and confirm **Delete**. > [tab] Mobile > > You can also add and manage rebates from the Zuper mobile app. > > 1. Open the quote or proposal. > 2. Go to the pricing summary. > 3. Next to **Rebate**, tap Add. > 4. Select a rebate template or add a custom rebate with a name and amount. > 5. Tap **Add**. > 6. Save your changes. > > ![Rebatemobile](https://mintcdn.com/zuperinc/wKfzfZMNFOKBw0ZR/images/Rebatemobile.png?fit=max\&auto=format\&n=wKfzfZMNFOKBw0ZR\&q=85\&s=670392de97c22071847b29a81ed89020) > > > [!NOTE] > > > > **Info**: To edit or remove a rebate: → On **Android**, tap the rebate or its pencil icon. → On **iPhone**, press and hold the rebate, or swipe it in the line item editor. Zuper displays each rebate separately and automatically recalculates the **Net Investment**. > [!NOTE] > > **Note**: On a quote, rebates apply to the entire document. On a proposal, each option can have its own rebates and Net Investment. ## Frequently asked questions > [accordion] Does a rebate reduce the amount the customer owes my business? > > No. Rebates affect only the customer's **Net Investment**. They do not reduce the **Total**, taxes, deposit, **Amount Due**, or the amount your business collects. > [accordion] Can I add more than one rebate? > > Yes. You can add up to 10 rebates to a quote or proposal option. Zuper combines all rebate amounts when calculating **Net Investment**. > [accordion] Can the combined rebate amount exceed the Total? > > No. The combined value of all rebates cannot exceed the **Total**. > [accordion] Can I add a percentage-based rebate? > > No. Rebates support fixed amounts only. > [accordion] Can I change the amount of a saved rebate template? > > Yes. You can change the amount after adding the template to a quote or proposal option. The change applies only to that document and does not update the original template. > [accordion] Does updating a rebate template change existing quotes or proposals? > > No. Each quote and proposal keeps its own copy of the rebate after it is added. > [accordion] Can I rename Net Investment? > > Yes. In **Quotes and Invoices General Settings**, enter a custom label in **Show Total After Rebates As**. Leave the field blank to use **Net Investment**. > [accordion] Why can my team see rebates but the customer cannot? > > Customer-facing visibility is controlled separately. Turn on **Show Rebates** in the applicable Proposal Layout to display rebates and **Net Investment** on the customer proposal page and PDF. # Recording a deposit on quotes Source: https://docs.zuper.co/Accounting/Recording_a_Deposit_for_Quotes If you need to collect money upfront from your client, you can add a required deposit to quotes. Customers will see that there is a deposit on the quote, so they know how much to pay you. When a deposit is recorded on a quote, it will transfer to the first invoice created for this job generated from the quote. **Navigation**: *Accounting* -> *Quotations* ### Adding a required deposit to a quote The deposit amount on quotes is determined by the settings configured for deposits in the **Organization Settings**. By default, this value is auto populated on quotes. However, if you need to update the deposit amount, you can do so easily. To modify the deposit amount: 1. Click the icon next to the "**Collect Deposit**" section. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-33.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=89196a32449f438a5fae7c24a185fab4) 2. Update the amount as required. 3. Click "**Update Deposit**". ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-32.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=53467dac1db8527a4a0fb9bad1ab2ffc) > [accordion] Setting up deposit amounts in Organization Settings > > The deposit amount on quotes is determined by the **Organization Settings**. To configure these settings: > > 1. Navigate to **Settings** from the left navigation menu and select **Organization Settings**. > > ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-29.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=a873f1f144fd262beae4b9fdc7014fee) > > 2. Click **Quotations and Invoices Settings**. > > ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-28.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=8f4ed3db84ec04ea437a3eb60e2a6b9a) > > 3. Configure the following fields: > > * **Allow Deposit on Quote Approval**: Choose whether to enable deposits for quotes. > * **Enter Threshold Amount**: Specify the maximum limit for deposit amounts. > * **Type of Deposit Value**: Choose between a fixed deposit amount or a percentage of the quote value. > * **Enter Deposit Value**: Define the default deposit amount or percentage. > * **Allow Payment Collection**: Enable payment collection for deposits. > * **Allow Sending Payment Link to Customer/Contact**: Enable sending payment links for deposits. > * **Payment Mode Facilitating the Payment**: Specify available payment methods (e.g., Card, Zuper Pay, Cash, or third-party payment apps). > * **Allow Field Executive to Collect Payment**: Allow field executives to log deposit payments. > > ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-27.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=79e82d469b946cec84a5d559c6f3997a) > > By configuring these settings, the deposit amount will be automatically populated on quotes by default. ### Recording deposits on quotes Once the quote is ready, you can email it to the customer. The customer can then pay the deposit amount directly by clicking the payment link in the email. Alternatively, if the customer pays by a different method, you can manually log the deposit received. **To log a deposit:** 1. Click **Collect Deposit** in the product table details or navigate to **More Actions** -> **Collect Deposit**. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-34.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=c3f33e77b422d6c77da6a82659621c1a) 2. A **Collect Deposit** dialog box will appear. Enter the following details: * **Payment Mode**: Select the method used for the deposit (e.g., Card, Zuper Pay, Offline Cash, or other third-party payment apps). * **Deposit Amount (in USD)**: Enter the exact deposit amount received from the customer. * **Payment Reference Number**: Provide a reference number, such as a transaction ID or check number, associated with the payment. * **Payment Date**: Specify the deposited date. * **Remarks**: Optionally, add any notes related to the deposit. * **Send Receipt/Confirmation Note**: Check this box if you want to send a confirmation receipt or a thank-you message to the customer. 3. After entering the details, click **Collect** to successfully log the deposit. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-31.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=6f1e662b18480f3a23e6eafb4715ee50) Once the full required deposit amount has been recorded, an icon will appear beside the "**Deposit**" field on the quote, indicating that the deposit has been collected. You also have the option to void the quote transaction. ![](https://mintcdn.com/zuperinc/5Qye55qfJoVt0EGz/Accounting/images/Quotes-30.png?fit=max\&auto=format\&n=5Qye55qfJoVt0EGz\&q=85\&s=d0603cd71f5ff2b86842243483ea9d2e) # Sections Source: https://docs.zuper.co/Accounting/Sections ## Overview Sections replace **Headers** across **Service Packages**, **Proposals**, **Quotes**, **Invoices**, and **Job** line items. With Sections, you can control what customers see, from individual line-item details to whether a section appears at all. ## How sections work? * When you add a section to a quote, invoice, or proposal, all line items inside it are treated as a group. Reordering a section moves every item in it together — you do not need to reorder each item individually. * Each section has its own configuration settings that control what your customer sees in PDFs, public links, previews, and presentation mode. * You can add line items directly to a section. > [!NOTE] > > **Note**: To ensure Sections configuration works correctly, make sure the ‘**Price**’ toggle is enabled under Estimate Options in the Proposal layout, and ‘Show Selling Price in Transaction’ is enabled for the relevant custom role. ## **Adding sections in transactions** > [tab] Web > > The web app supports Jobs, Quotes, Invoices, Proposals, and CPQ. > > 1. Use the “**+ Add**” button to add the Section: > > ![Sect40 2](https://mintcdn.com/zuperinc/Brg5bx4L60utYeYx/images/Sect40-2.png?fit=max\&auto=format\&n=Brg5bx4L60utYeYx\&q=85\&s=a0f4f7c3f014a5c0dc5cfeca48d60888) > > 2. Enter the section name and select the “**Add Section**” button. > > ![Sect41 1](https://mintcdn.com/zuperinc/Brg5bx4L60utYeYx/images/Sect41-1.png?fit=max\&auto=format\&n=Brg5bx4L60utYeYx\&q=85\&s=10be6ef592e99ad7197efd94d1d56741) > > 3. Under “**Actions**,” select the context menu. Choose “[**Configure**](https://docs.zuper.co/Accounting/Sections#section-configuration)” to access the section settings. > > ![Sect38 1](https://mintcdn.com/zuperinc/wFeWSFHyk7thEFT_/images/Sect38-1.png?fit=max\&auto=format\&n=wFeWSFHyk7thEFT_\&q=85\&s=b93f90ff2979bb8e4eb38e1b8f88ab26) > > Similarly, you can edit sections as well after creation. > [tab] Mobile > > The Mobile app supports Quotes, Invoices, and Proposals. > > 1. Tap the “**+**” button to add the Section. > > ![](https://mintcdn.com/zuperinc/no9fPPJbLw2alY0I/images/Sect44-portrait.png?fit=max\&auto=format\&n=no9fPPJbLw2alY0I\&q=85\&s=9247b05a207632aa62702842d2381fbb) > > 2. Type the section title and tap the "**Add**" button. > > ![](https://mintcdn.com/zuperinc/no9fPPJbLw2alY0I/images/Sect45-portrait.png?fit=max\&auto=format\&n=no9fPPJbLw2alY0I\&q=85\&s=938cadad0be2c753e6f4331c4c704b96) > > 3. Under “**Actions**,” select the context menu. Choose “[**Configure**](https://docs.zuper.co/Accounting/Sections#section-configuration)” to access the section settings. > > ![Sect 47 1](https://mintcdn.com/zuperinc/no9fPPJbLw2alY0I/images/Sect-47-1.png?fit=max\&auto=format\&n=no9fPPJbLw2alY0I\&q=85\&s=3ed1d345ee28bef7334e30adc9f7afbf) > [!NOTE] > > **Note**: A line item added using the generic “**Add**” button, rather than being added to a specific section, is placed in the last section. ## Section configuration Each section has four settings that control how it appears to the customer, in the PDFs, Public links, previews, and presentation mode. When a new section is added, it inherits the configuration of the previous section. | Setting | What it does | Default | | - | - | - | | **Show Line Items** | Displays individual line items to the customer within the section. | On | | **Show Line-Item Prices** | Shows the unit cost, markup, and price for each individual line item in a section. | On | | **Show Section Total** | Displays the sum of the section total. | Off | | **Hide Section** | Completely hides the section and all its items from the customer. | Off | ![Sect Custom 1](https://mintcdn.com/zuperinc/0eAQG0oHAKNuEfVf/images/sect_custom-1.png?fit=max\&auto=format\&n=0eAQG0oHAKNuEfVf\&q=85\&s=5784c6130077c79b6c94cc1037e3dbcd) Zuper carries over the section configuration when: * You create a quote from a proposal option. * You generate an invoice from a quote or job. * You create a job from a quote or invoice. ## Key points to note on hiding a Section * Customers cannot see hidden sections or their line items in PDFs, public links, or presentation mode. * Hidden line items still count toward the overall estimated total. * You can hide multiple sections at once. * The section total and all line-item prices are hidden from the customer throughout the quote/invoice/proposal. * When you enable Hide Section, Zuper turns off the Price toggle in **Proposal Layout** → **Estimate Options**. ![Sect43 1](https://mintcdn.com/zuperinc/7NIZfJ4IPBAP8dXw/images/Sect43-1.png?fit=max\&auto=format\&n=7NIZfJ4IPBAP8dXw\&q=85\&s=43b428b249c226af011ae270e0d58e0e) ## Section actions * Configure — Controls how line items and prices appear within the section. * Rename — Changes the section name. * Clone — Duplicates the section and all its line items. * Remove — Deletes the section. Select one of the following options: * Remove header only — Deletes the section but keeps the line items. * Remove section and all items — Deletes the section and all line items within it. ![Sect38 2](https://mintcdn.com/zuperinc/DbHPDw4vALALNIJc/images/Sect38-2.png?fit=max\&auto=format\&n=DbHPDw4vALALNIJc\&q=85\&s=614ece54a210025192cef83021a30648) ### Moving line items between sections: You can move any line item out of a section or into a section. * **Move out of Section** — Removes the item from its current section and places it at the top above all sections, ungrouped. * **Move to Section** — Move a line item from a section or an ungrouped item to a preferred section. ![Sect39](https://mintcdn.com/zuperinc/wFeWSFHyk7thEFT_/images/Sect39.png?fit=max\&auto=format\&n=wFeWSFHyk7thEFT_\&q=85\&s=97ac189f15b6e12e74b55ff542051ab9) ### To move a line item  Locate the line item in the section. * In the line item actions, select [**Move out of section**](https://docs.zuper.co/Accounting/Sections#moving-line-items-between-the-sections) or [**Move to section**](https://docs.zuper.co/Accounting/Sections#moving-line-items-between-the-sections) from the line-item actions, depending on the item's current position. * If moving to a section, select the destination section from the list. ![Sect42](https://mintcdn.com/zuperinc/7NIZfJ4IPBAP8dXw/images/Sect42.png?fit=max\&auto=format\&n=7NIZfJ4IPBAP8dXw\&q=85\&s=6c141d3ddc87fd4fda7621d4a0dd276e) ## Customer view * When only **Show Section Total** is enabled, the customer sees only the section total. Individual line items and their prices stay hidden. ![Section Display All](https://mintcdn.com/zuperinc/F9l9_jLr41Y3cFXj/images/section_display_all.gif?s=830b39571074fb7b18c2e7f37fdce704) * When **Show Line Items**, **Show Line-Item Prices**, and **Show Section Total** are all enabled, the customer sees each line item, its unit cost, markup, and price. The section total also appears against the sections. ![Section Display All 1](https://mintcdn.com/zuperinc/F9l9_jLr41Y3cFXj/images/section_display_all-1.gif?s=55e86a2f5e36f1d7ab12fc29030ab708) * When **Hide Section** is enabled, the customer does not see the section or any of its line items. Additionally, the prices for all the other line items are hidden from the customer as well. ![Section Hide](https://mintcdn.com/zuperinc/F9l9_jLr41Y3cFXj/images/section_hide.gif?s=995ed94041bbb7a9c94ac88acf6271f0) ## **Important note on templates** **No changes required if:** * You continue using the default configuration (where line items and prices are visible and section totals are hidden), your existing templates — both native and custom — will continue to work as expected. If you use **new Section visibility options** (for example, hiding line items, prices, or entire sections)**:** * **Proposals:** No impact. Sections are supported by default. * **Quotes & Invoices (Native Templates):** You will need to create new templates to use these capabilities. Check out how to create [quote & invoice templates](https://docs.zuper.co/Settings/Modules/Quotes-Invoices/Quotes-Invoices-Settings#quotes-%26-invoices-templates). * **Quotes & Invoices (Custom Templates):** Updates are required to support these capabilities. Please reach out to [**support@zuper.co**](mailto:support@zuper.co) for assistance.  > [!NOTE] > > **Note:** Custom template changes affect all documents using that template. Before requesting changes, confirm the update won't impact other quotes or invoices. For document-specific formatting, request a separate template from [support@zuper.co](mailto:support@zuper.co). # Sending and Getting Customer Approval Source: https://docs.zuper.co/Accounting/sending-a-proposal-and-getting-customer-approval Give your customers a simple, self-serve experience where they can review your proposal online, choose an option, and approve it with a digital signature. You'll be notified the moment they approve, decline, or request a change so you can move on to the next step. > [!WARNING] > > **Before you begin:**\ > The settings in **Settings → Modules → Quotes & Invoices → Quote and Invoice General Settings → Quote tab** control the proposal approval experience. Ensure those are configured correctly before sending. Refer to [Settings](/Settings/Modules/Quotes-Invoices/Quotes-Invoices-Settings#general-tab). ## Sending the proposal The first step is to send the proposal by email to the customer. Sending moves the proposal status from **Draft** to **Sent**, and that is what activates the approval flow for your customer. To send a proposal, open the **Proposal Details** page and click **Send** in the top right corner. If you are still building the proposal, you can click **Save & Send** instead. The **Send** dialog opens. ![Approval 01](https://mintcdn.com/zuperinc/pvpN-SUjenLs0go8/images/approval-01.png?fit=max\&auto=format\&n=pvpN-SUjenLs0go8\&q=85\&s=7e7ddd169828291c1d4934b589101b64) Review the fields and click **Send**. > [!TIP] > > **Pro Tip:** When emailing a proposal, you can add multiple recipients by separating each address with a comma in the CC and BCC fields. You can also customize the **subject line** and **message body** before sending. ![Approval 02](https://mintcdn.com/zuperinc/pvpN-SUjenLs0go8/images/approval-02.png?fit=max\&auto=format\&n=pvpN-SUjenLs0go8\&q=85\&s=7bfd4abf5d559dcf812b96edc5d4a1b6) The proposal status changes from **Draft** to **Sent**. Your customer receives an email with the proposal attached as a PDF and a **"View to Approve Proposal"** link that takes them to the interactive approval page. ## Sharing the proposal link If you want to share the proposal through WhatsApp or any other channel outside Zuper's email system, you can use the **Share Links**. Click the **copy icon** to copy the URL to your clipboard, the **WhatsApp icon** to share the link directly via WhatsApp, or the **open in browser icon** to preview exactly what your customer will see. Keep in mind that sharing the link does not change the proposal status. The customer approval flow is only active once you have sent the proposal by email and the status is **Sent**. ## What your customer sees When your customer opens the **"View to Approve Proposal"** link from their email, they land on a branded proposal page with your company logo, the proposal title, their billing and contact details, and all package options with full pricing. From here, your customer can take one of three actions: click **Review & Sign** to select a package and approve, click **Request Change** to send a change request back to your team, or click **Decline** to decline the proposal. ![Approval 03](https://mintcdn.com/zuperinc/pvpN-SUjenLs0go8/images/approval-03.png?fit=max\&auto=format\&n=pvpN-SUjenLs0go8\&q=85\&s=e99ea49bebb233b239fe13badf3c0b3a) If **Notify Created User on Status Updates?** is set to **Yes** in settings, you'll receive a notification as soon as your customer takes any of these actions. ### How does your customer approve the proposal When your customer clicks **Review & Sign**, the **Complete Your Signature** panel opens on the right side of the screen. Here's what they do: ![Approval 04](https://mintcdn.com/zuperinc/pvpN-SUjenLs0go8/images/approval-04.png?fit=max\&auto=format\&n=pvpN-SUjenLs0go8\&q=85\&s=324fd842452ff9645a55c9134c9b32fb) #### Select a package Your customer sees all available options; for example, **Basic**, **Advanced**, or **Installation Package** with pricing for each. If you enabled financing for a package in the proposal template, that option shows a **monthly payment amount and term** (for example, "\$41.24/month for 10 years") alongside the cash price. Once they pick an option, the **Item Summary** updates instantly with the line items, discounts, taxes, transaction fees, and total for that package. #### Choose a payment method Under **Payment Method**, your customer picks how they want to pay: * **Cash Payment** - Pay the full amount upfront * **Financing** - Monthly payments through your financing provider you configured, with the rate, term, and an "as low as" comparison shown. > [!NOTE] > > **Note:** Financing only shows up if **Enable Financing?** is turned on in settings **and** financing is enabled for that package in your proposal template. Once the proposal is **Approved**: If **Auto-convert Quote to Invoice?** is set to *Yes, Save as Draft* or *Yes, Save and Send*. Zuper creates an invoice from the approved proposal automatically. # Appointments Source: https://docs.zuper.co/Appointments/Appointments Not all roofing work happens in a single visit. A job might need an inspection, an adjuster walkthrough, a pre-production check, and the installation itself. These often fall on different days, involve different people, and sometimes span trades such as roofing, gutters, and siding. Appointments in Zuper let you manage all of that in one job. An appointment represents a scheduled visit. When you create a job, Zuper automatically creates an initial appointment. When a technician needs to return to the site, you can add additional appointments to the same job rather than creating separate jobs or rescheduling existing ones. Every appointment on a job shares the same invoice, job notes, and job history. This keeps multi-day and multi-visit work on a single record, reduces duplicate data entry, and gives your team a clear view of each visit while managers and dispatchers maintain visibility into the full job. ## Things to Know * A single appointment is automatically created when you create a new job under a dispatchable job category. If the job category is marked **Non-Dispatchable** (for example, Inspection), the job is created, but no appointment is added. * You cannot add appointments to a job in a terminated job status, such as Closed or completed. > [!TIP] > > Prerequisite: Account configuration is required to use this feature. Please contact the Support team for details. ### Add Appointments 1. Open the job you want to add an appointment to. 2. Navigate to the **Appointments** tab and click **Create Appointment**.\ ![Appointments 01 2](https://mintcdn.com/zuperinc/f6sFQRHvQqyOEO4z/images/appointments-01-2.png?fit=max\&auto=format\&n=f6sFQRHvQqyOEO4z\&q=85\&s=d3063c06b355b2fd5225cc5e2a509178) 3. Fill out the appointment details: 1. Add a title and, if needed, a description. 2. Select the appropriate **Appointment Type** from the dropdown based on the purpose of the appointment. > [!NOTE] > > You can configure the appointment types from **Settings > Job Settings > Appointment Types**. Once configured, these types appear in the **Appointment Type** dropdown when you create an appointment. > > ![Appointment 2 1](https://mintcdn.com/zuperinc/CdA_w-7zBfaE58Db/images/Appointment-2-1.png?fit=max\&auto=format\&n=CdA_w-7zBfaE58Db\&q=85\&s=2e588090cc787e69f98e441f1f1ddb19) 3. Assign technicians under **Assignee**. 4. Set the **Schedule Date** either *manually* or using [Assisted Scheduling](Work_Order_Management/Jobs/Assisted_Scheduling#assisted-scheduling). > [!NOTE] > > Note: If the **Enable Due Date** setting is disabled, you can create appointments without a schedule.\\ > > ![Job Due Date 1](https://mintcdn.com/zuperinc/wKFsqZEo6Ms4jfao/images/job-due-date-1.png?fit=max\&auto=format\&n=wKFsqZEo6Ms4jfao\&q=85\&s=83b6ddcb6b5aeb247fa720802dcb67dd) 5. Choose the **trade type** if this appointment is tied to a specific trade. 6. Switch to the **Tasks** tab if you want to attach a task to this appointment, either by creating a new one or by linking to an existing one. 7. Switch to **Purchase Orders** if you want to associate a *Purchase Order* or *Material Order* with the appointment. > [!NOTE] > > **Notes**: > > * Appointments work on Zuper's new [task](/Zuper_Dashboard/Tasks) experience feature, so if your organization is still on the older service task setup, reach out to [support@zuper.co](mailto:support@zuper.co) to get that switched. > * When a technician is assigned to a task linked to an appointment, the user will be automatically added to a Job as well. 4. Click **Save**.\ ![Appointments 1](https://mintcdn.com/zuperinc/CdA_w-7zBfaE58Db/images/Appointments-1.png?fit=max\&auto=format\&n=CdA_w-7zBfaE58Db\&q=85\&s=9393e0cad2d0689905ddc835b6640295) The appointment is added to the job with the configured **Schedule Date**, **Assignee**, **Appointment Type**, and **Trade Type**. The selected tasks and associated orders are also linked to the appointment, if applicable. ![Appointment 4](https://mintcdn.com/zuperinc/CdA_w-7zBfaE58Db/images/Appointment-4.png?fit=max\&auto=format\&n=CdA_w-7zBfaE58Db\&q=85\&s=18ac4ea6af29b40e27de1c4acf5eb55c) ### Managing an appointment * **Edit**: Click the appointment's name to open and modify its details. * **Delete**: Click the context menu and choose Remove. * **Clone**: Click the context menu and choose Clone to create a copy of it. ![Appointment 1](https://mintcdn.com/zuperinc/CdA_w-7zBfaE58Db/images/Appointment-1.png?fit=max\&auto=format\&n=CdA_w-7zBfaE58Db\&q=85\&s=5ef512cfcf3bba2b524576e5580fce97) * **Schedule**: Click the ***Unscheduled*** icon and choose either Manual or Assisted scheduling. * **Assign**: Click the ***Assignee*** icon and select the user you want to assign to the appointment. ### Appointment status on the Jobs list The Jobs list shows the status of each job’s appointments in the Scheduled Date column. Use the colored status bar to identify appointments that need scheduling or follow-up without opening the job. * **Grey**: The appointment is unscheduled. * **Blue**: The appointment is scheduled. * **Green**: The appointment is completed. ![SCR 20260806 Pwzn](https://mintcdn.com/zuperinc/C5CCZtoZHyFPYcZ2/images/SCR-20260806-pwzn.png?fit=max\&auto=format\&n=C5CCZtoZHyFPYcZ2\&q=85\&s=6e5bf0556f60693a94ff6e65b483229a) When a job has multiple appointments, the bar is divided into one segment for each appointment. Each segment shows the status of its corresponding visit, so you can review all appointment statuses from a single job row. ### Frequently Asked Questions > [accordion] When should I use Appointments instead of a Recurring Job? > > * Use Appointments when a single job needs multiple visits to the customer site with no fixed schedule. For example, a repair or replacement that spans several days, where each visit happens as the work requires rather than on a set cadence. > * Use a Recurring Job when you need to visit the customer site at a regular frequency, such as monthly or yearly maintenance. A recurring job carries only one appointment, since appointments are meant for irregular, as-needed visits rather than fixed intervals. > [accordion] Does scheduling one appointment schedule the entire job? > > No. Scheduling affects only the selected appointment. Other appointments associated with the same job keep their existing schedules. > [accordion] Can different appointments have different technicians? > > Yes. Each appointment can be assigned to different users or teams. > [accordion] What happens when I assign a technician to an appointment task? > > The technician is assigned to the task and will also be added to the associated appointment and parent job. > [accordion] Can a task belong to multiple appointments? > > No. A task can be linked to only one appointment. > [accordion] Can a purchase order be linked to multiple appointments? > > Yes. A purchase order can be linked to multiple appointments when the same materials are needed across visits. > [accordion] Does an unfulfilled purchase order stop me from working on the appointment? > > No. A purchase order linked to an appointment remains visible on the appointment card as long as it hasn’t been fulfilled. Once it's fulfilled, it no longer shows on the card. Either way, it doesn't block you from working on or completing the appointment. > [accordion] If I reorder tasks, can a task move to a different appointment? > > Yes. On the **Tasks** tab, tasks are grouped by the appointment they belong to. In reorder mode, dragging a task into another group re-links it to that appointment. Reorder carefully so each task stays with the correct appointment.\\ > > ![SCR 20260806 Qegn](https://mintcdn.com/zuperinc/C5CCZtoZHyFPYcZ2/images/SCR-20260806-qegn.png?fit=max\&auto=format\&n=C5CCZtoZHyFPYcZ2\&q=85\&s=287c07c942fbf46a8bee97c68eae8946) > [accordion] How do notifications work when a job has appointments? > > Your existing [job notifications](/Settings/Modules/Jobs/configuring_job_notifications) continue to work when a job has appointments. Each one is based on a different trigger: > > * **Job Reminder** is based on the appointment start date and time. Customers can be reminded ahead of each scheduled visit. > * **Job Delay Alert** is based on the job start time, end time, due date, or status. > * **Job Status Alert** is based on the job status. > > Delay alerts and status alerts apply to the whole job, not to a single appointment. For example, an admin links a Job Status Alert to the On My Way status. When a technician sets the job to On My Way before a visit, the customer is notified. On a multi-visit job, the technician can set On My Way again, and the customer will be notified. > [accordion] Are appointments and tasks the same? > > No. They serve different purposes on a job. > > An appointment is the schedule for a visit. It defines when the visit happens and who is going, with its own schedule, assignees, and trade type. A task is the work itself, such as an inspection or a repair step to be completed during the visit. You can link tasks to an appointment to show which work belongs to which visit, or leave them unlinked. > [accordion] Are time logs tracked at the appointment level? > > No. Time logs are tracked at the job level. Work and travel time recorded by technicians roll up to the job as a whole, not to individual appointments. > [accordion] Where can I configure Appointment Types? > > You can configure appointment types from **Settings > Job Settings > Appointment Types**. Once configured, the appointment types are available in the **Appointment Type** dropdown when creating an appointment from the **job creation page**, **Job Details page**, or the **job creation side sheet** accessed from the **Dispatch Board, Calendar, and Projects** modules. > > After an appointment type is selected, it is associated with the appointment and can be viewed on the **appointment card** in Job Details. You can also enable the **Appointment Type** attribute in the **Dispatch Board** and **Calendar** settings to display the appointment type on appointment cards in those views. # Managing your appointments from the Dispatch Board Source: https://docs.zuper.co/Appointments/Understanding-the-Dispatch-Board Use the **Dispatch Board** to efficiently manage your users’ schedules and job appointments. You can quickly find appointments that need attention, assign the right technicians, schedule or reschedule visits, and review job and appointment details from one workspace. Each appointment can have its own date, time, assignees, trade type, tasks, and linked dependencies while remaining connected to the same parent job. This makes it easier to coordinate multi-day, multi-trade, and multi-crew work without creating separate jobs. For example, a roofing job can include separate appointments for inspection, material delivery, installation, and final verification. Each visit can be scheduled independently and assigned to the most suitable technician. From the Dispatch Board, you can now: * View all, unscheduled, assigned, or unassigned appointments. * Drag and drop appointments into technician time slots. * Add or change assignees. * Reschedule appointments. * Clear a schedule while keeping the appointment available for later planning. * Open the parent job or the selected appointment for more details. * Create another appointment when the job requires an additional visit. > [!NOTE] > > **Note**: Once your organization uses Appointments, the Dispatch Board always dispatches by appointment. You can't switch back to dispatching by job. ## Understanding the Dispatch Board The Dispatch Board contains four primary areas.\ * Appointment Queue * Users * Scheduler * Map Together, these views help you match the right technician with the right appointment at the right time. ## Find appointments that need attention The appointment queue helps you identify work that still requires action. Depending on your workflow, you may need to schedule appointments, assign technicians, or review appointments that have already been allocated. 1. Click the **Scheduling and Dispatching** module and select **Dispatch Board**.\ ![Navidispatchboard](https://mintcdn.com/zuperinc/9yxwoq2lp0l62RFQ/images/navidispatchboard.png?fit=max\&auto=format\&n=9yxwoq2lp0l62RFQ\&q=85\&s=d98d3f062328813350cc332912404545) 2. Select the required time zone. 3. Select a **Trade Type** when applicable. 4. (Optional) Select a Service Territory. 5. Select the required team. 6. Select the date you want to manage. 7. Open the appointment queue in the upper-left corner. 8. Select one of the following options: * **All Appointments** - Displays all the appointments available to you. * **Unscheduled Appointments** - Displays appointments without a confirmed start and end date and time. You can use this queue to schedule appointments. * **Assigned Appointments** - Displays appointments assigned to one or more users. You can use this queue to review work that has already been allocated. * **Unassigned Appointments** - Displays appointments that do not currently have an assigned user or team. You can use this queue when appointments need technicians.\ ![Appointments 04](https://mintcdn.com/zuperinc/f6sFQRHvQqyOEO4z/images/appointments-04.png?fit=max\&auto=format\&n=f6sFQRHvQqyOEO4z\&q=85\&s=c821678b9dde543d40a9d123d190ce34) Use **Search**, **Filter**, and **Sort** to quickly locate the appointments you need. ## View job and appointment details Before scheduling or assigning work, you may need additional information about the job or appointment. The Dispatch Board allows you to review details without leaving your current view. 1. Locate the appointment in the dispatcher queue and right-click on it. 2. Select one of the following options: 1. **View Job Details** 2. **View Appointment Details**\ ![Appointments 05](https://mintcdn.com/zuperinc/f6sFQRHvQqyOEO4z/images/appointments-05.png?fit=max\&auto=format\&n=f6sFQRHvQqyOEO4z\&q=85\&s=2da895ae54cf780ab2411cef0c113ddd) Zuper opens the selected record in a side panel without taking you away from the Dispatch Board. ## View all appointments associated with a job 1. Select **View Job Details**. 2. Click the **Appointments** tab. 3. Review all appointments associated with the job.\ ![Appointments 06](https://mintcdn.com/zuperinc/f6sFQRHvQqyOEO4z/images/appointments-06.png?fit=max\&auto=format\&n=f6sFQRHvQqyOEO4z\&q=85\&s=33ea1a0a8b168ea4355c2e7287e8d9fe) 4. Select an appointment to view its details. ## Create a new appointment When an existing job requires an additional appointment, you can create it from the Dispatch Board itself. To do so, click the **+ Create Appointment** on the View Detail page. See [Add Appointments](/Appointments/Appointments#add-appointments)\ ![Dispatchappointments](https://mintcdn.com/zuperinc/b4MitVWIKwieURlq/images/Dispatchappointments.png?fit=max\&auto=format\&n=b4MitVWIKwieURlq\&q=85\&s=5fbf163655228952eda4e176f2b8aa5f) ## Schedule an appointment Unscheduled appointments appear in the appointment queue and are ready to be placed for a technician. Scheduling an appointment reserves a time slot and assigns responsibility for the visit. 1. On the appointment queue, select **Unscheduled Appointments**. 2. Select the required team and date. 3. Review the appointment details, including the parent's job, trade type, and due date. 4. Locate an available technician in the **Users** section. 5. Drag the appointment from the queue to an available time slot in the technician's scheduler row. The **Schedule dialog** opens. 1. Enter or review the Appointment Start Time. 2. Enter or review the Appointment End Time. 3. Turn on **All day** when the appointment should cover the entire day. Zuper sets the start and end times to your business hours. 4. Click **Assign** to add technicians when required. 6. Click **Update**.\ ![1786011942803305](https://mintcdn.com/zuperinc/dOKfVhBf-Ly86s38/images/1786011942803305.gif?s=8134c2f25b8a1322f88a20bbfffd93b5) Zuper schedules the appointment, assigns it to the selected technician, and displays it in the technician's scheduler row. ## Assign or reassign technicians As schedules change throughout the day, you may need to add technicians or move work between team members. The Dispatch Board allows you to update assignments. ### Assign additional technicians 1. Drag the appointment to a technician's scheduler row. 2. In the **Schedule** or **Reschedule** dialog, click **Assign More**. 3. Select the additional users.\ ![User Assignment](https://mintcdn.com/zuperinc/4oWkErWZPXMhTcgT/images/user-assignment.png?fit=max\&auto=format\&n=4oWkErWZPXMhTcgT\&q=85\&s=593fc44819540859845abf0bee998c2f) 4. Review the appointment start and end times. 5. Click **Update**. Zuper adds the selected users to the appointment. ### Reassign an appointment 1. Locate the appointment in the scheduler. 2. Drag the appointment from the current technician's row to another technician's row. The **Reschedule dialog** opens. 3. Review the new technician assignment. 4. Confirm the appointment start and end times. 5. Click **Update**. Zuper assigns the appointment to the selected technician. ## Reschedule an appointment Schedules often change because of customer availability, technician workload, weather conditions, or project timelines. You can reschedule an appointment without affecting any other appointments associated with the same job. 1. Select Assigned Appointments or locate the appointment in the scheduler. 2. Drag the appointment to a different time slot or technician. The Reschedule dialog opens. 1. Update the Appointment Start Time. 2. Update the Appointment End Time. 3. Turn on All Day when required. 4. Review the assigned users. 5. Click **Assign More** to add additional users when needed. 3. Click **Update**.\ ![1786012116491435](https://mintcdn.com/zuperinc/dOKfVhBf-Ly86s38/images/1786012116491435.gif?s=108ce6117e6bb383df7a617228a3767e) Zuper updates only the selected appointment. ## Clear an appointment schedule If an appointment is still required but the date and time are no longer confirmed, you can remove the schedule and return the appointment to the queue for future planning. 1. Open the Reschedule dialog for the appointment. 2. Click **Clear Schedule**.\ ![Clearschedule](https://mintcdn.com/zuperinc/O9p2OPkSjvzQYGpw/images/clearschedule.png?fit=max\&auto=format\&n=O9p2OPkSjvzQYGpw\&q=85\&s=ec5a46f09d792be741702f1c0db184ac) 3. Confirm the action when prompted. The appointment returns to the Unscheduled Appointments queue.\ Clearing the schedule removes only the scheduled date and time. The appointment remains associated with the job and can be scheduled again later. # Managing appointments from the Calendar Source: https://docs.zuper.co/Appointments/manage-appointments-from-calendar The Calendar provides a centralized workspace for planning, scheduling, and managing appointments. Instead of viewing appointments one at a time, the Calendar gives you a visual overview of scheduled and unscheduled appointments, helping you balance workloads, identify scheduling gaps, and coordinate upcoming visits. Whether you're scheduling new appointments, adjusting existing schedules, or reviewing upcoming work, the Calendar helps you stay organized. > [!NOTE] > > Using the classic Calendar? See [Calendar](/Scheduling_and_Dispatching/Calendar) for information about scheduling jobs. ## Accessing calendar * Select the **Scheduling & Dispatching module** icon from the left navigation menu and choose **Calendar**.\ ![Navicalendar](https://mintcdn.com/zuperinc/9yxwoq2lp0l62RFQ/images/navicalendar.png?fit=max\&auto=format\&n=9yxwoq2lp0l62RFQ\&q=85\&s=baaaf5780a017720526d0af9762a82c6) The calendar will display events based on the selected view. You can **filter** the Calendar by *Job Category*, *Teams*, *Users*, and other configured conditions. ## Understanding the Calendar The Calendar brings everything you need to manage appointments into a single workspace.\ ![SCR 20260806 Ouwe](https://mintcdn.com/zuperinc/C5CCZtoZHyFPYcZ2/images/SCR-20260806-ouwe.png?fit=max\&auto=format\&n=C5CCZtoZHyFPYcZ2\&q=85\&s=804cfe6f02958a49969dd924370f8afa) * **Calendar Views:** Switch between Month, Week, and Day views depending on how you want to review the schedule. * **Date Navigation**: Use the navigation controls to move between dates, jump to today, or select a specific date from the mini calendar. * **Filters**: Use filters to focus on the appointments you want to see. ## View scheduled appointments Scheduled appointments appear directly on the Calendar based on their assigned date and time. Depending on the selected view, you can quickly review upcoming work, technician commitments, and appointment distribution across your schedule. 1. Select the required Calendar view and date range. 2. Locate the appointment. 3. Click the appointment to view its details.\ ![SCR 20260806 Ozab](https://mintcdn.com/zuperinc/C5CCZtoZHyFPYcZ2/images/SCR-20260806-ozab.png?fit=max\&auto=format\&n=C5CCZtoZHyFPYcZ2\&q=85\&s=c1220fa0cd7b46b800dcf9dd02deccd5) ## View unscheduledunscheduled appointments Not every appointment is scheduled immediately. Unscheduled appointments remain available in a dedicated queue until you're ready to schedule. 1. Click **Unscheduled Appointments** in the upper-right corner. 2. A list of unscheduled appointments might appear. 3. Drag the appointment from the side panel to the required date and time. 4. Enter or confirm the Appointment Start Time. 5. Enter or confirm the Appointment End Time.\ ![SCR 20260806 Oxqr](https://mintcdn.com/zuperinc/C5CCZtoZHyFPYcZ2/images/SCR-20260806-oxqr.png?fit=max\&auto=format\&n=C5CCZtoZHyFPYcZ2\&q=85\&s=35841ccbbee7a234d63813b63c562862) 6. Turn on **All day** when the appointment should cover the entire day. Zuper sets the start and end times to your business hours. 7. Click **Update**. Once the appointment is scheduled successfully, you can view the job, reschedule, add a note, clone, delete the appointment,, or clear the schedule by right-clicking on the appointment card. ## Create a new job from the calendar You can create a job directly from the calendar, without navigating away from the scheduling interface. * Click Create Job in the top-right corner, or click and drag over the time slot you want the job scheduled for. See [Creating a new job](/Work_Order_Management/Jobs/creating_a_new_job) and [Appointments](/Appointments/Appointments#add-appointments) for how to fill in the job and appointment details. * The job is created with its first appointment already scheduled and assigned, so there's no separate step needed to set up that initial visit. ## Create and review non-job events A non-job event refers to any activity that a field technician or employee participates in that is not directly linked to a specific job. These events can include meetings, training sessions, administrative tasks, or any other non-job-related activities. To create a new non-job event from the calendar, refer to [Non-Job event](/Dispatch/Create_manage_non_job_event). ## Create and review a time-off request Manage technician availability effectively by adding time-off requests directly in the calendar. This feature helps plan workloads efficiently while ensuring seamless scheduling. To create a new time-off request from the calendar, refer to [Time-Off](/Scheduling_and_Dispatching/Calendar#3-create-and-review-timeoff-requests). # Work with appointments in the Zuper Mobile app Source: https://docs.zuper.co/Appointments/work-with-appointments-in-the-zuper-mobile-app An appointment is a scheduled visit for a job. When a job needs more than one visit, each visit can have its own schedule, assignee, and tasks. From the Zuper Field Service app, you can check your scheduled appointments, review the work planned for each visit, and complete the associated tasks. ## Check your appointments for the day Start your day from the Home screen, where every visit assigned to you is listed so you know where to be and when.\ ![Mobileappointment 01](https://mintcdn.com/zuperinc/XULQ1W6kzMhnRzHd/images/Mobileappointment-01.png?fit=max\&auto=format\&n=XULQ1W6kzMhnRzHd\&q=85\&s=ea40a71424d6dc6561b4afbc4e82e277) 1. Open the **Zuper Mobile** app. 2. On the **Home** tab, scroll to the **Appointments** section. 3. Review the appointments scheduled for you. > [!TIP] > > **Tip**: Use the date selector to view appointments for other days. 4. Tap an appointment to open it. When you open an appointment, Zuper takes you to the related job and displays the selected appointment along with the tasks linked to that visit. ## Complete the tasks for an appointment Tasks linked to an appointment represent the work planned for that visit. Complete them as you go so your progress stays tied to the right visit.\ ![Mobileappointment 02](https://mintcdn.com/zuperinc/XULQ1W6kzMhnRzHd/images/Mobileappointment-02.png?fit=max\&auto=format\&n=XULQ1W6kzMhnRzHd\&q=85\&s=a709fc6a6fd4e149ae58336712a7779d) 1. On the appointment details page, go to the **Tasks** tab. 2. Tap a task to open it. 3. Perform the task and update the task status. 4. If a checklist or inspection form is attached, complete it before you mark the task as completed. For more information, see [Tasks](/Zuper_Mobile_Apps/Tasks). ## Reschedule an appointment Reschedule an appointment when the visit needs to move to a different date or time. This lets you manage your own schedule from the field. 1. Open the appointment. 2. Tap the **schedule** icon (date and time), then select **Edit**. 3. On the **Schedule** screen, change the date and time, or turn on **All day** if needed.\ ![Mobileappointment 03](https://mintcdn.com/zuperinc/XULQ1W6kzMhnRzHd/images/Mobileappointment-03.png?fit=max\&auto=format\&n=XULQ1W6kzMhnRzHd\&q=85\&s=f07305ade4d130accd77ae3a03e4c1c5) 4. Tap **Done** to save your changes. > [!TIP] > > If you are already dispatched to or arrived at the visit, do not reschedule it. Add a [new appointment](/Appointments/work-with-appointments-in-the-zuper-mobile-app#add-an-appointment) for the additional work instead. ## Assign technicians to an appointment Bring another technician on a visit when the work needs more than one person. You can add technicians to any appointment assigned to you. 1. On the appointment details page, tap the **Assign** icon. Your name appears here as the current assignee. 2. Choose **Assign users** to pick team members yourself, or **Assisted schedule** to let Zuper suggest available users.\ ![Mobileappointment 04](https://mintcdn.com/zuperinc/XULQ1W6kzMhnRzHd/images/Mobileappointment-04.png?fit=max\&auto=format\&n=XULQ1W6kzMhnRzHd\&q=85\&s=653af0525f0978058449ccd72ef838a7) 3. Select the users you want to add to the appointment. ## Add an appointment Create a new appointment when a job needs another visit, or hand it to the office to schedule for you. > [!NOTE] > > **Note**: Creating an appointment requires the appropriate permission for your role. Contact your administrator if you need access. 1. Open the job and go to the **Details** tab. 2. In the **Appointments** section, tap the **+** icon. 3. On the **New Appointment** screen, enter an **Appointment title**. 4. Enter a **Description**. This step is optional. 5. Tap **Assign users**, then choose **Assign users** to pick team members yourself, or **Assisted schedule** to let Zuper suggest available users. 6. Tap **Select date & time**. On the **Schedule** sheet, turn on **All day**, or set the **Date**, **From**, and **To** times, then tap **Done**. 7. Tap **Create**.\ ![Imageappointment 06](https://mintcdn.com/zuperinc/Wb4QcjSokQ9E3RoP/images/imageappointment-06.png?fit=max\&auto=format\&n=Wb4QcjSokQ9E3RoP\&q=85\&s=fd22e3810e79b211b922f2f42724adfe) Your new appointment appears in the job's **Appointments** section. ## Frequently asked questions > [accordion] How do I mark an appointment as completed? > > Complete the tasks associated with the appointment, then update the job to match your organization's workflow. > [accordion] Can I add another appointment? > > Yes. You can add another appointment from the **Appointments** section of the job. > [accordion] Can I edit an appointment? > > Yes. Open the appointment, tap the **More options** icon, and select **Edit**. > [accordion] How can I see all the tasks associated with a job? > > On the job's **Details** page, go to the **Tasks** tab and turn on **All Tasks** to list every task associated with the job. # Channels Source: https://docs.zuper.co/Chat/Channels **Channels in Zuper** are shared spaces that help teams to communicate and collaborate in an organized way. By grouping related conversations in one place, channels make it easy to share updates, keep discussions focused, and find important information when needed.  Whether you’re coordinating across the entire organization, collaborating within a department, managing a project, or discussing a specific job in the field, channels ensure the right people have access to the right information at the right time.  Here are some examples of how teams commonly use channels:  * Company-wide announcements and updates. * Department-specific discussions (e.g., Service, Sales, Operations)  * Project coordination or recurring operational workflows  * Job-specific communication for seamless field-to-office alignment  # **Types of Channels**  Zuper offers three primary types of channels to cater to various needs.  ## 1. The General Channel  Every organization in Zuper automatically has a **#general** channel. All users are added to this channel by default.  You can use the **#general** channel for:  * Organization-wide announcements  * All-hands updates  * Information everyone needs to stay aligned  > [!NOTE] > > Note: The General channel cannot be archived. ## **2. Job-Specific Channels**  Job-specific channels are one of the most powerful features for field service teams.  These channels are directly linked to a particular job in Zuper and make it easy to keep all job-related communication in one place.  > [!NOTE] > > **UI Update:**\ > We've repositioned **Job Channels** into a dedicated section in the sidebar, separate from your other channels, for quicker access. **With job-specific channels, you can:**  * Start a conversation instantly from the **Job Details page → Chat section**  * Share files, documents, and photos from the field  * Exchange real-time updates as the job progresses. * Receive automated real-time job updates such as clock-in/out, quote acceptance/rejection status, invoice payments, status updates, and user assignment. ![Jobchannelchat](https://mintcdn.com/zuperinc/gV50wMTlFvFF0TSp/images/jobchannelchat.png?fit=max\&auto=format\&n=gV50wMTlFvFF0TSp\&q=85\&s=a81c6909506fa88c2e7ee2f395bf2f1f) > [!NOTE] > > **Note**: Anyone who has permission to view the job can see and send messages in its channel. However, only users who are assigned to the job or manually added as channel members will receive notifications for new messages. ## **3. Custom Channels**  Custom channels are spaces you can create for ongoing topics, specific teams, or projects. They let you organize conversations to match the way your team works and keep communication focused.  # **Create and manage channels** ## Creating a Channel You can create a channel to organize conversations around a team, project, operation, or topic. To start a custom channel: > [tab] Web > > * Click the Work Order Management/Job module from the left navigation menu and select **Chat**.   > * Click the **+** icon in the header.  > * Select **Create a Channel**.  > * Enter a **channel name**.  > * Add members to the channel (optional—you can do this after the channel is created as well). > * Click **Create**. A new channel will be created successfully. > > [https://drive.google.com/file/d/1dTg\_64\_FV4wUpCnw8EX0r6Fzec5tz9yN/preview](https://drive.google.com/file/d/1dTg_64_FV4wUpCnw8EX0r6Fzec5tz9yN/preview) > [tab] Mobile > > * In the Chat home page, tap the **+** icon at the bottom. > * Tap **Create Channel**.  > * Enter a channel name.  > * Search and add members to the channel.  > * Tap **Create** to finish. > > [https://drive.google.com/file/d/1eGhbLoD\_4GEatXgFQ4IhGQY\_uFTLrA-C/preview](https://drive.google.com/file/d/1eGhbLoD_4GEatXgFQ4IhGQY_uFTLrA-C/preview) > [!NOTE] > > **Note**: Job-specific channels form automatically from the job page and keep their names fixed. However, you can edit names for custom channels if needed. ## Adding Members to a Channel  > [tab] Web > > * Open the channel you want to add people. > > * Click the member avatars in the top right of the channel header. From there, add or remove members. > > > [!NOTE] > > > > Note: Admins can include anyone. Team leads and field executives can add members from their own teams. > > * Click **Add Members**. > * Select the members and click "**Add**." The selected member(s) will be added to the channel successfully. > > [https://drive.google.com/file/d/1oN5g1Cr2md1C3N68-N\_f8KV5r2W9V3Wh/preview](https://drive.google.com/file/d/1oN5g1Cr2md1C3N68-N_f8KV5r2W9V3Wh/preview) > [tab] Mobile > > * Open the channel you want to add members to. > * Tap the channel name at the top of the chat window. The Channel Details page opens. > * Tap **+Add** at the top-right corner of the Channel Details page to select and add new members to the group. > > [https://drive.google.com/file/d/1zfBReznwqoeLHlYF7WnLT-RC5FWB7xH9/preview](https://drive.google.com/file/d/1zfBReznwqoeLHlYF7WnLT-RC5FWB7xH9/preview) > [!NOTE] > > Note: The channel creator becomes the Channel Manager by default and can assign others. Channel Managers handle membership and moderation. ## Set a Notification Preference Updated You can control how you are notified for each channel. Zuper gives you two levels of control, a global preference for all channels, and a channel-level preference for individual channels. > [accordion] Global notification preference > > Your global preference sets the default notification behavior across all channels. > > > [tab] Web > > > > **Web** > > > > 1. Click the **Chat**  icon in the top-right corner of the Header bar. > > 2. Click the  icon. A **Notification Preference** panel opens. > > 3. Choose one of the following: > > * **All**: You receive a notification for every message in every channel. This is the default. > > * **Mentions and Direct Messages**: You are only notified when someone mentions you or sends you a Direct Message. > > 4. Your preference is saved immediately. > > > [!NOTE] > > > > > > **Note:** This setting applies to all channels where no channel-level preference has been set. > > > ![Notification 01](https://mintcdn.com/zuperinc/OZ1pujpaUp5LzUin/images/notification-01.gif?s=fb0ebe3d2a282e6215b9b7825e709dda) > > > [tab] Mobile > > > > 1. In the **Chat** home, tap on the icon. > > 2. Choose **Everything** or **Mentions**. > > > > [https://drive.google.com/file/d/1ncI1JKQjjZgm2xV2ZBMRrp0O0gZO6QqI/preview](https://drive.google.com/file/d/1ncI1JKQjjZgm2xV2ZBMRrp0O0gZO6QqI/preview) > [accordion] Channel-level notification preference > > You can override your global preference for any individual channel. Channel-level preferences always take precedence over your global settings. > > > [!NOTE] > > > > **Note:** Once a channel-level preference is set, it cannot be overridden by the global preference. > > > [tab] Web > > > > 1. Open the channel and click **More actions (⋮)** in the channel header. > > 2. Select **Notification Preference**. > > 3. Choose one of the following: > > * **All**: You receive a notification for every message in this channel. > > * **Mentions**: You are only notified when someone mentions you in this channel. > > * **Mute**: You receive no notifications from this channel. > > > > ![Notification 02](https://mintcdn.com/zuperinc/OZ1pujpaUp5LzUin/images/Notification-02.gif?s=18de5df1b6a9f758bbb64add815994d8) > > > [tab] Mobile > > > > 1. In the Chat home, tap and hold the channel name, or open the channel and tap its name to open the details page. > > 2. Select **Notification Preference**. > > 3. Choose **Muted**, **Everything**, or **Mentions**. > > > > [https://drive.google.com/file/d/1FPQIzaCKmrvay3XUgjRGLj2LvyyMhBN5/preview](https://drive.google.com/file/d/1FPQIzaCKmrvay3XUgjRGLj2LvyyMhBN5/preview) ### Muting a channel You can mute a channel when you want to reduce notifications but still read messages later. > [tab] Web > > * Hover over the channel name in the sidebar.  > * Click the **More actions (⋮)** icon.  > * Select **Mute Channel** to stop receiving notifications. > * To unmute, repeat the same steps and select **Unmute Channel**.  > > [https://drive.google.com/file/d/1knsTzSriGg1aNv6SArwjjRTEsE\_dZFxc/preview](https://drive.google.com/file/d/1knsTzSriGg1aNv6SArwjjRTEsE_dZFxc/preview) > [!NOTE] > > Note: After opening a channel conversation, click the channel name at the top to view the job details. ## Pinning a Channel Pinning a channel keeps your most active or critical conversations at the top of your sidebar (on web) or chat home (on mobile) for quick access. > [tab] Web > > * Hover over the channel name in the sidebar. > * Click the **More Actions** (⋮) icon and select **Pin this channel**. > * The pinned channel will now appear in the **Pinned Conversations** section for quick access > * To unpin, repeat the same steps and select **Unpin this channel**. > > Alternatively, you can also pin a channel from its details page. > > * Open the channel that you want to pin. > * Click the **More actions** (⋮) icon at the top right of the channel header. > * Select **Pin Channel**. > > [https://drive.google.com/file/d/1UHq2Xdj07c\_HXPXfUV49wJjgd7pHUKJb/preview](https://drive.google.com/file/d/1UHq2Xdj07c_HXPXfUV49wJjgd7pHUKJb/preview) > [tab] Mobile > > * In the Chat Home, tap and hold the channel name. A pop-up menu appears. > * Select **Pin channel**. > * The pinned channel will now appear in the **Pinned Conversation** section for quick access. > * To unpin, tap and hold again and select **Unpin channel**. > > [https://drive.google.com/file/d/1VI4ikmO\_7rZKjtKTWrKqiUoXIIfqKjUs/preview](https://drive.google.com/file/d/1VI4ikmO_7rZKjtKTWrKqiUoXIIfqKjUs/preview) ## Archiving a Channel When a topic or project is complete, archive it to make it read-only and clean up your active list (can be restored later if needed). > [!NOTE] > > Note: Archiving a channel archives it for everyone in the channel. > [tab] Web > > * Open the channel that you want to archive from the sidebar. > * Click the **More actions** (⋮) icon at the top right of the channel header and select  **Archive for everyone**. > > [https://drive.google.com/file/d/1QOAJum27o0a357kihxjLuiSwkU9829n9/preview](https://drive.google.com/file/d/1QOAJum27o0a357kihxjLuiSwkU9829n9/preview) > > > [!NOTE] > > > > **Note:** The #*general* channel cannot be archived. > [tab] Mobile > > * In the Chat Home, tap and hold the channel name. A pop-up menu appears. > * Select **Archive for everyone**. > > [https://drive.google.com/file/d/1p1lAt61pX8nDjKEbpJYbx3tfj69Fb-tB/preview](https://drive.google.com/file/d/1p1lAt61pX8nDjKEbpJYbx3tfj69Fb-tB/preview) > > > [!NOTE] > > > > **Note:** The #*general* channel cannot be archived. # Leaving a Channel  Leaving a channel removes you completely from the channel if it’s no longer relevant to you (no more access or notifications). > [tab] Web > > * Hover over the channel name in the sidebar. > * Click the **More Actions** (⋮) icon and select **Leave this channel**. > > Alternatively, you can also leave a channel from the details page.  > > * From the channel details page, click the **More actions** (⋮) icon in the channel header and select **Leave Channel**. > > [https://drive.google.com/file/d/1\_udI9ZcwK2XHtESOCe07tLiYX5nlvQmT/preview](https://drive.google.com/file/d/1_udI9ZcwK2XHtESOCe07tLiYX5nlvQmT/preview) > [tab] Mobile > > * In the Chat Home, tap and hold the channel you want to leave. > * From the pop-up menu, select **Leave Channel**. > > Alternatively, you can also leave a channel or group from its details page. > > * Open the channel you want to leave from the Chat Home. > * Tap the channel name at the top of the chat window to open the details page. > * Select **Leave channel**, then confirm to exit the channel. > > [https://drive.google.com/file/d/1YaHlLGIb0yUfdAAzIbc00Q9if-jIZ\_vx/preview](https://drive.google.com/file/d/1YaHlLGIb0yUfdAAzIbc00Q9if-jIZ_vx/preview) > [!NOTE] > > **Note**: Once you leave a channel, you will no longer see messages or receive notifications from this channel. # Assigning a Channel Manager The person who creates a channel automatically becomes its **Channel Manager**. Channel Managers can:  * Add/remove members  * Delete messages  * Assign additional managers  > [tab] Web > > * Open the channel where you want to assign a user as a channel manager. > * Click the member avatars in the top right of the channel header. > * Hover over a member and click the **More actions** (⋮) icon next to the member’s name. > * Select **Make Channel Manager**. ![Channelmanagerweb](https://mintcdn.com/zuperinc/73hFknghzmqIdYuF/Chat/Channelmanagerweb.png?fit=max\&auto=format\&n=73hFknghzmqIdYuF\&q=85\&s=15d5fd281d8e105965fb8b77221719be) > [tab] Mobile > > * Open the channel and tap its name at the top. > * In the member list, select a user. > * Choose **Make Channel Manager**. > > [https://drive.google.com/file/d/1-tX2z-QAp8VHR7QZHvJYPZ3FfIZ8kQQS/preview](https://drive.google.com/file/d/1-tX2z-QAp8VHR7QZHvJYPZ3FfIZ8kQQS/preview) > [!NOTE] > > Note: The assigned member will now have channel manager privileges and can manage channel settings, add or remove members, and moderate content. # Removing a Member from a Channel Removing a member from a channel restricts access for individuals who no longer need to participate in the conversation. > [tab] Web > > * Open the channel from which you want to remove a member. > * Click the member avatars in the top-right of the channel header to view all members. > * Hover over the member’s name and click the **More actions** (⋮) icon. > * Select **Remove from Channel**. ![Removememberchannelweb](https://mintcdn.com/zuperinc/73hFknghzmqIdYuF/Chat/Removememberchannelweb.png?fit=max\&auto=format\&n=73hFknghzmqIdYuF\&q=85\&s=c3493ca6459d651d3d3460a4dab52e7d) > [tab] Mobile > > * Open the channel from which you want to remove a member. > * Tap the channel name at the top of the chat window to view existing members. > * From the members list, select a member. > * Choose **Remove from Channel**. > > [https://drive.google.com/file/d/1-tX2z-QAp8VHR7QZHvJYPZ3FfIZ8kQQS/preview](https://drive.google.com/file/d/1-tX2z-QAp8VHR7QZHvJYPZ3FfIZ8kQQS/preview) The removed member will no longer have access to the channel or its messages. With Channels in Zuper Chat, your team can move faster, reduce scattered messages, and keep job-related discussions tightly connected to the actual work, all while maintaining clear organization and focus.  Whether you're in the office or on-site, Zuper Chat helps ensure nothing falls through the cracks.  # Direct Messages Source: https://docs.zuper.co/Chat/Direct-Messages A Direct Message (DM) is a private, one-to-one conversation between users that happens outside of channels. For instance, you can use DMs to quickly ask questions, clarify details with a specific user, or follow up on tasks, jobs, or requests without involving a larger audience.   > [!NOTE] > > **Note**: Admins can initiate direct messages with any user. Field Executives (FEs) and Team Leads (TLs) can start direct messages only with users within their own team. However, they can still access and continue direct messages that have already been initiated by admins. # Starting a New DM   To initiate a private conversation with a user in Zuper, follow these steps: > [tab] Web > > * Click the **+ icon** in the header.  > * Select **New Direct Chat**  > * Search for the member’s name and select them to start a DM.  > > [https://drive.google.com/file/d/1dwPBHs\_tyLeiPETLEBdfJbumpp6A\_wV7/preview](https://drive.google.com/file/d/1dwPBHs_tyLeiPETLEBdfJbumpp6A_wV7/preview) > [tab] Mobile > > * In the **Chat Home**, tap the **+** icon at the bottom-right.  > * Search for the user and tap their name to start a new DM.  > > [https://drive.google.com/file/d/1jCuzK8CoVJG\_2pC\_nmnUUChVokdRcom8/preview](https://drive.google.com/file/d/1jCuzK8CoVJG_2pC_nmnUUChVokdRcom8/preview) # Muting a DM  Muting a conversation helps you minimize distractions by pausing notifications from a direct message. You can still view messages at any time, but they just won’t trigger alerts or show the unread count.  > [tab] Web > > * Hover over the DM in the sidebar  > * Click the **More actions** (⋮) icon.  > * Select **Mute this conversation** to stop receiving notifications.  > * To unmute, repeat the same steps and select **Unmute this conversation**.  > > Alternatively, you can also mute a conversation from its details page.  > > * Open the DM that you want to mute.  > * Click the More actions (⋮) icon in the DM header and select **Mute Conversation**. > > [https://drive.google.com/file/d/1bCsCiocgZKk5Eq3uu2Wpo6ycxnaO3ii7/preview](https://drive.google.com/file/d/1bCsCiocgZKk5Eq3uu2Wpo6ycxnaO3ii7/preview) > [tab] Mobile > > * In the Chat Home, tap and hold the user name. A pop-up menu appears. > * Select **Mute conversation** to disable notifications. > * To unmute, tap and hold again and select **Unmute conversation**. > > Alternatively, you can also mute a conversation from its details page. > > * Open the user name that you want to mute. > * Tap the username at the top of the chat window. > * In the conversation details page, **toggle on Mute** **conversation** to disable notifications. > > [https://drive.google.com/file/d/1A96t\_GAy94BlPdynk8stNRQajrUu1DyH/preview](https://drive.google.com/file/d/1A96t_GAy94BlPdynk8stNRQajrUu1DyH/preview) # Pinning a DM  Pinning a conversation keeps it at the top of your sidebar (Web) or Chat Home (Mobile) under Pinned conversations, making frequently used DMs easy to access.  > [tab] Web > > * Hover over the DM in the sidebar.  > > * Click the More actions (⋮) icon.  > > * Select **Pin this conversation** to keep it at the top of your list.  > > * To unpin, repeat the same steps and select **Unpin this conversation**.  > > Alternatively, you can also pin a conversation from its details page.  > > * Open the DM that you want to pin.  > * Click the More actions (⋮) icon in the DM header and select **Pin Conversation.** > > [https://drive.google.com/file/d/1J8s\_oVx5Iu0aEio252qTxlpnEPe9WzV5/preview](https://drive.google.com/file/d/1J8s_oVx5Iu0aEio252qTxlpnEPe9WzV5/preview) > [tab] Mobile > > * In the **Chat Home**, tap and hold the user name. A pop-up menu appears.  > * Select **Pin conversation**.  > * To unpin, tap and hold again and select **Unpin conversation**.  > > [https://drive.google.com/file/d/1hD3IcN16NOlHqPeguhW5d2yL32ZIr80u/preview](https://drive.google.com/file/d/1hD3IcN16NOlHqPeguhW5d2yL32ZIr80u/preview) # Messages Source: https://docs.zuper.co/Chat/Messages The Chat module includes helpful message actions that make conversations easy to manage and follow. You can edit or delete messages, pin important updates, mark messages as unread, add attachments, react to messages, and reply in threads to keep discussions organized across channels and direct messages. # Editing a Message If you’ve made a typo or need to update the content, you can edit any message you’ve sent. > [!NOTE] > > **Note**: Channel Managers and Admins cannot edit messages sent by other users. > [tab] Web > > * Open the channel or DM from the sidebar > * Hover over the message you want to edit. > * Click the More Actions () icon. > * Select **Edit message**. > * Make your changes, then click the paper plane icon to send your updated message. > > ![Editmessageweb](https://mintcdn.com/zuperinc/fsB0q7T6Wx4nbo4Y/Chat/Editmessageweb.png?fit=max\&auto=format\&n=fsB0q7T6Wx4nbo4Y\&q=85\&s=8805c05921c7f8d5beca465d978a87a3) > [tab] Mobile > > * Open the channel or DM from the home page. > * Tap and hold the message you want to change. > * Select  **Edit Message** from the pop-up menu. > * Make your edits and then tap the paper plane icon to send the updated message.  > > ![Editmessage](https://mintcdn.com/zuperinc/fsB0q7T6Wx4nbo4Y/Chat/Editmessage.png?fit=max\&auto=format\&n=fsB0q7T6Wx4nbo4Y\&q=85\&s=6f6fcf7be39d0ace9272eebbefe9a7f0) > [!NOTE] > > Note: If you need to copy any message from a direct message chat to reuse or reference it elsewhere, select **Copy Message** from the menu. The text will be copied to your clipboard for reuse. # Deleting a Message If you no longer want a message to appear in a conversation, you can delete it. > [tab] Web > > * Open the channel or DM. > * Hover over the message you want to delete. > * Click the More Actions () icon. > * Select **Delete message**. > * Click **Delete** again to confirm. > > ![Deletemessageweb](https://mintcdn.com/zuperinc/fsB0q7T6Wx4nbo4Y/Chat/Deletemessageweb.png?fit=max\&auto=format\&n=fsB0q7T6Wx4nbo4Y\&q=85\&s=1232f0455ab4edb877e0c448886f16f1) > [tab] Mobile > > * Open the channel or DM. > * Tap and hold the message you want to delete. > * Select **"Delete Message"** from the pop-up menu, and then confirm by tapping **"OK"**. > > ![Deletemessage](https://mintcdn.com/zuperinc/fsB0q7T6Wx4nbo4Y/Chat/Deletemessage.png?fit=max\&auto=format\&n=fsB0q7T6Wx4nbo4Y\&q=85\&s=2d45cf991848a5d2cc549dd83ced9982) > [!NOTE] > > Note: Deleting a message is a permanent action that removes it for everyone in the channel or direct message. Channel Managers and Admins can delete messages of other users in a channel. # Pinning a Message Pinning a message allows you to highlight key information, such as important updates, links, or attachments, so that team members can easily refer to them later. > [tab] Web > > * Open a channel or DM. > * Hover over the message you want to pin and click the "**Pin**" icon. > * The message will now appear under the **Pinned** tab in the conversation header for all members to view. > > [https://drive.google.com/file/d/1Cv-dvM1Z1gb8G-FY6WFr7MQXYlit8DAQ/preview](https://drive.google.com/file/d/1Cv-dvM1Z1gb8G-FY6WFr7MQXYlit8DAQ/preview) > [tab] Mobile > > * Open the channel or DM. > * Tap and hold the message you want to pin. A pop-up menu appears. > * Select **Pin to this Chat**. > * You can then view the pinned message by tapping the channel or user name at the top of the chat window and selecting **Pinned messages**. > > [https://drive.google.com/file/d/1dMzRPlu5otJCsqMO1V\_suH-LAWxYLhCl/preview](https://drive.google.com/file/d/1dMzRPlu5otJCsqMO1V_suH-LAWxYLhCl/preview) # Marking Messages as Unread If you want to revisit a message later, you can mark any message as unread. This helps you stay organized by treating the message and the following messages as new until you’re ready to respond. > [tab] Web > > * Open a channel or DM. > * Hover over the message you want to mark as unread. > * Click the More actions ( ) icon. > * Select **Mark as Unread**. > > ![unreadweb](https://mintcdn.com/zuperinc/IYBzsRkjeFQRD9-5/Chat/unreadweb.png?fit=max\&auto=format\&n=IYBzsRkjeFQRD9-5\&q=85\&s=ed7d37629c0acb55cbd79ad757addfaa) > [tab] Mobile > > * Open the channel or DM. > * Tap and hold the message you want to mark as unread. A pop-up menu appears. > * Select **Mark as Unread**. > The message will then be highlighted as unread, making it easy for you to find later. > > ![unreadmobile](https://mintcdn.com/zuperinc/IYBzsRkjeFQRD9-5/Chat/unreadmobile.png?fit=max\&auto=format\&n=IYBzsRkjeFQRD9-5\&q=85\&s=1dbc174d8104b349fa9e451babbe7a7f) # Viewing Unread Messages You can easily access all messages you haven’t opened or have marked as unread from the sidebar or home. > [tab] Web > > * Navigate to the **Unread** tab in the Chat sidebar. > * You can view all conversations (DMs and Channels) with unread messages. > > [https://drive.google.com/file/d/1gohUMyPkTREa\_XhJLF\_JC75qxsDTBbAf/preview](https://drive.google.com/file/d/1gohUMyPkTREa_XhJLF_JC75qxsDTBbAf/preview) > [tab] Mobile > > * On the chat home screen, tap the **Unread** tab. > * This opens a feed of all unread messages, including DMs and channel messages. > * Tap a message to open it in the chat window. > > [https://drive.google.com/file/d/15YX9QgRr8lVESs5FqAh1khUja2YmIcQK/preview](https://drive.google.com/file/d/15YX9QgRr8lVESs5FqAh1khUja2YmIcQK/preview) > [!NOTE] > > **Note**: Once an unread message is opened, it is automatically marked as read. # Adding Attachments You can add attachments in Chat to share important files, images, or videos with your team, whether it’s a project brief, invoice copy, or photos from the field. You can easily access attachments in a conversation from the ‘**Files**’ and ‘**Photos** and **Videos**’ sections within a conversation. > [tab] Web > > * Click the paper clip icon in the message composer. > * Upload the necessary file(s) from your computer. > * Click the paper plane icon to send the message with the attachment. > > [https://drive.google.com/file/d/1iiDu-YycU3GZ6J-2BEDIpBUWSrKl5OeE/preview](https://drive.google.com/file/d/1iiDu-YycU3GZ6J-2BEDIpBUWSrKl5OeE/preview) > [tab] Mobile > > * Open the channel or direct message. > * Tap the **+** (plus) icon next to the message field. > * Choose from the available options: > 1. **Take a picture**: Capture and attach a photo instantly using your mobile camera. > 2. **Record a video**: Record a short video clip and share it directly in the chat. > 3. **Choose from gallery**: Select an existing photo or video from your device’s gallery. > 4. **Upload a file**: Attach documents, spreadsheets, PDFs, or other files stored on your device. > 5. **Scan a document**: Use your camera to scan and upload physical documents as images or PDFs. > > Once you’ve added the desired attachment, tap the paper plane icon to share it in the conversation. > > [https://drive.google.com/file/d/1NDlAXrskl\_7P-IRAke3\_YKQIDHSCojeq/preview](https://drive.google.com/file/d/1NDlAXrskl_7P-IRAke3_YKQIDHSCojeq/preview) # Using Emoji and Reactions Emoji reactions let you respond quickly without sending another message. > [tab] Web > > * Hover over the message and click the emoji icon. > * Select an emoji from the menu to send. > * To remove a reaction, click it again. > > ![Emoji](https://mintcdn.com/zuperinc/rlMzd-WVUuL9_BN5/images/Emoji.png?fit=max\&auto=format\&n=rlMzd-WVUuL9_BN5\&q=85\&s=dfa7d1dd78dbb99f6d952007d1b6197b) > [tab] Mobile > > * Tap and hold the message you want to react to. A pop-up menu appears. > * Tap the emoji you want to react with. > > ![Emoji](https://mintcdn.com/zuperinc/IYBzsRkjeFQRD9-5/Chat/Emoji.png?fit=max\&auto=format\&n=IYBzsRkjeFQRD9-5\&q=85\&s=b5d78244c78d08d113b451fe58f9781e) # Mentioning Users & Entities You can mention Users or share entities such as Jobs, Customers, Projects, Quotes, and Invoices directly in your messages. > [tab] Web > > * In the message composer, type @ or click on the icon. > * Select a user or entity from the list that appears or type the name to search. > * You can mention multiple users or share multiple entities in the same message. > * You can click the entity mentioned to open its details page for a complete view. > > [https://drive.google.com/file/d/1yl6nqS25rpz8ojiuXpHhXk8L8LoQPJnI/preview](https://drive.google.com/file/d/1yl6nqS25rpz8ojiuXpHhXk8L8LoQPJnI/preview) > [tab] Mobile > > * Tap the icon in the message composer. > * Select a user or entity from the list that appears, or type the name to search. > * You can mention multiple users or entities in the same message. > * You can click the entity mentioned to open its details page for a complete view. > > [https://drive.google.com/file/d/1LxvJpY1WmQsQQMYju9zapuPghdu8MzcP/preview](https://drive.google.com/file/d/1LxvJpY1WmQsQQMYju9zapuPghdu8MzcP/preview) > [!NOTE] > > Note: Mentioned users are notified and can access the messages in which they are mentioned from the "Mentions" tab in the Sidebar (web) and from Home (mobile). # Threads Threads help keep conversations organized by allowing you to reply directly to a specific message instead of starting a new conversation in the main chat. This makes it easier to follow discussions and maintain context within busy channels. ### Viewing Threads > [tab] Web > > * To view all your active or unread threads, click the **Ellipsis** (⋯) icon at the top right of the chat sidebar. > * Select **Threads** to open a list of all ongoing threaded conversations. > * Click any thread to open it directly in the chat window and view the complete discussion. > [tab] Mobile > > * On the chat home screen, tap the **Threads** tab. > * This opens a feed of all your active and unread threads. > * Tap any thread to open it and view the full conversation. ### Replying to Threads > [tab] Web > > * Open the specific channel or DM. > * Hover over the message you want to reply to. > * Click the thread reply icon. > * A **Thread Reply** panel opens on the right side of the chat window. > * Type your reply in the message field. You can also add attachments, mentions, or emojis if needed. > * Click the paper plane icon to send your threaded reply. > > [https://drive.google.com/file/d/1ClkRW1zMmhC8OCyk89yas\_7j2hT\_pezd/preview](https://drive.google.com/file/d/1ClkRW1zMmhC8OCyk89yas_7j2hT_pezd/preview) > [tab] Mobile > > * Open the specific channel or DM. > * Tap and hold the message you want to reply to. > * Select **Thread reply** from the pop-up menu. > * A thread view opens where you can type your reply. Add attachments and mentions as needed. > * Tap the paper plane icon to send your reply. > > [https://drive.google.com/file/d/15-XpwtESikpS-HTuCAql6x92-psWMu9d/preview](https://drive.google.com/file/d/15-XpwtESikpS-HTuCAql6x92-psWMu9d/preview) # Notifications You will be notified about new messages and mentions in DMs and Channels you are a member of. Notifications can be accessed from the Chat Notification centre in the web app. # Search in Chat Source: https://docs.zuper.co/Chat/Search The Search feature in Chat helps you quickly: * Locate specific users, messages, and channels across the chat module. * Sort message results by creation date. * Filter message results by sender or channel. > [tab] Web > > * Click the Search icon at the top right of the Chat sidebar. > * Type your keyword — for example, a user’s name, message content, or channel name. > * The search window displays categorized results under: > 1. **Messages** – Displays messages that include the search term. > 2. **Users** – Lists users whose names match your search term. > 3. **Channels** – Shows channels containing the keyword in their title. > > **Using Filters in Search (Messages Only)** > > Filters are available when the **Messages** tab is selected, and help refine your results: > > You can organize and narrow results using the following options: > > * **Sort** (Created At): Use the Sort option to organize message results by their created date (Newest or Oldest). > * **From**: Select and view messages shared by a specific user. > * **In:** Select and view the channels where the message was sent. > > After applying the required filters, select a search result to open the corresponding conversation directly. > > [https://drive.google.com/file/d/1Jn2pcHw1GqfRMl4aDFmICaHQpcHrbi8z//preview](https://drive.google.com/file/d/1Jn2pcHw1GqfRMl4aDFmICaHQpcHrbi8z//preview) > [tab] Mobile > > * In Chat Home, tap the Search bar. > * Enter a keyword to search across DMs, channels, and messages. Results will be categorized under Messages, Channels, and Users. > > **Using Filters in Search (Messages Only)** > > Filters appear only within the Messages tab: > > * Tap **Sort & Filter** to organize results by: > 1. Most Relevant- Displays messages that best match your search keywords. > 2. Newest: Shows the most recently sent messages first. > 3. Oldest: Displays the earliest sent messages first. > * After selecting a sort option, you can refine further using: > 1. **From** – Select and view messages shared by a specific user. > 2. **In** – Select and view the channels where the message was sent. > * Tap **Apply** to view the sorted results and select the desired search result to open the conversation directly in the chat window. > > [https://drive.google.com/file/d/14BB5Jo46dVePfZldT5wOXiiU3o-iJZgP/preview](https://drive.google.com/file/d/14BB5Jo46dVePfZldT5wOXiiU3o-iJZgP/preview) # Quick Start Guide Source: https://docs.zuper.co/Chat/quickstart-guide The Chat feature enables faster team communication and real-time alignment through instant messaging. Use **Direct Messages** (DM) for private one-to-one discussions and **Channels** for group collaboration on teams, jobs, or topics. Chat is available on the web (V3) and mobile apps. ## Pre-requisites Before you start, make sure the following requirements are met: * Chat is available on Web V3, iOS v4.0.3+, and Android v4.1.7+. * The Chat feature must be enabled for your organization. Contact your Customer Success Manager or email [support@zuper.co](mailto:support@zuper.co) to enable it. * Your access and actions depend on your role (Admin, Team Lead, Field Executive). ## Getting Started: Sidebar (Web) / Home (Mobile)  The Sidebar on web and the Home screen on mobile are where all conversations live.  From here, you can:  * View all conversations, including Direct Messages, Channels, and Pinned conversations. * Filter conversations by Unreads, Recents, Threads, or Mentions. * Start a new Direct Message or Channel. * Search across Messages, Users, and Channels. > [tab] Web > > [https://drive.google.com/file/d/18hbHd4u-4FZsHlDZJSvQj\_OnNCm2f4R\_/preview](https://drive.google.com/file/d/18hbHd4u-4FZsHlDZJSvQj_OnNCm2f4R_/preview) > [tab] Mobile > > [https://drive.google.com/file/d/1CP3coTAoNVhalAiI8sZByBcJ2F8NvAHQ/preview](https://drive.google.com/file/d/1CP3coTAoNVhalAiI8sZByBcJ2F8NvAHQ/preview) ## Direct Messages (DMs) Direct Messages are one-to-one conversations between users. **Who can start DMs**: * Field Executives and Team Leads can start DMs with their own team members. * Admins can start DMs with any user. > [!NOTE] > > Note: Field Executives and Team Leads can view and reply to DMs initiated by Admins. > [tab] Web > > [https://drive.google.com/file/d/1dwPBHs\_tyLeiPETLEBdfJbumpp6A\_wV7/preview](https://drive.google.com/file/d/1dwPBHs_tyLeiPETLEBdfJbumpp6A_wV7/preview) > [tab] Mobile > > [https://drive.google.com/file/d/1jCuzK8CoVJG\_2pC\_nmnUUChVokdRcom8/preview](https://drive.google.com/file/d/1jCuzK8CoVJG_2pC_nmnUUChVokdRcom8/preview) ## **Channels**  Channels let teams collaborate in group conversations. Zuper supports three types of channels.   ### **1. General Channel**  Every organization in Zuper automatically has a **#general** channel. All users are added to this channel by default.  You can use the **#general** channel for:  * Organization-wide announcements  * All-hands updates  * Information everyone needs to stay aligned  > [!NOTE] > > Note: The General channel cannot be archived. ### **2. Job-Specific Channels**  Job-specific channels are created to centralize all communication related to a particular job. Each Job Channel is identified by a suitcase icon and is named after the job it belongs to. These channels are initiated from the **Job Details page** → **Chat** → **Start Conversation** and are automatically linked to the job. > [!NOTE] > > **UI Update:**\ > We've repositioned **Job Channels** into a dedicated section in the sidebar, separate from your other channels, for quicker access. ![Jobchannelchat](https://mintcdn.com/zuperinc/gV50wMTlFvFF0TSp/images/jobchannelchat.png?fit=max\&auto=format\&n=gV50wMTlFvFF0TSp\&q=85\&s=a81c6909506fa88c2e7ee2f395bf2f1f) By using a job-specific channel, teams can: * Share photos, documents, and files related to the job in one place * Exchange real-time updates as the job progresses * Receive automated real-time job updates such as clock-in/out, quote acceptance/rejection status, invoice payments, status updates, and user assignment * Keep all job-related discussions contextually tied to the job details * Ensure clear communication between office teams and field technicians > [!NOTE] > > **Note**: Any user with permission to view a job can create a Job Channel using the **Start Conversation** button. By default, assigned users, their Team Leads, and users configured in Job General Settings are automatically added as channel members. ### **3. Custom Channels**  Custom channels are created to organize conversations around specific ongoing topics, teams, or projects. By creating a custom channel, teams can: * Keep conversations focused and relevant to a particular topic or project. * Make it easier for members to find past discussions, files, and decisions. * Collaborate efficiently with the right people, without unnecessary noise * Maintain clarity as projects evolve or topics continue over time. ## Creating Custom Channels You can create a channel with one or more members for collaboration. > [tab] Web > > [https://drive.google.com/file/d/1dTg\_64\_FV4wUpCnw8EX0r6Fzec5tz9yN/preview](https://drive.google.com/file/d/1dTg_64_FV4wUpCnw8EX0r6Fzec5tz9yN/preview) > [tab] Mobile > > [https://drive.google.com/file/d/1eGhbLoD\_4GEatXgFQ4IhGQY\_uFTLrA-C/preview](https://drive.google.com/file/d/1eGhbLoD_4GEatXgFQ4IhGQY_uFTLrA-C/preview) ### Channel Managers Channel Managers can control member access and help keep conversations organized. **Channel Managers can:** * Add or remove channel members. * Assign other users as Channel Managers. * Delete messages in the channel. **Who becomes a Channel Manager:** * **#general channel:**\ All Admins are automatically assigned as Channel Managers. * **Job channels:**\ The following users are automatically assigned as Channel Managers: 1. Team Leads of the assigned technicians. 2. Primary Technician of the job. 3. User who created the job (if enabled in Job General Settings). 4. Any Admins added to the channel. * **Other channels:**\ The user who creates the channel is automatically assigned as the Channel Manager. > [!NOTE] > > Note: Admins have Channel Manager permissions in any channel they join, even if not explicitly assigned. ## Managing Conversation You can manage conversations to stay focused and respond faster. Zuper lets you pin important conversations, mute distractions, and archive channels when they’re no longer active. ### Pin a Conversation Pinning keeps it at the top in the “Pinned Conversations” for quick access. > [tab] Web > > [https://drive.google.com/file/d/1J8s\_oVx5Iu0aEio252qTxlpnEPe9WzV5/preview](https://drive.google.com/file/d/1J8s_oVx5Iu0aEio252qTxlpnEPe9WzV5/preview) > [tab] Mobile > > [https://drive.google.com/file/d/1hD3IcN16NOlHqPeguhW5d2yL32ZIr80u/preview](https://drive.google.com/file/d/1hD3IcN16NOlHqPeguhW5d2yL32ZIr80u/preview) ### Set a Notification Preference Updated You can control how you are notified for each channel. Zuper gives you two levels of control, a global preference for all channels, and a channel-level preference for individual channels. > [accordion] Global notification preference > > Your global preference sets the default notification behavior across all channels. > > > [tab] Web > > > > **Web** > > > > 1. Click the **Chat** icon in the top-right corner of the Header bar. > > 2. Click the  icon. A **Notification Preference** panel opens. > > 3. Choose one of the following: > > * **All**: You receive a notification for every message in every channel. This is the default. > > * **Mentions and Direct Messages**: You are only notified when someone mentions you or sends you a Direct Message. > > 4. Your preference is saved immediately. > > > [!NOTE] > > > > > > **Note:** This setting applies to all channels where no channel-level preference has been set. > > > ![Notification 01](https://mintcdn.com/zuperinc/OZ1pujpaUp5LzUin/images/notification-01.gif?s=fb0ebe3d2a282e6215b9b7825e709dda) > > > [tab] Mobile > > > > 1. In the **Chat** home, tap on the icon. > > 2. Choose **Everything** or **Mentions**. > > > > [https://drive.google.com/file/d/1ncI1JKQjjZgm2xV2ZBMRrp0O0gZO6QqI/preview](https://drive.google.com/file/d/1ncI1JKQjjZgm2xV2ZBMRrp0O0gZO6QqI/preview) > [accordion] Channel-level notification preference > > You can override your global preference for any individual channel. Channel-level preferences always take precedence over your global settings. > > > [!NOTE] > > > > **Note:** Once a channel-level preference is set, it cannot be overridden by the global preference. > > > [tab] Web > > > > 1. Open the channel and click **More actions (⋮)** in the channel header. > > 2. Select **Notification Preference**. > > 3. Choose one of the following: > > * **All**: You receive a notification for every message in this channel. > > * **Mentions**: You are only notified when someone mentions you in this channel. > > * **Mute**: You receive no notifications from this channel. > > > > ![Notification 02](https://mintcdn.com/zuperinc/OZ1pujpaUp5LzUin/images/Notification-02.gif?s=18de5df1b6a9f758bbb64add815994d8) > > > [tab] Mobile > > > > 1. In the Chat home, tap and hold the channel name, or open the channel and tap its name to open the details page. > > 2. Select **Notification Preference**. > > 3. Choose **Muted**, **Everything**, or **Mentions**. > > > > [https://drive.google.com/file/d/1FPQIzaCKmrvay3XUgjRGLj2LvyyMhBN5/preview](https://drive.google.com/file/d/1FPQIzaCKmrvay3XUgjRGLj2LvyyMhBN5/preview) ### Archive a channel Removes it from view for all users (searchable and restorable later). > [!NOTE] > > Note: DMs and the #general channel cannot be archived. > [tab] Web > > [https://drive.google.com/file/d/1QOAJum27o0a357kihxjLuiSwkU9829n9/preview](https://drive.google.com/file/d/1QOAJum27o0a357kihxjLuiSwkU9829n9/preview) > [tab] Mobile > > [https://drive.google.com/file/d/1p1lAt61pX8nDjKEbpJYbx3tfj69Fb-tB/preview](https://drive.google.com/file/d/1p1lAt61pX8nDjKEbpJYbx3tfj69Fb-tB/preview) ## Sending and Managing Messages ### Mentions Tag users (@username) or entities (Jobs, Projects, Customers, Quotes, Invoices) — triggers notifications for user mentions; entity mentions link to details. > [tab] Web > > [https://drive.google.com/file/d/1yl6nqS25rpz8ojiuXpHhXk8L8LoQPJnI/preview](https://drive.google.com/file/d/1yl6nqS25rpz8ojiuXpHhXk8L8LoQPJnI/preview) > [tab] Mobile > > [https://drive.google.com/file/d/1LxvJpY1WmQsQQMYju9zapuPghdu8MzcP/preview](https://drive.google.com/file/d/1LxvJpY1WmQsQQMYju9zapuPghdu8MzcP/preview) ### Threads Reply to a specific message to keep related discussions organized. > [tab] Web > > [https://drive.google.com/file/d/1ClkRW1zMmhC8OCyk89yas\_7j2hT\_pezd/preview](https://drive.google.com/file/d/1ClkRW1zMmhC8OCyk89yas_7j2hT_pezd/preview) > [tab] Mobile > > [https://drive.google.com/file/d/15-XpwtESikpS-HTuCAql6x92-psWMu9d/preview](https://drive.google.com/file/d/15-XpwtESikpS-HTuCAql6x92-psWMu9d/preview) ### Reactions Add emojis to acknowledge messages quickly. > [tab] Web > > ![Emoji](https://mintcdn.com/zuperinc/rlMzd-WVUuL9_BN5/images/Emoji.png?fit=max\&auto=format\&n=rlMzd-WVUuL9_BN5\&q=85\&s=dfa7d1dd78dbb99f6d952007d1b6197b) > [tab] Mobile > > ![Emoji](https://mintcdn.com/zuperinc/IYBzsRkjeFQRD9-5/Chat/Emoji.png?fit=max\&auto=format\&n=IYBzsRkjeFQRD9-5\&q=85\&s=b5d78244c78d08d113b451fe58f9781e) ### Attachments Share images, videos, documents — media appears in "**Photos & Videos**"; files in "**Files**" section. > [tab] Web > > [https://drive.google.com/file/d/1iiDu-YycU3GZ6J-2BEDIpBUWSrKl5OeE/preview](https://drive.google.com/file/d/1iiDu-YycU3GZ6J-2BEDIpBUWSrKl5OeE/preview) > [tab] Mobile > > [https://drive.google.com/file/d/1NDlAXrskl\_7P-IRAke3\_YKQIDHSCojeq/preview](https://drive.google.com/file/d/1NDlAXrskl_7P-IRAke3_YKQIDHSCojeq/preview) ### Pinning a message Highlight key info within a conversation for easy reference.  > [tab] Web > > [https://drive.google.com/file/d/1Cv-dvM1Z1gb8G-FY6WFr7MQXYlit8DAQ/preview](https://drive.google.com/file/d/1Cv-dvM1Z1gb8G-FY6WFr7MQXYlit8DAQ/preview) > [tab] Mobile > > [https://drive.google.com/file/d/1dMzRPlu5otJCsqMO1V\_suH-LAWxYLhCl/preview](https://drive.google.com/file/d/1dMzRPlu5otJCsqMO1V_suH-LAWxYLhCl/preview) ### Mark as unread Flag messages to review later (thread replies excluded).  > [tab] Web > > ![unreadweb](https://mintcdn.com/zuperinc/IYBzsRkjeFQRD9-5/Chat/unreadweb.png?fit=max\&auto=format\&n=IYBzsRkjeFQRD9-5\&q=85\&s=ed7d37629c0acb55cbd79ad757addfaa) > [tab] Mobile > > ![unreadmobile](https://mintcdn.com/zuperinc/IYBzsRkjeFQRD9-5/Chat/unreadmobile.png?fit=max\&auto=format\&n=IYBzsRkjeFQRD9-5\&q=85\&s=1dbc174d8104b349fa9e451babbe7a7f) ### Edit/Delete Messages: * Users: Can edit/delete their own messages.  * Channel Managers: Can delete others' messages (but can’t edit them). > [tab] Web > > ![Editdeleteweb](https://mintcdn.com/zuperinc/IYBzsRkjeFQRD9-5/Chat/Editdeleteweb.png?fit=max\&auto=format\&n=IYBzsRkjeFQRD9-5\&q=85\&s=bd5c10ab958886c4f562e1e442fb5e5c) > [tab] Mobile > > ![Editdeletemobile](https://mintcdn.com/zuperinc/IYBzsRkjeFQRD9-5/Chat/Editdeletemobile.png?fit=max\&auto=format\&n=IYBzsRkjeFQRD9-5\&q=85\&s=89ff47af8431b39572ccf243e6a36bc0) ## Search Quickly locate content:  * Search across Messages, Users, and Channels.  * Sort message results by creation date.  * Filter message results by sender or channel.  > [tab] Web > > [https://drive.google.com/file/d/1Jn2pcHw1GqfRMl4aDFmICaHQpcHrbi8z/preview](https://drive.google.com/file/d/1Jn2pcHw1GqfRMl4aDFmICaHQpcHrbi8z/preview) > [tab] Mobile > > [https://drive.google.com/file/d/14BB5Jo46dVePfZldT5wOXiiU3o-iJZgP/preview](https://drive.google.com/file/d/14BB5Jo46dVePfZldT5wOXiiU3o-iJZgP/preview) This streamlined guide focuses on essential steps to get you started quickly. For deeper details, refer to the articles below: * **Channels**\ Learn how to create, manage, and collaborate with your team using channels. * **Direct Messages**\ Learn how to start and manage private conversations with individuals. * **Messages**\ Learn how to send, receive, and organize messages effectively. * **Search**\ Learn how to quickly find messages, channels, and conversations using search. # Applying credits Source: https://docs.zuper.co/Client/Contact/Applying_credits Zuper Credits feature allows users to manage and apply credits across modules, where payments can be obtained, such as Invoices, Quotes, and Customer Profiles. Credits can be added, applied, or voided, providing flexibility in payment processing. **Navigation**: *CRM--> Contacts --> Select a Contact --> Credits --> +* ## **Adding credits** 1. Select the “**CRM**” module from the left navigation menu and choose "**Contacts**.” The Contacts listing page opens. ![Image](https://mintcdn.com/zuperinc/V8kBP4pFnO5EgXUT/images/image-39.png?fit=max\&auto=format\&n=V8kBP4pFnO5EgXUT\&q=85\&s=fc50bedf8f8515df11999b1817f9481a) 2. Select a contact from the listing to view its details. 3. On the details page, navigate to **Overview**>>**Highlights**>>**Credits**>>**Add Credits.** ![Image](https://mintcdn.com/zuperinc/V8kBP4pFnO5EgXUT/images/image-40.png?fit=max\&auto=format\&n=V8kBP4pFnO5EgXUT\&q=85\&s=4f1abec70a40e0fbf8c2c4357cc5a22c) 4. Fill in the following details to add credits for the selected contact. ![Image](https://mintcdn.com/zuperinc/V8kBP4pFnO5EgXUT/images/image-43.png?fit=max\&auto=format\&n=V8kBP4pFnO5EgXUT\&q=85\&s=0c02b96c7cee37bc71aa243cd9b26ba9) * **Credit Date** - The date on which the credit note needs to be created. * **Credit Amount -** Enter the credit amount.  (e.g., USD 450).  * **Payment Mode** - The mode of payment through which the payment was obtained. (e.g., Check).  * **Remarks** - Additional comments (e.g., pre-payment for services). 5. Click the “**Save**” button to save the credit note for the specified amount against the customer’s profile.  ## Applying Credits * **On Invoices/Quotes**: The "**Apply Credits**" tab displays available credit when you Record Payment for an unpaid invoice. Click the radio button by "**Apply Credits**" to view credit notes with a positive balance. Check the boxes to choose which credit notes to use and adjust the amounts if needed; the invoice amount should exceed the available credit in each note. * The **Invoice Amount** is the total cost billed to the customer for the goods or services provided, including any taxes or additional fees. * The **Total Credits** represent the cumulative sum of credits available to the customer, which can be used on the invoice or deposit payments on quotes.  *  The **Total Applied Amount** is the portion of the available credits that has been used (or is being applied) to use against the current invoice.  ![CR5 Pn](https://mintcdn.com/zuperinc/702WvYaFwwoofRCs/images/CR5.png?fit=max\&auto=format\&n=702WvYaFwwoofRCs\&q=85\&s=95f6338f8d5b3679ebde552fea9c2844) ## **Viewing Credits** * In the Customer Profile, click "**View Credits**" to see credit memos with details like **Credit Name**, **Available Credit**, and **Status** (Unapplied, Partially Applied, Applied). * **Unapplied** - The credit note has not been used to make any payments. * **Partially applied** - The credit note has been applied to a payment, but the remaining amount can be used. * **Applied**- The credit note has no remaining balance and has been fully utilized to make payments.  ![CR8 Pn](https://mintcdn.com/zuperinc/702WvYaFwwoofRCs/images/CR8.png?fit=max\&auto=format\&n=702WvYaFwwoofRCs\&q=85\&s=82a2e229e8adbd2c600ce9c8488a7323) * Click "**View History**" to view the table showing **Credit Name**, **Available Credit**, **Used Credit**, **Amount Credited**, and **Status**. ![CR11 Pn](https://mintcdn.com/zuperinc/702WvYaFwwoofRCs/images/CR11.png?fit=max\&auto=format\&n=702WvYaFwwoofRCs\&q=85\&s=893e325462e33b98edacc2bf41ec87c6) ## **Refunds and void** * For non-Zuper Pay customers, clicking the kebab menu displays three options: View Details, which takes you to the transaction details; Void, which allows you to void the Payment; and Refund Transaction, which enables you to create a credit note for the customer.  > [!NOTE] > > **Note:** When you refund a customer, the payment status is switched to partially refunded, and the invoice status changes to partially paid. ### **For Zuper Pay Customers** If Zuper Pay is enabled, you can initiate full or partial refunds directly from an Invoice or payment transaction. You can issue a credit note against this payment. A credit note is created from the customer’s profile. ![CR21 Pn](https://mintcdn.com/zuperinc/702WvYaFwwoofRCs/images/CR21.png?fit=max\&auto=format\&n=702WvYaFwwoofRCs\&q=85\&s=99b22af2685e82f1b672fad7af968679) ## **Reporting** Credit History Report: This report is exportable and has the following columns: Credit Note Number, Opening Balance, Closing Balance, Applied Amount, Transaction, Action, Credited, Remarks, and Date. ## **Notifications** * Customers receive notifications via a dialog box when credits are added, deleted, or refunded. ## **Permissions** * Only an Admin user has permission to create and apply credit notes. ##  **Impact across modules** * Invoices: The "**Record Payment**" button offers conventional payment methods and credit application tabs. * **Quotes**: The Record Payment button offers payment methods and credit application tabs. **Customers**: Edit screen includes fields for **Credit Name**, **Date**, **Payment Method**, **Amount**, and **Remarks**. A "**Download**" button generates a report. ## **Payment listing** Payments made with credits have the payment mode as Credits. There is a credit note beside the status for partially refunded transactions. The status of such transactions would be partially refunded. ![CR22 Pn](https://mintcdn.com/zuperinc/702WvYaFwwoofRCs/images/CR22.png?fit=max\&auto=format\&n=702WvYaFwwoofRCs\&q=85\&s=2fdb2bc5824562609894cdf07d085e54) # Adding new contact Source: https://docs.zuper.co/Client/Contact/Create_contact Adding a contact allows you to manage individual client information. This includes essential details such as the contact's name, phone number, email address, preferred time zone, and association with an organization or property. By creating a contact, you can easily communicate with the right individuals, assign them to jobs or service requests, and maintain a detailed history of all interactions. Follow the steps below to add a new contact and link them with organizations or properties as needed. **Navigation**:CRM -> *Contacts* -> + *New Contact* * Select the "**CRM**" module from the left navigation menu and choose "**Contacts**". * The Contacts listing page opens. * Click the "**+ New Contact**" button at the top right corner of the page. ![Image](https://mintcdn.com/zuperinc/V8kBP4pFnO5EgXUT/images/image-32.png?fit=max\&auto=format\&n=V8kBP4pFnO5EgXUT\&q=85\&s=282d7bcdecf0be43f282efd33bdffa23) Fill in the following sub-sections: 1. **Primary Details** * **First Name** (*Mandatory*): Enter the contact’s first name. * **Last Name**: Enter the contact’s last name. This field is optional but helps in full-name identification. * **Organization**: Select the organization the contact is associated with. This links the contact to a business entity. * **Email (***Mandatory***)**: Provide the contact's official email address. This email will be used for sending job-related notifications, invoices, and other communications. Sending job-related notifications and updates. Auto-populating the recipient field when sending invoices. Delivering quote approvals and payment receipts. > [!NOTE] > > If this field is left blank, the recipient email will not auto-populate when you send an invoice associated with this contact, requiring manual entry each time. Always ensure a valid email is saved here to enable seamless invoice delivery. * **Preferred Timezone**: Choose the timezone that applies to the contact. This ensures that all time-sensitive activities, such as job scheduling and alerts, are correctly aligned with their local time. * **Category**: Select a category that best classifies the contact (e.g., decision-maker, technician, billing). Helps in filtering and reporting. * **Accessible by everyone**: Indicates if the contact should be visible to all users. Set to “**No**” by default to restrict visibility. * **Account Manager** (*Mandatory*): Choose the internal user responsible for managing this contact. Required to ensure accountability. * **Tags**: Add one or more tags to help categorize and search for the contact easily. * **Has SLA**: Specify whether the contact is covered under a Service Level Agreement (SLA). Select an option from the dropdown. * **Pricelis**t: Select the relevant price list to be applied when jobs or services are performed for this organization. * **Description**: Provide a brief description for this contact. ![Image](https://mintcdn.com/zuperinc/V8kBP4pFnO5EgXUT/images/image-33.png?fit=max\&auto=format\&n=V8kBP4pFnO5EgXUT\&q=85\&s=6d9a2f48734e86dfd1c856803daa197f) ### Lead Source The **Track Lead Source** option helps you record the origin of your leads. Enabling this setting ensures every new customer or job record includes a field to capture and report the source of the lead. This feature improves marketing insights, sales performance tracking, and lead attribution. ![Image](https://mintcdn.com/zuperinc/V8kBP4pFnO5EgXUT/images/image-34.png?fit=max\&auto=format\&n=V8kBP4pFnO5EgXUT\&q=85\&s=2c50d98051de6cda2cb36f6430f2a5a0) **Prerequisites** * Admin or user role with permission to manage customer and contact settings. **Enable Lead Source Tracking** To learn how to enable Lead Source Tracking, see [Enable Lead Source](https://docs.zuper.co/Settings/Modules/Customers-Contacts/Customers-Contacts-Settings#enable-lead-source) **Create and Manage Lead Sources** To learn how to create Lead Sources, see [Lead Sources](https://docs.zuper.co/Settings/Modules/Customers-Contacts/Customers-Contacts-Settings#lead-sources) * These lead sources will appear as selectable options when users assign a source to a customer /contact or job record. > [accordion] Using Lead Source Data > > ## **Using Lead Source Data** > > * View the lead source in customer /contact details or Job details. > * Filter customers/contacts and jobs by lead source in lists by filtering them as "**Source**". > * Use this data to evaluate which channels bring the most leads. > > [!NOTE] > > > > Note: The first job will inherit the lead source from the customer record. The second job onwards, it should be manually selected. > > **Reporting and Analytics** > > **Reports** > > The **Source** field has been added as a column in core reports to enhance tracking and analysis: > > * **Job Master Report** > * **Customer Master Report** > * **Report Builder** (fully integrated for custom report creation) > > **Dashboard Widget** > > A new **Horizontal Bar Chart Widget** has been introduced to visualize Lead Source metrics directly on the dashboard: > > * **Lead source**: Displays the lead sources. > * **No. of Jobs**: Shows the “**Total number of Jobs against that particular lead source**.” > * **On hover**: Reveals the total job value against that particular lead source. > * **Filterable by date range**: Users can apply custom date filters to focus on specific periods (e.g., quarterly or yearly trends). > > This widget enables you to identify top-performing lead sources and optimize your marketing efforts efficiently. > > **Bulk Operations** > > **Lead Source** is now available in the Bulk Update feature for efficient data management: > > * **Customer Module**: Update Lead Sources in bulk for multiple customers at once. > * **Job Module**: Apply Lead Source changes across batches of jobs. > > This streamlines onboarding and corrections, eliminating the need for manual entry for each record. > >  **Filtering** > > Enhanced filtering options have been added to improve search and navigation: > > * **Filter by Source** on the **Job Listing Page**. > * **Filter by Source** on the **Customer Listing Page**. > > **Dynamic Updates**: Results refresh in real-time as users select or multi-select lead sources, ensuring quick and relevant views without page reloads. > > **Configuring Lead Source Sync in HubSpot-Zuper Integration** > > To enable seamless Lead Source tracking across HubSpot and Zuper, follow these steps for setup and mapping: > > • **Create Custom Lead Source Fields in HubSpot:** Individually add a custom field for "**Lead Source**" to the Contact and Deal entities in HubSpot. This field will capture the origin of leads. > > • **Map Fields in Zuper HubSpot Integration Settings**: Once created, navigate to Zuper Settings > Integrations > HubSpot. Map these HubSpot fields to Zuper's primary Lead Source fields in the Customer/Contact and Jobs modules. > > • **Sync Direction and Data Flow:** With mapping complete, Lead Source information flows bidirectionally: Depending on the integration direction (**HubSpot** → **Zuper** or **Zuper** → **HubSpot**, or **both ways**), updates propagate automatically, ensuring consistency across platforms. > > **Best Practices** > > * Define a standard list of lead sources to maintain consistency. > * Encourage team members to fill in the lead source for every new record. > * Utilize reports or dashboards to analyze trends in lead sources. > > ### Edge Cases & Validations > > In Zuper, the Lead Source feature is designed to be flexible and user-friendly, but it's essential to understand how it behaves in various edge cases. Below is a summary of common scenarios, their expected behaviors, and any relevant notes. This ensures smooth data management and avoids unexpected issues during implementation. > > | **Scenario** | **Expected Behavior** | **Notes** | > | :- | :- | :- | > | **Job created without a lead source** | Allowed – field is optional. | Users can proceed without selecting a Lead Source; the job will be created successfully, and the field will remain blank. This supports quick entry for non-critical tracking. | > | **Lead Source removed from master list** | Existing records retain the old value (now marked as inactive). | Removed sources won't appear in new dropdowns or selections, but historical data is preserved for reporting and auditing. No automatic cleanup or migration occurs. | > | **The customer has no lead source, but the job has the lead source** | Allowed – no backfill required. | Lead Sources are independent per record type (Customer vs. Job). | > | **User disables "Track Lead Source"** | The field is hidden across the entire UI and not populated for new records. | This global setting (under Admin > Settings) removes the field from forms, reports, dashboards, and filters. Existing data remains intact but is no longer visible or editable until re-enabled. | 2. **Contact Information** * **Home Number**: Enter the contact’s home phone number. Useful for personal or after-hours communication. * **Mobile Number**: Enter the contact’s mobile number. This is typically the primary method of communication. * **Work Number**: Enter the contact’s office or work phone number. Ideal for professional interactions. 3. **Portal Details** * Portal Access: Specify whether the contact should have access to the customer portal. Set to "**Yes**" to enable access and allow self-service features like viewing jobs, invoices, and quotes. 4. **Tax Details**: Choose the applicable tax settings for the contact based on your region or internal policies. These settings will automatically be applied to invoices and billing documents. * **Tax Preference**: Choose whether the contact is **Taxable** or **Tax Exempt**. This affects how taxes are calculated for this contact in quotes and invoices. * **Tax Group**: Pick the appropriate tax group that applies to this contact. Tax groups define the specific tax rates or rules used. 5. **Account Details** * **Billing Frequency**: Choose how often the contact should be billed (e.g., monthly, quarterly, yearly). Helps automate and manage billing cycles. * **Payment Term**: Select the agreed-upon payment term for the contact. This defines the time frame within which payment is expected. 6. **Property:** You can associate properties with the contact to ensure seamless tracking of service history and work orders. To add a property, * Click "**+ Pick Property**" next to the Property section. * Use the pop-up to search for and select the relevant properties that belong to the contact. 7. **Service and Billing Address**: Add the contact's service and billing locations. You can specify these details in two ways. * Address Entry: Type the full physical address. * Geo-Coordinates: Enter latitude and longitude if you want to use exact map-based positioning. > [!TIP] > > For the most accurate location data, use the **"Pick from Map"** option. This allows you to pinpoint the address directly on the map interface.\ > Once you've selected the correct location, click "**Use this Address**" to save the information. 8. **Other Details:** If any custom fields are added under the settings, you can fill in the details here. ![Image](https://mintcdn.com/zuperinc/V8kBP4pFnO5EgXUT/images/image-36.png?fit=max\&auto=format\&n=V8kBP4pFnO5EgXUT\&q=85\&s=cb59ad2246e1948197b1d481045fedb1) After filling in all the details, click **Save Contact**. The Contact will be saved successfully and can be linked to any jobs, quotes, invoices, or service requests. ![Image](https://mintcdn.com/zuperinc/V8kBP4pFnO5EgXUT/images/image-37.png?fit=max\&auto=format\&n=V8kBP4pFnO5EgXUT\&q=85\&s=fb68a9cc6b4dc97178ad7541ddaf978c) ## Auto-Create property When [**Auto-Create Property**](https://docs.zuper.co/Settings/Modules/Customers-Contacts/Customers-Contacts-Settings#auto-create-property) is enabled, Zuper creates a property record the moment you save a contact with a valid service address. You do not need to build a property separately or link it manually. **Note:** Zuper uses the street name from the service address as the property name. For example, a service address of 500 Main Street, New York, creates a property named **500 Main Street**. When you save, Zuper automatically: * Creates a new property using the street name as the property name. * Displays the property under **Properties Associated** in the right panel of the contact detail page, and you can view the property details. ### Address sync between customer/contact and property Because the contact and property are linked, you never need to update both records separately. | **If you update…** | **Zuper updates…** | | :- | :- | | The service address on the contact | The address on the linked property | | The address on the property | The service address on the linked contact | ![Image](https://mintcdn.com/zuperinc/V8kBP4pFnO5EgXUT/images/image-38.png?fit=max\&auto=format\&n=V8kBP4pFnO5EgXUT\&q=85\&s=7d28c504009c9194a6e1c9d8d97ad033) This works in both directions, so it does not matter which record you update first. > [!NOTE] > > **Note:** Sync only works when a property is already linked to a contact. If you saved the contact without a service address, Zuper did not create a property at that point. Adding an address later does not trigger a new property. In that case, create the property manually and link it using **+ Pick Property** on the contact detail page. # Managing the Contact Detail Source: https://docs.zuper.co/Client/Contact/Manage_contact Effectively managing contact information is vital for delivering personalized communication, enhancing customer engagement, and ensuring smooth field operations. Zuper provides a centralized platform to create, organize, and maintain detailed contact profiles that serve as the primary touchpoints for customer interactions. By consolidating key details such as phone numbers, email addresses, associated organizations or properties, tax preferences, and portal access, Zuper enables your team to interact with the right person at the right time, ensuring faster resolutions and stronger relationships. This guide will walk you through how to access the Contacts module and efficiently manage contact-related data. ## Accessing the contacts listing page **Navigation**:  Clients  -> *Contacts ->  Contacts listing page* * Select the “**Client**” module from the left navigation menu and choose “**Contacts**.” * You will land on the Listing page, which provides a comprehensive view of all your contacts with key information such as *Contact Name, Status, Email, Work number*, and more. ![Contacts17 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contacts17.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=ba35a597c7ffca66d9b45e3a9d3776dd) ## **Exploring the listing page** The Customer/Contact Listing Page layout in Zuper includes view management, column selection, views, and saving customized views. This process is performed directly on the module’s listing page. **Default Listing Behavior** The system retains its existing default listing behavior, ensuring that pre-set configurations or default views are preserved. When you first access the Customer/Contact Module Listing Page, you’ll see the default view with columns such as Customer/Contact Number, Customer/Contact Address, Customer/Contact Tags, and Customer/Contact Status. ## **Create view configuration** **Selecting Columns** You can choose which columns to display to focus on relevant data: 1.     Select the “**Customer/Contacts**” module from the left navigation menu. You can view the listing page. ![Contv1 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contv1.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=59138e81e12a248934e97c9e710da603) 2. From the “Views” list, click “**+Create new view**.” ![Contv2 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contv2.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=93bbb214c6fd8c8477d3a03d7caaafda) 3. A “**Create View**” dialog box appears. View Name (**Mandatory**) – Enter the view name. Share with - Select any one of the options (User, Team), and you can add the relevant users. Visibility to all users – Toggle on to make this view visible. Click "**Create**" to create a new view. ![Contv12 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contv12.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=bf3a2907be8385c36052a5f269b42864) 4. Once you click “**Create**,” the **Columns** sidebar appears, showing “**Available Columns**” and “**Displayed Columns**.” To add a column, drag it from the “**Available Columns**” list on the left to the “**Displayed Columns**” list on the right. You can click “**Continue**.” ![Contv3 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contv3.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=6302d6255475627c488952db528a3c52) 5. To remove a column, drag it from the “**Displayed Columns**” list back to the “**Available Columns**” list or click the **-** next to the column name. Click **Continue** to apply the changes. ![Contv4 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contv4.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=f2f4337f6bb0cfc908610aeb5691d613) 6. If you wish not to add any filter, click “**Skip and Save**” to create the view. ![Contv5 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contv5.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=1024bb218134c86ff4cb53eb938cce58) 7. The view is saved successfully. ![Contv7 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contv7.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=a76acf731302d1b8a88c35028ae42800) ## **Applying filters** The Filter feature lets you refine your view by applying multiple filters based on available attributes. For example, you can select an attribute like "**Customer/Contact Status Type**," choose conditions such as "**Equal to**," "**Contains**," or "**Does Not Contain**," and choose the desired value. Once the filter is applied, the results will update to show only the Customer/Contacts that meet your criteria, making it easier to find and manage relevant Customer/Contacts. 1. Click "**Filter"** at the top left of the page. Choose the attributes you want to filter by, apply the desired conditions, and click the "**Add"** button to view the results. ![Contfilter13 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contfilter13.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=a60518d82f5ff5be4e995ee07145c1cd) 2. Click “**Update View**” to modify the existing view. ![Contv9 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contv9.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=43e450731abc2e54f5a1bfdb7730817c) 3. The new view is set successfully with the filter. You can view the filter created and the filter name from the view list. ![Contv7 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contv7.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=a76acf731302d1b8a88c35028ae42800) ## **Update view** An update view allows you to modify the current display settings of the "**Customer/Contacts**" section. After making changes, you can save the updated configuration to the existing one or name it a new view. 1. Add/remove the existing columns and click “**Update View**” to modify the existing view. ![Contv9 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contv9.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=43e450731abc2e54f5a1bfdb7730817c) 2. The view is updated successfully. ![Contv10 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contv10.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=4e8516a50a5ab9dfa4d33d9d72cc5076) 3. Click the down arrow below the “**Update View**” to create a new view by clicking “**Save as new view**.” ![Contv11 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contv11.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=fe7f2d80131c330df3e37b259d04e5e9) 4. A “**Create View**” dialog box appears. * View Name (**Mandatory**) – Enter the view name. * Share with - Select any one of the options (User, Team), and you can add the relevant users. * Visibility to all users – Toggle on to make this view visible. Click “**Create**” to create the new view. ![Contv12 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contv12.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=bf3a2907be8385c36052a5f269b42864) 5. Click “**Reset View**” to reset the current view. ![Contv8 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contv8.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=f1fb6e56c62fe0cdf4ddbad95d84630c) ## **Setting permissions for views** ### **Edit Permissions** Users with edit permissions can modify the layout: * They can add/remove columns, reorder them, and adjust views as described above. * If permission is given, changes can be saved as a new view or overwritten as an existing one. ### **View Permissions** Users with view-only permissions can see the layout but cannot make changes: * They can view the customized columns and filters but cannot edit them. To ensure consistency for viewers, they can save them as a new “**View**.” ### **Make changes to the view** * **Rename**: This option allows you to change the view's name (e.g., from “New\_Customer” to something else). * **Visibility**: This lets you adjust who can see the view. Options include sharing with a user or team or keeping it private (“Only Me”), as well as toggling visibility for all users in Zuper (as shown in the “Create a View” dialog in prior images). * **Duplicate**: This function creates a copy of the “New\_Customer” view, allowing you to modify the duplicate without affecting the original. * **Delete**: Removes the view entirely. Since this is a custom view, deleting it would revert the listing to the default view or another saved view. Only the created user can delete the view. ![Contv13 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contv13.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=f0d4fa8c59d4e6960074c29629c37c29) The Customer/Contact Module Listing Page in Zuper allows for flexible layout customization directly on the listing page. You can select and reorder columns, apply views, save customized views, and set permissions to ensure the right level of access for your team. Use the steps above to tailor the view to your workflow and save it for future use. ## Pinned filters Zuper's Customers module lets you use pinned filters to streamline your filter experience. Pinned filters keep your most-used criteria readily accessible for quick application. Pin up to 3 filters in any module. Navigation: *Clients -> Customers -> Filters -> Pinned Filter* 1. Select the “**Clients**” module from the left navigation menu. Choose the “**Customers/Contacts**.” ![Cf3 Pn](https://mintcdn.com/zuperinc/YiKFe6sEZro1Cw3W/images/cf3.png?fit=max\&auto=format\&n=YiKFe6sEZro1Cw3W\&q=85\&s=eb83ee8f3d530e1a58cf44480fba4741) 2. **Pin Filters for Quick Access** * Once your filters are set, click the **Pin Filters** button in the dialog box to save them as pinned. * Pinned filters appear in the dialog box's "**Pinned Filters**" section, allowing you to apply them with one click in future sessions. ![Cf1 Pn](https://mintcdn.com/zuperinc/YiKFe6sEZro1Cw3W/images/cf1.png?fit=max\&auto=format\&n=YiKFe6sEZro1Cw3W\&q=85\&s=f1cd55fa2100bc7fc259ea61597fc1ef) 3. To Unpin the filter: * To unpin, select a pinned filter and click **Remove**. * To apply pinned or default filters, open the dialog box and select them. * Use **Clear All** to remove active filters. ![Cf4 Pn](https://mintcdn.com/zuperinc/YiKFe6sEZro1Cw3W/images/cf4.png?fit=max\&auto=format\&n=YiKFe6sEZro1Cw3W\&q=85\&s=139330e113bd17a91268eb90c3dd56c4) After filtering a specific Customer/Contact, click the “**Name**” on the listing page to view and manage its details on the Customer/Contact details page. ### Creating a new contact You can quickly create a new contact directly from the listing page. 1. Click the "**+ New Contact**" button in the top right corner. 2. Fill in the required fields such as Contact Name, Contact Information, Tax Details, and Service Addresses. 3. For a step-by-step walkthrough, refer to the [Creating a new contact](https://docs.zuper.co/Client/Contact/Create_contact) article. ![Contacts7 Pn](https://mintcdn.com/zuperinc/Cn7Gj1kyrBFOvJPh/images/Contacts7.png?fit=max\&auto=format\&n=Cn7Gj1kyrBFOvJPh\&q=85\&s=c59116869037a0c691df370e22e7ec39) ## **Managing contact details** Once you select a contact from the Contacts listing page, the Contact Details page opens. It provides a centralized workspace to view and manage contact information, associated records, recent activity, notes, and attachments. The page follows a three-panel layout consisting of the left panel, center panel, and right panel. ![1 2](https://mintcdn.com/zuperinc/SdGJwqNAUpyP_IrO/images/1-2.png?fit=max\&auto=format\&n=SdGJwqNAUpyP_IrO\&q=85\&s=3675e399700efdb62486af09ecf3b7a0) ### Left Panel- Contact Information The left panel displays the contact's basic information and provides quick access to commonly used actions. At the top of the panel, you can view the contact's name and address. You can also access quick actions to create a related record, send an email, make a call, add a note, or perform other contact-related actions. Below the contact information, the Primary Details section displays key information, including: * Organization: The organization associated with the contact. * Category: The category assigned to the contact. * Email: The contact's email address. * Home: The contact's home phone number. * Work: The contact's work phone number. * Mobile: The contact's mobile number. * Tags: Tags associated with the contact. * Lead Source: The source from which the contact was acquired. * Pricelist: The pricelist associated with the contact. * Status: The current status of the contact. * Service Address: The address where services are provided. * Billing Address: The contact's billing address. * Portal Access: Indicates whether the contact has access to the customer portal. * Tax Preference: Displays the contact's tax preference. ## Center Panel – Contact Workspace The center panel provides access to contact-related information through different tabs. These tabs help you view and manage records associated with the contact. > [accordion] Overview > > The Overview tab provides a summary of the contact's information, including key highlights, recent activity, and associated records. > > You can view the following sections: > > * Highlights: Displays key financial and communication information, such as receivables, credits, and the last email date. > * Recent Activity: Shows the latest actions and updates performed on the contact. > * Recent Jobs: Displays jobs associated with the contact, including job numbers, statuses, and scheduled dates. > * Recent Quotes: Displays quotes created for the contact, along with their estimate numbers, due dates, statuses, and total amounts. > * Recent Invoices: Displays invoices associated with the contact and their details. > [accordion] Jobs > > The Jobs tab displays all jobs associated with the contact. You can review job details, track their statuses, and access individual job records. > [accordion] Quotes > > The Quotes tab displays quotes created for the contact. You can review estimate numbers, due dates, statuses, and total amounts. > [accordion] Invoices > > The Invoices tab displays invoices associated with the contact, helping you review billing records and payment statuses. > [accordion] Payments > > The Payments tab displays payments received from the contact, allowing you to review payment-related records. > [accordion] Projects > > The Projects tab displays projects associated with the contact. You can access the project records to review their details and track progress. > [accordion] Work Orders > > The Work Orders tab displays work orders associated with the contact, allowing you to review and manage related service work. > [accordion] Material Orders > > The Material Orders tab displays material orders associated with the contact, helping you track requested materials and their fulfillment. > [accordion] Requests > > The Requests tab displays service requests raised by the contact. You can review and manage the requests from this section. > [accordion] Communication > > The Communication tab displays communication records associated with the contact, such as emails and calls. > [accordion] Assets > > The Assets tab displays assets associated with the contact, providing access to their related records. > [accordion] Contracts > > The Contracts tab displays contracts linked to the contact, allowing you to review the associated agreements. > [accordion] Properties > > The Properties tab displays properties associated with the contact. You can access these records to view property-related information. > [accordion] Outbound Logs > > The Outbound Logs tab displays logs of outbound communications sent to the contact. > [accordion] Notes > > The Notes tab displays notes added to the contact. You can add comments, reminders, or supporting information and review existing notes. > [accordion] Activity > > The Activity tab provides a chronological history of actions and updates performed on the contact. It helps you track changes and monitor contact-related activities. > [accordion] Gallery > > The Gallery in Contacts includes photos and videos associated with the contact, bringing all contact-related media into one unified view. You can browse, filter, and organize media uploaded across jobs linked to the contact. > > For more information about the available Gallery actions, see the [Jobs Gallery](https://docs.zuper.co/Work_Order_Management/Jobs/Jobs_gallery) article. > > ![4 2](https://mintcdn.com/zuperinc/SdGJwqNAUpyP_IrO/images/4-2.png?fit=max\&auto=format\&n=SdGJwqNAUpyP_IrO\&q=85\&s=113427c61cd5b049edc222585c77f2e4) > > > [!NOTE] > > > > **Note**: Photos and videos added to a job's Gallery are also available in the associated customer's Gallery. However, media uploaded directly to the customer's Gallery is not automatically associated with jobs created for that customer. When you select [**Filter > Show Related**](https://docs.zuper.co/Work_Order_Management/Jobs/Jobs_gallery#filtering-media) in the Job's Gallery, all media uploaded directly to the customer's Gallery is also displayed. ### Right panel The right panel displays files attached to the contact. You can view existing attachments and upload additional files using the + icon or the Add Attachments button. ## More actions The More Actions menu at the top-right corner of the page provides additional options for managing the contact. The available actions include: ![3 2](https://mintcdn.com/zuperinc/SdGJwqNAUpyP_IrO/images/3-2.png?fit=max\&auto=format\&n=SdGJwqNAUpyP_IrO\&q=85\&s=9f07307624b41be92fc01061d4579f40) > [accordion] Edit Contact > > Update the contact’s information, such as name, email, phone numbers, or associated organization. > > > [!NOTE] > > > > **Updating a contact's email does not update existing jobs.** > > > > When you change the email address on a contact profile, Zuper saves the new email on the profile only. Jobs that were already created keep the original email address in their service contact details. You must update each existing job manually to reflect the new email. > [accordion] Email/Text > > Instantly send an email or text to the contact directly from the system for quick communication. > [accordion] Print/Send Statement > > Generate and share a print-friendly version of the contact’s financial statement, including invoices and payment history. > [accordion] Merge Contact > > Combine duplicate contacts into a single profile to avoid redundancy and maintain clean records. > [accordion] Deactivate > > Temporarily disable a contact without deleting their data, preserving historical information for future reference. Once deactivated, you will have the option to activate or delete the contact. ### View Auto-Created Property When Auto-Create Property is enabled, Zuper automatically creates a property record when you save a contact with a valid service address. You don't need to create or associate the property manually. To view the auto-created property: 1. Open the contact details page. 2. Locate the Properties tab. 3. Select the property to view its details. A quick-view panel opens showing the property name, location, number of jobs, and associated contacts. This is a good way to get a summary without leaving the page. 4. To see the full property record, select **View details in a new tab** in the quick-view panel. ![2 2](https://mintcdn.com/zuperinc/SdGJwqNAUpyP_IrO/images/2-2.png?fit=max\&auto=format\&n=SdGJwqNAUpyP_IrO\&q=85\&s=8a97ef6a5301f32f6b212ee6d162a363) ## FAQs > [accordion] I updated a contact's email address. Why do my existing jobs still show the old email? > > Zuper saves the new email on the contact profile only. It does not automatically apply the change to jobs that were created before the update. Each existing job stores its own copy of the service contact details at the time the job was created. > > To update the email on an existing job, open the job and edit the service contact details directly. You must do this for each affected job individually. > > If the issue continues, contact [Support](mailto:support@zuper.co). > [accordion] Why did an SMS notification reach the wrong person? > > SMS notifications are delivered to the phone number saved on the contact record. If the same number is saved on more than one contact — for example, on both a primary customer and a secondary contact — the message is delivered to whoever owns that number, while the message content and outbound log continue to reference the primary customer. > > To prevent messages reaching an unintended recipient, make sure each contact record holds only that contact's own phone number, and check for duplicate numbers across related contacts. # Adding new organization Source: https://docs.zuper.co/Client/Organization/Create_Organization Adding an organization allows you to manage business-level client information. This includes essential details such as the organization's name, location, tax and billing information, and primary points of contact. By setting up an organization, you can group multiple customers under one business entity, making it easier to handle corporate accounts, manage multi-site service needs, and generate consolidated reports. Follow the steps below to set up an organization and link it with customers and service locations effectively. **Navigation**: Clients -> *Organizations* -> + *New Organization* 1. Select the "**Clients**" module from the left navigation menu and choose "**Organizations**". ![Create Org1 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Organization/Create_Org1.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=96afacd5e9adeefdc176c7099eb9ddc5) 2. The **Organizations** listing page appears. 3. Click the "**+ New Organization**" button at the top right corner of the page. ![Create Org2 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Organization/Create_Org2.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=5de33d19b4945036aa424f2afb71c1be) 4. Fill in the following sub-sections: 1. **Primary Details** * **Organization Name**: Enter the official name of the organization. * **Organization Logo**: Upload a logo to visually identify the organization in the platform. * **Organization Email**: Provide the organization's official email address. This email will be used for sending job-related notifications, invoices, and other communications. * **Preferred Timezone**: Choose the timezone in which the organization primarily operates. This ensure that all time-sensitive activities, such as job scheduling, and alerts are correctly aligned with their local time. * **Pricelist**: Select the relevant price list to be applied when jobs or services are performed for this organization. ![Create Org3 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Organization/Create_Org3.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=20fb8b65fe1d638d832355ee9110f4fb) 2. **Tax Details** Choose the applicable tax settings for the organization based on your region or internal policies. These settings will automatically be applied to invoices and billing documents. ![Create Org4 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Organization/Create_Org4.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=943926c57e208088bca629673430dc72) 3. **Service and Billing Address** Add the organization's service and billing locations. You can specify these details in two ways. 1. Address Entry: Type the full physical address. 2. Geo-Coordinates: Enter latitude and longitude if you want to use exact map-based positioning. ![Create Org5 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Organization/Create_Org5.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=e15d16b81ad3e676ca7c08e2a1fda17b) > [!TIP] > > For the most accurate location data, use the **"Pick from Map"** option. This allows you to pinpoint the address directly on the map interface.\ > Once you've selected the correct location, click "**Use this Address**" to save the information. > > ![Create Org6 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Organization/Create_Org6.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=cc556480f054b3f4d3431ee67ff41754) 4. **Customers/Contacts and Properties information** You can associate customers and their properties with the organization to ensure seamless tracking of service history and work orders. > [accordion] To add contacts > > * Click **"+ Pick Contacts"** in the *Primary Information* section. > * A pop-up will appear listing all available customers/contacts. Select one or more to link them to the organization. > > ![Create Org7 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Organization/Create_Org7.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=b392db242a716179408c83baa274b000) > [accordion] To add properties > > * Click **"+ Pick Property"** next to the *Property* section. > * Use the pop-up to search and select the relevant properties that belong to the organization. > > ![Create Org8 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Organization/Create_Org8.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=aeb32f42f0cbadd34e060250b31961a3) 5. **Other Details** If any custom fields are added under the settings, you can fill in the details here. 6. **Save organization** After entering all the necessary details, click the "**Save Organization**" button to successfully create the organization. ![Create Org9 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Organization/Create_Org9.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=9f413827ad47ebc3fc4dff2f72a3368a) The Organization module contains different company details linked to the customer contacts. Associating these modules can help the field technician operate efficiently.    # Managing the organization detail Source: https://docs.zuper.co/Client/Organization/Managing_Organization Effectively managing organizational information is essential for delivering personalized service, maintaining accurate records, and streamlining field operations. Zuper offers a centralized platform to create, organize, and maintain comprehensive organization profiles that are a single source of truth for your customer data. By consolidating key details such as contact information, service addresses, tax preferences, and linked customers or properties, Zuper enables businesses to deliver better customer experiences and improve job execution. Organizations are the foundation for associating jobs, invoices, contracts, and assets, making them critical to day-to-day operations. With a structured and unified approach, you can easily manage all your organization's records while maintaining visibility into the entities you serve. This guide will walk you through accessing the Organizations module, creating new records, and managing organization-related data efficiently. ## Accessing the Organization listing page **Navigation**:  Clients  -> *Organizations ->  Organization listing page* The Organization Listing Page layout in Zuper includes view management, column selection, views, and saving customized views. This process is performed directly on the module’s listing page. **Default Listing Behavior** The system retains its existing default listing behavior, ensuring that pre-set configurations or default views are preserved. When you first access the Organization Module Listing Page, you’ll see the default view with columns such as Organization Number, Organization Address, Organization Tags, and Organization Status. ## **Create View Configuration** **Selecting Columns** You can choose which columns to display to focus on relevant data: 1.     Select the “**Organization**” module from the left navigation menu. You can view the listing page. ![Orgl1 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl1.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=2914e089ddc10a43dd3903920bd9bdec) 2. From the “**Views**” list, click “**+Create new view**.” ![Orgl2 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl2.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=7dc6aad3ea23d4bb55f682ad30ff63bc) 3. A “**Create View**” dialog box appears. View Name (**Mandatory**) – Enter the view name. Share with - Select any one of the options (User, Team), and you can add the relevant users. Visibility to all users – Toggle on to make this view visible. ![Orgl3 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl3.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=b807e30cf1990c48a18209579f246f5e) 4. Once you click “**Create**,” the **Columns** sidebar appears, showing “**Available Columns**” and “**Displayed Columns**.” To add a column, drag and drop it from the “**Available Columns**” list on the left to the “**Displayed Columns**” list on the right. You can click “**Continue**.” ![Orgl4 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl4.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=3a5ebfd2e16c5e80517f4d5a087d5ccc) 5. To remove a column, drag it from the “**Displayed Columns**” list back to the “**Available Columns**” list or click the **-** next to the column name. Click **Continue** to apply the changes. ![Orgl5 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl5.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=c8504b74811b59a5ad22cdcb172fee84) 6. If you wish not to add any filter, click “**Skip and Save**” to create the view. ![Orgl6 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl6.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=21a89efd7316d378c3c05de197548261) 7. The view is saved successfully. ![Orgl7 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl7.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=968717dde3293af7fc8a108929e1f2f4) ## **Applying filters** The Filter feature lets you refine your view by applying multiple filters based on available attributes. For example, you can select an attribute like "**Organization Status Type**," choose conditions such as "**Equal to**," "**Contains**," or "**Does Not Contain**," and choose the desired value. Once the filter is applied, the results will update to show only the Organizations that meet your criteria, making it easier to find and manage relevant Organizations. 1. Click "**Filter"** at the top left of the page. Choose the attributes you want to filter by, apply the desired conditions, and click the "**Add"** button to view the results. ![Orgl8 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl8.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=84863013200f119d9367a04dca0ecd25) 2. Click “**Update View**” to modify the existing view. ![Orgl9 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl9.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=ebb03a91c15d33ea9660ff4e3c1f0c0a) 3. The new view is set successfully with the filter. You can view the filter created and the filter name from the view list. ![Orgl10 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl10.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=c819062784d476c59d3069f85769af19) ## **Update View** An update view allows you to modify the current display settings of the "**Organization**" section. After making changes, you can save the updated configuration to the existing one or name it a new view. 1. Add/remove the existing columns and click “**Update View**” to modify the existing view. ![Orgl9 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl9.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=ebb03a91c15d33ea9660ff4e3c1f0c0a) 2. The view is updated successfully. ![Orgl10 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl10.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=c819062784d476c59d3069f85769af19) 3. Click the down arrow below the “**Update View**” to create a new view by clicking “**Save as new view**.” ![Orgl13 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl13.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=b65a78db35eadb1add72b489ebf3d67d) 4. A “**Create View**” dialog box appears. * View Name (**Mandatory**) – Enter the view name. * Share with - Select any one of the options (User, Team), and you can add the relevant users. * Visibility to all users – Toggle on to make this view visible. Click “**Create**” to create the new view. ![Orgl3 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl3.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=b807e30cf1990c48a18209579f246f5e) 5. Click “**Reset View**” to reset the current view. ![Orgl11 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl11.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=c75b728daa33d697e7867b6a41ec8066) ## **Setting Permissions for Views** ### **Edit Permissions** Users with edit permissions can modify the layout: * They can add/remove columns, reorder them, and adjust views as described above. * If permission is given, changes can be saved as a new view or overwritten as an existing one. ### **View Permissions** Users with view-only permissions can see the layout but cannot make changes: * They can view the customized columns and filters but cannot edit them. To ensure consistency for viewers, they can save them as a new “**View**.” ### **Make changes to the view** * **Rename**: This option allows you to change the view's name (e.g., from “**Org**” to something else). * **Visibility**: This lets you adjust who can see the view. Options include sharing with a user or team or keeping it private (“**Only Me**”), as well as toggling visibility for all users in Zuper (as shown in the “Create a View” dialog in prior images). * **Duplicate**: This function creates a copy of the “**Org**” view, allowing you to modify the duplicate without affecting the original. * **Delete**: Removes the view entirely. Since this is a custom view, deleting it would revert the listing to the default view or another saved view. Only the created user can delete the view. ![Orgl14 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl14.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=0be256ad4d6925afd9dfbd22e8dc8bd7) ## Pinned filters Zuper's Organizations module lets you use pinned filters to streamline your filter experience. Pinned filters keep your most-used criteria readily accessible for quick application. Pin up to 3 filters in any module. ***Navigation***: Clients -> Organizations -> Filters -> Pinned Filter 1. Select the “**Clients**” module from the left navigation menu. Choose the “**Organizations**.” ![Pinorg1 Pn](https://mintcdn.com/zuperinc/uWJXnqMkUObW6Xs-/images/pinorg1.png?fit=max\&auto=format\&n=uWJXnqMkUObW6Xs-\&q=85\&s=94262f58d894ba42f326da9e1977c6ad) 2. **Pin Filters for Quick Access** * Once your filters are set, click the **Pin Filters** button in the dialog box to save them as pinned. * Pinned filters appear in the dialog box's "**Pinned Filters**" section, allowing you to apply them with one click in future sessions. ![Pinorg2 Pn](https://mintcdn.com/zuperinc/uWJXnqMkUObW6Xs-/images/pinorg2.png?fit=max\&auto=format\&n=uWJXnqMkUObW6Xs-\&q=85\&s=43bd81ae09509c28ca745d1b448b0263) 3. To Unpin the filter: * To unpin, select a pinned filter and click **Remove**. * To apply pinned or default filters, open the dialog box and select them. * Use **Clear All** to remove active filters. ![Pinorg3 Pn](https://mintcdn.com/zuperinc/uWJXnqMkUObW6Xs-/images/pinorg3.png?fit=max\&auto=format\&n=uWJXnqMkUObW6Xs-\&q=85\&s=590b99c78784ce806a3e40c7de66fc02) The Organization Listing Page in Zuper allows for flexible layout customization directly on the listing page. You can select and reorder columns, apply views, save customized views, and set permissions to ensure the right level of access for your team. Use the steps above to tailor the view to your workflow and save it for future use. After filtering a specific Organization, click the “**Organization** **Name**” on the listing page to view and manage its details on the Organization details page. ### Creating a new organization You can quickly create a new organization directly from the listing page. 1. Click the "**+ New Organization**" button at the top right corner. 2. Fill in the required fields such as *Organization Name, Contact Information, Tax Details,* and *Service Addresses*. 3. For a step-by-step walkthrough, refer to the [Creating a new organization](https://docs.zuper.co/Client/Organization/Create_Organization) article. ![Organization4 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Organization/Organization4.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=df6556d17080ae249af053421904a4b8) *** ### **Managing organization details** Once you select an organization from the Organizations listing page, the **Organization Details** page opens. It provides a centralized workspace to view and manage organization information, associated records, recent activity, and attachments. The page follows a three-panel layout consisting of the left panel, center panel, and right panel. ![Image](https://mintcdn.com/zuperinc/V8kBP4pFnO5EgXUT/images/image-30.png?fit=max\&auto=format\&n=V8kBP4pFnO5EgXUT\&q=85\&s=4919cce4cf9f0ad0143ca912ee42d703) ## Left panel – Organization Information The left panel displays the organization's basic information and provides quick access to commonly used actions. At the top of the panel, you can view the **Organization Name** and **Service Address**. You can also use the quick actions to create a related record, send an email, or add a note to the organization. Below the organization information, the **Primary Details** section displays key information, including: * **Email:** The organization's email address. * **Pricelist:** The pricelist associated with the organization. * **Service Address:** The primary address where services are provided. * **Billing Address:** The organization's billing address. * **Tax Preference:** Indicates whether the organization is taxable or tax-exempt. * **Tax Group:** The tax group associated with the organization. * **Created By:** The user who created the organization. * **Last Updated at:** The date the organization details were last updated. The **Description** section displays additional information about the organization. ## Center Panel – Organization Workspace The center panel provides access to organization-related information through different tabs. These tabs help you view and manage records associated with the organization. ## Right panel In the right panel, you can view the other module details interlinked with the organization module, such as contacts, property, project, quotes, invoice contract, and assets association for the organization. > [accordion] Overview > > The **Overview** tab provides a summary of the organization's recent activities and associated records. > > You can view the following sections: > > * **Recent Activity:** Displays the latest actions and updates performed on the organization, helping you track changes made by users. > * **Recent Jobs:** Displays jobs associated with the organization, along with their job numbers, statuses, and scheduled dates. > * **Recent Quotes:** Displays quotes created for the organization, including estimate numbers, due dates, statuses, and total amounts. > * **Recent Invoices:** Displays invoices associated with the organization, along with their invoice details and payment statuses. > [accordion] Jobs > > The **Jobs** tab displays all jobs associated with the organization. You can review job details, track their statuses, and access individual job records. > [accordion] Quotes > > The **Quotes** tab displays quotes created for the organization. You can review quote details, including estimate numbers, due dates, statuses, and total amounts. > [accordion] Invoices > > The **Invoices** tab displays invoices associated with the organization. You can review invoice details and track their payment statuses. > [accordion] Projects > > The **Projects** tab displays projects associated with the organization, allowing you to access and manage their related records. > [accordion] Requests > > The **Requests** tab displays service requests associated with the organization. You can review and track the requests submitted by or for the organization. > [accordion] Assets > > The **Assets** tab displays assets associated with the organization, providing access to their related records. > [accordion] Contracts > > The **Contracts** tab displays contracts associated with the organization, allowing you to review and access contract details. > [accordion] Properties > > The **Properties** tab displays properties associated with the organization, along with their related information. > [accordion] Contacts > > The **Contacts** tab displays contacts associated with the organization. You can access individual contact records and review their details. > [accordion] Notes > > The **Notes** tab displays notes added to the organization. Notes can include text, images, videos, or documents that provide useful information about the organization. > [accordion] Activity > > The **Activity** tab provides a chronological history of actions and updates performed on the organization. It helps you track changes and monitor organization-related activities. ## Right Panel – Attachments The right panel displays files attached to the organization. You can view existing attachments and upload additional files using the **+** icon or the **Add Attachments** button. ## More Actions The **More Actions** menu at the top-right corner of the page provides additional options for managing the organization. The available actions include: ![Image](https://mintcdn.com/zuperinc/V8kBP4pFnO5EgXUT/images/image-31.png?fit=max\&auto=format\&n=V8kBP4pFnO5EgXUT\&q=85\&s=89558a5d1327e15fd7a9f5b1ca474b0c) > [accordion] Edit Organization > > Opens the organization details for editing. You can update the organization's information as needed. > [accordion] Print/Send Statement > > Allows you to print or send the organization's statement. > [accordion] Deactivate > > Allows you to temporarily disable an organization without losing data. > [!NOTE] > > **How Field Executives access organizations** > > Field Executives see only organizations they have personally created in > their default Organizations list. Organizations created by other users > do not appear in the list, even if the FE is assigned to a job at that > organization. > > * **Via job records**: Organizations linked to a job are accessible > from within the job record and appear in search results, but are > not added to the FE's default list. > * **"Assigned" means via jobs**: There is no direct > organization-to-user assignment in Zuper. A FE being "assigned" > to an organization means they have at least one job associated > with that organization. > > **To give Field Executives visibility into all organizations**, enable > the **Allow Field Executive to View All Organizations** setting in > **Settings → \[confirm path]**. See > [Managing Your Users](/Settings/Users_Teams/Users_Creation) for > related access settings. # Overview Source: https://docs.zuper.co/Client/Overview The **Client module** in Zuper serves as the foundation for managing all your customer-related information. Whether you're scheduling a job, dispatching a technician, generating an invoice, or reviewing service history, it all starts with your client data, organized into **Customers**, **Organizations**, and **Properties**. Understanding how these components work together helps you deliver better service, streamline operations, and maintain clean, structured records for every interaction. ## What is the client module used for? The Client module is where you: * Add and manage individual **customers** and their contact details. * Group customers under **organizations** (such as companies or franchises). * Define **properties** (locations) where field jobs are performed. * Track service history, jobs, invoices, and communications by customer, organization, or property. * Ensure accurate job scheduling, invoicing, and reporting. It provides a single source of truth for your service operations. ## Customers/Contacts A **Customer** in Zuper refers to an individual person who receives your services or communicates with your field teams. The **Customers** page allows you to manage individual clients and their essential contact details, such as names, phone numbers, email addresses, and service preferences. Each customer profile can also store a complete history of jobs, invoices, and communications, making providing personalized and responsive service easier. Customers can be standalone records or linked to an organization or a specific property, depending on the nature of the service relationship. ## Organizations An **Organization** represents a *business*, *company*, or *corporate entity*. The **Organizations** page captures company-level details, ideal for managing business-to-business (B2B) relationships. It includes fields for company name, headquarters location, tax and billing information, and primary contacts. Organizations help to group multiple customer contacts under a single corporate entity, making it easier to manage clients with multiple branches or teams. This structure enables consolidated reporting, unified billing, and streamlined service management across departments or locations, while still maintaining individual-level records for each customer contact. ## Properties A **Property** is a physical location where your field team delivers services. This could be a home, office, warehouse, apartment complex, or store. Each property record stores address information, associated contact persons, site-specific resources, and a complete service history. Zuper allows you to associate multiple properties with a single customer or organization, enabling independent, accurate scheduling, technician dispatch, and asset tracking for each site. This is particularly beneficial for service providers handling operations across multiple client locations or managing facilities. > [!NOTE] > > Each property can be linked to only one organization at a time. If a property already belongs to an organization, it will not be available to select for another. To reassign a property to a different organization, open the property record and select **Edit** to update the organization. Learn more about [managing properties](https://docs.zuper.co/Client/Property/Managing_Property). Together, these three elements—Customers, Organizations, and Properties—create a powerful, flexible structure that helps teams deliver efficient, accurate, and personalized service with recurring maintenance needs. # Adding new property Source: https://docs.zuper.co/Client/Property/Create_property Adding a property allows you to define the exact physical location where services need to be delivered. A property may represent a customer’s office, retail store, or residence and includes vital information like the address, contact person, and service history. Setting up properties ensures accurate job scheduling, technician dispatching, and record-keeping, especially when a customer has multiple service locations. **Navigation**:  Clients  -> *Properties  ->+ New Property* 1. Select the "**Clients**" module from the left navigation menu and choose **Properties**. ![Property1 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Property/Property1.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=6523ac02a504b34da8fa8a11ef778988) 2. The **Properties** listing page opens. 3. Click the "**+ New Property**" button at the top right corner of the page. A new property creation page will appear. ![Property2 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Property/Property2.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=0b815a825b6c98437aa0497ab7f1f0e3) 4. Fill in the following sub-sections: 1. **Primary Details** * **Choose Organization**: Select the organization that this property belongs to. * **Property Name**: Enter the name of the property. * **Property Image**: Upload an image to visually identify the property. * **Choose Parent Property**: If this property is a child property, choose a parent property. * **Pricelist**: Select the relevant price list to be applied when jobs or services are performed for this property. ![Property3 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Property/Property3.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=940bf434bf989d3936993ec83dd26b76) 2. **Tax Details** Choose the applicable tax settings for the property based on your region or internal policies. These settings will automatically be applied to invoices and billing documents. ![Property4 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Property/Property4.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=4ed4d72c7c6f15b20a82fdec30d4ff64) 3. **Property Address** Add the property locations. You can specify these details in two ways. * **Address Entry**: Type the full physical address. * **Geo-Coordinates**: Enter latitude and longitude if you want to use exact map-based positioning. ![Property5 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Property/Property5.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=47bb61a945cb3d4b25709acba9106ff1) > [!TIP] > > For the most accurate location data, use the **"Pick from Map"** option. This allows you to pinpoint the address directly on the map interface.\ > \ > Once you've selected the correct location, click "**Use this Address**" to save the information. ![Property6 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Property/Property6.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=cafb7670f1fa48604a69e1fc090c2b5b) 4. **Contacts**: Add customer information for this property. ![Property7 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Property/Property7.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=b4a76bb96b66f75471598865fdc1bbd1) 5. **Other Details** If any custom fields are added under the settings, you can fill in the details. 6. **Save Property** After entering all the necessary details, click the "**Save Property**" button to successfully create the property. ![Property8 Pn](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Client/Property/Property8.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=82ded833d363a4dd2ebb6d8a384b8707) ### Address sync with customer/contacts If this property is linked to a contact, Zuper keeps the addresses on both records in sync. Update the address here, and Zuper updates the service address on the linked contact automatically and vice versa. Creating a property is essential for associating it with multiple modules, such as assets and contacts. This association enables field technicians to efficiently provide services to end contacts.  ![Autpr7](https://mintcdn.com/zuperinc/zPFSMPwA21WlsNQ-/images/autpr7.png?fit=max\&auto=format\&n=zPFSMPwA21WlsNQ-\&q=85\&s=63fd182b6a0bde98b4c50c8fc783c292) # Managing the property detail Source: https://docs.zuper.co/Client/Property/Managing_Property Efficiently managing property information is crucial for delivering high-quality service, ensuring accurate job allocation, and maintaining clear visibility across all service locations. Zuper provides a centralized and structured property module that allows you to create, organize, and maintain detailed property records, serving as a single source of truth for all location-based customer data. With Zuper, you can consolidate key details like property address, contact information, tax details, and linked customer or organization records. Properties act as foundational entities for associating jobs, invoices, assets, and projects, making them essential to the day-to-day functioning of your field service operations. This guide will help you access the Properties module, create new property records, and manage property-related information effectively. ## Accessing the property listing page The Property Listing Page layout in Zuper includes view management, column selection, views, and saving customized views. This process is performed directly on the module’s listing page. ## **Default Listing Behavior** The system retains its existing default listing behavior, ensuring that pre-set configurations or default views are preserved. When you first access the Property Module Listing Page, you’ll see the default view with columns such as Property Number, Property Address, Property Tags, and Property Status. **Navigation**: Clients ->*Properties* -> *Properties listing page* * Select the "**Client**" module from the left navigation menu and choose "**Properties**." * You will land on the **Properties** listing page, which provides a comprehensive view of all your properties with key information such as Property Name, Status, Associated Customer or Organization, and Created By. ![Property1 Pn](https://mintcdn.com/zuperinc/noPgwpKDoZrQKHPY/images/property1.png?fit=max\&auto=format\&n=noPgwpKDoZrQKHPY\&q=85\&s=dee1da424f10f38a2cbad7b97150927b) 2. From the “**Views**” list, click “**+Create new view**.” ![Orgl2 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl2.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=7dc6aad3ea23d4bb55f682ad30ff63bc) 3. A “**Create View**” dialog box appears. View Name (**Mandatory**) – Enter the view name. Share with - Select any one of the options (User, Team), and you can add the relevant users. Visibility to all users – Toggle on to make this view visible. ![Orgl3 Pn](https://mintcdn.com/zuperinc/Nz5hYkeVtSkMQBoe/images/Orgl3.png?fit=max\&auto=format\&n=Nz5hYkeVtSkMQBoe\&q=85\&s=b807e30cf1990c48a18209579f246f5e) 4. Once you click “**Create**,” the **Columns** sidebar appears, showing “**Available Columns**” and “**Displayed Columns**.” To add a column, drag and drop it from the “**Available Columns**” list on the left to the “**Displayed Columns**” list on the right. You can click “**Continue**.” ![Propl4 Pn](https://mintcdn.com/zuperinc/KefXDBv2w02vbWo0/images/Propl4.png?fit=max\&auto=format\&n=KefXDBv2w02vbWo0\&q=85\&s=1330204bda621f8d3fb7a56486c128a8) 5. To remove a column, drag it from the “**Displayed Columns**” list back to the “**Available Columns**” list or click the **-** next to the column name. Click **Continue** to apply the changes. ![Propl5 Pn](https://mintcdn.com/zuperinc/KefXDBv2w02vbWo0/images/Propl5.png?fit=max\&auto=format\&n=KefXDBv2w02vbWo0\&q=85\&s=f033ba21d8bcc5e785bd4fe7031a3a0e) 6. If you wish not to add any filter, click “**Skip and Save**” to create the view. ![Propl6 Pn](https://mintcdn.com/zuperinc/KefXDBv2w02vbWo0/images/Propl6.png?fit=max\&auto=format\&n=KefXDBv2w02vbWo0\&q=85\&s=cb8a2c3f914c2afd93ae8f559a39fab2) 7. The view is saved successfully. ![Propl7 Pn](https://mintcdn.com/zuperinc/KefXDBv2w02vbWo0/images/Propl7.png?fit=max\&auto=format\&n=KefXDBv2w02vbWo0\&q=85\&s=d1d536cbbb133d4d6567f084a8057e01) ### **Applying filters** The Filter feature lets you refine your view by applying multiple filters based on available attributes. For example, you can select an attribute like "**Contact Status Type**," choose conditions such as "**Equal to**," "**Contains**," or "**Does Not Contain**," and choose the desired value. Once the filter is applied, the results will update to show only the Properties that meet your criteria, making it easier to find and manage relevant Properties. 1. Click "**Filter"** at the top left of the page. Choose the attributes you want to filter by, apply the desired conditions, and click the "**Add"** button to view the results. ![Propl9 Pn](https://mintcdn.com/zuperinc/KefXDBv2w02vbWo0/images/Propl9.png?fit=max\&auto=format\&n=KefXDBv2w02vbWo0\&q=85\&s=71a9607663315edc50c3859c30f407af) 2. Click “**Update View**” to modify the existing view. ![Propl10 Pn](https://mintcdn.com/zuperinc/KefXDBv2w02vbWo0/images/Propl10.png?fit=max\&auto=format\&n=KefXDBv2w02vbWo0\&q=85\&s=bbd9fec6ecfdd12cb971b459d2237ede) 4. The new view is set successfully with the filter. You can view the filter created and the filter name from the view list. ![Propl7 Pn](https://mintcdn.com/zuperinc/KefXDBv2w02vbWo0/images/Propl7.png?fit=max\&auto=format\&n=KefXDBv2w02vbWo0\&q=85\&s=d1d536cbbb133d4d6567f084a8057e01) ## **Update View** An update view allows you to modify the current display settings of the "**Property**" section. After making changes, you can save the updated configuration to the existing one or name it a new view. 1. Add/remove the existing columns and click “**Update View**” to modify the existing view. ![Propl10 Pn](https://mintcdn.com/zuperinc/KefXDBv2w02vbWo0/images/Propl10.png?fit=max\&auto=format\&n=KefXDBv2w02vbWo0\&q=85\&s=bbd9fec6ecfdd12cb971b459d2237ede) 2. The view is updated successfully. ![Propl7 Pn](https://mintcdn.com/zuperinc/KefXDBv2w02vbWo0/images/Propl7.png?fit=max\&auto=format\&n=KefXDBv2w02vbWo0\&q=85\&s=d1d536cbbb133d4d6567f084a8057e01) 3. Click the down arrow below the “**Update View**” to create a new view by clicking “**Save as new view**.” ![Propl12 Pn](https://mintcdn.com/zuperinc/KefXDBv2w02vbWo0/images/Propl12.png?fit=max\&auto=format\&n=KefXDBv2w02vbWo0\&q=85\&s=a833c48c8ecfcc744de53c42032d5e12) 4. A “**Create View**” dialog box appears. * View Name (**Mandatory**) – Enter the view name. * Share with - Select any one of the options (User, Team), and you can add the relevant users. * Visibility to all users – Toggle on to make this view visible. Click “**Create**” to create the new view. ![Propl3 Pn](https://mintcdn.com/zuperinc/KefXDBv2w02vbWo0/images/Propl3.png?fit=max\&auto=format\&n=KefXDBv2w02vbWo0\&q=85\&s=0506b0d465bd511885ff840c9d571635) 5. Click “**Reset View**” to reset the current view. ![Propl11 Pn](https://mintcdn.com/zuperinc/KefXDBv2w02vbWo0/images/Propl11.png?fit=max\&auto=format\&n=KefXDBv2w02vbWo0\&q=85\&s=e16bb6ab1e5affdf96ff48a65fa93f69) ## **Setting Permissions for Views** ### **Edit Permissions** Users with edit permissions can modify the layout: * They can add/remove columns, reorder them, and adjust views as described above. * If permission is given, changes can be saved as a new view or overwritten as an existing one. ### **View Permissions** Users with view-only permissions can see the layout but cannot make changes: * They can view the customized columns and filters but cannot edit them. To ensure consistency for viewers, they can save them as a new “**View**.” ### **Make changes to the view** * **Rename**: This option allows you to change the view's name (e.g., from “**Prop**” to something else). * **Visibility**: This lets you adjust who can see the view. Options include sharing with a user or team or keeping it private (“Only Me”), as well as toggling visibility for all users in Zuper (as shown in the “Create a View” dialog in prior images). * **Duplicate**: This function creates a copy of the “**Prop**” view, allowing you to modify the duplicate without affecting the original. * **Delete**: Removes the view entirely. Since this is a custom view, deleting it would revert the listing to the default view or another saved view. Only the created user can delete the view. ![Propl13 Pn](https://mintcdn.com/zuperinc/KefXDBv2w02vbWo0/images/Propl13.png?fit=max\&auto=format\&n=KefXDBv2w02vbWo0\&q=85\&s=a929bbb3d4783bba328e4361162d1d70) ## Pinned filters Zuper's Properties module lets you use pinned filters to streamline your filter experience. Pinned filters keep your most-used criteria readily accessible for quick application. Pin up to 3 filters in any module. **Navigation**: *Clients -> Properties à Filters -> Pinned Filter* 1. Select the “**Clients**” module from the left navigation menu. Choose the “**Properties**.” ![Pinprop1 Pn](https://mintcdn.com/zuperinc/uWJXnqMkUObW6Xs-/images/pinprop1.png?fit=max\&auto=format\&n=uWJXnqMkUObW6Xs-\&q=85\&s=180d64c33d93d2621dd7bdd5acacc198) 2. **Pin Filters for Quick Access** * Once your filters are set, click the **Pin Filters** button in the dialog box to save them as pinned. * Pinned filters appear in the dialog box's "**Pinned Filters**" section, allowing you to apply them with one click in future sessions. ![Pinprop2 Pn](https://mintcdn.com/zuperinc/PtS7YCn8YsZYz1Ad/images/pinprop2.png?fit=max\&auto=format\&n=PtS7YCn8YsZYz1Ad\&q=85\&s=b296f231f37abcc5617ae9a335fa6541) 3. To Unpin the filter: * To unpin, select a pinned filter and click **Remove**. * To apply pinned or default filters, open the dialog box and select them. * Use **Clear All** to remove active filters and return to the full job list. ![Pinprop3 Pn](https://mintcdn.com/zuperinc/PtS7YCn8YsZYz1Ad/images/pinprop3.png?fit=max\&auto=format\&n=PtS7YCn8YsZYz1Ad\&q=85\&s=573c798972d3229430f044ee99900294) ## Creating a new property You can quickly create a new property directly from the listing page. 1. Click the "**+ New Property**" button in the top right corner. 2. Fill in the required fields such as *Property Name, Property Address, Contact Information*, and *Tax Details*. 3. For a step-by-step walkthrough, refer to the [Creating a new property](https://docs.zuper.co/Client/Property/Create_property) article. ![Property4 Pn](https://mintcdn.com/zuperinc/noPgwpKDoZrQKHPY/images/property4.png?fit=max\&auto=format\&n=noPgwpKDoZrQKHPY\&q=85\&s=a7ef49e89dbe15ae08fadc30d301c818) ### **Managing property details** Once you select a property from the Properties listing page, the Property Details page opens. It provides a centralized workspace to view and manage property information, associated records, recent activities, and attachments. ![4 1](https://mintcdn.com/zuperinc/SdGJwqNAUpyP_IrO/images/4-1.png?fit=max\&auto=format\&n=SdGJwqNAUpyP_IrO\&q=85\&s=53d8b698d8d610eb00cff64a04f4e151) ### Left Panel – Property Information The left panel displays the property's basic information and provides quick access to create property-related records, such as Jobs, Projects, Quotes, and Invoices, as well as to add notes. At the top, you can view the following details: * Property Name: Displays the name of the property. * Property Address: Displays the property's location. Below this, the Primary Details section displays the following information: * Organization: The organization associated with the property. * Parent Property: The parent property, if applicable. * Pricelist: The pricelist associated with the property. * Property Address: The property's registered address. * Assigned To: The users or teams assigned to the property. * Tax Preference: The property's applicable tax preference. * Tags: Tags associated with the property. * Created By: The user who created the property. * Last Updated At: The date and time when the property was last updated. ## Center Panel The center panel provides access to property-related information through different tabs. > [accordion] Overview > > The Overview tab provides a snapshot of the property's recent activities and associated records. > [accordion] Jobs > > Displays the jobs associated with the property. You can review job details, track job statuses, and access individual job records. > [accordion] Quotes > > Displays quotes created for the property. You can review quote details, including estimate numbers, dates, statuses, and amounts. > [accordion] Invoices > > Displays invoices associated with the property, allowing you to review invoice details and track their status. > [accordion] Projects > > Displays projects associated with the property. You can access the linked projects and review their details. > [accordion] Requests > > Displays service requests associated with the property, helping you track customer-reported issues and service requirements. > [accordion] Assets > > Displays assets registered or associated with the property. You can access asset details and track the equipment or items maintained at the property. > [accordion] Contracts > > Displays contracts associated with the property, allowing you to review the applicable service agreements. > [accordion] Notes > > Displays notes added to the property. You can add comments, reminders, attachments, and other relevant information for future reference. > [accordion] Activity > > Displays a chronological history of actions performed on the property, helping you track property-related updates and changes. > [accordion] Gallery > > The Gallery in Properties includes photos and videos associated with the property, bringing all property-related media into one unified view. You can browse, filter, and organize media uploaded to the property. > > ![2 1](https://mintcdn.com/zuperinc/SdGJwqNAUpyP_IrO/images/2-1.png?fit=max\&auto=format\&n=SdGJwqNAUpyP_IrO\&q=85\&s=57ed220d0cfd454a533d2378129c3ce5) > > For more information about the available Gallery actions, see the [Jobs Gallery](https://docs.zuper.co/Work_Order_Management/Jobs/Jobs_gallery) article. > > > [!NOTE] > > > > **Note**: Photos and videos added to a job's Gallery are also available in the associated property's Gallery. However, media uploaded directly to the property's Gallery is not automatically associated with jobs linked to that property. Selecting Filter > Show Related in the Job Gallery does not display media uploaded directly to the property's Gallery. ### Right Panel – Attachments The right panel displays files attached to the property. You can view existing attachments and upload additional files using the + icon. ## More Actions The More Actions menu at the top-right corner provides additional options for managing the property. ![3 1](https://mintcdn.com/zuperinc/SdGJwqNAUpyP_IrO/images/3-1.png?fit=max\&auto=format\&n=SdGJwqNAUpyP_IrO\&q=85\&s=c43f9a2addd862583d49c5afc3a31590) > [accordion] Edit Property > > Select this option to modify the existing property details. > [accordion] Deactivate > > Select this option to deactivate the property when it is no longer active. > > > [!NOTE] > > > > Note: You can temporarily disable a property without losing data. Once deactivated, you have the option to activate or delete the property as needed. ### FAQs 1. **Why can I not edit the address on a completed job?** Completed and closed jobs lock the property and schedule fields to preserve the service record. Edit the property record itself (Client > Properties > Edit Property) and the updated address will apply to all future jobs at that property. 2. **Can I change the property on an accepted quote?** No. Once a quote is accepted, the associated customer and property are locked. Clone the quote to create an editable version with the correct property. 3. **I edited the property address b,ut the invoice still shows the old address. Why?** Invoices capture the billing address at the time they were created. Editing the property after invoice creation does not update the address on existing invoices. To correct an invoice address: void the invoice, update the property, then re-create the invoice. # Setting up commissions Source: https://docs.zuper.co/Commissions/Commissions Commissions in Zuper allow you to define and track performance-based commission values for employees based on Job performance. This helps you align incentives with business outcomes. You can reward teams for closing higher-value jobs, maintaining healthy margins, and delivering profitable work. It ensures commission values are structured, measurable, and tied to actual performance. Commissions are configured in **Job Costing & Expenses** and applied directly within the Job workflow. Once added, they are reflected in financial tracking and reporting. For Jobs, commissions are included in job cost calculations. By managing commissions inside the system, you reduce manual calculations and gain clear visibility into both commission values and their impact on profitability. ### **Prerequisites** Before tracking Commissions: * Commission must be enabled for your account. To enable it, contact your account administrator or email [support@zuper.co](mailto:support@zuper.co). * By default, Admins can view and manage Commissions. However, if your business requires different visibility, you can configure access for specific roles. To do this, navigate to:\ **Settings > Users & Teams > Custom Roles > Job/Project**, then enable the **Manage Commissions** toggle. * You must have at least one user/team member assigned to the Job to add a commission. Only assigned users are eligible to receive commission. ## **Set up Commission Rates** Before you can start assigning or tracking commissions on Jobs, you need to set commission rates for your team members. This is a one-time setup. Once completed, commissions can be automatically calculated based on performance. **To assign a commission structure to a user:** 1. Navigate to **More** > **Settings** in the left navigation bar. 2. Click the **Jobs** module in Settings and choose **Job Costing & Expenses**. ![Commission 1](https://mintcdn.com/zuperinc/LNErWh0AG_JtxzVb/Commissions/Images/SCR-20260921-ovwd.png?fit=max\&auto=format\&n=LNErWh0AG_JtxzVb\&q=85\&s=ee69399f6b33b9878f56bab3331eefde) 3. Go to the **Commissions** tab. 4. Click **+ Add Commission**. ![Commission 3](https://mintcdn.com/zuperinc/_M5H7aKxpQP2Mjqk/Commissions/Images/SCR-20260924-mnwx.png?fit=max\&auto=format\&n=_M5H7aKxpQP2Mjqk\&q=85\&s=c18b52ff8aadf92acf948a2f822f5942) 5. The **Build Commission Structure** page will open. Here, you can: 6. Provide a clear and descriptive commission **name**. 7. Select the **users** eligible under this structure. > [!NOTE] > > **Note**: You can define only one commission structure per user. Multiple commission structures for the same user are not allowed. **Define Commission Options** 8. Click **+ Add Commission** under Commission Options. 9. Choose the financial metric by **selecting** **Commission** **Type**: * Planned Revenue * Planned Profit * Planned Profit Margin * Actual Profit * Actual Profit Margin > [!NOTE] > > **Note**: **Actual Revenue** is not available as a selectable Commission Type.\ > By default, Actual Total Revenue is locked to the sum of accepted quote subtotals, based on the revenue configuration defined in Settings. This ensures that profitability and commission calculations are always measured against the customer’s committed contract value, even if job line items are modified during execution. 10. Define the **condition**. 11. Enter the threshold **value**. **Define Commission value** 12. Enter the commission value in the **Add Rate** field. 13. Select value type: * Flat Value * % of Actual Revenue * % of Actual Profit * % of Planned Revenue * % of Planned Profit 14. Click **+** to add additional tiers if required. You can configure multiple conditions and multiple payout tiers within the same structure. 15. Click **Save** once completed. ![Commission 3](https://mintcdn.com/zuperinc/z6lEcH8zRXGDkSIo/Commissions/Images/Commission-4.png?fit=max\&auto=format\&n=z6lEcH8zRXGDkSIo\&q=85\&s=a09a61b0759a60045e605abb1a0c93e6) **Managing a Commission Structure** Once a commission structure is created, you can modify it anytime. From the **Commission** list page: * Click the three-dot menu beside a commission structure. * Choose **Edit** to update the configuration. * Choose **Disable** to make it inactive. Disabling a structure prevents it from being applied to new jobs. A disabled structure can then be deleted if required. ![Commission 3](https://mintcdn.com/zuperinc/_M5H7aKxpQP2Mjqk/Commissions/Images/SCR-20260924-mnsd.png?fit=max\&auto=format\&n=_M5H7aKxpQP2Mjqk\&q=85\&s=35a4cee0ae8b2fed924b6bda62ab08a7) ## **Managing Commissions in Job Costing** In roofing businesses, incentives often play a key role in driving sales performance and job completion efficiency. To ensure complete financial visibility, Zuper allows commissions to be included as part of [job costing](/Zuper_for_Roofing/Job_Costing). When commissions are added to a Job, they are automatically included in **Actual COGS**. This means profitability calculations reflect not only materials, labor, and expenses, but also commission values. For example, if a sales representative earns commission on a roofing job, that payout is treated as part of the job’s cost. If costs increase due to commissions or additional labor, the **Actual Profit and Margin** update automatically. This real-time visibility helps you understand the full financial impact of each job and make informed pricing or margin decisions moving forward. ### Adding a commission to a Job 1. Open the **Job** details page. 2. Navigate to the **Line Item** section. ![Commission 3](https://mintcdn.com/zuperinc/LNErWh0AG_JtxzVb/Commissions/Images/SCR-20260921-opiv.png?fit=max\&auto=format\&n=LNErWh0AG_JtxzVb\&q=85\&s=1f6788b419b911a1d7f99bd168c22d0c) 3. On the Commission tab, click + **Add Commission**. ![Commission 3](https://mintcdn.com/zuperinc/LNErWh0AG_JtxzVb/Commissions/Images/SCR-20260921-opoy.png?fit=max\&auto=format\&n=LNErWh0AG_JtxzVb\&q=85\&s=aa79b632472ba5b31c6c5631f96eeef9) 4. Select the **user** to whom you are assigning commission. Now, you can assign a commission to users already assigned to the job, users referenced in custom lookup fields on the job, or any other user in your organisation, including members of non-dispatchable teams. 5. If a commission structure is defined for the user, the system automatically calculates the commission value, and you can choose an appropriate one from the list. 6. If no structure is defined, Zuper allows you to manually define the commission rate for the user within the Job. ![Commission 3](https://mintcdn.com/zuperinc/LNErWh0AG_JtxzVb/Commissions/Images/SCR-20260921-opuo.png?fit=max\&auto=format\&n=LNErWh0AG_JtxzVb\&q=85\&s=06318f4275b2708c25c06fe032ea4734) 7. Click **Save** to apply the changes. ![Commission 3](https://mintcdn.com/zuperinc/LNErWh0AG_JtxzVb/Commissions/Images/SCR-20260921-opxm.png?fit=max\&auto=format\&n=LNErWh0AG_JtxzVb\&q=85\&s=cf452480972b06fd0bf39c12722ee81f) > [!NOTE] > > **Note:** When multiple commissions are added to a job, each commission is evaluated independently based on the defined metric. The second commission is not recalculated based on the profitability updated after the first commission is applied. Additionally, commission values are dynamically recalculated when profitability changes.\ > For example, if a commission is defined as 10% of Actual Profit and the Job initially has \$1,000 Actual Profit, the commission value will be \$100. If material or labor changes increase Actual Profit to \$2,000, the commission value automatically updates to \$200. You do not need to update it manually. The commission will now be recorded in **Job Costing**. To view its impact: Click on **Actual** **COGS/Overhead** to see the breakdown, including commission as part of Actual Cost. ![Commissionlisting 12](https://mintcdn.com/zuperinc/LNErWh0AG_JtxzVb/Commissions/Images/SCR-20260921-oqfj.png?fit=max\&auto=format\&n=LNErWh0AG_JtxzVb\&q=85\&s=85ee39fe7e6b71e7b21614aa91c37bf4) #### How overhead affects Actual Profit commissions  If your organisation has overhead configured in **J[ob Costing & Expenses > General Settings](/Zuper_for_Roofing/Job_Costing_Settings#general-settings)**, it changes how commissions based on the **Actual Profit** commission type are calculated.  When Overhead is applied, Zuper deducts the Overhead amount from Gross Profit before calculating the commission. This ensures commissions are calculated using the profit remaining after indirect business costs are accounted for.  **Example:** If a job has a Gross Profit of **\$1,000** and Overhead of **\$200**, the Actual Profit type used for commission calculations is **\$800**. If the commission rate is **10%**, the commission amount is **\$80** instead of **\$100**.  Other commission types, including **Flat Rate**, **Planned Revenue**, **Planned Profit**, and **Actual Revenue**, are not affected by Overhead.  ### Recording a Payout from the Job You can record a commission payout directly from the job without going to the Commissions Listing page. Add a Payout 1. Click the **three-dot menu (⋯)** next to the commission you want to pay out. 2. Select **Add Payout**. The Add Payout dialog opens. ![Commissionlisting 14](https://mintcdn.com/zuperinc/LNErWh0AG_JtxzVb/Commissions/Images/SCR-20260921-oqkc.png?fit=max\&auto=format\&n=LNErWh0AG_JtxzVb\&q=85\&s=ff626de3274bb9831b31eab84fa229f2) 3. Review or update the **Payment Date**. It defaults to today. 4. Enter the **Amount**. 5. Add an optional note in **Payout Notes**. 6. Click **Record Payout**. ![Commissionlisting 13](https://mintcdn.com/zuperinc/LNErWh0AG_JtxzVb/Commissions/Images/SCR-20260921-oqol.png?fit=max\&auto=format\&n=LNErWh0AG_JtxzVb\&q=85\&s=2132b0ad9112be1a03511eb46a0ffcdc) The Payment Status updates automatically, **Paid** for a full payment, or **Partially Paid** if a balance remains. > [!NOTE] > > **Note:** You can record multiple partial payouts against the same commission until it is fully settled. > [!TIP] > > **Need to Pay Multiple Commissions at Once?** > > Use the Commissions Listing page in the Accounting module for bulk payouts. See [Managing Commission Payouts](/Managing-commission-payouts). ## **Managing Commissions in a Project** When a Job is associated with a Project, the commission value defined for that Job is automatically reflected within the Project under: **Navigation**: *Project > Financials > Commissions* This allows you to view consolidated commission values across all Jobs linked to the Project. ![Commission 3](https://mintcdn.com/zuperinc/_M5H7aKxpQP2Mjqk/Commissions/Images/SCR-20260924-mpkr.png?fit=max\&auto=format\&n=_M5H7aKxpQP2Mjqk\&q=85\&s=2a3b8a704e98268b7647cf2ce4629bd9) In addition to Job-level commissions, you can also add a **Flat Value commission** directly within the Project. ### **Adding a Commission in a Project** 1. Click **+ Add Commission**. 2. In the **Add Commission** dialog box: 1. Select **User** – Choose the team member receiving the commission. 2. Enter the *flat value*. 3. Click **Add**. ![Commission 3](https://mintcdn.com/zuperinc/_M5H7aKxpQP2Mjqk/Commissions/Images/SCR-20260924-mptf.png?fit=max\&auto=format\&n=_M5H7aKxpQP2Mjqk\&q=85\&s=946062b191aa375be23d733767e7cf22) The commission will appear in the Project’s commission list.  **Managing Existing Project Commissions** For commissions added directly at the Project level, you can perform the following actions from the menu (⋯): * Edit the commission rate * Delete the commission entry if needed All updates are reflected immediately in the total commission amount shown for the Project. If a Job is part of the Project, its commission values will automatically roll up and be displayed here. These Job-level commissions are read-only within the Project and must be edited from the respective Job. ![SCR 20260924 Mvea](https://mintcdn.com/zuperinc/_M5H7aKxpQP2Mjqk/images/SCR-20260924-mvea.png?fit=max\&auto=format\&n=_M5H7aKxpQP2Mjqk\&q=85\&s=95ba445ce54d67bad1e0dfff81c94cb6)  **Things to Know** 1. When the commission type is based on **Planned Revenue** or **Planned Profit**, only the value from accepted quotes is considered for commission calculation. Quotes in Draft or Sent status are not included. 2. Each commission added to a Job is calculated independently based on the selected metric. If multiple users receive commission on the same Job, their payouts are evaluated separately. 3. Commission structures apply only to **Jobs**. 4. Project-level commissions support **Flat Value only**. Profitability-based or metric-based commission structures are not available in Projects. 5. Only users assigned to the Job or Project are eligible to receive commission. 6. If a Job runs at a loss, commission based on profit will not result in a negative value.\ For example, if Actual Profit is -\$500 and the commission is defined as 10% of Actual Profit, the commission value will be calculated as \$0. Negative commission values are not applied. ## **Commissions Report** After assigning users to line items and tracking commissions on jobs, use the Commissions Master Report to view how commissions are recorded across jobs and projects within a selected date range. This report helps you: * View commissions by employee or salesperson * Track commission details at the job and line item level * Identify commission types (actual, proportional, or flat) * Review commission amounts and creation details **To access the Commission Report** 1. Navigate to **More** > **Reporting** > **Reports** in the left navigation bar. 2. Navigate to **Miscellaneous Reports >** **Commissions Master Report**. 3. Set the **From Date** and **To Date**. 4. Choose the **Commission Date** type. 5. Click **Generate Report**. ![Commission19](https://mintcdn.com/zuperinc/LNErWh0AG_JtxzVb/Commissions/Images/SCR-20260921-oszr.png?fit=max\&auto=format\&n=LNErWh0AG_JtxzVb\&q=85\&s=1672ed22b553e861af35707a90cb7f0b) # Creating and managing PPM Source: https://docs.zuper.co/Contracts_and_Assets_Management/Assets/Creating_PPM Planned Preventive Maintenance (PPM) is a proactive approach to maintaining equipment, machinery, or systems by scheduling regular inspections, servicing, and repairs before any issues arise. The goal of PPM is to minimize the risk of unexpected failures, reduce downtime, and extend asset lifespans. Let’s get started with creating and managing a new PPM for an asset in Zuper! > [!NOTE] > > **Common terms for this feature** > > Customers may refer to assets using different terms depending on their industry. In Zuper, the following are all equivalent: > > | What customers call it | Zuper term | > | - | - | > | Station / stations | Asset / assets | > | Unit / units | Asset / assets | > | Service location | Asset / property | > | Multiple stations | Multiple assets | > | One job per station | One job per asset | > | Contract covers stations | Contract covering multiple assets | > | Multi-site PPM | PPM across multiple assets or locations | > > When this article refers to **assets**, it includes stations, units, and service locations. **Navigation:** Contracts and Assets Management module -> Assets-> Assets listing page -> Asset detail page ## To create a PPM * Select the **Contracts and Assets Management** module from the left navigation menu and choose “**Assets**." You will view the list of assets (both active and inactive) on the asset listing page.  ![Assetnew Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/assetnew.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=9619d0ee56553137473f0f0e96423fc9) * Choose the asset for which you want to add a new PPM from the asset listing page. The selected asset details page appears.  * On the asset details page, scroll down to the PPM section in the right pane and click the\*\* "+\*\*" icon. A side pane will appear, and you can create a new PPM. ![Asset20 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset20.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=b2e98a6a24f6eaae6ff747c91eadb4ea) > [!NOTE] > > Note: To add PPM for an asset, it must be linked to an organization or customer. Unlinked assets (referred to as "Orphan" assets) will not display the + (Plus) button. You can associate the asset with an organization or customer first, then go ahead and add PPM. > [!NOTE] > > **Keeping future maintenance out of your active jobs list** > > Scheduling a PPM does not create jobs for every future service date. Jobs are > created only when the **Generate Job in Advance** lead time is reached — so a PPM > recurring every 6 or 12 months produces a job shortly before each service, not a > backlog of future-dated jobs in your active list. > > To see the full forward schedule, use **Manage PPM** on the asset listing page, > which lists each PPM with its last and next service dates. ### Primary Details Fill in the following primary details: * **PPM Name:** Enter a name for the PPM. * **PPM Description:** Provide a brief description of the PPM. * **Choose Property**: Select a property of an org/customer to associate with the PPM. * **Choose Asset**(*Mandatory*): Select one or more assets for which you want to create a new PPM. You can choose assets currently associated with the contract or any other existing assets, as needed. * *Example: A service contract covers 3 water pump stations. You select all 3 assets in the Choose Asset field and enable Auto-Generate Job. Zuper creates a PPM for each asset. On the scheduled date, 3 separate jobs are auto-generated — one per station — and each appears individually in the Jobs listing."* > [!NOTE] > > **Note**: When you select multiple assets, Zuper creates one separate PPM entry per asset. If Auto-Generate Job is enabled, each asset generates its own independent job on the scheduled date not one combined job for all assets. ![](https://mintcdn.com/zuperinc/7Bu7cWfxGOT6fS3e/Contracts_and_Assets_Management/Assets/asset21.png?fit=max\&auto=format\&n=7Bu7cWfxGOT6fS3e\&q=85\&s=4404ba2b821ed818cb117c996938987a) * **Choose Part/Service**: Select a part or service associated with the contract to include in the PPM. * **Priority** (*Mandatory*): Select the priority from the drop-down list. Options include Low, Medium, and High. * **Auto-Generate Job**: By default, it will be set to "**No**." If you want to auto-generate a job based on the PPM, select "**Yes**."  > [accordion] If selected "Yes" for Autogenerate job. Follow these steps: > > Job Settings > > * **Generate Job in Advance** (*Mandatory*): Set how many days before the scheduled date the job should be created automatically. > > * **Job Category**: Choose the job category from the drop-down list. > > ![](https://mintcdn.com/zuperinc/7Bu7cWfxGOT6fS3e/Contracts_and_Assets_Management/Assets/asset22.png?fit=max\&auto=format\&n=7Bu7cWfxGOT6fS3e\&q=85\&s=5769813b9210ab3dadea2d72c4b83040) > > * **Street Address**: Click "**Pick from Map**" to fill in the street address information. > > After completing the primary details, click the "**Next**" button to proceed to the scheduling step for the PPM. ### PPM Schedule Provide the following details to schedule: * **PPM Start Date**: Select the start date of the PPM. * **PPM End Date**: Select the end date of the PPM. ![](https://mintcdn.com/zuperinc/7Bu7cWfxGOT6fS3e/Contracts_and_Assets_Management/Assets/asset23.png?fit=max\&auto=format\&n=7Bu7cWfxGOT6fS3e\&q=85\&s=9751701b4593a1d3af5946c97837877a) * **Recurrence**: Select how often this PPM should occur - Daily, Weekly, Monthly, Yearly, or Custom. * **Schedule Dates**: These dates are **automatically populated** for upcoming schedules (service dates) based on the chosen recurrence. After filling in all of these details, click the “**Create PPM**” button.  A new PPM will be created and successfully added to the asset. ## Manage PPM Once a PPM has been created for an asset, you can also edit or delete the PPM as needed. To manage PPM, follow these steps: * Click "**Manage PPM**" at the top right of the asset listing page.  ![Asset30 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset30.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=8d4beff2abe55dfcb86a97ce28bc0d36) * You can access all PPMs for assets, including PPM ID, name, last service date, next service date, and more. You can also use the **search bar** to search and view specific asset's PPM details.  * From there, you can view, edit, or delete PPM by using the icon under **Actions**. ![Asset31 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset31.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=9a1b736810836eb52656642685000713) > [!NOTE] > > **Note**: The job icon next to the PPM ID indicates that a **job will be auto-generated** for this PPM on the scheduled dates. This is because you've chosen "**Yes**" to "Auto Generate Job" while creating a PPM. ## Scheduling PPM In Zuper, PPM tasks can be automatically converted into jobs for field technicians to complete on scheduled dates. However, if the **autogenerate jobs** option was not enabled during PPM creation, you can still manually issue PPMs as jobs. Here's how: * On the PPM listing page, identify the PPMs that do not have autogenerate jobs enabled. ![/Contracts\_and\_Assets\_Management/Assets/85.png+\_existingInIndexedDbMintlify](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Contracts_and_Assets_Management/Assets/85.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=67f717063b0588ef1aa223c8ccd4b660) * Select the PPM(s) that need job creation. An action bar will appear at the bottom. > [!NOTE] > > **Note**: The checkbox is enabled only for PPMs that do not have autogenerate jobs configured. * Click "**Issue Chosen PPMs**". A Preview PPMs pop-up will appear. ![/Contracts\_and\_Assets\_Management/Assets/87.png+\_existingInIndexedDbMintlify](https://mintcdn.com/zuperinc/7Bu7cWfxGOT6fS3e/Contracts_and_Assets_Management/Assets/87.png?fit=max\&auto=format\&n=7Bu7cWfxGOT6fS3e\&q=85\&s=a442b21a71539f6ee704e0fbe6285990) * Select the **Job Category** from the dropdown menu and set the **Start Time** and **End Time** for each PPM. ![/Contracts\_and\_Assets\_Management/Assets/88.png+\_existingInIndexedDbMintlify](https://mintcdn.com/zuperinc/7Bu7cWfxGOT6fS3e/Contracts_and_Assets_Management/Assets/88.png?fit=max\&auto=format\&n=7Bu7cWfxGOT6fS3e\&q=85\&s=f20e4fe4bd7ef6c4bc7e5ff45a7553eb) * Click "**Submit**" to create PPM jobs successfully. So, that's the process of creating and managing PPM in the Zuper Web App. By following these step-by-step instructions, you can efficiently create and manage these maintenance schedules, ensuring optimal performance and longevity of assets. # Creating an asset Source: https://docs.zuper.co/Contracts_and_Assets_Management/Assets/Creating_asset Any item purchased by a company as a product and, when distributed to a customer service location to fulfill a job, contract, or service agreement, is referred to as an asset. It can either be owned by the customer or by the company itself. Let’s get started with creating a new asset in Zuper! **Navigation**: *Contracts and Assets Management module -> Assets → + New Asset* ## To create a new asset * Select the “**Contracts and Assets Management**” module from the left navigation menu and choose “**Assets**.” ![Assetnew Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/assetnew.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=9619d0ee56553137473f0f0e96423fc9) * On the assets listing page, you will see an overview of existing assets, including Asset Code, Asset Name, Asset status, and more. * Click the “**+ New Asset**” button at the top right corner of the page to begin creating a new asset. ![Asset44 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset44.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=8922a55d537d03f823c0bd105edde96f) * The new asset creation page appears in a user-friendly layout, making data entry easier: ### A. Primary Details * **Product**: Select the product you want to distribute to a customer from the inventory. The asset code and name will be auto-filled based on the selected product. * **Asset Code**(*Mandatory*): It is ideally the product model used to identify the kind of asset. This field is auto-filled based on the selected product. * **Asset Name**(*Mandatory*): The name of the asset. This field is auto-filled based on the selected product. * **Asset Serial Number**: A unique identifier (letters, digits, or dashes) used for business-owned or customer-owned assets. ![Asset45 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset45.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=6128a8b7f808d4e0d8e4c17493fd1476) * **Asset Category**(*Mandatory*): The category to which the asset belongs. * **Asset Image**: Upload an image to help identify the asset. * **Asset Status**: The current status of the asset. * **Asset Ownership**: Indicates whether the asset is customer-owned or company-owned. * **Purchase Date**: The date when the asset was purchased. * **Purchase Price**: The actual purchase price of the asset. * **Warranty Expiry Date**: The date when the asset’s warranty expires. * **Placed in Service Date**: The date when the asset was put into service. * **Residual Price**: The estimated remaining value of the asset. * **Useful Life**: The expected duration the asset can be used (in days, months, or years). * **Asset inspection form**: Select the asset inspection form from the dropdown menu. This is the checklist used by field technicians to assess an asset’s condition and record maintenance details. * **Asset Description**: A brief summary of the asset. ### B. Primary Information Customer information includes details about the organization or customer associated with the asset. When entering customer information: * You can select an organization, a customer, or both. * If the selected organization and customer are linked, their details will be auto-filled. ![Asset46 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset46.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=3155d4443f8a525b1be455bca048c847) > [!NOTE] > > **Note**: Based on the customer or organization you've chosen, the service and billing address will be auto-filled. You can modify the address if needed. ### C. Association(s) You can also associate a property or parent asset with this new asset. To do this, click the "**+ Add**" button, choose the property or parent asset as needed, and click "**Proceed**." ### D. Service/Billing Address The service or billing address indicates where the asset is provided. It is automatically filled based on the selected customer or organization, but you can change it if necessary. ![Asset47 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset47.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=7684b86201107337d42d3d87f68108ae) ### E. Add Part Parts are individual components or materials associated with an asset, which may be required for its operation, maintenance, or repairs. To add parts to an asset: * Click the **"+ Line Item"** button. * Select the required parts and specify the quantity. * Click **"Add Part"** to include them in the asset. ![Asset48 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset48.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=e45ac0615c4d5e95264ea62265ad88c1) After adding parts, you can view, edit, or remove them using the icon under the "**Actions**" column. ### F. Asset Attachments You can add relevant files and attachments to the asset. To do this: * Click the "+ **Add Attachments**" button. A pop-up will appear. * Click to upload or drag and drop a file from your computer. * Once uploaded, click the "**Close**" button. * You can also preview or remove attachments as needed. After filling in all of these details, click the "**Save Asset**" button at the top right corner of the page. ![Asset49 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset49.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=0afeb68b55b1c5e7d3e8cd5cd1d0943e) A "**Create Asset**" dialog box appears. Click the "**Create**" button to create the asset.   The new asset is created successfully. # Managing inspection forms Source: https://docs.zuper.co/Contracts_and_Assets_Management/Assets/Inspection_form Asset inspection forms are essential tools that field technicians use to perform thorough asset inspections and document maintenance activities. These checklists streamline the inspection process, ensuring that asset conditions and maintenance needs are accurately recorded. In this guide, we'll walk you through the steps to configure, associate, and complete an asset inspection form within a job, helping you maintain high standards of asset management and job completion. **Navigation**: * *Settings-> Modules -> Assets -> Inspection Forms* * *Assets -> Asset Listing page -> + New Asset -> Asset Inspection Form* * *Jobs -> Job Listing page -> + New Job -> Asset Inspection Form* ## **Configure an Asset Inspection Form** To efficiently associate an asset inspection form with Jobs, it is important to configure the inspection form in settings. Follow these steps: * Select Settings from the left navigation menu. * Click **Modules** and choose **Asset** to open the Asset Settings page. * Select **Inspection Forms**. The inspection forms listing page will appear. ![Assetsettings Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/assetsettings.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=e6c867e28a9ec9bbc845fdc33ac6b920) * Click **+ New Form** to create a new inspection form. ![Assetsettings2 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/assetsettings2.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=882fc094cfa0e89ed13c77427e3403b6) * Enter the following details and click **Proceed** to begin customizing the inspection form. ![Assetsettings3 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/assetsettings3.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=86c33e362bae029a0c3c1180c5c89282) * **Inspection Form Name** (*Mandatory*) – Enter a name for the inspection form. * **Description** – Provide a brief description of the inspection form. **Customizing the inspection form** To customize the inspection form, simply drag and drop fields from the right panel into the form layout. Arrange them as needed to suit your inspection requirements. You can also **edit, clone, or delete** fields using the action menu available next to each field. ![Assetsettings7 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/assetsettings7.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=ae5d4f1a0e4e26409944811fc06c8eee) > [accordion] Available fields > > 1. Text > * Single-Line Input: This allows you to create a field to enter a single line of free text. > * Multi-Line Input: This allows you to create a field to enter multiple lines of free text. > > 2. Date > * Date: This allows you to create a field to select a specific date from a calendar. > * Time: This allows you to create a field where you can select a specific time. > * Date & Time: This allows you to create a field where both date and time can be selected. > > 3. Selection > * Single-Selection: This allows you to create a radio input Field where one of the provided options can be selected. > * Multi-Selection: This allows you to create check boxes where the provided options can be checked. > * Drop-Down: This allows you to create a drop-down field with the required list of options. > > 4. Media > * Upload: This allows you to create a file input field to upload files. > * Single Image: This allows you to upload a single image as input. > * Multi Images: This allows you to upload multiple images in one field. > * Barcode Scan: This allows you to scan and capture barcodes using a device camera or scanner. > > 5. Misc > > * Look up: This allows you to create a file input field to look up the products from the parts and services module. > > * Data Table: This allows you to create a dynamic table field to input structured data in rows and columns. > > * Signature: This allows you to sign directly within the form using touch or a mouse input. > > > [!NOTE] > > > > Note: You can also control the behavior and visibility of each field using the following options: > > > > * Mark as Required Field- Makes the field mandatory to fill out before submitting the form. > > * Mark as Read Only- Displays the field as non-editable; users can view the value but cannot modify it. > > * Mark as hidden field- Hides the field from all users; it will not appear in the form interface. > > * Hide to FE/Technician- Makes the field invisible specifically to technicians or front-end users during form access. ## **Associate an Inspection Form with an Asset** After you have successfully configured and created a new inspection form, you can associate an inspection form with an asset in any of the following ways: > [accordion] Create a new asset with an Inspection Form > > * In the left navigation menu, select **Contracts and Assets Management** and choose **Assets**. > > * On the asset listing page, select **+ New Asset**. The new asset creation page will appear. > > ![](https://mintcdn.com/zuperinc/7Bu7cWfxGOT6fS3e/Contracts_and_Assets_Management/Assets/99.png?fit=max\&auto=format\&n=7Bu7cWfxGOT6fS3e\&q=85\&s=471bc67361e011dfbc6890733db80917) > > * In the **Primary Details** section, fill in the following information: > > 1. **Product** (*Mandatory*) – Select the product to be assigned as an asset. > 2. **Asset Code** – Auto-generated based on the selected product. > 3. **Asset Name** – Auto-filled based on the selected product. > 4. **Asset Serial Number** – Enter a unique identifier (letters, numbers, or dashes). > 5. **Asset Category** (*Mandatory*) – Select the asset category. > 6. **Asset Image** – Upload an optional image. > 7. **Asset Status** – Select the asset’s current status. > 8. **Asset Ownership** – Choose **Customer-owned** or **Company-owned**. > 9. **Purchase Date** – Select the date of purchase. > 10. **Purchase Price** – Enter the asset’s purchase cost. > 11. **Warranty Expiry Date** – Select the warranty expiration date. > 12. **Placed in Service** – Enter the asset’s service start date. > 13. **Residual Price** – Enter the estimated residual value. > 14. **Useful Life** – Define the asset’s lifespan (days, months, or years). > 15. **Asset Description** – Enter optional details about the asset. > 16. **Asset Inspection Form** – Select an inspection form from the dropdown. > > ![](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Contracts_and_Assets_Management/Assets/100.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=73143136b7fea51372a6786ead81b776) > > * Enter additional details such as **Customer Information**, **Service Address**, and **Attachments**. > > * Select **Save Asset** to create the asset with the associated inspection form. > [accordion] Edit an existing asset to add an Inspection Form > > * Navigate to the Assets listing page. > > * On the **Asset Listing** page, locate the asset you want to edit. > > * Select the ellipsis icon () next to the asset and choose **Edit Asset**. > > ![](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Contracts_and_Assets_Management/Assets/102.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=90971f490ed90af5d83c76a6322c9ea6) > > * Update the asset details, including adding an **Inspection Form**. > > * Select **Update Asset** to save the changes. ## **Associate an Inspection Form with a Job** After linking an inspection form to an asset, you can associate the asset with jobs. This ensures that field technicians complete the inspection form before marking the job as complete. ### **Create a Job with an Inspection Form** * Navigate to the **Jobs** module in the left navigation menu. You will land on the jobs listing page. ![](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Contracts_and_Assets_Management/Assets/105.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=5a2eec5935d343cc5defddf796b893fe) * On the **Job Listing** page, select **+ New Job**. ![](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Contracts_and_Assets_Management/Assets/106.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=04a2fab91319e8f9fca9b3d0b193852b) * Enter job details such as **Job Title, Job Category, Due Date, Service Address**, and **Customer Information**. * Under **Assets**, select **+ Add Asset**. ![](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Contracts_and_Assets_Management/Assets/107.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=0f0208ffa4fcf86e549f3e2f1f4cd9e7) * Choose an asset that has an **Inspection Form.** The Asset with an inspection form will be added to the job. ![](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Contracts_and_Assets_Management/Assets/109.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=69b8287ae8213fcb0c170f1323a7424f) * Select **Create Job** to save the job. ### **Complete an Asset Inspection Form in a Job** After creating a job with an asset inspection form, here's how you can complete the asset inspection form in a Job. * Open the job details page. * In the **Assets Associated** section, select the icon next to the asset. ![](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Contracts_and_Assets_Management/Assets/112.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=c656e3d9959d5afca8ba2611f4869ceb) * Select **Fill Inspection Form**. * Complete the form based on asset requirements and observations. ![](https://mintcdn.com/zuperinc/REyxl-NZWG7jHng2/Contracts_and_Assets_Management/Assets/113.png?fit=max\&auto=format\&n=REyxl-NZWG7jHng2\&q=85\&s=f2d7980ad84e8f7630b81c0911a00775) * Select **Submit**. By following the steps outlined in this guide, you can efficiently configure, associate, and complete asset inspection forms within your jobs. This ensures that field technicians are equipped with the necessary tools to conduct comprehensive inspections and complete jobs accurately. With streamlined documentation and a more efficient inspection process, you can maintain better oversight of asset conditions and improve overall service delivery. # Overview Source: https://docs.zuper.co/Contracts_and_Assets_Management/Assets/Overview Zuper’s Assets Module streamlines asset management by enabling businesses to track, maintain, and optimize their physical assets efficiently. By centralizing asset data, businesses can minimize downtime, extend equipment lifespan, and improve service delivery. With features like preventive maintenance scheduling, asset history tracking, and seamless association with jobs, contracts, and customers, Zuper ensures peak operational efficiency—all within a unified platform. ### **Key Benefits of the Assets Module** **Comprehensive Asset Tracking** Easily track and manage all assets in a centralized system. Record essential details such as asset codes, serial numbers, purchase dates, warranty details, and current status for complete visibility and control. **Preventive Maintenance Scheduling** Plan and schedule **preventive maintenance (PPM)** to keep assets in optimal condition, reducing unexpected breakdowns and minimizing downtime. **Seamless Asset Associations** Link assets with **contracts, customers, jobs, projects, and properties**, creating a structured asset management workflow that enhances operational efficiency. **Parts & Services Management** Track parts usage and service requirements for each asset to ensure timely repairs and maintenance. Maintain inventory control and prevent service delays due to missing components. **Detailed Asset History** Access a complete history of each asset, including maintenance activities, service records, and repair logs, to gain insights into asset performance and make informed decisions about replacements or upgrades. **Custom Attributes & Reporting** Customize asset attributes based on your business needs and generate detailed reports on asset performance, maintenance schedules, and key operational metrics to drive data-driven decision-making. # Managing your assets Source: https://docs.zuper.co/Contracts_and_Assets_Management/Assets/managing_assets Efficient asset management ensures operational efficiency and extends equipment lifespan. Zuper’s unified platform enables seamless asset creation, tracking, and management. With centralized control, businesses can monitor asset status, track history, and streamline maintenance. This guide covers accessing the Assets listing page, key actions, and managing asset details effectively. **Navigation**: *Contracts and Assets Management module -> Assets-> Assets listing page -> Asset Details* ## Accessing the assets listing page The asset listing page is designed to help you stay organized by providing a centralized view of all assets and enabling quick access to critical asset details. The page includes several key features to streamline asset management: ![Asset32 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset32.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=e321ae64b4903b4957dca5ad9c9b6f51) ## Listing View Customize the Assets listing by adding/removing or reordering columns, then Update View to overwrite or save it as a new view. **Update View** Click Update View to modify the current view after changes. **Save as a new view** Use the dropdown beside Update View → Save as new view. **Create View dialog** Enter the View Name (mandatory), choose Share with (User/Team) and add users, toggle Visibility to all users, and click Create. **Reset View** Click Reset View to restore the current view to the default. **Permissions** * **Edit**: Add/remove/reorder columns; save as new or overwrite existing views. * **View-only**: Apply views but can’t edit; can Save as new view to copy without altering the original. * **Manage view**: Rename, adjust Visibility (Only Me/User/Team or global toggle), Duplicate, or Delete (creator only; reverts to default/another saved view). ## Pinned filters Zuper's Assets module lets you use pinned filters to streamline your filter experience. Pinned filters keep your most-used criteria readily accessible for quick application. 1. **Pin Filters for Quick Access** * Once your filters are set, click the **Pin Filters** button in the dialog box to save them as pinned. * Pinned filters appear in the dialog box's "**Pinned Filters**" section, allowing you to apply them with one click in future sessions. ![Pin Asset2](https://mintcdn.com/zuperinc/uWJXnqMkUObW6Xs-/images/pin-asset2.png?fit=max\&auto=format\&n=uWJXnqMkUObW6Xs-\&q=85\&s=9a7153600fe1ebd6b76eca2ed14b8a4b) 2. To Unpin the filter: * To unpin, select a pinned filter and click **Remove**. * To apply pinned or default filters, open the dialog box and select them. * Use **Clear All** to remove active filters. ![Pin Asset3](https://mintcdn.com/zuperinc/uWJXnqMkUObW6Xs-/images/pin-asset3.png?fit=max\&auto=format\&n=uWJXnqMkUObW6Xs-\&q=85\&s=b6fd8c67905efc004a5e69ed46758eba) **Open asset details** After filtering, click an Asset Number or Asset ID to view and manage details in the Zuper Assets Module. ![AV1 Pn](https://mintcdn.com/zuperinc/1Dzz6aS8fECz91-C/images/AV1.png?fit=max\&auto=format\&n=1Dzz6aS8fECz91-C\&q=85\&s=bd9cf44fc81899f5c624120f0e09dc4d) ### Bulk Action: The bulk printing of QR codes on the Assets is possible. With this, Assets can get their QR code printed in size.  1. Select the list of assets you want to bulk update and choose the option “**Print QR Code.**” ![AV2 Pn](https://mintcdn.com/zuperinc/1Dzz6aS8fECz91-C/images/AV2.png?fit=max\&auto=format\&n=1Dzz6aS8fECz91-C\&q=85\&s=21489b5c42b625c47dffed548a07fcda) 2. The QR Codes are successfully printed in bulk. ![Ast2 Jp](https://mintcdn.com/zuperinc/foY4ItPnEcbwC0iC/images/Ast2.jpg?fit=max\&auto=format\&n=foY4ItPnEcbwC0iC\&q=85\&s=e72a7b6abd6137f500fae6bb1040adec) > [!NOTE] > > **Note:** The Bulk Print QR code is available for less than **100** assets at a time; if more than **100** assets are selected, the PDF is generated and sent over email. We can print the QR code using any printer. **Compatibility:** > [!TIP] > > **The exported PDF will print to 1” x 2 5/8” sized labels—this format prints on the Avery Template Presta 94200 template.** With this new feature, businesses can save time by updating the asset status and asset fields for multiple assets with a single click. The assets will have a QR code for identification for internal purposes, and a list of QR codes will be sent to field executives during field service. This bulk option helps them print multiple QR codes easily. ### **Manage PPM** (Planned Preventive Maintenance) Easily oversee and manage planned preventive maintenance schedules for assets to ensure timely servicing and reduce unexpected breakdowns. To do this, click the "**Manage PPM**" button at the top right of the listing page. For a more detailed guide on how to manage PPM, see the Creating and Managing PPM article. ![Asset34 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset34.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=8980077c1c31ef13d1427e455e466a3c) ### **New asset creation** Quickly create new assets directly from the listing page, streamlining asset management. To do this, click the "**+ New Asset**" button at the top right corner. For more detailed guide on how to create a new asset, see creating a new asset article. ![Asset35 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset35.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=f5a999288a841ae4b7d0cb28f70e9c96) ### **Filter assets** Refine your asset view by applying multiple filters based on predefined criteria such as **Asset Type, Status, Location, Warranty Expiry**, and more. Click [here](https://docs.zuper.co/Work_Order_Management/Jobs/managing_your_jobs#applying-filters) for more details on how to apply multiple filters and find specific assets quickly. ![Asset36 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset36.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=36039984fe7acf133d3ea60f30fdb26b) After filtering an asset, click the “**Asset Name**” or “**Asset Code**” to view and manage its details. ## Managing Asset Details  Once an asset is created or accessed from the listing page, the **Asset Details Page** becomes your central hub for managing its lifecycle. The page follows a three-column layout, the left panel displays the asset's primary details, while the right panel provides contextual insights and quick actions for efficient asset management. ![Asset38 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset38.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=fb69b7df1d313d62b3b0c5ef8e9c8af4) ## Left panel  The left panel contains asset-related details such as the asset name and code. Below this, you will find the quick actions bar, which provides contextual action buttons, including options to view the history of performed actions, create a new job or project, add notes, and view the asset's QR code (which can be printed and affixed to the physical asset for tracking and identification purposes). From here, you also have quick access to view information such as asset details, associated parts, notes, history, activity, and jobs. > [accordion] View history > > Use the " **History"** button to view a chronological log of all actions performed on the asset. This includes Status updates (e.g., asset activation, deactivation, or maintenance), Job and project associations, Parts added, and more. > > ![Asset39 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset39.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=872edd6de5b052084449359ce7303eac) > [accordion] Create new job/project > > Use the “**+ New**” button to create a new job or a project for the asset, if required.   > > ![Asset12 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset12.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=f10d3d130af264988f72a4e22dd2de8c) > > * For step-by-step instructions on how to create a new job, see the [Creating a new job](https://zuperinc.mintlify.app/Work_Order_Management/Jobs/creating_a_new_job) article.   > * For step-by-step instructions on how to create a new project, see the [Creating a new project](https://docs.zuper.co/Projects/Creating_a_new_project) article. > [accordion] Add notes > > Use the "**+ Add Note**" button to create a new note. Notes are comments or information added to an asset over its course. Your notes can be anything ranging from a simple text reminder to an image of the item, service, video, or document. All added notes can be viewed under the  **Notes** Section.  > > ![Asset13 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset13.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=d8096570dd19f87038ce5d9225c8d1d1) > [accordion] View & print QR code > > Use the " **QR Code**" button to view and print the asset’s QR code, which can be attached to the physical asset for streamlined tracking and identification.  > > ![Asset14 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset14.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=25f8d15339f3c56f809a79747699cc7a) > [accordion] View asset details > > The asset details section offers a comprehensive overview of the asset, including its code, ownership, status, warranty status, last service date, purchase date, price, location, description, and other relevant details.  > > ![Asset37 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset37.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=d2cda475ac613932f02dbc9ac4930360) > [accordion] View asset parts > > 1. This section allows you to view all the parts associated with the asset. To add new parts to the asset, click the "**+ Add item**" button at the top right of the page.   > > ![Asset40 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset40.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=5e034a9b6733ec2d69b09f2482b61390) > > 2. Select the parts with quantity and click "**Add Part.**" The parts will be updated successfully to the asset. > [accordion] View notes > > 1. The Notes section allows you to view, add, and manage notes related to the asset. From here, you can use the rich text editor to add any new note. To tag a user to a note, you can use @ and key in the name to tag the user.   > > 2. You can attach multimedia files such as images, audio, video, and documents related to the contract. Use the “**+**” option to associate the notes with other modules such as customer, property, etc.   > > 3. You can also choose one of the following options for how you’d like the notes to be visible:   > > * **Public**- This privacy setting will help you make the note public to all, including the customer.    > * **Internal**(Default) – This privacy setting will help you make the note visible to all your Zuper users in your account.   > * **Only me**– This note is visible only to the user who created the note.   > > After adding the notes, click the “**Post Note**” button to post the notes.    > > ![Asset13 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset13.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=d8096570dd19f87038ce5d9225c8d1d1) > > 1. Once the notes have been posted, you can sort them based on the newest or oldest.    > > > [!NOTE] > > > > **Note**: Asset notes can be edited or deleted only by the user who created them. > [accordion] View asset history > > The asset history section allows you to view a chronological log of all actions performed on the asset.  > > ![Asset39 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset39.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=872edd6de5b052084449359ce7303eac) > [accordion] View activity > > The activity section on the details page displays a log or timeline of all actions and updates related to this asset, helping you stay informed about recent changes and track the asset’s status.  > > ![](https://mintcdn.com/zuperinc/7Bu7cWfxGOT6fS3e/Contracts_and_Assets_Management/Assets/asset17.png?fit=max\&auto=format\&n=7Bu7cWfxGOT6fS3e\&q=85\&s=ea6eed2399487ecae833f87fbf30995c) > [accordion] View asset jobs > > The asset jobs section allows you to view all jobs associated with the asset. This includes new, ongoing and completed jobs, providing you with a comprehensive overview of job statuses, schedule, and related details.  > > ![Asset41 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset41.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=a338dd7c290f260dc7e0e39a2a049616) ## Right panel In the right panel, view the organization or contact information associated with the asset, and manage its links to various modules, such as properties, projects, contracts, organizations, PPM, and more. To associate a module, click the “**+**” icon next to the desired module. ![Asset42 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset42.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=1e7045afdcdba938ea15b09a05028950) ## More actions    Managing assets doesn’t stop at viewing details—you can perform various actions such as editing, cloning, printing, sharing, and deactivating the asset. To do this, click the "**More Actions**" button at the top right corner of the page and select the desired option.  ![Asset43 Pn](https://mintcdn.com/zuperinc/N0-kTgRb79_nCoAC/images/asset43.png?fit=max\&auto=format\&n=N0-kTgRb79_nCoAC\&q=85\&s=5d608c99d4b83045abda57f2fbf6b34a) > [accordion] Edit Asset > > Use the **Edit Asset** option to modify existing asset details as needed. > [accordion] Clone > > Use the **Clone** **Asset option** to quickly create a replica of an existing asset, saving time. The current asset details will be duplicated onto a new asset page, where you can make any necessary edits before saving. > [accordion] Print/Save as PDF > > Use this option to print the asset details or save them as a PDF for documentation purposes. > [accordion] Share via Email > > This option enables you to share asset details via email directly from the platform. > [accordion] Deactivate > > Use the Deactivate option to disable the asset. Once deactivated, you will have the option to **delete** the asset, if needed. Managing assets efficiently is crucial for ensuring their optimal usage, tracking their status, and maintaining accurate records. With Zuper, you have a centralized platform to oversee all asset-related activities—from creation and modification to tracking history, managing associated parts, and linking jobs or projects. # Creating a contract Source: https://docs.zuper.co/Contracts_and_Assets_Management/Contract/Creating_Contract A service contract is an agreement between a business and its customer that outlines the services to be performed, the timeline for completion, and other essential details. It serves as a formal record of the mutual commitments, ensuring clear expectations and accountability for both parties. Let’s get started by creating a new contract for Zuper! **Navigation**: *Contracts and Assets Management module -> Contracts -> + New Contract* ## To create a new contract * Select the "**Contracts and Assets Management**” module from the left navigation menu and choose “**Contracts**." ![Contract36 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract36.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=aa1512f975faf84463a13b7b4f0792e3) * On the contracts listing page, you will see an overview of existing contracts, including Contract Names, Start & End Dates, Status, and more. * Click the “**+ New Contract**” button at the top right corner of the page to begin creating a new contract. ![Contract37 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract37.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=24abbc3d09b6b881654275a1a84c63e5) * The new contract creation page appears in a user-friendly three-pane layout, making data entry easier: 1. **Left Panel**: Enter the contract details, term, and address. 2. **Center Panel**: Add important contract information such as contract type (new/renewed), description, and associated parts & services. 3. **Right Panel**: Associate contracts with relevant modules like customers, invoice history, properties, assets, and more. ### A. Contract Details ![](https://mintcdn.com/zuperinc/-S_TpUncdyLgPIzH/Contracts_and_Assets_Management/Contract/contracts28.png?fit=max\&auto=format\&n=-S_TpUncdyLgPIzH\&q=85\&s=c3ac7af53a2b71103d5d9e35e721f785) * **Contract Package**: Select a package from the dropdown menu. These packages can be configured under **Settings** > **Configuration Settings** > **Contracts** > **Contract Packages**. > [!NOTE] > > **Note**: When selecting a package, the contract period, type, and parts & services will be auto-filled based on the package details. * **Contract Prefix**: Enter a prefix to help identify the contract. * **Contract Name**(*Mandatory*): Provide a unique name to identify the contract ### B. Contract Period * **Contract Term**(*Mandatory*): Define the contract period in months. * **Contract Start Date**(*Mandatory*): Set the start date of the contract. ![Contract38 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract38.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=7a37217f43383996b78cdbbb1134f84e) > [!NOTE] > > **Note**: Once the start date is selected, the invoice details are automatically populated based on the chosen package. * **Contract Expiry Date**(*Mandatory):* Enter the contract's end date. * **Activation Date**: Specify the date on which the contract becomes active and its services are available to the customer. Please note that the activation date can be the same as or later than the Contract Start Date, depending on when the customer begins using the contracted services. ### C. Primary Details * **Contract Ref No**: Assign a unique reference number to the contract. * **Contract Type**(*Mandatory*): Choose the contract type (e.g., New or Renewed). ![Contract39 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract39.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=5d26e0a94a1e568706864c3881c047f1) * **Contract Template**: Select the standard template to be used for the contract. * **Contract Description**(*Mandatory*): Enter a brief description of the contract. ### D. Part/Service Details Parts & services will be automatically populated based on the selected contract package in the details section. Additionally, you can add items by clicking the "**+ Add**" button. ![Contract40 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract40.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=4bf526585eed171b12284696567638ed) After adding the parts and services to the contract, based on the organization settings, either a transaction-level or line-item *discount* will be applied to that contract. ### Options Choose the preferred [Option](https://docs.zuper.co/Inventory_Management/Parts_Services/Create_New_Part_Service#3-options) for each line item in the contract parts list. ![Optipro14 1](https://mintcdn.com/zuperinc/jdBZbTsAYGchLwIJ/images/optipro14-1.png?fit=max\&auto=format\&n=jdBZbTsAYGchLwIJ\&q=85\&s=b0220590ce21f6d4df7f3a8c53e578de) > [accordion] Updating Discount Type > > To update the discount amount, click the icon next to "Discount" or use the icon in the Parts & Services details section to update Discount Type Settings. > > ![Contract41 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract41.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=f580fcd7a0c47627e6f5413f6e717901) > > Depending on your Organization settings, you can choose how discounts to be applied: > > * **Line-item level**: Apply discounts to each individual item in the quote. > * **Transactional level**: Apply discounts based on the subtotal of all items in the quote. > [!NOTE] > > **Note**: If a line item has a custom tax and the contract includes both taxable and non-taxable parts and services: > > * Only line-item level discounts can be applied. > * Transaction-level discounts cannot be applied in such cases. > > Transaction-level discounts are only applicable when all parts and services in the contract are either fully taxable or fully non-taxable. This restriction ensures accurate discount and tax calculations, preventing any miscalculations. ### E. Associations When creating a contract, you can associate various modules with the contract as needed to streamline field service operations and maintain a centralized record of all relevant information related to the contract. These associations help ensure seamless contract execution and tracking. Click the “**+**” icon next to each section to associate the modules, further enhancing the contract management process and keeping all pertinent information in one easily accessible location. ![Contract42 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract42.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=ed03321082a2e12474418453acabdbbe) > [accordion] Organization/contact > > Associating a contact or organization with a contract, you can maintain details of businesses and key contacts linked to the contract. Based on the contact/organization chosen, the service address will be auto-filled. You can then change as needed. > [accordion] Properties > > Associating properties with the contract helps streamline scheduling and dispatching, ensuring technicians are assigned to the correct locations. > [accordion] Projects > > By associating a project with a contract, you can manage complex service agreements more effectively, ensuring that all jobs related to the project are aligned with the contract terms. > [accordion] Invoice History > > The **Invoice History** section provides a chronological log of all actions and updates related to an invoice. This helps maintain a clear record of changes, ensuring transparency and easy tracking of invoice modifications, status updates, and payments. During contract creation, you can set up recurring invoices for contracts. > > > [accordion] Setting Up Recurring Invoicing for Contracts > > > > Recurring invoicing ensures timely billing for ongoing service contracts, helping businesses maintain a consistent cash flow while reducing manual effort. To enable automated invoice generation, follow these steps: > > > > 1. **Billing Period**: Choose the frequency of invoicing—**Quarterly, Yearly, or Monthly**. > > 2. **Generate Invoice Before (In Days)**: Specify how many days in advance the invoice should be created (e.g., 5 days before the due date). > > 3. **Payment Term**: Set the payment term (e.g., Monthly). > > 4. **Invoice Template**: Select an invoice template from the available options. > > 5. **Automatically Generate Invoice**: Choose **Yes** to enable automatic invoice creation or **No** for manual generation. > > > > ![Contract43 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract43.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=330af12813a8329bf45aac2bd41b609c) > > > > Based on the configured settings, invoice dates will be generated automatically. > > > [accordion] To view invoice history > > > > 1. Navigate to the **Contract Details** page. > > 2. In the right panel, locate the **Invoice History** section. > > 3. Here, you can see a detailed log of all actions taken on the invoice. > [accordion] Assets > > Associating assets with the contract enables you to track specific assets covered under the contract, ensuring that they receive the necessary maintenance and servicing. This helps manage the assets' lifecycle and maintain optimal operational performance. > [accordion] Planned Preventive Maintenance (PPM) > > By associating PPM tasks with the contract, you can schedule recurring maintenance to prevent service disruptions. This ensures that all required preventive measures are in place, reducing downtime and extending the longevity of the equipment. > > > [accordion] Steps to create a new PPM > > > > To create a new PPM, > > > > **1. Step 1** > > > > Click the "**+ Create PPM**" button. A sidebar will appear to create a new PPM. > > > > ![Contract44 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract44.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=306802621adcadb36f9edb55cc7c3250) > > > > **2. Step 2: Primary Details** > > > > Fill in the following primary details: > > > > * **PPM Name:** Enter a name for the PPM. > > > > * **PPM Description:** Provide a brief description of the PPM. > > > > * **Choose Property:** Select a property of an org/customer to associate with the PPM. > > > > * **Choose Asset (Mandatory):** Select one or more assets for which you want to create a new PPM. You can choose assets currently associated with the contract or any other existing assets, as needed. > > > > ![Contract45 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract45.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=aae155fb5ff07bb9c0d0e7b5d1d5484d) > > > > * **Choose Part/Service:** Select a part or service associated with the contract to include in the PPM. > > > > * **Priority (Mandatory):** Select the priority from the drop-down list. Options include Low, Medium, and High. > > > > * **Auto Generate Job:** By default, it will be set to "**No**." If you want to auto-generate a job based on the PPM, select "**Yes**." > > > > **3. Step 3 (Optional): If selected "Yes" for Autogenerate job. Follow these steps:** > > > > Job Settings > > > > * **Generate Job in Advance (Mandatory)**: Set how many days before the scheduled date the job should be created automatically. > > > > * **Job Category**: Choose the job category from the drop-down list. > > > > ![Contract46 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract46.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=f940234f5202c876ef57441efa9ce389) > > > > * **Street Address**: Click "**Pick from Map**" to fill in the street address information. > > > > After completing the primary details, click the "**Next**" button to proceed to the scheduling step for the PPM. > > > > **4. Step 4: PPM Schedule** > > > > Provide the following details to schedule: > > > > * **PPM Start Date**: Select the start date of the PPM. > > > > * **PPM End Date**: Select the end date of the PPM. > > > > ![Contract47 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract47.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=d934a32d2ec606b3b78750de6c77d743) > > > > * **Recurrence**: Select how often this PPM should occur- Daily, Weekly, Monthly, Yearly, or Custom. > > > > * **Schedule Dates**: These dates are **automatically populated** for upcoming schedules (service dates) based on the chosen recurrence. > > > > **5. Step 5** > > > > After filling in all of these details, click the “**Create PPM**” button. A new PPM will be created and added to the contract successfully. After creating a PPM, you can edit/delete it as needed by clicking the icon next to it. > > > > ![Contract48 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract48.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=9d35e019e9ed8e8156a53bac68e41d02) > > > > > [!NOTE] > > > > > > **Note**: You can also create a new PPM directly under the "**Asset** " column after adding an asset. Once the PPM has been created and associated with this contract, you can view it under the "PPM" section. > [accordion] Attachments > > Adding attachments to the contract allows you to store and manage important documents such as agreements, service reports, or manuals. This ensures easy access to vital information whenever needed, keeping all contract-related documentation organized and readily available. * After filling in all the required details, click the "Save Contract" button at the top right corner of the page. * A "Save Contract" dialog box appears. Click the "**Create**" button." ![Contract49 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract49.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=4b9d49375c7b64008a220c045a19a6b0) * A new contract will be created successfully. # Overview Source: https://docs.zuper.co/Contracts_and_Assets_Management/Contract/Overview In Zuper, the **Contracts Module** enables businesses to efficiently manage service agreements, ensuring seamless execution, tracking, and maintenance of contractual obligations. It provides a centralized platform for defining contract terms, automating invoice generation, and monitoring contract-based jobs, helping businesses stay compliant and organized while delivering consistent service. *For contracts covering multiple assets or stations, PPM is configured per asset — each asset gets its own schedule and auto-generates its own job independently. See Creating and managing PPM for step-by-step instructions* ### **Key Benefits of the Contracts Module** **Automated Invoice Generation** Effortlessly generate recurring invoices based on predefined billing periods, payment terms, and invoice templates, reducing manual work and ensuring timely payments. **Seamless Contract Associations** Link contracts with customers, assets, properties, jobs, and invoices, centralizing all contract-related data for streamlined workflow management. **Recurring Service & Maintenance Automation** Schedule and automate preventive maintenance and recurring job assignments to ensure timely service fulfillment and contract compliance. **Parts & Services Management** Automatically populate contract-specific parts and services, apply predefined pricing structures, and offer discounts at the transactional or line-item level based on business needs. **Advanced Contract Filtering & Search** Apply and save custom filters to quickly locate specific contracts based on status, renewal dates, contract types, and other attributes, improving accessibility and organization. **Invoice & Payment History Tracking** Maintain a detailed record of contract-related invoices, modifications, and payments, ensuring complete financial transparency and easy auditability. **Follow up Reminders** Set up automated reminders for contract renewals and expirations, helping businesses take proactive action to extend agreements and maintain uninterrupted service. **Customizable Contract Templates** Personalize contract formats with company branding, service terms, and payment conditions, ensuring consistency and professionalism in customer interactions. **User Roles & Permissions** Define access controls and approval workflows by assigning contract-related permissions to specific team members, enhancing security and operational control. *** # Managing your contracts Source: https://docs.zuper.co/Contracts_and_Assets_Management/Contract/managing_your_contract Efficient contract management is essential for maintaining clear agreements, ensuring compliance, and optimizing service operations. Zuper provides a centralized platform to track, update, and manage contracts seamlessly. With powerful features, businesses can monitor contract statuses, manage associated records, and ensure that all contract details remain accurate and aligned with business needs. This article will walk you through the steps to access the Contracts listing page, update contract details, and manage contracts effectively in Zuper. **Navigation**: *Contracts and Assets Management module -> Contracts -> Contracts listing page -> Contract Details* # Accessing the contracts listing page * Select the “**Contracts and Assets Management**” module from the left navigation menu and choose “**Contracts**.” You will land on the contracts listing page. ![Contract36 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract36.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=aa1512f975faf84463a13b7b4f0792e3) * On the contracts listing page, you can view an overview of existing contracts, including the Contract Name, Start & End Dates, Status, and more. # Exploring the listing page Customize the Contracts listing by adding/removing or reordering columns, then Update View to overwrite or save it as a new view. **Update View** Click Update View to modify the current view after changes. **Save as a new view** Use the dropdown beside Update View → Save as new view. **Create View dialog** Enter the View Name (mandatory), choose Share with (User/Team) and add users, toggle Visibility to all users, and click Create. **Reset View** Click Reset View to restore the current view to the default. **Permissions** * Edit: Add/remove/reorder columns; save as new or overwrite existing views. * View-only: Apply views but can’t edit; can Save as new view to copy without altering the original. * Manage view: Rename, adjust Visibility (Only Me/User/Team or global toggle), Duplicate, or Delete (creator only; reverts to default/another saved view). **Open contract details** After filtering, click a Contract Number or Contract ID to view and manage details in the Zuper Contracts Module. ## Pinned filters Zuper's Contracts module lets you use pinned filters to streamline your filter experience. Pinned filters keep your most-used criteria readily accessible for quick application. Pin up to 3 filters in any module. **Navigation**: *Contracts and Assets Management module -> Contracts -> Filters -> Pinned Filter* 1. Select the “**Contracts**” module from the left navigation menu. ![Pin Contr1 Pn](https://mintcdn.com/zuperinc/uWJXnqMkUObW6Xs-/images/pin-contr1.png?fit=max\&auto=format\&n=uWJXnqMkUObW6Xs-\&q=85\&s=baa248219e9a25e1728747ce2ff08470) 2. **Pin Filters for Quick Access** * Once your filters are set, click the **Pin Filters** button in the dialog box to save them as pinned. * Pinned filters appear in the dialog box's "**Pinned Filters**" section, allowing you to apply them with one click in future sessions. ![Pin Contr2 Pn](https://mintcdn.com/zuperinc/uWJXnqMkUObW6Xs-/images/pin-contr2.png?fit=max\&auto=format\&n=uWJXnqMkUObW6Xs-\&q=85\&s=46b98f86cb2c2dc7f5af80d6d654e478) 3. To Unpin the filter: * To unpin, select a pinned filter and click **Remove**. * To apply pinned or default filters, open the dialog box and select them. * Use **Clear All** to remove active filters. ![Pin Contr3 Pn](https://mintcdn.com/zuperinc/uWJXnqMkUObW6Xs-/images/pin-contr3.png?fit=max\&auto=format\&n=uWJXnqMkUObW6Xs-\&q=85\&s=48a4a5cced5a85e3ded42d00c2ef20fc) # Managing contract details  Once a contract is created or accessed from the listing page, the Contract Details Page serves as your central hub for managing its lifecycle. The details page has a three-column layout, providing quick access to information and actions within each panel. ![Contract53 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract53.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=4467db093d3c2a30472c2cf1df012414) ## Left panel  The left panel contains contract-related details such as the contract name and number. Below this, you will find the quick actions bar, which provides contextual action buttons, including options to email the customer, add notes, and create a new job for the contract. From here, you also have quick access to view information such as contract details, associated notes, parts & services, jobs, and activities.  > [accordion] Mail customer > > Use the "**Mail**" button to view and mail the contact or the organization for whom you’re creating this contract. > > ![Contract54 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract54.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=d6aa17cf33fd51b58ce335c21c815c0d) > [accordion] Create new job > > Use the “**+ New**” button to create a new job for the contract, if required.    > > For step-by-step instructions on how to create a new job, see the [Creating a new job](https://zuperinc.mintlify.app/Work_Order_Management/Jobs/creating_a_new_job) article.   > > ![Contract55 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract55.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=764198288250cae669122cf77c959414) > [accordion] Add note > > Use the "**+ Add Note**" button to create a new note.  Notes are comments or information added to a contract over its course. Your notes can be anything ranging from a simple text reminder to an image of the item, service, video, or document. All added notes can be viewed under the Notes Section.  > > ![Contract56 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract56.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=e288b598869ce8b6c34510c3de84d6f0) > [accordion] View contract details > > The contract details section provides an overview of all contract-related information, including the contract number, contract type, contract period, invoice details, contract address, and more.  > > ![Contract57 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract57.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=12fb95ac16fc87fdbd462e9ec106af87) > [accordion] View notes > > 1. The Notes section allows you to view, add, and manage notes related to the contract. From here, you can use the rich text editor to add any new note. To tag a user to a note, you can use **@** and key in the name to tag the user.   > > 2. You can attach multimedia files such as images, audio, video, and documents related to the contract. Use the “**+**” option to associate the notes with other modules such as customer, property, etc. > > ![Contract58 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract58.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=f1acfcc26f755837f7296c9a672b2180) > > 3. You can also choose one of the following options for how you’d like the notes to be visible:  > > * **Public** - This privacy setting will help you make the note public to all, including the customer.   > * **Internal** (Default) – This privacy setting will help you make the note visible to all your Zuper users in your account.   > * **Only me** – This note is visible only to the user who created the note.   > > After adding the notes, click the “**Post Note**” button to post the notes. Once the notes have been posted, you can sort them based on the newest or oldest.    > > > [!NOTE] > > > > **Note**: Contract notes can be edited or deleted only by the user who created them. > [accordion] View associated parts & services > > This section allows you to view the parts and services associated with the contract. It provides an overview of all the items included, whether automatically populated from the contract package or manually added. > > ![Contract59 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract59.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=b823a441aac7f6c8ffcac3fa16c605f7) > [accordion] View associated jobs > > The Jobs section allows you to view all jobs associated with the contract. This includes both ongoing and completed jobs, providing you with a comprehensive overview of job statuses, schedule, and related details. > > ![](https://mintcdn.com/zuperinc/7Bu7cWfxGOT6fS3e/Contracts_and_Assets_Management/Contract/contracts17.png?fit=max\&auto=format\&n=7Bu7cWfxGOT6fS3e\&q=85\&s=1be4c8d883b8e61bfbdeaa5147daac39) > [accordion] View activity > > The activity section on the details page displays a log or timeline of all actions and updates related to the contract, helping you stay informed about recent changes and track the contract’s progress.  > > ![Contract60 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract60.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=8fb7b3e07eac8e2a13d86deb1fedf94f) ## Right panel In the right panel, view the organization or contact information associated with the asset, and manage its links to various modules, such as properties, assets, projects, organizations, and more. To associate a module, click the “**+**” icon next to the desired module.  ![Contract61 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract61.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=3dcf48d028f70be779d42c090ca0625c) ## More actions Managing contracts doesn’t stop at viewing details—you can perform various actions such as printing, sharing, editing, cloning, or deactivating the contract as needed. > [accordion] Print and Share   > > To print or share the contract via email, click the “**Print/Share**” option from the top right corner of the job details page and choose either “**Print/Save as PDF**” or “**Share via email**” option.  > > ![Contract62 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract62.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=5494f7e3c799a7a14dc94314c1f5d7f9) > [accordion] Edit contract > > To modify any of the existing contract details, click “**More Actions**” at the top right corner of the page and select '**Edit Contract**. > > ![Contract63 Pn](https://mintcdn.com/zuperinc/1bNBR6xMzT6dAr4M/images/contract63.png?fit=max\&auto=format\&n=1bNBR6xMzT6dAr4M\&q=85\&s=e08f426c1c9aa478a489aa257270efc9) > [accordion] Clone existing contract > > The Clone option allows you to quickly create a replica of an existing contract, saving you time. To do this, click "**More Actions**" at the top right corner of the page and select "**Clone**." The current contract details will be duplicated onto a new contract page, where you can make any necessary edits before saving. > [accordion] Deactivate contract > > To deactivate/disable the contract, click “**More Actions**” at the top right corner of the page and select “**Deactivate**.” Once deactivated, you will have the option to delete it if needed. Managing contracts efficiently is essential for seamless operations, compliance, and financial accuracy. With Zuper, you have a comprehensive platform to oversee every aspect of your contracts, from creation and tracking to modifications and associated actions, ensuring they remain well-organized, up-to-date, and aligned with your business objectives # Create a Widget Source: https://docs.zuper.co/Create-a-Widget Creating a widget takes only a few minutes. Start by choosing the widget type that best matches your customer journey: **instant estimate**, **online booking**, **estimate & book**, or **lead capture**, and then configure how submissions should be handled in Zuper. Every new widget begins in **Draft** status. You can complete the setup, test the experience, and make changes without exposing it to homeowners until you're ready to activate it. ## Create a new widget 1. Go to **Settings** from the left navigation menu. 2. Under **Customer Experience**, select **Website Widget**. 3. Select **+ New Widget** at the top right. 4. Enter a **Widget** **Name**. This name is for internal reference and isn't shown to homeowners. Zuper also uses the widget name as a tag to help identify and manage submissions created through the widget. 5. Optionally, add a **Description** for your team's reference. 6. Select a **Widget** **Type**: *Online Booking, Instant Estimate, Estimate & Book, or Lead Capture*. 7. Turn on **Create a Job** if you want Zuper to automatically create a job for every submission. When enabled, a **Job Category** field appears, allowing you to select the category assigned to those jobs. Leave this setting turned off if you prefer to review submissions before creating jobs manually. 8. Select **Next**. Zuper saves the widget as a draft and opens the next step, Appearance. ![SCR 20260901 Pqxj](https://mintcdn.com/zuperinc/flqFOakcrzRP6Z1Y/images/SCR-20260901-pqxj.png?fit=max\&auto=format\&n=flqFOakcrzRP6Z1Y\&q=85\&s=b219b0abdddd54ad566a8d10010f016e) ## What's next Continue through the setup to configure the experience for homeowners. The remaining steps depend on the widget type and may include appearance, questions, roofing options/service, and other settings. Choose the setup guide for your widget: > [card] [Online Booking](/Setting-up-Online-Booking-Widget) > > Let homeowners choose a service and book directly. > [card] [Instant Estimate](/Zuper_for_Roofing/Website_Widget/Instant_Estimate) > > Show or share pricing options before a homeowner calls. > [card] [Estimate & Book](/Zuper_for_Roofing/Estimate_and_Book_widget) > > Combine a price estimate with scheduling a visit. > [card] [Lead Capture](/Zuper_for_Roofing/Setting-up-Lead-Capture-widget) > > Collect project details for your team to follow up. ## Frequently asked questions > [accordion] How many widgets can I create? > > You can create up to **20 widgets**. Each widget is independent, with its own type, branding, questions, and settings, allowing you to tailor widgets for different customer journeys and campaigns. > [accordion] Should I turn on Create a Job? > > Turn it on if you want every submission to become a job automatically, ready for your team to schedule without an extra step. Leave it off if you'd rather review each submission first, for example, to confirm scope or filter out low-quality leads, before it becomes a job. > > > [!NOTE] > > > > **Note**: For Estimate & Book widgets, Zuper creates a job once a homeowner books a visit, regardless of this setting. > [accordion] Will Zuper create a contact and property from a submission? > > Yes. When a homeowner submits a response, Zuper checks your account for a matching contact and property. If a match already exists, Zuper links the submission to those existing records instead of creating duplicates. If no match exists, Zuper creates a new contact and property as a lead intake. # Adding and Managing Cards in Your Wallet Source: https://docs.zuper.co/Customer_Portal/Cards This guide explains how to add, manage, and use payment cards in the Customer Portal's Wallet. The Wallet saves up to five cards on file for quick and secure payments, eliminating the need to re-enter card details for every transaction. **Navigation**: *Settings -> Customer/Contact Settings -> Allow Payment Card on File*. ## **For Business:** ### **Pre-requisites** 1. Select the “**Settings**” module from the left panel. Under the “**Modules**,” choose the “**Customer/Contact**.” Select the “**Customer/Contact General Settings**.” ![Ccard1 Pn](https://mintcdn.com/zuperinc/lZz0FiLKFztG8FJg/images/ccard1.png?fit=max\&auto=format\&n=lZz0FiLKFztG8FJg\&q=85\&s=a04d5a683a1bbad3efb31b6dec4b5a50) 2. **Allow payment card on file?** ![Ccard2 Pn](https://mintcdn.com/zuperinc/lZz0FiLKFztG8FJg/images/ccard2.png?fit=max\&auto=format\&n=lZz0FiLKFztG8FJg\&q=85\&s=32c9716f02b09839c6bcb70cbbe3d7aa) ## **For Customers:** **Navigation**: *Customer Portal* *-> Cards* ### **Accessing the Wallet** 1. Log in to the Customer Portal. If the business has enabled the card addition option, you’ll see a **Wallet** menu item in the navigation. ![Ccard3 Pn](https://mintcdn.com/zuperinc/lZz0FiLKFztG8FJg/images/ccard3.png?fit=max\&auto=format\&n=lZz0FiLKFztG8FJg\&q=85\&s=932ecaaba55ff238019987b731f30b68) 2. Click **Wallet** to view your saved cards and Transaction history.  ![Ccard4 Pn](https://mintcdn.com/zuperinc/lZz0FiLKFztG8FJg/images/ccard4.png?fit=max\&auto=format\&n=lZz0FiLKFztG8FJg\&q=85\&s=670b02903a69cfe1967c02742337dc62) ### **Adding a Card to Your Wallet** You can add up to five cards to your Wallet, including any cards added during previous transactions with the business. Follow these steps to add a card: 1. Navigate to the **Wallet** section in the Customer Portal. 2. Click the **Add Card** button. * Enter the card details in the provided fields, Card number * Expiration date * CVC code * Country * Zip code ![Ccard5 Pn](https://mintcdn.com/zuperinc/lZz0FiLKFztG8FJg/images/ccard5.png?fit=max\&auto=format\&n=lZz0FiLKFztG8FJg\&q=85\&s=5c34380ca25b7f3d75ebffc18080fc3b) 3. If you want the new card to be your primary card, check the **Set as primary card** checkbox. (See the details of the “**Setting a Primary Card**” section below.) Click **Save** to add the card. ![Ccard6 Pn](https://mintcdn.com/zuperinc/lZz0FiLKFztG8FJg/images/ccard6.png?fit=max\&auto=format\&n=lZz0FiLKFztG8FJg\&q=85\&s=26ac7138de99586c388df27d5cfad77c) **Actions You Can Take:** * **Set as Default**: Select a card and click **Set as Default** to make it the payment default. * **Delete a Card**: Select a card and click **Delete**. If it’s the Default card and you have other cards, you’ll be prompted to choose a new Default card. * **View Details**: See card details like the brand and last four digits (full card numbers are never shown for security). The Default card is the default card used for payments during checkout. Here’s how Default cards work: * **One Default Card**: Only one card can be set as Default. * **Mandatory Default Card**: A Default card must be set if you have at least one card. * If you have only one card, it is automatically set as the Default card. * If you have multiple cards, the first added card is the default, but you can change it. * **Setting a Default Card**: * When adding a new card, check the **Set as Default card** checkbox to make it the Default card. * To change the Default card, go to the Wallet, select a different card, and click **Set as Default**. * During Checkout, when using a new card to pay, a Set as default card checkbox appears (unchecked by default). Check it to set the new card as the Default. * **Deleting a Default Card**: If you delete the Default card and have two or more remaining cards, you’ll be prompted to select a new Default card. If you have only one card, you can delete it even if it is the Default card. **Managing Cards in Your Wallet** In the Wallet, you can view and manage all cards saved on file, including those added by the business. Each card displays: * Card brand (e.g., Visa, Mastercard). * Last four digits. * Expiration date. * Default card status (if applicable). ![Ccard7 Pn](https://mintcdn.com/zuperinc/lZz0FiLKFztG8FJg/images/ccard7.png?fit=max\&auto=format\&n=lZz0FiLKFztG8FJg\&q=85\&s=3743620d93e722d671b1878b326ec0a4) ![Ccard8 Pn](https://mintcdn.com/zuperinc/lZz0FiLKFztG8FJg/images/ccard8.png?fit=max\&auto=format\&n=lZz0FiLKFztG8FJg\&q=85\&s=a57377deef3ab358ad816e65453d36f7) ## **Using a Saved Card During Checkout** You can use saved cards to make payments quickly during checkout in the Customer Portal. Here’s how: 1. Proceed to the checkout page. 2. Your default card is selected by default in the payment section. 3. Select a different saved card from the list of saved cards to use. 4. The selected card’s details (e.g., card number, expiration date) are pre-filled for convenience. 5. Complete the payment. **Notes:** * **Disabled Card Types**: You cannot select those cards during checkout if the business disables a card type or brand. **Using a New Card**: If you pay with a new card instead of a saved one, you’ll see a **Save card for future payments** checkbox. Check it to add the card to your Wallet. A Set as Default card checkbox appears (unchecked by default) if checked. \ \ **Invoice Payments:** 1.     Click any one of the invoices to view the details. ![Ccard9 Pn](https://mintcdn.com/zuperinc/lZz0FiLKFztG8FJg/images/ccard9.png?fit=max\&auto=format\&n=lZz0FiLKFztG8FJg\&q=85\&s=58f3f1ec64118110a746443a57b88e7f) 2. Click the “**Pay**” button to pay for the invoice. ![Ccard10 Pn](https://mintcdn.com/zuperinc/lZz0FiLKFztG8FJg/images/ccard10.png?fit=max\&auto=format\&n=lZz0FiLKFztG8FJg\&q=85\&s=7d352af66d1b311e2f863c7d98d164f1) 3. Select the payment method and click “**Pay Now**.” ![Ccard11 Pn](https://mintcdn.com/zuperinc/lZz0FiLKFztG8FJg/images/ccard11.png?fit=max\&auto=format\&n=lZz0FiLKFztG8FJg\&q=85\&s=b048bc5d8c9514f844130121aebc1d15) 4. The payment is successfully done. ![Ccard12 Pn](https://mintcdn.com/zuperinc/lZz0FiLKFztG8FJg/images/ccard12.png?fit=max\&auto=format\&n=lZz0FiLKFztG8FJg\&q=85\&s=bd950c0051331b149f5bfc7b0ddd86c5) ## **Quote Payments:** 1. Click any one of the quotes to view the details.  ![Ccard13 Pn](https://mintcdn.com/zuperinc/lZz0FiLKFztG8FJg/images/ccard13.png?fit=max\&auto=format\&n=lZz0FiLKFztG8FJg\&q=85\&s=a55ea36b76ec09f35e69e3f29cf3df5d) 2. Click the “**Pay Deposit**” button to pay for the quote. ![Ccard14 Pn](https://mintcdn.com/zuperinc/lZz0FiLKFztG8FJg/images/ccard14.png?fit=max\&auto=format\&n=lZz0FiLKFztG8FJg\&q=85\&s=169755193d5eca1d8a2b29f7993601f1) 3. Select the payment method and click “**Pay Now**.” ![Ccard15 Pn](https://mintcdn.com/zuperinc/lZz0FiLKFztG8FJg/images/ccard15.png?fit=max\&auto=format\&n=lZz0FiLKFztG8FJg\&q=85\&s=50831e380bffb0930f52ff0d0f75b111) 4. The payment is successfully done. ![Ccard16 Pn](https://mintcdn.com/zuperinc/lZz0FiLKFztG8FJg/images/ccard16.png?fit=max\&auto=format\&n=lZz0FiLKFztG8FJg\&q=85\&s=686dc7430b58b711dda28176cf70bd00) ## **Frequently Asked Questions** **Why can’t I see the Wallet in the Customer Portal?** The Wallet is only visible if the business has enabled the “Allow customers to add cards on file” setting. Contact the business to confirm. **How secure is my card information?** Stripe, a trusted payment processor, encrypts and securely stores your card details. Neither the business, Zuper, nor any other intermediaries can access your card information. **Can I add more than five cards?** No, a customer record is limited to five saved cards, including those added by the business. However, if the business has your cards saved for future transactions, they will be reflected, even if there are more than five. **What happens if I delete my only card?** You can delete your only card, but you must add a new card or enter payment details manually for future transactions. **How do I know when my saved card is charged?** You’ll receive an email notification whenever a saved card is charged for approved work. ## Customer Portal User Manual link [Customer Portal Settings](https://docs.zuper.co/Settings/Customer_Portal/Customer_Portal) [**Login to your customer portal**](https://docs.zuper.co/Customer_Portal/Login_to_customer_portal) To learn more about the Customer Portal usage, click [here](https://drive.google.com/file/d/10KQUozMwYmoUhS7GEsjY0QG_ACSIz2Ib/view?usp=sharing) # Login to your customer portal Source: https://docs.zuper.co/Customer_Portal/Login_to_customer_portal The customer portal is your one-stop solution for viewing your field service-related activities. You must log in and provide your user ID and password to enter our portal, or you can use your email ID and OTP.  ## Pre-Requisites To do the setup correctly, use the link below: [**Customer Portal**](https://docs.zuper.co/Settings/Customer_Portal/Customer_Portal) ## **Login via Password** 1. Enter the URL: `{{company-login-name}}.stagingzuperhub.com` -> Staging\ `{{company-login-name}}.zuperhub.com` -> Live Login to Zuper customer portal account. Enter the "**Email ID**" and click next.  ![Custportal1 Pn](https://mintcdn.com/zuperinc/iVv3y5srKGry72Gq/images/custportal1.png?fit=max\&auto=format\&n=iVv3y5srKGry72Gq\&q=85\&s=9420d22cec842ec33730fc30e8cf2406) 2. Enter the email ID and password. (Note: this is applicable if you have opted for a user ID and a password.)  Click the "**Login**" button.  ![Custportal2 Pn](https://mintcdn.com/zuperinc/iVv3y5srKGry72Gq/images/custportal2.png?fit=max\&auto=format\&n=iVv3y5srKGry72Gq\&q=85\&s=1cb0b3f3047fd304bf0ad99736892375) 3. The login is successful.  ![Custportal3 Pn](https://mintcdn.com/zuperinc/iVv3y5srKGry72Gq/images/custportal3.png?fit=max\&auto=format\&n=iVv3y5srKGry72Gq\&q=85\&s=f9fc83cb79c57536261c32123e397c31) 4. To change your password, click the "**Reset Password**" button.  ![Custportal4 Pn](https://mintcdn.com/zuperinc/iVv3y5srKGry72Gq/images/custportal4.png?fit=max\&auto=format\&n=iVv3y5srKGry72Gq\&q=85\&s=551297a563573b21d5caa0174a561576) 5. The password reset email will be sent to the registered email ID. ![Custportal5 Pn](https://mintcdn.com/zuperinc/iVv3y5srKGry72Gq/images/custportal5.png?fit=max\&auto=format\&n=iVv3y5srKGry72Gq\&q=85\&s=53636e6cc75b2ac63a82c0a6ad110c25) 6. Check the registered email. Click the "**Set Password**" button.  ![Custportal6 Pn](https://mintcdn.com/zuperinc/iVv3y5srKGry72Gq/images/custportal6.png?fit=max\&auto=format\&n=iVv3y5srKGry72Gq\&q=85\&s=b772d9ff4931f8b60e6dca4f7fa19c4f) 7. Enter the password and reconfirm the password.  Click the "**Reset Password**" button.  ![Custportal7 Pn](https://mintcdn.com/zuperinc/iVv3y5srKGry72Gq/images/custportal7.png?fit=max\&auto=format\&n=iVv3y5srKGry72Gq\&q=85\&s=16738a23dbb32b923fbfad6f8c25a99a) 8. The password is reset successfully.  ![Custportal8 Pn](https://mintcdn.com/zuperinc/iVv3y5srKGry72Gq/images/custportal8.png?fit=max\&auto=format\&n=iVv3y5srKGry72Gq\&q=85\&s=8bc7e75b1dc6045a6c502dc3e87671db) 9. Enter the email ID and password. (Note: this is applicable if you have opted for a user ID and a password.)  Click the "**Login**" button.  ![Custportal9 Pn](https://mintcdn.com/zuperinc/iVv3y5srKGry72Gq/images/custportal9.png?fit=max\&auto=format\&n=iVv3y5srKGry72Gq\&q=85\&s=b09cffb96e3ff166b7c4018918c0e7d6) 10. The login is successful.  ![Custportal10 Pn](https://mintcdn.com/zuperinc/iVv3y5srKGry72Gq/images/custportal10.png?fit=max\&auto=format\&n=iVv3y5srKGry72Gq\&q=85\&s=333199fcb696d643ae706416bd9a800f) ## **Login via OTP** Alternatively, you can login using your email ID and the OTP received in your email ID.  1. Login to the Zuper customer portal account. Enter the "**Email ID**" and click "**Send OTP**."  ![Custportal11 Pn](https://mintcdn.com/zuperinc/iVv3y5srKGry72Gq/images/custportal11.png?fit=max\&auto=format\&n=iVv3y5srKGry72Gq\&q=85\&s=5b33da27dddae0265d0e0e22b97edc40) 2. Check the email to get the "**OTP**." ![Custportal12 Pn](https://mintcdn.com/zuperinc/iVv3y5srKGry72Gq/images/custportal12.png?fit=max\&auto=format\&n=iVv3y5srKGry72Gq\&q=85\&s=6543299e600d64611023b94d2a2139f4) 3. Enter the OTP received and select the “**Sign in**” button. ![Custportal13 Pn](https://mintcdn.com/zuperinc/iVv3y5srKGry72Gq/images/custportal13.png?fit=max\&auto=format\&n=iVv3y5srKGry72Gq\&q=85\&s=684e53d9d1c89b207ff35e886fbbd596) 4. The login is successful.  ![Custportal14 Pn](https://mintcdn.com/zuperinc/iVv3y5srKGry72Gq/images/custportal14.png?fit=max\&auto=format\&n=iVv3y5srKGry72Gq\&q=85\&s=106fb016e0d3a9c9d4fb5d025b554da8) ## Customer Portal User Manual link [Customer Portal Settings](https://docs.zuper.co/Settings/Customer_Portal/Customer_Portal) [**Adding and Managing Cards in Your Wallet**](https://docs.zuper.co/Customer_Portal/Cards) To learn more about the Customer Portal usage, click [here](https://drive.google.com/file/d/10KQUozMwYmoUhS7GEsjY0QG_ACSIz2Ib/view?usp=sharing) A secure login process safeguards your personal and financial information on a customer portal. It allows only authorized users to access sensitive data, such as account details, billing information, and order history. # Dispatch Assistant Source: https://docs.zuper.co/Dispatch/Assistant-Dispatch Find the Right Technician, Every Time Dispatching isn’t just about assigning *any* technician; it’s about assigning the right technician at the right time. Zuper’s **Dispatch Assistant** on the Dispatch Board helps dispatchers do exactly that, in seconds. Dispatch Assistant intelligently shortlists the most suitable technicians by evaluating job location, technician base location, and existing scheduled jobs, along with availability, skills, service territories, shifts, and workload. By factoring in both where a technician starts and where they are headed next, it clusters assignments more effectively and significantly reduces unnecessary travel. ![Assistant 1](https://mintcdn.com/zuperinc/CPwX6NlUtNruC9sq/images/Assistant-1.png?fit=max\&auto=format\&n=CPwX6NlUtNruC9sq\&q=85\&s=a02a34804bc6fdc494f2f10f48478bd7) This smart evaluation enables dispatchers to: * Assign jobs faster with confidence * Optimize assignments and minimize travel time * Improve on-time arrivals and job sequencing * Balance workloads across technicians With Dispatch Assistant, dispatchers move from manual guesswork to data-driven decisions, improving operational efficiency while delivering a better experience for both technicians and customers. > [!TIP] > > **Availability** \ > Dispatch PRO must be enabled for your organization. Please contact our [support team](support@zuper.co) to enable this feature. ## Accessing Assisted Scheduling You can launch **Dispatch Assistant** directly from the **Dispatch Board** by right-clicking on the relevant job and selecting “**Dispatch Assistant**”. ![Assistant 2](https://mintcdn.com/zuperinc/CPwX6NlUtNruC9sq/images/Assistant-2.png?fit=max\&auto=format\&n=CPwX6NlUtNruC9sq\&q=85\&s=358415a860d3d1e9a87646089748d2ee) The panel opens; Dispatch Assistant automatically evaluates the job details and begins shortlisting eligible technicians. ### Understanding the Dispatch Assistant Panel Dispatch Assistant progressively narrows down technicians using configurable criteria that are automatically pre-filled from the job details. You can also edit each criterion directly from the panel to fine-tune technician selection. * **Duration (Job Duration)** \ Job Duration reflects the total time required to complete the job. For scheduled jobs, it is derived from the scheduled start and end times. For unscheduled jobs, it uses the [Estimated Duration](/Settings/Modules/Jobs/configuring_Job_categories) defined in the job category. Only technicians who can accommodate the entire duration are considered. * **Slot Duration** \ Slot Duration defines the time window in which Dispatch Assistant searches for technicians who have enough continuous availability to complete the entire job. For scheduled jobs, it is automatically derived from the job’s scheduled start and end times. For unscheduled jobs, it defaults to your organization’s business hours. You can adjust it manually if needed, but the slot duration must always be equal to or longer than the job duration.\ **Examples**: * A 1-hour job with a slot duration set from 10:00 AM to 3:00 PM: Dispatch Assistant looks for any technician available for a continuous 1-hour period anywhere within those 5 hours. * A 1-hour job with a slot duration set from 10:00 AM to 11:00 AM: Dispatch Assistant looks for technicians free for the full fixed hour between 10:00 AM and 11:00 AM. * A 1-hour job cannot have a slot duration of 10:00 AM to 10:30 AM, as the slot (30 minutes) is shorter than the job duration (1 hour), this is not allowed. * **Skills and Skill Levels**\ Dispatch Assistant matches technicians who possess the required skills when shortlisting the technicians. Technicians will be shortlisted if they hold any of the necessary skill(s). The skillset filter is automatically inherited from the job, based on [job category](/Settings/Modules/Jobs/configuring_Job_categories#creating-skillsets-for-a-job-category) mapping. * **Service Territory** \ Technicians & teams are filtered based on the selected Service Territory to ensure territory alignment. This will be picked up automatically from the job, if applicable. * **Team Selection** \ Assisted Scheduling adapts to how you’re already using the Dispatch Board. When launched from the Dispatch Board, the currently selected team is pre-applied. However, if you want to look out for technicians from other teams, you can update the team from the dispatch assistant panel directly and search for the right technicians. > [!NOTE] > > **Note**: If that team doesn’t belong to the chosen Service Territory, Zuper automatically switches to **Any Team** and shows all eligible technicians. * **Consider User Shifts** \ When enabled, Dispatch Assistant respects real-world availability by factoring in existing job assignments, shift timings, work hours, time-offs, and non-job events. Only technicians whose shifts align with the selected arrival window are shown. * **Only Available Technicians** \ This toggle controls how strictly availability is enforced. When enabled, only technicians with uninterrupted availability throughout the job duration are shown. When disabled, even if they are occupied, closet technicians are considered. This is useful when prioritizing critical or high-priority jobs. ![Assistant 1](https://mintcdn.com/zuperinc/CPwX6NlUtNruC9sq/images/Assistant-3.png?fit=max\&auto=format\&n=CPwX6NlUtNruC9sq\&q=85\&s=ce9c04c4a0189407e4806c7769893592) ### Technician Shortlisting and Sorting After considering the key criteria, a list of technicians is shown. \ By default, technicians are sorted by **Distance** (proximity), so the nearest technicians appear at the top, helping you quickly find the technician closest to the job from their scheduled job or base location, minimizing travel. You can refine the technician list using the **Sort By** options: ![Assistant 1](https://mintcdn.com/zuperinc/CPwX6NlUtNruC9sq/images/Assistant-6.png?fit=max\&auto=format\&n=CPwX6NlUtNruC9sq\&q=85\&s=26e4e5120a4dab2c48793ed83a263596) * **Distance (Default):** Lists technicians closest to their scheduled job or base location, reducing travel time. * **Available Duration:** Shows technicians with the most free hours at the top, helping assign jobs to underutilized team members. * **Available Slots:** Prioritizes technicians with the highest number of free slots, supporting flexible, multi-job scheduling. * **Number of Jobs:** Highlights technicians with the fewest scheduled jobs, helping balance workloads across the team. * **Base Location:** Lists technicians by proximity to their base location, optimizing start-and end-of-day efficiency and enhancing work-life balance. > [accordion] Base Location > > A technician’s **Base Location** represents their primary start or end point for the workday, such as a home address, office, or depot. Base Location is configured on the technician’s user profile under **Settings > Users > Edit Profile > Location**. > > \ > Dispatch Assistant considers the base location alongside job locations when prioritizing technicians. This is especially helpful for early-morning or end-of-day assignments. For example, if one technician is finishing a job slightly farther away, but another technician’s base location is closer to the new job, the Dispatch Assistant prioritizes the technician with the shorter overall travel distance. This improves routing efficiency and supports better work-life balance for technicians. ### Crown Indicator The **crown icon** highlights the technician whose scheduled job or base location is closest to the job being dispatched. This indicates the technician who is likely to require the **least travel**. When you hover over a crowned technician card: * The estimated travel distance and time are displayed. * Zuper shows the **route on the map** between the technician’s previous job or base location and the selected job. If Zuper detects that a technician may arrive late to their next scheduled job due to projected travel time, a **conflict message** appears on the technician card. This helps you review alternatives before assigning the job. ![Assistant 8](https://mintcdn.com/zuperinc/CPwX6NlUtNruC9sq/images/Assistant-8.png?fit=max\&auto=format\&n=CPwX6NlUtNruC9sq\&q=85\&s=37158d96c1b0c1ea551462092c0575bf) Dispatchers can rely on the crown indicator for both current and future assignments to reduce travel and improve routing efficiency. ## Assigning a Technician 1. Review the shortlisted technicians. 2. Select the desired technician. 3. Click **Assign Technician**, or click an available free slot to schedule the job. ![Assistant 1](https://mintcdn.com/zuperinc/CPwX6NlUtNruC9sq/images/Assistant-4.png?fit=max\&auto=format\&n=CPwX6NlUtNruC9sq\&q=85\&s=aa830b5c7330f0846cb708ee5173188c) 4. Confirm the assignment. You can view the job on the map and visually confirm that the job has been scheduled successfully. # Creating and managing a non-job event Source: https://docs.zuper.co/Dispatch/Create_manage_non_job_event A non-job event refers to any activity that a field technician or other employees engage in that is not directly related to a specific job or work order. Creating these event(s) informs dispatchers that the technician is unavailable for job assignments during this period, enabling better scheduling and resource management. You can create a non-job event from either the **Dispatch Board** or the **Calendar**. **Navigation:** *Dispatch Board  -> -> Non-Job Event* ## Create a non-job event 1. Select the **Scheduling and Dispatching** module from the left navigation menu and choose either *Calendar* or *Dispatch Board*. ![](https://mintcdn.com/zuperinc/IrlKO33t1FrE3lZ2/Dispatch/images/nonjob-1.png?fit=max\&auto=format\&n=IrlKO33t1FrE3lZ2\&q=85\&s=d1a5c4a1f94750c1564661ddd01242a2) 2. Click the **drop-down** menu next to the "**Create Job**" button located at the top-right corner of the page and select “**New Non Job Event**”. ![](https://mintcdn.com/zuperinc/IrlKO33t1FrE3lZ2/Dispatch/images/nonjob-2.png?fit=max\&auto=format\&n=IrlKO33t1FrE3lZ2\&q=85\&s=65148dec49a86bf4856186887b5b4424) 3. A **Create Non Job Event** sidebar will appear. > [!NOTE] > > **Note**: You can create a non-job event for a specific time period on the **Dispatch Board** by clicking and dragging the cursor across the desired time range in the scheduler. Once selected, choose "**Create a Non-Job Event**" from the available options.