Home Visit Details
Use the Home Visit Details screen to provide the visit address for a home appointment.
This screen collects address data, validates service availability, and returns updated pricing based on the resolved location.
This screen includes
- An Address field that accepts street, number, and city.
- Optional Floor and Apartment or Room number fields.
- An optional Notes field for access or location instructions.
- A cost notice that reflects the appointment cost based on the resolved location.
- A Next button that advances the flow when required fields are valid.
- Informational text that states the app shares the provided details with the doctor.
Workflow
This workflow describes how the app processes home visit location details.
- Open the Home Visit Details section after selecting a home visit appointment type.
- Enter an address that resolves within the supported service area.
- Review the updated appointment cost returned for the resolved location.
- Select Next to continue.
If the location is outside the doctor’s service range, the SDK returns an availability state that disables the home visit option.
Validations
These validations run before the app allows the user to proceed.
| Scenario | App Behavior | SDK Output |
|---|---|---|
| Required address field is missing. | The primary action remains disabled and the Address field shows an inline error. | Required field validation error for address. |
| Address cannot be resolved or falls outside the service area. | The screen indicates out-of-range status and disables home visit selection. | Availability or range validation error. |
| Address input changes. | The screen refreshes the cost notice based on resolved location. | Updated pricing data. |
| Input exceeds allowed field length. | Additional input is blocked. | Field length validation error. |
The app validates address data and availability before advancing to the next step.
Actions
Home visit handling depends on availability and validation results.
Home Visit Actions
| Scenario | App Behavior | SDK Output |
|---|---|---|
| User enters a valid address within service range. | The screen updates the cost notice and prepares the request for submission. | Update set with resolved address data and updated pricing. |
| User enters an address outside service range. | The screen shows out-of-range status and disables the home visit option. | Availability error that disables home visit selection. |
| User selects Next with valid input. | Navigation advances to the next step in the request flow. | Update set with updated appointment request state. |
| User navigates back before proceeding. | No address update is applied. | No state change returned. |
| Server-side validation fails. | An error appears and navigation remains blocked. | Address validation error. |