Skip to content
Nabeeh Nabeeh Help Center Open the app

Maintenance contracts

Create a contract from Maintenance Contracts, review the profile and the maintenance-contracts calendar, and log materials when Inventory is on for the account.

Maintenance Contracts is the menu name for this work. The screen title is Contract Management. A contract is an operating agreement for a party or a scope: repeating visits, terms, and dates. You run it from the list, profile, and calendar. It is separate from a single maintenance request, though it may generate related work.

List and profile

On Maintenance Contracts, search by name or number. On All branches, the list shows the branch and you can filter by it. The profile shows parties, term, extra conditions, and notes. The calendar shows contract commitments on the days. Past days show only the maintenance requests that were actually created. Expected visits follow each service's current frequency. On an active contract they start from the next date the system will still create a request for: today plus the service's Auto-generate before (days). On a contract that is not active they start today, as a preview only. Expected visits are drawn dashed, and as a hollow dot in the month view. Changing a frequency changes only what is expected from now on, and never redraws the past.

Add a contract with only the fields on the form. When you have many contracts, import them from the multi-sheet template: see Import maintenance contracts — it opens in the Import & Export Center, and each contract is imported with all its lines or not at all. The contracts sheet has an optional branch column — leave it empty to use the header branch (or Main); a named value files that row even if the header is elsewhere. Older files without the column still import. Do not document internal column maps here; follow the template headings as shown.

On the Contracting party tab, choose Add customer next to the Customer field to add a customer who is not in the list yet without leaving the contract. Once you save the customer form, the new customer is selected in the field. The button appears only if your role can add customers.

On the Scope of services tab, type in the Service field to search your account's services by name instead of scrolling a long list. Only active services are offered for a new line; a line saved with a service that was deactivated later keeps showing it when you edit the contract.

Note: If Inventory is enabled — or the contract already stored materials — the profile and the Materials tab show materials. On that tab, Available now is the current on-hand stock. You may allocate a quantity above Available now (stock can arrive later); the row shows a light warning, and save is not blocked.

On edit (not create), the Budgets tab caps a utility allowance or tracks spare-parts spend — separate from materials allocation and from basic contract details.

Use print preview from the profile when that action appears. The printed document uses the saved contract title, with the standard title as a fallback. The First Party shows the company name and, when available, its address; the signature table remains unchanged. For the second party, a company customer prints the company name and falls back to the customer name when needed; an individual prints the customer name directly. The company tax ID is printed under Commercial Register in the party details and signature table, and the contract's project address is included when available.

In Contract Print Settings, show or hide sections, including Contract Description, Contract Duration, and Financial, customize each section title per language, and drag sections into the required order. The list also includes Introduction Text, First Party, and Second Party. By default, the introduction appears first, followed by the first-party and then second-party details; you can move any of these sections. When a contract has a description, it appears after the second-party details by default; you can rename the section, for example to Contract Subject. Contract Duration follows it by default and generates its text from the available duration, start date, and end date; optional additional text can follow it on a new line. Visits can appear as a dated table or as text that puts each recurring service on its own line with its visit count and frequency, without dates; on-demand services are excluded. Separate optional text can follow the visit details in either display mode. Empty additional text is not printed, and its field is hidden when its section is disabled while the saved value is retained. Financial shows the available contract value and payment notes without duration data. Clear a section title in every language to print its content in position without a heading. Add General Terms once at account level to include them in printed contracts; these terms remain separate from each contract's internal notes. You can also add Closing Text, position it, or hide it with the section controls. On the Design tab, choose the Arabic and English fonts and, when needed, separate content (8–12pt) and heading (10–20pt) font sizes. Leaving either size at the template default preserves that template's original sizing. The selected font is embedded in the PDF so its appearance remains consistent when printed. Section titles can use a primary-color bar with white text or primary-color text without a background. Their alignment can be centered or set to the start of the line, which follows the contract language direction. The same tab accepts separate header, footer, and page-background images, with page scope and image-fit controls. Leave any of them empty and the matching image from the account Print settings is used instead, with its own options. When a header image is present, the printout uses compact top spacing while retaining a safe print margin. Save the settings before opening the refreshed preview.

Choose Signature display as either a Detailed table with party information or Simple signature blocks that show both party names with separate signature and stamp lines.

A new line entered in any multiline print field is kept as a new line in the PDF.

Each print text and section title has a field per language. Write in your language: a text left empty in another language is translated automatically after you save, and a section title that still shows the section name in another language takes the translation of your title. Wording you type in a language yourself is kept as it is.

The footer image stays at the bottom edge. It repeats at the bottom of every page when all pages are selected, or appears at the bottom of the last page only, with space reserved so it does not cover content.

