Sync queue

Offline ServiceTitan sync queue and operator status.

A no-database model for the queue, retry, review, blocked, and manual-complete states PageToJob needs before any ServiceTitan API worker is allowed to run.

Offline queue summary
5
items
1
retrying
1
blocked
1
review
1
manual done
3
runbooks
This is an offline queue model. It does not process jobs, call ServiceTitan, or store credentials.

Operator-visible sync status

sync-001

Desert Peak Heating & Air

queued
Type: booking_request
Source: /ac-repair-phoenix
Binding: ac-repair-phoenix
Attempts: 0
Next retry: Not scheduled
Key: st-ready:9f2a7c10
Last error

No error recorded.

Operator action

Review mapped booking payload before enabling API-backed CRM handoff.

Customer-safe state

Lead is already captured and business notification fallback remains active.

sync-002

Desert Peak Heating & Air

needs review
Type: booking_request
Source: /emergency-ac-repair
Binding: emergency-ac-repair
Attempts: 0
Next retry: Not scheduled
Key: st-ready:b8c44191
Last error

Capacity rule requires dispatch review before automated handoff.

Operator action

Confirm after-hours capacity rule, booking provider, and dispatch owner.

Customer-safe state

Request remains manual-first until the warning is cleared.

sync-003

Desert Peak Heating & Air

blocked
Type: taxonomy_import
Source: ServiceTitan job types and business units
Binding: No binding yet
Attempts: 0
Next retry: Not scheduled
Key: st-ready:taxonomy-demo
Last error

No approved ServiceTitan app access, customer authorization, or granted scopes.

Operator action

Keep using the manual Titan Map and request customer/admin access only after approval path is confirmed.

Customer-safe state

Website publishing continues from customer-reviewed manual mappings.

sync-004

Desert Peak Heating & Air

retrying
Type: outcome_match
Source: June AC Repair campaign outcomes
Binding: summer-ac-demand
Attempts: 2
Next retry: 2026-06-21T14:00:00Z
Key: st-ready:outcome-demo
Last error

Supplied export is missing invoice IDs for two candidate bookings.

Operator action

Request corrected export or mark unmatched records as manual-review.

Customer-safe state

Revenue proof excludes uncertain matches until reviewed.

sync-005

Desert Peak Heating & Air

manual complete
Type: drift_check
Source: Monthly Titan Map drift review
Binding: maintenance-plan
Attempts: 1
Next retry: Not scheduled
Key: st-ready:drift-demo
Last error

No error recorded.

Operator action

Publish the reviewed offer copy and record resolved drift finding.

Customer-safe state

Customer-approved fix is ready for launch packet update.

Retry and support runbooks

Retry only when the next step is deterministic

Retry transient exports, webhooks, or API failures with an idempotency key. Do not retry missing mappings or missing authorization.

Prevents duplicate ServiceTitan records and keeps operator work focused on real blockers.

Manual completion is a valid offline state

If the customer or operator completes a handoff manually, mark the queue item manual-complete instead of pretending automation occurred.

The customer gets a clean proof trail without false API claims.

Authorization blockers stop API work, not website operation

A blocked ServiceTitan sync should preserve the public website, booking fallback, notification fallback, and manual Titan Map workflow.

PageToJob remains sellable before approved ServiceTitan access exists.

Queue guardrails

  • - This queue is an offline model and does not write to ServiceTitan.
  • - No queue item should be processed automatically without customer authorization, eligible modules, granted scopes, approved app access, and secure token storage.
  • - Operator-facing sync failures must show source, status, idempotency key, attempts, last error, and next action.
  • - Customer proof packets should exclude uncertain revenue matches and label manual completion honestly.