Policy Cancelled Event
Event emitted when an insurance policy is cancelled.
Overview
The PolicyCancelledEventV1 event is emitted by the PolicyService when an insurance policy is cancelled. This event signifies a terminal state in the policy lifecycle and contains details about the cancellation including the reason, any applicable refunds, and the financial state at the time of cancellation.
When is this event emitted?
This event is published when:
- A policyholder requests cancellation of their policy
- An administrator cancels a policy on behalf of the policyholder
- A policy is cancelled due to non-payment after exhausting grace periods
- A policy is cancelled due to fraud or misrepresentation
Key Information
The event payload includes:
- Event Metadata: Event ID, correlation ID, timestamps for noticed and effected dates
- Policy Identification: Policy ID and policy status at cancellation
- Cancellation Details: Cancellation date, reason, who requested it, and who approved it
- Financial Information: Refund amount and financial details at the time of cancellation
- Policyholder: Policy holder identifier
Downstream Consumers
Systems that typically consume this event include:
- Billing systems (to stop collections and process refunds)
- Customer communication services (to send cancellation confirmations)
- Reporting and analytics platforms
- Partner systems (to update policy status)
- Claims systems (to close any open claims)
Schemas
JSON Schema
Event emitted when a policy is cancelled.
Unique identifier for the event (UUID as string)
Correlation identifier for the event (UUID as string)
Timestamp when the event was noticed (milliseconds since epoch)
Timestamp when the event took effect (milliseconds since epoch)
Type of the event.
Logical clock reading for event ordering
Unique identifier for the policy (UUID as string)
Who requested the cancellation.
Who approved the cancellation.
Timestamp when the cancellation took effect (milliseconds since epoch)
The reason for the cancellation of the policy.
Financial details captured when the policy was cancelled.
Unique identifier for the policy holder (UUID as string)
Status of the policy at cancellation time
Avro Schema
Event emitted when a policy is cancelled.
Unique identifier for the event (UUID as string)
Correlation identifier for the event (UUID as string)
Timestamp when the event was noticed
Timestamp when the event took effect
Type of the event.
Logical clock reading for event ordering
Unique identifier for the policy (UUID as string)
Who requested the cancellation.
Who approved the cancellation.
Timestamp when the cancellation took effect
The refund amount.
The reason for the cancellation of the policy.
Financial details captured when the policy was cancelled.
Unique identifier for the policy holder (UUID as string)
Status of the policy at cancellation time