Integration Guide
PolicyOne participates in the OnePolicy platform event bus as both a publisher and subscriber.
- Publishes
events:policy—policy.bound,policy.issued,policy.cancelled,policy.renewed. BillingOne is the primary consumer. - Consumes
events:claims—claim.settledfrom ClaimsOne to keep underwriting data current in real time.
Available Integrations
| Integration | Stream | Direction | Events | Status |
|---|---|---|---|---|
| BillingOne — Bind & Issuance | events:policy | PolicyOne → BillingOne | policy.bound, policy.issued | ✅ Live |
| ClaimsOne — Claims Events | events:claims | ClaimsOne → PolicyOne | claim.settled | ✅ Live |
| BillingOne — Payment Events | events:payment | BillingOne → PolicyOne | payment.charged, payment.failed | Planned |
| ISO ClaimSearch | External API | ClaimsOne → PolicyOne | CLUE lookups | Via ClaimsOne |
BillingOne Integration
When an agent binds a quote, PolicyOne writes a policy.bound event to the outbox atomically, then OutboxPublisher streams it to Redis where BillingOne's PolicyEventsConsumer creates the billing account.
Rendering diagram…
See the BillingOne Integration section for full details.
Claims Integration
When a claim settles in ClaimsOne, PolicyOne's ClaimsEventsConsumer reacts in real time:
Rendering diagram…
See the Claims Integration section for full details.
Section Contents
BillingOne
| Page | What you'll learn |
|---|---|
| ① Overview | Outbox pattern, design decisions, component index |
| ② Architecture | C4 L1–L3 diagrams, DB tables, Redis stream layout |
| ③ Event Flow | Sequence diagrams — happy path, retry, DLQ |
| ④ Payload Reference | Every field in PolicyBoundPayload and PolicyIssuedPayload |
| ⑤ Operations | Env vars, monitoring, troubleshooting, local dev |
ClaimsOne
| Page | What you'll learn |
|---|---|
| ① Claims Integration | Purpose, stream map, consumer group details |
| ② Architecture | C4 context and container diagrams |
| ③ Event Flow | Sequence diagrams — receive, process, agent task creation |
| ④ Large Loss Workflow | What happens after policy.agent_tasks is created |
| ⑤ Operations | Env vars, monitoring, DLQ management |