Event Notifications and Mailers
This section documents the event notification system and mailers used in our Transportation Management System (TMS) to provide automated alerts and communications for critical business events.
Overview
The TMS notification system uses an event-driven architecture to manage email notifications for various business events. The system consists of several components that work together to detect events, manage recipients, and deliver notifications.
System Components
The notification system is built using the following key components:
- Event Dispatchers: Detect and create reference events for specific business conditions
- Event Processors: Handle the processing and delivery of notifications
- Event Updaters: Manage the lifecycle of events (closing events when conditions are resolved)
- Recipients Retrievers: Determine who should receive notifications
- Email Parameters: Define the content and structure of notification emails
- Mailers: Handle the actual email delivery
Event Types
The system currently supports three main event types:
1. New Load Tender Notifications
Purpose: Alerts TG staff when new EDI 204 Load Tenders are received from trading partners.
Recipients: All ERP users within the company
Trigger: EDI 204 records created within the last hour
Event Closure: When a response (EDI 990) is created for the load tender
2. Invoice Sent via EDI Notifications
Purpose: Confirms successful transmission of EDI 210 invoices to trading partners.
Recipients: All ERP users within the company
Trigger: Invoices with status '02' (sent) that haven't generated events yet
Event Closure: One-time notification (no automatic closure)
3. Invalid Invoice Notifications
Purpose: Alerts staff when EDI 210 invoices fail validation due to missing or invalid fields.
Recipients: All ERP users within the company
Trigger: Invoices with status '03' (validation failed)
Event Closure: When invoice status changes from '03' to another status
This notification system ensures that TG staff are promptly informed of critical business events, enabling timely responses to load tenders, confirmation of invoice deliveries, and rapid resolution of data validation issues.