Add Coverage

---

Use the Add Coverage screen to create a new insurance policy when no valid policy exists or when the user adds a new one.

This screen includes:

• A modal header with the title Add coverage and a close control.
• A search input that filters insurance providers in real time.
• A scrollable list of insurers with logos and names.
• A selectable list layout for choosing an insurer.
• Dynamic input fields that render based on the selected insurer.
• Input fields for policy number and required identifiers.
• Inline validation messages for invalid or missing values.
• A primary action button that submits coverage details and continues the flow.

---

Workflow

1. Open the Policy field from the Home screen.
2. Select Add new coverage.
3. The platform returns the list of available insurers.
4. Display the insurer list.
5. Select an insurer.
6. Render dynamic input fields based on the selected insurer configuration.
7. Enter the required policy data:
   • Policy number.
   • Additional identifiers as required.
8. Submit the coverage request.
9. The platform validates the request.
   • If validation succeeds, the platform creates and links the coverage to the patient account.
   • If validation fails, the platform returns validation errors and the UI remains editable.

---

Validations

These rules define insurer selection and coverage input constraints enforced by the platform.

Condition	App behavior	SDK output
No insurer selected.	Disable progression.	No request is sent.
No matching insurer found.	Display fallback message.	Empty result set returned.
Required policy fields are missing.	Disable submission and highlight fields.	Validation error indicating missing required fields.
Policy data format is invalid.	Display validation messages.	Validation error indicating invalid input format.
Insurer configuration requires additional fields.	Render required input fields dynamically.	Field configuration returned in insurer response.
Request violates insurer or platform rules.	Display error state and prevent progression.	Error response identifying invalid coverage request.

Actions

These actions define behavior during coverage creation.

Condition	App behavior	SDK output
Screen loads.	Display loading state.	Request insurer list from platform.
Insurers returned.	Render list of available insurers.	Insurer list response.
User selects an insurer.	Update UI and render required input fields.	No request sent.
User submits coverage data.	Send coverage creation request.	Request to create and link coverage.
Coverage creation succeeds.	Update UI and proceed in flow.	Response with updated coverage context.
Coverage creation fails.	Display validation errors.	Structured error response.

---

Endpoint Resources

Add Coverage

PUT 

v3/coverage/add

Displays add coverage screen.

---