Choosing Print generates an A4 PDF and opens it in a new tab, so the contract does not include the browser's date, page title, or URL header. The generated file is saved in print history; Reprint opens that same stored copy even if the contract data or print settings change later.

If the contract is on the wrong branch, use Move to branch on the profile. Only the contract row moves — generated later requests pick up the new branch; existing requests stay unless you move them separately. A move that would leave the contract covering properties on two branches is blocked until you split the contract. Staff assigned to only one branch do not see this action.

Automatic maintenance requests

Every night the system creates maintenance requests from each active contract's scheduled services. A visit is created on the day it falls due minus the service's Auto-generate before (days), until the service reaches its maximum number of requests. Each contract service gets at most one request per scheduled day. If you delete a request that was generated for a day, it is not created again for that day, and moving a generated request to another day or time does not create a new one for its original day.

To check contract schedules without waiting for midnight, choose Run generation for today on the Maintenance Contracts list:

  1. Read the explanation in the confirmation window, then choose Start generation.
  2. Generation runs in the background for every active contract in your account, across all branches, using your account's date and the same rules as the nightly run.
  3. When it finishes, you get a notification with the number of requests generated, skipped (already generated), and failed.

Note: Only one run for today can be in progress at a time, and a second run within a few minutes is refused. Running it again on the same day does not create duplicate requests. The button appears only to users whose role has the Run Contract Generation for Today permission (see Account users and roles). Because the run covers every branch, staff assigned to only one branch do not see it.

Competency certificate

Each contract has one competency certificate, opened from Competency certificate at the top of the contract profile. The top of the panel is filled in from the contract: Contract number, Date (the contract signing date, or its start date when no signing date is recorded), Customer (the company name for a company customer, the customer name for an individual; the printed certificate shows it after "Messrs."), and Address (the contract's project address). To change any of these, edit the contract itself.

  1. Adjust the Certificate title and Statement if needed, for example "Fire Systems Competency Certificate". The first time you open the certificate, both are prefilled with defaults that use your company name.
  2. Search Inventory by material name or SKU and pick a material to add it with a count of 1, then type the correct count and press Enter to return to search for the next material. Picking a material that is already listed increases its count instead of adding it twice.
  3. Drag items to reorder them or remove any you do not need, then choose Save or Save and print.

The certificate prints as a PDF in your current interface language and uses the header, footer, and page-background images from Contract Print Settings (or, for an empty one, from the account Print settings), along with the font and the content and heading font sizes chosen on its Design tab; the heading size applies to the certificate title. Each unit is shown as recorded on the material in inventory. The certificate stays editable at any time and does not change inventory quantities. A material deleted from inventory drops off the certificate.

Note: A certificate cannot be printed until it has at least one material. Viewing, editing, and printing are three separate permissions under the Competency Certificate group in roles.

Additional conditions and disputes

From Contract Settings on the contracts list, open Extra Condition Templates or Dispute Templates. Each section has its own templates. Enter a clause in the required languages and save it. Depending on your permissions, you can edit, delete, activate, or deactivate templates.

When creating a contract, Add default dispute clauses from templates appears below the additional-condition option. Both are selected by default; clear either option to omit that section’s templates. Saving the basic details copies all active templates from each selected section. Then open Disputes or the additional-conditions tab to add, edit, or remove contract-specific clauses and save that tab.

Note: Each contract keeps its own copy. Later changes to a template, including deactivation or deletion, do not change existing contracts. Editing a contract clause does not change its template.

Disputes appear in the contract profile and printout. Contract Print Settings lets you show or hide the section, customize its title in each language, and reorder it. Its default position is immediately before General Terms. These are contractual clauses, not a case-tracking workflow.

For imports, use the Disputes sheet and link clauses by contract number. Older workbooks without this sheet remain valid. If the workbook supplies no dispute rows for a contract, its existing clauses remain unchanged on update. Imports do not automatically apply templates. See Custom fields for additional contract data rather than text clauses.

Export

Open Contract Settings above the maintenance contracts list and select Export contracts (under Import contracts) to download an Excel file of the contracts with their services, materials and conditions. See Export your data.

  • Inventory — log material use when the contract profile shows materials.
  • Maintenance requests — treat a request born from a contract obligation as a normal request.
  • Budgets — on the contract Budgets tab: cap a utility allowance or track spare-parts spend.
  • Collection — owners-association billing: share groups and collection rounds as separate views on the Collection tab.
  • Custom fields — add an extra field to the contract's basic details tab.
  • Branches — move the contract if it was filed under the wrong branch.
  • Export your data — download the list as an Excel file.
  • Import maintenance contracts — add many contracts, or update them from an export, with every sheet.
  • Account users and roles — grant Run Contract Generation for Today to the roles that may use the button.
  • Notifications — find the result of a manual generation run.