Skip to main content

Offer Appointment

The Offer Appointment screen allows doctors to propose an additional appointment after completing an existing one. This screen helps initiate follow-up care by sending a new appointment offer to the patient. Patients can view, accept, or decline the offer in their app.

The screen appears after navigating from the completed appointment view. It supports a single scheduled offer and up to three alternative suggestions.

This screen includes:

  • A follow-up appointment creation form.
  • A Suggested Scheduling card that allows up to three alternatives.
    • Highlights fields in red when edited.
    • Prevents duplicate alternatives.
    • Displays the delete icon only on alternatives 2 and 3.
    • Calculates total and doctor fees automatically.
  • Editable fields for date, time, and location.
  • A patient note input (optional).
  • A Submit button that activates when required fields are valid.
  • Edit and Cancel actions for active offers.
  • Automatic expiration after a configured timeout.
  • Redirect to appointment history after submission.

Workflow​

Create an Additional Appointment​

  1. Open a completed appointment.
    Completed appointment view with offer option
  2. Enter the proposed date and time.
  3. Select a location.
  4. (Optional) Enter a patient note.
  5. Select Submit Offer.
    • Show a spinner during submission.
    • Redirect to appointment history after success.
    • Display an error message if submission fails.

Edit an Offer​

  1. Open an active offer.
  2. Select Edit.
  3. Modify the offer details.
  4. Select Update Offer.
    • Validate changes before submitting.
    • Display confirmation if successful.

Cancel an Offer​

  1. Open an active offer.
  2. Select Cancel.
  3. Confirm the action.
    • Show a modal for confirmation.
    • Remove the offer from the active state.
    • Log cancellation for auditing.

Validations​

  • Require valid date, time, and location before enabling the Submit button.
  • Highlight modified fields in red until submitted.
  • Prevent duplicate scheduling alternatives.
  • Limit suggested alternatives to three.
  • Enforce selection of a valid location.
  • Automatically expire offers that are not submitted after the configured timeout.

Actions​

  • Submit the offer and redirect to the appointment history.
  • Show success or error messages.
  • Allow edits while the offer remains active.
  • Cancel an offer and update its current state.

SDK and API References​

GET 

/profile/appointments/{id}/offer-an-appointment

Returns the form for creating an additional appointment. The response includes contextual messages, required fields, and support for multiple scheduling options.

UI Element Types​

LevelReferenceTypeValuePlacement
1offer-messageRegularOffer another appointment to patient (full name), the offer will be sent to the patient for approval—
1alternative~{1}Card—
2——Suggested Scheduling—
1spacerSpacer—
1approveButtonApprove—