Stage 1 — Order Intake & Normalization

Goal

Receive title search orders from any external source and convert them into a single canonical order model that downstream stages can process.

Scope

This stage is responsible only for ingesting and preparing the order. It does not perform property searches, county lookups, or title analysis.

Output: Normalized Internal Order.

Responsibilities

• Receive new orders
• Parse source-specific payloads
• Extract structured order information
• Normalize into a common schema
• Validate mandatory fields
• Detect duplicate or updated orders
• Create internal work item
• Forward to Stage 2

Possible Intake Channels

Email

• Gmail
• Outlook / Microsoft 365

APIs

• Partner REST API
• Internal API
• Webhooks

Mortgage / Title Platforms

• LOS integrations
• Title Production Systems

File Based

• XML
• CSV
• Excel
• PDF package

User Interfaces

• Customer Portal
• Internal Manual Entry

Third-Party Integrations

• Gmail API
• Microsoft Graph API
• LOS APIs
• Webhook endpoints
• SFTP
• Object Storage

Processing Pipeline

Incoming Source
      │
      ▼
Source Adapter
      │
      ▼
Parser
      │
      ▼
Canonical Mapper
      │
      ▼
Validation
      │
      ▼
Duplicate Detection
      │
      ▼
Order Created

Canonical Order Model

• Source
• External Order ID
• Client
• Order Type
• Property Address
• APN (optional)
• Owner (optional)
• Requested Product
• Attachments
• Received Timestamp
• Metadata

Validation

• Required fields present
• Valid address format
• Duplicate order detection
• Existing order update detection
• Attachment accessibility
• Supported state/county (optional)

Optional Enrichment

• Address normalization
• County detection
• State detection
• APN lookup (if lightweight)
• Client configuration
• SLA / Priority assignment

Current Implementation

Gmail
   │
   ▼
Email Consumer
   │
   ▼
Email Parser
   │
   ▼
Order Normalizer
   │
   ▼
Internal Order

Currently implemented:

• Gmail consumer
• Email parsing
• Order normalization

Future adapters can plug into the same normalization layer without changing downstream stages.

Human Involvement

None.

Expected automation: 100%.

Definition of Done

• Order successfully received.
• Canonical order created.
• Validation completed.
• Duplicate status determined.
• Internal work item created.
• Ready for Stage 2 (Property Resolution).