Deucalion Docs
How-to guideA task-oriented guide for completing a specific goal.
adminreportsexportsintegrationsconnected-systemsapi

Using Reports, Exports, and Integrations

Generate client-ready outputs, publish structured exports, and keep connected-system workflows observable.

Before you start

  • Completed inspections or site data exist for the output you need.
  • The relevant export or integration permissions are enabled for your workspace.
  • You know whether the receiving team wants a client-facing document or structured data.

Expected outcome

Teams can publish trustworthy reports, use the staged CSV import and export workflows deliberately, and explain integration state when something goes wrong.

Generate client-ready reports

  1. Open Reports for the site or inspection you need to publish.
  2. Choose a specific site before using site-scoped actions such as review packs, site compliance reports, certificate bundles, or asset exports.
  3. Switch to inspection scope when the output is an inspection certificate or inspection report.
  4. Use preview workflows before high-risk downloads so the office team can catch stale branding, visit-note, defect, or certificate context early.
  5. Generate the output that matches the job: compliance report, defect summary, certificate bundle, inspection certificate, or asset register.
Deucalion admin reports workspace
Preview first when the output is customer-facing or commercially sensitive.

Use structured exports deliberately

  1. Use CSV exports when another system or customer process needs structured data instead of a PDF.
  2. Use scheduled-work CSV export when planning data needs to travel into another office workflow.
  3. Expect scheduled-work and work-order exports to include the planning month when a record is month-planned instead of exactly booked.
  4. Keep site names, customer names, and identifiers clean before exporting so downstream systems do not inherit bad labels.

Interpret empty compliance output correctly

  1. If a selected site has no completed inspection data in scope, treat the compliance report as not assessed, not as a pass.
  2. Use preview before download so the office team can see whether the report has enough inspection evidence to support the client-facing conclusion.
  3. Return to Inspections or Scheduler when the report is not assessed because the missing input is operational data, not a PDF styling issue.

Proof template output in Document Templates before relying on it

  1. Use Document Templates when the report or certificate layout itself needs review.
  2. Open the rendered proof output for the relevant template/version and check the proofing state before assigning it to live outputs.
  3. If the proof shows stale render history or missing regions, fix the template in Document Templates before changing the underlying inspection or quote data.

Run staged CRM and CMMS imports deliberately

  1. Open Connected Systems and move into the Imports desk, or use the contextual Import Data action from CRM, Sites, Systems, Assets, or Work Orders.
  2. Choose the dataset that matches the source file: customers and sites, systems and assets, or work orders and tasks.
  3. Download the published template before the first upload and keep the headers exact.
  4. For work orders and tasks, use either an exact scheduled_date or a month-only target_month in the source file, never both for the same record.
  5. Upload the CSV into the staged import flow so the office can preview counts, warnings, conflicts, and blocking errors before any live records change.
  6. Resolve candidate matches when the run detects possible duplicates, then accept warnings only when you understand why the source data is still safe to apply.
  7. Apply the ready rows once the preview looks clean, or cancel the run and correct the source file if the staged state is not trustworthy yet.

Use error CSVs and contextual entry points to recover faster

  1. Download the issue CSV when the run contains warning, conflict, or error rows that need correction outside Deucalion.
  2. Start imports from the desk that already owns the target data when possible, because the contextual entry points keep the intended dataset obvious for the operator.
  3. Treat the staged run as the review surface and the source spreadsheet as the correction surface.

Keep connected systems observable

  1. Use Connected Systems and integration views to monitor connection health, sync history, linked entities, and conflicts.
  2. Re-run sync only after you understand the current state from logs and linked records.
  3. Use API keys for scoped integration credentials and use the public API reference at API docs for contract detail.

Troubleshooting

ProblemWhat to check
The report looks outdatedConfirm the underlying inspection, visit-note, defect, and site data were current before generation.
A site report action is disabledChoose a single site first; all-sites scope cannot run site-scoped downloads.
A compliance report says not assessedConfirm there is completed inspection evidence in the selected scope before treating the site as compliant or non-compliant.
A proofed PDF still looks wrongCheck the Document Templates version and rendered proof state before editing the source record.
A CSV export is rejected downstreamCheck identifiers, headers, and whether you exported the right workflow dataset.
A CMMS or CRM import template failsCompare the uploaded file to the published template and validate the required columns first.
A staged import sits in warning or conflictReview the candidate matches, accept only intentional warnings, and download the issue CSV before applying the run.
The wrong import workflow opens from a pageRe-open the import from the contextual entry point and confirm you chose the dataset that matches the source records.
An integration sync looks wrongReview sync history, linked entities, and conflicts before re-running the connection.

Reference surfaces

  1. Use Reports, Report Writer, and Document Templates for the output-generation path.
  2. Use Connected Systems, Integrations, API Keys, and Webhooks for sync, import, and machine-access detail.
  3. Use the Artifact Output Atlas when you need to follow an export, certificate, PDF, or outbound event from origin to consumer.

On this page