Skip to main content

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:

  1. Event Dispatchers: Detect and create reference events for specific business conditions
  2. Event Processors: Handle the processing and delivery of notifications
  3. Event Updaters: Manage the lifecycle of events (closing events when conditions are resolved)
  4. Recipients Retrievers: Determine who should receive notifications
  5. Email Parameters: Define the content and structure of notification emails
  6. 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.