📢 BizEvent Resource

Transaction workflow coordination and event management

The event-driven workflow coordinator that manages business events and transaction notifications within the 7G ecosystem. BizEvent handles the generation, tracking, and lifecycle management of transaction notices (deposits, redemptions, conversions) and provides event cancellation capabilities. It serves as the coordination layer between transaction intentions and actual BizTransaction processing.

5
Endpoints
3
Notice Types
4
Event States
Full
Audit Trail
🔔

Workflow Coordinator

Manages the pre-transaction workflow by generating notices and tracking business events that coordinate between transaction intentions and actual processing execution.

📋

Event Lifecycle

5 core endpoints: GET (query events), NoticeOfDeposit, NoticeOfRedemption, NoticeOfConversion (create events), and Cancel (terminate events) with full status tracking.

🔄

Transaction Integration

Bridges transaction planning with execution - events can trigger downstream BizTransaction processing or be cancelled before execution.

Available Endpoints

Event Management

GET Get Events Filtering and event history
PUT Cancel Event Terminate pending events before execution

Transaction Notice Generation

POST NoticeOfDeposit Initiate deposit workflow coordination
POST NoticeOfRedemption Initiate redemption workflow coordination
POST NoticeOfConversion Initiate investment conversion workflow

Core Data Transfer Objects

NoticeOfDepositDTO NoticeOfDeposit POST endpoint Deposit workflow parameters (20 properties) including account/investment specification, amount, settlement dates, payment details (cheque fields), entry fee configuration, and BizTransaction coordination
NoticeOfRedemptionDTO NoticeOfRedemption POST endpoint Redemption workflow parameters (11 properties) including account/investment specification, quantity/amount options, settlement date, comment, and external ID for transaction tracking
NoticeOfConversionDTO NoticeOfConversion POST endpoint Conversion workflow parameters (15 properties) with source/target investment specifications, conversion method and factor, quantity/amount options, and external transaction ID
BizEventDTO GET responses, event tracking Complete event structure (22 properties) including event type identification, entity references, lifecycle status tracking, cancellation control, BizTransaction linkage, approval chain, timing information, and audit trail for compliance

Filter Data Transfer Objects

GET endpoint uses a filter class to bind query parameters. This is a request-only structure for filtering and pagination.

BizEventFilter GET /BizEvent 9 properties: 2 direct lookups (ProductID, ExternalProductId) + 5 FilterField with dot operators (BizEventID, BizEventTypeID, AccountNumber, AccountID, ExternalAccountId) + pagination (PageNumber, PageSize)

Event State Machine & Lifecycle

BizEvent follows a 4-state lifecycle managing the coordination between transaction intentions and actual processing. Events serve as the pre-transaction workflow layer, allowing notice generation, approval workflows, and cancellation before committing to immutable BizTransaction records.

1

Created

Event created via POST /BizEvent/NoticeOf* endpoints. Initial validation complete, awaiting processing trigger

NoticeOfDeposit/Redemption/Conversion
→
2

Pending

Event queued for processing. Can be cancelled via PUT /BizEvent/Cancel. Approval workflows may occur here

PUT /BizEvent/Cancel
→
3

Processing

Event executing, creating associated BizTransaction records. Cannot be cancelled once processing begins

Auto-triggers BizTransaction
→
4

Completed / Cancelled

Final state. Completed events link to BizTransaction records. Cancelled events release workflow locks

GET /BizEvent

Cancellation Rules

Events can only be cancelled while in Created or Pending states. Once Processing begins, cancellation is prohibited as BizTransaction creation has started. To reverse a processed event, use BizTransaction rollback operations instead of event cancellation.

Common Use Cases

💳

Deposit Notices

Generate deposit notifications for pending cash inflows, enabling settlement preparation and allocation planning.

💰

Redemption Workflow

Create redemption notices for withdrawal requests, triggering liquidation workflows and settlement processes.

🔄

Investment Conversions

Coordinate investment class conversions with proper notice periods and regulatory compliance tracking.

❌

Event Cancellation

Cancel pending events before execution, releasing workflow locks and updating stakeholder notifications.

Business Rules & Constraints

Event Lifecycle & State Machine

  • State progression: Created → Pending → Processing → Completed / Cancelled with immutable state history
  • Cancellation window: Events can only be cancelled while in Created or Pending states - once Processing begins, cancellation prohibited
  • Automatic progression: Events in Pending state automatically advance to Processing based on settlement dates or approval completion
  • Timeout handling: Events remaining in Pending for >30 days automatically expire and transition to Cancelled
  • Concurrent limit: Maximum 10 active events (Created/Pending/Processing) per account

Notice Types & Workflow Triggers

  • NoticeOfDeposit: Coordinates cash receipt expectations with automatic BizTransaction creation after settlement date or approval trigger
  • NoticeOfRedemption: Manages liquidation requests with approval workflows and automatic redemption processing
  • NoticeOfConversion: Manages investment switching with eligibility verification and dual-transaction coordination
  • Auto-processing flags: autoProcessAfterSettlement, autoProcessOnApproval enable automated BizTransaction creation

Validation & BizTransaction Integration

  • Pre-transaction layer: BizEvents serve as workflow coordination before committing to immutable BizTransaction records
  • Automatic transaction creation: Processed events automatically create corresponding BizTransaction records (Deposit, Redemption, or Conversion dual-transactions)
  • Entity validation: All events require valid BizEntity and Account references with ownership verification and active status checks
  • Investment validation: Deposit/Redemption events validate investment existence, active status, and allotment eligibility
  • Conversion validation: Source and target investments validated for compatibility and same product requirement
  • Idempotency: externalEventId prevents duplicate event creation from integration retries

Audit & Query Capabilities

  • Filtering: GET /BizEvent supports filtering by status, eventType, dateRange, entity, investment with FilterField dot operators
  • Status history: State transition history maintained with timestamps and user attribution for audit compliance
  • Transaction linkage: BizEventDTO includes associatedBizTransactionID array tracking all generated transactions