> ## Documentation Index
> Fetch the complete documentation index at: https://docs.probaseapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Season contracts

> Sell an on-demand job for one total price over a season, collect it in one payment or in monthly payments, and cap how many visits it includes

# Season contracts

Many snow customers pay one price for the whole winter, not per push. A **Fixed term total** plan is made for this. It's a contract: one total price for a set timeframe, such as Nov 1 to Mar 31. The customer pays it all at once or in monthly payments. You can also limit how many visits or days the price includes, and charge for any extra.

A contract is always an [on-demand job](https://docs.probaseapp.com/scheduling/on-demand-jobs.md). ProBase doesn't book its visits by itself. You add visits when they're needed, one at a time or with [Dispatch](https://docs.probaseapp.com/scheduling/dispatch.md).

> [!NOTE]
>
> Season contracts are rolling out gradually. If you don't see **Fixed term total** under **How is this plan structured?**, it hasn't reached your account yet. On some accounts the **Fixed term total** option wears a small **Beta** label. The label is only a heads-up: contracts work and bill the same way with or without it.

## How a contract bills

* **The payments add up to the contract price.** ProBase charges each payment on its date, overnight, and adds it to the customer's invoice as *\[job] — payment 1 of 6*. Each payment is charged once, even if you edit the list later.
* **Charges and discounts go on the first payment.** Any extra charges on the job bill once, with the first payment. A discount also comes off the first payment.
* **Visits don't add a charge.** A completed visit adds a \$0 line with a note such as *Visit 4 of 10 in your contract*, so the customer can see how much of the contract they've used.
* **Extra visits.** With a visit limit, each visit completed past the limit adds an *extra visit* charge at your overage price. With a day limit, the first visit on each extra day adds an *extra day* charge, and later visits that day are free. A visit counts on the day it was scheduled for, not the day you marked it done — a push scheduled for Nov 9 that you complete early on Nov 6 counts as Nov 9. The bill, the job page's used count and the Dispatch list all count it the same way.
* **Cancelling stops billing.** A cancelled contract charges no more payments. A contract that closes at its End Date still charges any payments it has left.

## Setting up a contract service

Set up the service once, and every new contract for it starts from the same price, payments and limit. This uses the service's [billing setup](https://docs.probaseapp.com/getting-started/service-catalog.md#setting-up-billing-for-an-on-demand-service).

**1. Choose Fixed term total**

On **How do you want to bill this service?**, pick **Fixed rate or recurring plan** and tap Next. On **How is this plan structured?**, pick **Fixed term total** — *A total contract price for a specific timeframe (e.g., a winter season), paid upfront or in installments.* **Ongoing recurring** is the plan that bills on a repeating schedule with no end date.

![How is this plan structured?](https://mintcdn.com/lawnstarter/9ZAYUp_xxpE0vdRD/images/probase/service-billing-setup/10-contract-plan.png?fit=max\&auto=format\&n=9ZAYUp_xxpE0vdRD\&q=85\&s=8c15a357ca151eb26d638d7ec3934291)

**2. Set the contract price**

Enter the **Contract price** for the whole term and the **Tax rate**.

![The contract price](https://mintcdn.com/lawnstarter/ScvXrlZRfLd4WsUU/images/probase/service-billing-setup/11-contract-price.png?fit=max\&auto=format\&n=ScvXrlZRfLd4WsUU\&q=85\&s=8321bc3607d4ee8cb9aa198ab80d5830)

**3. Pick a payment schedule**

Choose **Single payment** to bill the full price on one invoice, or **Monthly installments** to split it into equal monthly payments.

![Choosing a payment schedule](https://mintcdn.com/lawnstarter/WOXFiNPxdU_Pwpjm/images/probase/service-billing-setup/12-contract-payment-schedule.png?fit=max\&auto=format\&n=WOXFiNPxdU_Pwpjm\&q=85\&s=5acc3dfd74548eab3df10fc005a444e3)

To split it your own way, edit the **Payment pattern**. Each row is a share of the price and when it falls: the first payment date, a number of months after it, or the End Date. Tap **Add payment** to add a row. The **Total scheduled** line shows whether the shares add up to the full price.

![A two-payment pattern](https://mintcdn.com/lawnstarter/uJ0Az2FIa6v2krKi/images/probase/service-billing-setup/13-contract-pattern-split.png?fit=max\&auto=format\&n=uJ0Az2FIa6v2krKi\&q=85\&s=af3e71991f3436d6a779105cd6fa6dad)

If you switch between Single payment and Monthly installments after editing the pattern, ProBase asks **Rebuild the payment list?** first. Choose **Keep my payments** to keep your edits.

![Rebuild the payment list?](https://mintcdn.com/lawnstarter/uJ0Az2FIa6v2krKi/images/probase/service-billing-setup/14-contract-rebuild-ask.png?fit=max\&auto=format\&n=uJ0Az2FIa6v2krKi\&q=85\&s=f2e5a69b642fdd224b2cdbeb7d3f9d77)

**4. Add a visit limit (optional)**

Choose what the limit counts:

* **Visits (or passes)** — every completed visit counts.
* **Days** — several visits on the same day count as one day.

Then enter how many the contract includes and the **Overage price** for each extra one. Tap **Skip** if the contract has no limit.

![The visit limit](https://mintcdn.com/lawnstarter/uJ0Az2FIa6v2krKi/images/probase/service-billing-setup/15-contract-visit-limit.png?fit=max\&auto=format\&n=uJ0Az2FIa6v2krKi\&q=85\&s=d486f5d22bba989caf1fcd730dd78730)

The service page then shows the setup, for example **Fixed term total**, \**$2,000.00**, **2 payments** and *10 visits, then $75.00 per extra visit*.

![A contract setup on the service page](https://mintcdn.com/lawnstarter/josiD0sekXPoCshD/images/probase/service-billing-setup/16-service-page-contract.png?fit=max\&auto=format\&n=josiD0sekXPoCshD\&q=85\&s=0bc46a924cf26a2f22801072e49474a0)

## Selling a contract on a new job

**1. Start an on-demand job**

Tap the **+** button, choose **New Job**, and pick the customer, property and service. On the Schedule step, **Service Frequency** must be **On demand**. Set the Start Date and the **End Date** — a contract's payments run up to its End Date.

**2. Choose Fixed term total**

On **How do you want to bill this job?**, pick **Fixed rate or recurring plan**, then **Fixed term total**.

![Fixed term total on the Billing step](https://mintcdn.com/lawnstarter/5Ur8CtIP5tHRgf-F/images/probase/contract-billing/01-plan-fixed-term-total-430.png?fit=max\&auto=format\&n=5Ur8CtIP5tHRgf-F\&q=85\&s=f555c02a1701575966b75854d1b35ccf)

**3. Pick a payment schedule**

Choose **Single payment** or **Monthly installments**.

![Payment schedule](https://mintcdn.com/lawnstarter/W5RCDaao1p-0zJES/images/probase/contract-billing/02-payment-schedule-430.png?fit=max\&auto=format\&n=W5RCDaao1p-0zJES\&q=85\&s=2be6566e7f7ed61f497f0bc185b3fbc8)

**4. Fill in what the customer pays**

The summary asks for the **Contract price** and **Tax rate**, then shows the **First payment date** and the list of **Payment dates & amounts**, each with its amount with tax. Until you add a price, it reads *Add a contract price to save this contract.*

![The summary before a price is added](https://mintcdn.com/lawnstarter/YoJR3xrA8UoE3xx0/images/probase/contract-billing/03-summary-unpriced-430.png?fit=max\&auto=format\&n=YoJR3xrA8UoE3xx0\&q=85\&s=7296e0980a96bbccf337f302a9e6c6d7)

You can change any payment's date or amount, or tap **Add payment**. The **Total scheduled** line must match the contract price before you can go on.

![Two payments](https://mintcdn.com/lawnstarter/YoJR3xrA8UoE3xx0/images/probase/contract-billing/04-summary-two-payments-430.png?fit=max\&auto=format\&n=YoJR3xrA8UoE3xx0\&q=85\&s=dd37dee4c186ef7c4ec85c6d19500b7b)

**5. Add a limit, charges or a discount (optional)**

Below the payments, tap **Add a visit limit**, **Add a charge** or **Add discount**. A discount *Comes off the first payment*, so it can't be more than the first payment plus any charges. If it is, the summary says *That is more than the first payment. Make the discount smaller or change the price.*

![A visit limit on the summary](https://mintcdn.com/lawnstarter/YoJR3xrA8UoE3xx0/images/probase/contract-billing/05-summary-visit-limit-430.png?fit=max\&auto=format\&n=YoJR3xrA8UoE3xx0\&q=85\&s=0accf353ad993cd16828a79a9dc1c6d3)

![A discount larger than the first payment](https://mintcdn.com/lawnstarter/Irn62c7Y9uRTDAeL/images/probase/contract-billing/06-summary-discount-over-first-payment-430.png?fit=max\&auto=format\&n=Irn62c7Y9uRTDAeL\&q=85\&s=9abc71ce5c1a0d3718b4257dbb67ac35)

**6. Confirm and create**

The confirmation shows the price, such as **\$1,800.00 / contract**, and the billing, such as *Fixed term total · first payment Nov 2, 2026*. Tap **Confirm and create job**.

![The contract on the confirmation](https://mintcdn.com/lawnstarter/5Ur8CtIP5tHRgf-F/images/probase/contract-billing/07-confirm-430.png?fit=max\&auto=format\&n=5Ur8CtIP5tHRgf-F\&q=85\&s=4bda246ba346de4853c1a66425af5a32)

If the service has no billing setup yet, the confirmation offers to save this contract as the service's billing for new jobs. See [Saving the billing to the service](https://docs.probaseapp.com/scheduling/on-demand-jobs.md#saving-the-billing-to-the-service).

## The contract's job page

The job page shows the price, such as **\$1,800 / contract**, and the total with tax. The **Service plan** section shows how it's collected, for example *Invoice: Contract — monthly for 6 months*, and how far along it is: *1 of 6 payments charged* and *Next payment: \[date]*, or *Charged in full*.

![A contract job page](https://mintcdn.com/lawnstarter/5Ur8CtIP5tHRgf-F/images/probase/contracts/07-contract-job-page.png?fit=max\&auto=format\&n=5Ur8CtIP5tHRgf-F\&q=85\&s=7fd10a5065aa1e4857a1d8e575c3c3ab)

The job's row in the **Services** list on the customer and property pages reads the same price, **\$1,800 / contract**, and the contract price counts in full toward the customer's [Contract value](https://docs.probaseapp.com/customers/customer-history.md#contract-value).

![The contract's Service plan line](https://mintcdn.com/lawnstarter/YoJR3xrA8UoE3xx0/images/probase/contracts/07-contract-job-page-service-plan.png?fit=max\&auto=format\&n=YoJR3xrA8UoE3xx0\&q=85\&s=05f343a06238bc54bb945f7afbef767f)

Its visits read **Fixed term total** on visit cards and on the visit's **Details** tab.

> [!NOTE]
>
> After you save a change on a contract's job page, reload the page to see the new figures.

### Editing the payment list

Tap the **Invoice: Contract** line to open the **Payment list**. Change a payment's date or amount, remove one, or tap **Add payment**. The payments must add up to the contract price. Charged payments are locked and read, for example, *Payment 1 · \$300.00 / Charged Nov 1*.

![The Payment list](https://mintcdn.com/lawnstarter/YoJR3xrA8UoE3xx0/images/probase/contracts/08-contract-payment-list.png?fit=max\&auto=format\&n=YoJR3xrA8UoE3xx0\&q=85\&s=40f562fa2a83e2c3bd6d6232c6f6e08c)

When you change one amount, ProBase spreads the difference over the payments that follow, and a note tells you which changed — for example *Payments 3 to 6 changed to $275.00 so the total stays $1,800.00.* Removing a payment spreads its amount over the payments that follow, and the note names each payment's old and new amount, including one you typed yourself — for example *Payment 2, the $400.00 you entered, is now $468.75 and Payments 3 to 5 $275.00 → $343.75: they share the removed payment's $275.00, so the total stays $1,800.00.*

![Payments re-split after an edit](https://mintcdn.com/lawnstarter/5Ur8CtIP5tHRgf-F/images/probase/contracts/08-contract-payment-list-resplit-edit.png?fit=max\&auto=format\&n=5Ur8CtIP5tHRgf-F\&q=85\&s=29ede55ca9320b864cc42756b01b8cf7)

![Payments re-split after a remove](https://mintcdn.com/lawnstarter/5Ur8CtIP5tHRgf-F/images/probase/contracts/08-contract-payment-list-resplit-remove.png?fit=max\&auto=format\&n=5Ur8CtIP5tHRgf-F\&q=85\&s=865d718748e964c23b2b8668e948532c)

You don't have to wait for one change to finish before making the next, even on a weak signal. An amount you type stays on the payment you typed it into — even when a date you just changed moves that payment to a new place in the list.

Tap **Save changes** to keep them — ProBase confirms with *Payments updated.* If a payment was charged while you had the list open, your other edits are still saved and that payment stays as it was charged.

![Payments updated after saving](https://mintcdn.com/lawnstarter/5Ur8CtIP5tHRgf-F/images/probase/contracts/09-contract-payment-list-charged-mid-edit-saved.png?fit=max\&auto=format\&n=5Ur8CtIP5tHRgf-F\&q=85\&s=33e7f1ef709a73577f9b58a9f705c826)

If you close the list with unsaved edits, ProBase asks **Discard changes?**

![Discard changes?](https://mintcdn.com/lawnstarter/YoJR3xrA8UoE3xx0/images/probase/contracts/08-contract-payment-list-discard-ask.png?fit=max\&auto=format\&n=YoJR3xrA8UoE3xx0\&q=85\&s=24fcb6b158f5343ffa85de06b1a9b4eb)

You need permission to edit jobs to change the payment list.

### Changing the price or adding a visit limit

**Change Pricing** on a contract shows the **Contract price**, how to collect it (for example *6 monthly payments*), and what's been charged so far. The contract price can't change once the contract is charged in full.

![Change Pricing on a contract](https://mintcdn.com/lawnstarter/YoJR3xrA8UoE3xx0/images/probase/contracts/09-change-pricing-contract.png?fit=max\&auto=format\&n=YoJR3xrA8UoE3xx0\&q=85\&s=825bc5290cf2655fa888af55939efc89)

To add a limit, tap **Add a visit limit** on the job page or in Change Pricing. Pick **Visits (or passes)** or **Days**, then enter how many are included and the overage price. A changed limit only applies to visits completed after you save it.

![Adding a day limit](https://mintcdn.com/lawnstarter/Irn62c7Y9uRTDAeL/images/probase/contracts/09-change-pricing-contract-limit-open.png?fit=max\&auto=format\&n=Irn62c7Y9uRTDAeL\&q=85\&s=a8e47720e9e953c7cc476fb7817c9f57)

The job page then shows the limit and how much of it is used, such as *10 days · 0 used · \$50 per extra day*.

![The limit on the job page](https://mintcdn.com/lawnstarter/YoJR3xrA8UoE3xx0/images/probase/contracts/09-contract-job-limit-10-days.png?fit=max\&auto=format\&n=YoJR3xrA8UoE3xx0\&q=85\&s=ffefa3eeb9342ae2465575b7e4c3be93)

### Changing the schedule

While a contract has payments left to charge, it stays **On demand**. Change Schedule says *This contract still has remaining payments.* if you pick another frequency.

![The frequency is locked](https://mintcdn.com/lawnstarter/YoJR3xrA8UoE3xx0/images/probase/contracts/10-change-schedule-frequency-locked.png?fit=max\&auto=format\&n=YoJR3xrA8UoE3xx0\&q=85\&s=cb1eed481be19a1ac026a3588e03dc47)

The End Date can't move before a payment that hasn't been charged. If an earlier End Date would leave scheduled visits after it, ProBase asks first — for example *This cancels 1 scheduled visit after \[date]*. Choose **Cancel those visits** or **Keep the End Date as it is**.

![Moving the End Date earlier](https://mintcdn.com/lawnstarter/YoJR3xrA8UoE3xx0/images/probase/contracts/10-change-schedule-end-date-prompt.png?fit=max\&auto=format\&n=YoJR3xrA8UoE3xx0\&q=85\&s=d61be19663e536a42f4d78df08bc9bab)

## Contracts in Dispatch

On the [Dispatch](https://docs.probaseapp.com/scheduling/dispatch.md) list, a contract whose next visit would go past its limit reads **Visit limit reached · \$75.00** (or **Day limit reached** for a day limit), showing the extra price. You can still dispatch it — the extra visit is charged at that price.

![Visit limit reached on Dispatch](https://mintcdn.com/lawnstarter/YoJR3xrA8UoE3xx0/images/probase/contracts/01-dispatch-limit-reached.png?fit=max\&auto=format\&n=YoJR3xrA8UoE3xx0\&q=85\&s=1e38094591e591c9a9fb42aa5d94a948)

When you schedule a visit on a contract that closed at its End Date, the sheet says it reopens the job and which visit it is in the contract, for example *This is visit 8 in the contract.*

![Scheduling a visit on a closed contract](https://mintcdn.com/lawnstarter/YoJR3xrA8UoE3xx0/images/probase/contracts/02-closed-contract-reopen-sheet.png?fit=max\&auto=format\&n=YoJR3xrA8UoE3xx0\&q=85\&s=e456702143fd13b17825f49c19d57abd)

Extending the season for contracts reopens them until the new End Date and starts no new term. The sheet reads *No new charges are created.*

![Extend the season for contracts](https://mintcdn.com/lawnstarter/YoJR3xrA8UoE3xx0/images/probase/contracts/03-extend-season-contracts-sheet-dated.png?fit=max\&auto=format\&n=YoJR3xrA8UoE3xx0\&q=85\&s=09fa43846a481a211e8378fa3477a05e)

## Quoting a contract

On a quote, set an on-demand line's service to one whose billing setup is **Fixed term total**. The line fills in its **Contract price** and payments from the setup. Give the line an **End Date** — the quote can't be sent or accepted without one, and shows *Add an End Date to the \[service] contract before sending or accepting this quote.* until you do.

![A contract line with its End Date](https://mintcdn.com/lawnstarter/rdRYJtJKfhBRqonn/images/probase/quote-contract/01-contract-line-with-its-end-date.png?fit=max\&auto=format\&n=rdRYJtJKfhBRqonn\&q=85\&s=e2e8e6b94da4909ff8eca68a5a5f4ead)

![The quote waits for an End Date](https://mintcdn.com/lawnstarter/2cZHrr6At26juavL/images/probase/quote-contract/05-send-waits-for-the-end-date.png?fit=max\&auto=format\&n=2cZHrr6At26juavL\&q=85\&s=0ac76d0e7d507880757800accf537526)

A contract collects up front with its first payment, so a quote with a contract line takes no deposit. If the quote already has a deposit, ProBase asks whether to **Remove the deposit** or **Don't add this line**.

![Remove the deposit?](https://mintcdn.com/lawnstarter/rdRYJtJKfhBRqonn/images/probase/quote-contract/02-remove-the-deposit.png?fit=max\&auto=format\&n=rdRYJtJKfhBRqonn\&q=85\&s=672746b86cf9343230c77219be39dc5f)

The customer reads the contract price and every payment date, for example *Payments: $375.00 today, then $375.00 on Dec 4, Jan 4 and Feb 4. The contract ends Feb 28, 2027.* They approve for the first payment's amount.

![The customer reads the contract](https://mintcdn.com/lawnstarter/2cZHrr6At26juavL/images/probase/quote-contract/03-customer-reads-the-contract.png?fit=max\&auto=format\&n=2cZHrr6At26juavL\&q=85\&s=754cd6758a53d79bd2c999ca14d1cbe6)

![The approved contract quote](https://mintcdn.com/lawnstarter/2cZHrr6At26juavL/images/probase/quote-contract/04-approved.png?fit=max\&auto=format\&n=2cZHrr6At26juavL\&q=85\&s=dc297b703cc727ab1256ff3edbccf79b)

After approving, the customer is told when their first payment is charged — for example *Your first payment of $375.00 is charged today, Nov 4.* or *…is charged on Dec 1.* The quote's Activity names the same day, such as *first payment $375.00 on Nov 4*, and links to the jobs it created.

When the customer approves, or you mark the quote accepted, ProBase creates the contract job with exactly the payments and dates the quote showed, even if you change the service's setup later. No visit is booked.

## Importing contracts

When you [import customers](https://docs.probaseapp.com/customers/importing-customers.md) onto a contract service, each row becomes a contract using the service's setup. A row is set aside, with no job made, if the contract needs an End Date and the row has none, or if there's no price on the row or the service. The import summary tells you how many rows were set aside and why, for example *2 contract rows need an End Date. Add one to each and import them again.*

![Contract rows set aside on the import summary](https://mintcdn.com/lawnstarter/E9WW7tLQMwjwGrGF/images/probase/import-summary/contract-rows-set-aside.png?fit=max\&auto=format\&n=E9WW7tLQMwjwGrGF\&q=85\&s=547c648b839b17f50e7531d7df1276f6)

## Duplicating a contract

[Duplicate job](https://docs.probaseapp.com/scheduling/on-demand-jobs.md#duplicating-a-job-for-next-season) on an ended contract copies its price, payment schedule and visit limit. The payments are worked out again from the new job's dates.

## Related pages

* [On-demand jobs](https://docs.probaseapp.com/scheduling/on-demand-jobs.md)
* [Dispatch](https://docs.probaseapp.com/scheduling/dispatch.md)
* [Service catalog](https://docs.probaseapp.com/getting-started/service-catalog.md)
* [Creating quotes](https://docs.probaseapp.com/customers/creating-quotes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.