Contracts
Set up client agreements from templates or accepted quotes, keep every revision, and bill them on a schedule.
A contract records what a client has agreed to pay for: the lines, prices, dates, payment terms and any prepaid hours. Use contracts for recurring services. XODASH keeps every revision, so you can always see which terms applied on a given date, and the contract's billing turns those terms into draft invoices.
Open CRM → Contracts to see every agreement. The page has four tabs: Customer contracts, Templates, Line presets and Invoice layouts. A company's own contracts are also on the Contracts tab of its record.
Who can use it
Creating and changing contracts, templates and presets needs the CRM Editor or CRM Admin role. CRM Viewers can open contracts and see their lines, quantities, dates and status, but not prices, discounts, billing or prepaid hours.
Contract statuses
- draft: being set up. A draft has no effect until you activate it.
- scheduled: activated, but its start date hasn't come yet.
- active: activated and in its term.
- expired: its end date has passed.
- cancelled: stopped by hand. Revisions, invoices and history are kept.
The end date is exclusive: a contract that ends on March 1 covers the client through the last day of February.
Create a contract
Start a new contract
On Customer contracts, or on a company's Contracts tab, select New contract.
Choose the company and a starting point
Pick the Company (it's filled in when you start from a company). To start from a saved setup, choose a Template, or choose an Accepted quote to copy its lines and payment terms. You can use one or the other, or neither to build the contract by hand.
Set the name, currency and dates
Enter the Agreement name, the Currency, the Start date and, if the agreement has one, the End date (exclusive). If part of the term was already invoiced elsewhere, set Already billed through (exclusive) so it isn't billed twice.
Add lines and terms
Add lines with Add a service or product or Add custom line, then open Payment, purchase order and renewal terms. You can also tick Line presets to add their lines.
Select Create draft
The contract is saved as a draft. Review it, then activate it when it's ready.
Contracts can be in USD, CAD, EUR, GBP, AUD or NZD. A template offers only the currencies it has complete prices for, and its prices are used exactly as entered. Nothing is converted.
Contract lines
Each line has a Line name, Quantity, Rate, Unit price, Pricing method (fixed, hourly, usage or per unit), Unit of measure, Frequency (one time, weekly, biweekly, monthly, quarterly, semiannual or annual) and Billing timing (In advance or In arrears). Products are always priced per unit.
- Rate: Catalog rate uses the price from your catalog, Custom rate uses the price you type, and Keep saved rate keeps a line's existing price.
- Tax: inherit uses the client's tax region from the contract's billing setup, so no rate is needed on the line. taxable needs a Tax rate (%). non taxable and exempt add no tax.
- Discount (%) takes a percentage off the line.
- Prorate partial periods charges part of the price for a period the contract only partly covers.
For hourly lines, only approved time is billed and the quantity isn't a commitment. Use Minimum minutes and Round up to to set how each approved time entry is counted. A period with no approved time bills nothing.
Bundles
A fixed fee line can hold Bundle components: the services and products the fee covers. Mark each one as Included in the bundle fee or Billed separately, in addition to the fee. A component left as Not decided yet blocks invoicing for that bundle until you choose.
Contract-wide discounts
Under Contract-wide discounts, select Add discount and choose a Percentage or a Fixed amount. Applies to can be Every charge, Selected lines or Selected pricing methods, with optional Starts and Ends before dates. Discounts apply to each invoice after line discounts and before tax: percentages first, then fixed amounts. A fixed amount applies once per invoice.
Payment, purchase order and renewal terms
Set the Payment terms (due on receipt, net 15, 30, 45 or 60), whether a Purchase order required, the PO number and PO limit, the Renewal setting and Renewal notice (days). Customer-facing terms and conditions appear on the contract and its invoices.
Create a contract from an accepted quote
When a signed or paid quote has monthly or annual items, its page shows Create contract & invoice. This creates a draft contract for the recurring items and invoices the one-time items and the first period in one step, so nothing is billed twice. You set the Contract name, Starts and Ends (optional), review what is invoiced now and when the contract's own billing starts, then confirm. Nothing is created until you do.
A quote can have only one contract. If it already has one, the dialog shows it and offers Use existing contract.
Converting needs the CRM Editor or CRM Admin role. If converting would request a QuickBooks invoice, you also need the QuickBooks Admin role. See QuickBooks.
You can also choose an Accepted quote when you select New contract. If that quote was already invoiced, set the billed-through date before you activate a contract with recurring lines.
Activate a contract
Open the draft and select Activate, then enter a Reason and confirm. XODASH refuses to activate a contract unless:
- the company is active and the contract has at least one line,
- its end date hasn't already passed,
- it has a PO number when a purchase order is required, and
- for a contract from an already invoiced quote, the billed-through date is set.
A contract whose start date is in the future becomes scheduled until that date.
Revise, amend or cancel
Open a contract to see its lines, terms, billing and Activity. Use the Revision list to view Latest saved revision, Currently effective terms or any earlier version.
- Edit draft changes a draft. Enter a Reason for revision and select Save revision.
- Amend changes an active contract from an Amendment effective date. Earlier periods keep the earlier terms, and each amendment becomes a new version.
- Cancel contract stops it. Revisions, invoices and history are kept.
Renew a contract
On an active contract with an end date, select Renew. XODASH opens a new draft named after the original with "renewal" added, starting on the old end date, with the same lines and terms. Adjust it and save.
For a company in the Active Clients stage, Renewal quote on the company record opens the same renewal. The Renewal setting on a contract is recorded with its terms; XODASH doesn't renew a contract on its own.
Set up billing
A contract's Billing section turns its lines into draft invoices.
Set up the billing cycle
Choose the Invoice frequency, the Anchor date (on or before the contract start, within one year) and the Customer tax region, then select Set up billing.
Preview a draft
Enter a Bill through date and select Preview draft. XODASH shows the invoice it would create and lists anything that blocks it.
Generate the draft
Select Generate draft invoice. Review it from the invoice list, where you can also Void a draft so its service periods can be billed again.
A tax region of Not set yet isn't the same as 0%. It blocks invoicing for lines set to inherit. After the first invoice, the frequency, anchor and tax region are locked, but you can still pause billing by clearing Billing enabled.
To finalize, number and send invoices, see Invoices. To bill many contracts at once, use the Billing workspace.
Prepaid hours
Prepaid hours are blocks of time a client buys or is given up front. Hourly time draws them down, soonest-expiring block first.
On an activated contract, open Prepaid hours and select Grant a block. Enter a Name, Hours, Starts and Ends before (leave blank for no end), then choose:
- At the end date: Unused hours expire or Unused hours roll over (rolling over needs an end date).
- Beyond the balance: Bill at the hourly rate or Refuse and flag.
Each block shows its balance and whether it's Active or Closed. Every grant, draw-down, expiry and rollover is kept in the contract's ledger, which can't be edited. Templates can also include Prepaid support blocks, which are copied to contracts created from them.
Templates and line presets
Templates are reusable contract setups. Line presets are reusable sets of lines you can add to any contract or template in the same currency. Select New template or New line preset, or Edit an existing one.
- Saving creates a new version. Existing contracts keep their saved terms.
- New templates start as Draft. Drafts can't create customer contracts; set Status to Published when it's ready. Clear Active to archive a template or preset.
- Internal guidance (Template description, Usage notes and Recommended cadence and setup) is for your team only and never appears on a customer document.
- A template can carry prices in other currencies. A currency is offered only when every price it needs is entered, and the editor lists what's missing.
- History shows every version. Simulate shows what a template would bill for a start date, frequency, tax region and currency you choose, without saving anything.
Expiry reminders
For a company in the Active Clients stage, XODASH warns on the company record and in the dashboard's expirations list from 30 days before its last signed contract ends. One reminder, Renew or close out the company, goes to the account owner, or else the owner of its latest won deal, or else a workspace admin. The company stays in Active Clients until you renew the agreement or change its stage. Open-ended contracts never trigger the warning.