> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cadmus-cad.app/llms.txt
> Use this file to discover all available pages before exploring further.
# E-citations overview
> Electronic citations and warnings from the MDT.
Electronic citations and warnings from the MDT.
Screenshot placeholder: E-CITATIONS home screen
**Availability:** Sidebar **E-Ticket** may show **This area is still in development for this release.** on production builds when the agency does not have **E-Ticket Module** enabled. Agencies with e-tickets turned on in Web Admin can use **E-Ticket** in production.
## Standalone vs call-linked citations
| Agency setup | Mobile behavior |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| **CAD Module** on (default) | **Linked call** dropdown appears on new citations. **ISSUE CITATION** requires an assigned call for live sync. |
| **CAD Module** off, **E-Ticket Module** on | Calls, Map, and Dashboard nav are hidden. New citations do **not** ask for a call. Issue and sync work without an `IncidentID`. |
Configure modules under [Agency settings](/admin/agency-settings) in Web Admin.
## Home screen
**E-CITATIONS** with:
* **NEW CITATION** button
* Tabs: **DRAFTS & QUEUED** / **SUBMISSION HISTORY**
* Metrics: **ISSUED TODAY**, **PENDING SYNC**, **AVG STOP**, **WARNINGS** / **CITATIONS**
Screenshot placeholder: Drafts and queued tab with PENDING SYNC badge
## New citation wizard
Tap **NEW CITATION** and toggle **CITATION** vs **WARNING**.
Fill **Subject / Vehicle**, **Violation / Loc** or **Violation** (template-driven forms may use this label), **Signatures**, and **Review & Issue**. When your Missouri state template includes them, you may also enter **Court division**, optional **OCN**, **CDL** (Yes / No / blank), and **Did unlawfully** checkboxes (operate/drive, park, C.M.V., hazmat).
On **Violation / Loc** or **Violation**, start typing in the **Unlawful Act** or violation description field. Type offense words (for example, *steal* matches *stealing*). Results are ranked by description, not RSMO number. Codes your agency uses often appear with an **Often used** badge. **Unlawful Act** is filled from the selection but can still be edited. If the catalog is not cached yet, connect once to sync, or enter the charge manually.
For **Seat belt unlawful act**, type at least four characters including **belt** (for example, *belt* or *seat belt*). Shorter terms such as *seat* alone do not return seat-belt statutes. Missouri RSMo 307.178.x and 307.179 appear when the search includes **belt**.
On **Subject / Vehicle** or **Driver**, tap **Scan ID** to scan the license barcode with the device camera or a hardware wedge scanner. Review the parsed fields, or tap **Use demo data** for training. Mapped fields include name, DOB, license number, and address. Sex, height, and similar fields not on the citation form are ignored.
Tap **ISSUE CITATION** or **SAVE DRAFT**. Use **Violator Refused to Sign** when applicable. For full CAD agencies, select a **Linked call** before issuing for live sync. Standalone e-ticket agencies skip the call selector.
Screenshot placeholder: Citation wizard Subject/Vehicle step
## Status labels
* **PENDING SYNC** — waiting for network upload
* **SUBMITTED** — sent to records
* **PRINTED** — hard copy produced
## Print
* Open **PDF PREVIEW** from a citation (issued or ready to print).
* When your agency uses a **state or custom form template**, choose:
* **4" THERMAL** — single-strip layout for mobile 4″ printers (Missouri: page 1 and 2 sequential)
* **LETTER (FRONT + BACK)** — letter-size page with front and back side-by-side
* Use **PRINT** from the preview once the form shows correctly (not a blank page).
* **BACK TO E-CITATIONS** returns to the citation list.
* PDF content includes defendant/driver, vehicle, and offense fields from the filled citation.
* **Officer**, **Badge**, and **Issue date** on Missouri Form 37A are filled automatically from your login when you start a new citation — you do not type them on the entry form.
Officers do not enter or see fine amounts in the citation wizard, review screen, or print preview. Courts and records systems assign fines separately.
If the preview is blank, check network so template pages can download, then reopen **PDF PREVIEW**. Contact an admin if the form still does not appear.
Screenshot placeholder: Citation print preview with thermal and letter chips
## Offline and sync
In **live mode**:
* Drafts are stored locally on the device.
* **SUBMISSION HISTORY** loads citations synced to CAD from your agency (`/agencies/{agencyId}/citations`).
* **ISSUE CITATION** uploads through `POST /citations/sync`. For full CAD agencies, the citation must be linked to an active **call (incident)** before issue. Standalone e-ticket agencies (CAD off, E-Tickets on) can issue and sync without a call.
* Active charge codes for your agency **State** (for example MO/RSMO) are cached after the first online visit to **E-CITATIONS**. Charge code search works offline after that sync.
* Errors show on the home screen with **RETRY**. Tap **RETRY** or re-open a pending draft after linking the call (when required).
In **Training Mode**, sample citations stay on the device only — nothing is transmitted.
* **Auto-Sync Ticket Data** in Settings uploads when online (when enabled).
* See [Connectivity and offline](/mobile/connectivity-offline).
## Requirements
* Agency **E-Ticket Module** enabled in Web Admin (on by default for existing agencies).
* Agency **Traffic Stops Allowed** in Web Admin for citation workflows.
* For call-linked citations: **CAD Module** on and an assigned call selected before issue.
* Bluetooth printer paired if printing in field.
## Warnings
Issued citations are legal documents — verify identity and statute before **ISSUE CITATION**.
**PENDING SYNC** means records may not have citation yet — confirm sync before leaving stop.