Confirmation Delay (CD)
This metric is planned for release in February 2026.
Confirmation Delay (CD) measures the time between when a physical event occurred and when Dockflow first accepted a confirmation for it.
CD = first_confirmation_accepted - event_date
Target: TBD | Lower is better
What it Measures
| Field | Description |
|---|---|
event_date | When the event physically happened (e.g., vessel departed) |
first_confirmation_accepted | When Dockflow first accepted a valid confirmation |
CD answers: "How long after an event happens do we know about it?"
Why CD Matters
- Real-time visibility: Shows how close to "real-time" your data is
- Latency expectations: Helps understand delays for planning
- Source comparison: Identifies which carriers/sources are faster
Key Factors
| Factor | Impact | Controllable? |
|---|---|---|
| Carrier reporting speed | Carriers batch-update at different intervals | No |
| Data source type | Terminal data typically faster than carrier EDI | Partially |
| Update frequency | 6h-72h dynamic based on expected events | Yes |
For terminal-related events (gate-in, gate-out, discharge, load), having the correct terminal connection configured is critical for CD performance.
When a container's terminal is correctly linked, Dockflow receives updates directly from the terminal. When the terminal connection is missing or incorrect, Dockflow relies on carrier EDI, which is significantly slower.
This makes terminal connection accuracy one of the highest-impact factors for reducing CD on terminal events. See Terminal Integrations for setup instructions.
Delay Components
┌─────────────────────────────────────────────────────────────────┐
│ CONFIRMATION DELAY │
├─────────────────────┬───────────────────────┬───────────────────┤
│ Carrier Reporting │ Dockflow Polling │ Processing │
│ (not controllable) │ (6h-72h dynamic) │ (~minutes) │
└─────────────────────┴───────────────────────┴───────────────────┘
Relationship to Other Metrics
| Metric | Measures | Question it answers |
|---|---|---|
| Freshness | Time since last update | "Is our data being updated?" |
| TTFF | Time to first data | "How fast do we get initial data?" |
| CD | Time from event to confirmation | "How delayed is each milestone?" |
Planned Features
- CD metric card on dashboard
- Average CD by event type
- Container-level CD drill-down
- CD trend over time
- Export with CD values
Timeline
| Milestone | Date |
|---|---|
| Specification | January 2026 |
| Development | February 2026 |
| Beta release | Week of Feb 16, 2026 |
Feedback
Share your thoughts on CD:
- Email: [email protected]