Contract type
The first card, Contract type, has three cards: Annual Maintenance Contract, Service contract and Free service / warranty. New contract starts on Annual Maintenance Contract, or on the type chosen from the New contract menu. On Edit contract the type is shown locked: "(cannot change on existing contract)". See How AMC, service and warranty contracts and one-off jobs differ.
Client & site
| Field | What to enter | Required | Default or options | When it shows |
|---|---|---|---|---|
| Select client | One of your active clients, or + Add new client, which opens the Add client box. The X clears it. | No ("Select a client (optional)") | Empty | Always |
| Company name | The client's company. Up to 191 characters ("Maximum 191 characters reached"). | No | The client's name when a client is picked | Locked while a client is picked on New contract; editable on Edit contract |
| Contact person | The person to contact. Letters, spaces and . - ' only, up to 100 characters. | Yes: "Contact person name is required", "Must be at least 2 characters" | The client's name when a client is picked and the field is empty | Always |
| Contact phone | The phone number. | Yes: "Contact phone number is required" (fewer than 5 digits) | The client's phone | Locked while a client is picked on New contract; editable on Edit contract |
| Contact email | An email address, up to 191 characters. | No: "Enter a valid email address" | The client's email | Locked while a client is picked on New contract; editable on Edit contract |
| Address | The site address: search a place ("Enter site address…") and set the pin on the map. The coordinates show under the map. | Yes: "Site location is required, use 'Use my location' or pin on map" (it needs the text and a map point) | Empty | Always. On Edit contract the text box cannot be typed in: change it with a place pick or the map ("Search or enter site address…"). |
Machines
The card is Machines ([number]). Add machine adds a block Machine [number]; the X removes a block while there is more than one. "Each machine becomes its own contract." Edit contract has one machine.
| Field | What to enter | Required | Default or options | When it shows |
|---|---|---|---|---|
| Select from inventory | An item from your catalog (the first 500), or + Add new inventory item, which opens the item box with Serviceable machine set to yes | No ("Select an item (optional)") | Empty | With View on Items; + Add new inventory item needs Add on Items |
| Machine / model | The machine's name or model, up to 191 characters | Yes: "Machine / model name is required" | The item's name when an item is picked | Always |
| Brand | The brand, up to 100 characters | No | The item's brand | Always |
| Capacity | The capacity, for example 18 TR. Up to 50 characters. | No | The item's capacity | Always |
| Serial number | The serial number, up to 100 characters | No | Empty | Always |
| Installed year | The year, four digits | No | Empty | Always. Edit contract keeps digits only. |
| Installed by | "Us (our installation)", "Another contractor", "OEM / brand dealer" or "Client directly" | No | "Another contractor"; "Us (our installation)" for a warranty | Always |
| Location / condition notes | Where the machine is and its state, up to 191 characters | No | Empty | Always |
For a warranty, a machine not installed by you shows "Warranty contracts are for your own installations." and Create contract is greyed out until every Installed by is "Us".
Contract terms
| Field | What to enter | Required | Default or options | When it shows |
|---|---|---|---|---|
| Start date | A date | Yes: "Start date is required" | Your company's today on New contract | Always |
| End date | A date after the start | Yes: "End date is required", "End date must be after start date" | The start date plus 12 months on New contract | Always |
| AMC type | "Non-Comprehensive (parts billed)" or "Comprehensive (parts included)" | No | Non-Comprehensive on New contract | AMC only. On Edit contract a change here is not saved. |
| Visits per year | A number, at least 1 ("Must be at least 1 visit per year") | No | 4 | Locked at 4 for an AMC: "Fixed at 4 for AMC: configurable after data migration." (New contract), "Fixed at 4 for AMC." (Edit contract) |
| Cost ([currency]) | The contract's price, 0 or more ("Amount cannot be negative") | No (empty is 0) | Empty | New contract, Service contract only |
| Template | One of your service templates ("Optional"). Picking one sets Visits per year to the template's. | No | Empty | New contract, Service contract only, once a template exists |
| Amount ([currency]) | The contract's price, 0 or more | No | The saved amount | Edit contract, any type but a warranty |
| Currency | One of the currencies. "Can change only while the contract has no invoices." | No | The saved currency | Edit contract, any type but a warranty |
A new contract takes the currency of its project, else your company's currency.
Buttons and messages
| Form | Buttons | Saved | Refused |
|---|---|---|---|
| New contract | Cancel, Create contract or Create [number] contracts (greyed out until the required fields are filled) | "[number] contract(s) created", plus ", [number] failed" | See A contract cannot be created |
| Edit contract | Cancel (Close when read only), Save changes | "Contract updated" | See Edit contract cannot be saved, or a change is not kept |
