Add Coverage
Use the Add Coverage screen to create and link a new insurance policy.
Available insurers and required fields derive from the coverage configuration response.
This screen includes:
| # | Element | Description |
|---|---|---|
| 1 | Header | Displays screen title and close action |
| 2 | Search input | Filters insurers |
| 3 | Insurer list | Displays available insurers |
| 4 | Insurer row | Displays insurer name and logo |
| 5 | Dynamic form fields | Displays insurer-specific policy fields |
| 6 | Policy number field | Updates policy identifier |
| 7 | Validation message | Displays invalid or missing field errors |
| 8 | Submit action | Creates and links the policy |
| 9 | Close action | Dismisses the screen |
Workflow
- Open the coverage selector.
- Select Add coverage.
- Render available insurers.
- Select an insurer.
- Render insurer-specific fields.
- Enter required policy information.
- Submit coverage details.
- Validate coverage data.
- Link the policy to the active account..
Validations
| Scenario | App Behavior | SDK Output |
|---|---|---|
| No insurer selected | Disable submission | state = unchanged |
| No matching insurer found | Display empty state | results = empty |
| Required fields missing | Block submission | error = required_fields |
| Policy format invalid | Display validation error | error = invalid_policy |
| Additional fields required | Render dynamic fields | fields = required |
| Coverage unsupported | Display error state | coverage = unsupported |
| Request in progress | Display loading state | state = loading |
| Request fails | Display error state | state = error |
Actions
| Scenario | App Behavior | SDK Output |
|---|---|---|
| Add Coverage opened | Load insurers | PUT /api/v3/coverage/add |
| Search updated | Filter insurer list | results = filtered |
| Insurer selected | Render insurer fields | insurer = selected |
| Policy fields updated | Update form state | form = updated |
| Submit selected | Create coverage | coverage = submitted |
| Coverage created | Link active policy | coverage = linked |
| Creation rejected | Display validation errors | state = error |
| Screen closed | Preserve current state | state = unchanged |
Endpoint Resources
Add Coverage
PUT
v3/coverage/add
Returns the add coverage screen.