Deucalion Docs
How-to guideA task-oriented guide for completing a specific goal.
admincrmroutinesservice-contractsschedulermaintenance

Setting Up Routine Contracts and Maintenance Planning

Build service contracts and routines from CRM, preview generated work, and move ready routine work into Scheduler.

Before you start

  • The customer account exists in CRM.
  • The relevant sites, systems, and assets are linked to the account.
  • Scheduler is enabled when you want to generate routine work.

Expected outcome

Routine service commitments are visible on the customer account and can be previewed before inspections or planner tasks are generated.

Open the account routine workspace

  1. Open Customers.
  2. Open the customer account.
  3. Select the Routines tab.
  4. Review the summary cards for contracts, active routines, due soon, overdue, and next due.

The routines panel is account-owned. Use it to define the recurring commitment before asking Scheduler to create visits.

Create a service contract

  1. Select Add Contract.
  2. Enter the contract name.
  3. Set the status: draft, active, paused, or ended.
  4. Assign an owner when one person should review renewals.
  5. Set contract start, contract end, next review, and renewal notice days where known.
  6. Add notes that explain the commercial wrapper.
  7. Save the contract.

Use a service contract when multiple routines should sit under the same maintenance agreement or renewal review. A routine can still exist without a contract wrapper.

An accepted PPM contract quote can also create the service contract automatically. In that case, review the generated contract and routines from the customer account rather than creating a duplicate manual contract.

Create a routine

  1. Select Add Routine.
  2. Enter a routine name.
  3. Choose a service contract when the routine belongs to one.
  4. Set status to active when it should generate work.
  5. Choose the service line.
  6. Choose the covered scope: account, site, system, or asset.
  7. Select the matching site, system, or asset when the scope requires it.
  8. Set frequency: annual, six-monthly, quarterly, monthly, weekly, or custom.
  9. Add anchor date and next due date.
  10. Choose work type: inspection or scheduler task.
  11. Set the inspection type or task type.
  12. Add the duration, flex days, crew size, access equipment, out-of-hours flag, industry override, and notes where relevant.
  13. Optionally choose a default field resource. Leave it as Resolve at generation when the attending engineer is not yet known — generated work is created unassigned and the engineer is assigned in Scheduler before deployment.
  14. Save the routine.

Routines should be scoped as tightly as the operational work requires. An account-level routine is useful for generic customer work; asset-level routines are better when the job must be tied to a specific asset.

Pause, resume, and review routines

  1. Pause a routine when the customer pauses the commitment but the history should remain.
  2. Resume a routine when it should generate future work again.
  3. End a routine when it should no longer be part of the live maintenance plan.
  4. Use the upcoming windows list to review due dates before generating work.

Paused and ended routines are not the same. Pause is temporary; ended is a lifecycle decision.

Preview routine generation

  1. Open an active routine.
  2. Select Preview.
  3. Choose the target month.
  4. Optionally set Assign generated work to when the attending field resource is already known. Leaving it unset creates unassigned draft work.
  5. Run the preview.
  6. Review ready rows, warning rows, and blocked rows.
  7. Read each blocker before generating work.
  8. Confirm the preview only when the rows are correct.
  9. Select Generate Ready Work.

The preview is required before generation. It protects the planner from creating visits when a routine has no due date, points at inaccessible site/system/asset scope, or uses a default field resource who cannot receive scheduled field work. A routine with no default field resource at all is not blocked: it previews as ready and generates unassigned draft work, with final engineer assignment happening in Scheduler before deployment.

Understand what generation creates

Routine generation creates either inspections or scheduler tasks, depending on the routine work type.

  1. Inspection routines create inspection work with the configured inspection type.
  2. Scheduler task routines create planner tasks with the configured task type.
  3. Generated work carries routine identity and generation period so duplicate generation can be avoided.
  4. Work generated without a field resource starts as an unassigned draft; assign the engineer in Scheduler before deployment.
  5. Next due dates are advanced after generation.
  6. Scheduler must be available for generation actions to appear.

Generated work should still be reviewed in Scheduler before field deployment. A generated row is not automatically the same as a confirmed customer appointment.

When routines were created from an accepted PPM contract quote, the quote acceptance step creates the maintenance commitment only. It does not automatically deploy every future visit.

Work routine health prompts

Routine health prompts highlight maintenance setup that needs review.

PromptWhat it means
Contracts needing reviewA service contract is close to or past its review window.
Routines without assetsA routine points at a site or system where the asset register is incomplete.
Sites missing contactsRoutine work exists but the site lacks useful contact context.
Blocked generationA routine could not safely generate work without correction.

Use prompts as triage. Fix the owning customer, site, asset, or routine record rather than dismissing the signal by default.

Troubleshooting

ProblemWhat to check
The Preview action is missingConfirm Scheduler is enabled for the workspace and the routine is active.
Generation is blockedCheck scope, due dates, target month, and default field-resource eligibility.
The wrong work type is generatedEdit the routine work type and the inspection or task type before previewing again.
A routine is overdue but no job existsPreview generation for the target month and check blockers.
Routine billing is not appearing in FinanceThis is expected. Routine contracts are not current billing candidates; Finance currently lists accepted non-PPM quotes and completed work orders when those sources are linked to CRM accounts.
  1. Use Customers, Quotes, Work Orders, and Finance for the customer account and commercial context around a routine.
  2. Use Quoting a PPM Contract and Creating Routines when a service contract should be created from customer quote approval.
  3. Use Planner Control and Capacity for generated work, target months, and future routine pressure.
  4. Completing a generated visit does not automatically suggest or create the next PPM visit. Return to Routine Maintenance or Maintenance Planner when the recurrence is due again.

On this page