Skip to main content

Patient Insurance Task

The main purpose of this connector is to collection Insurance Information from patients whose information are missing. The connector validates required fields, and if they are not provided created a task for the patient to provide these fields.

A notification is sent to the patient when the workflow is run in production mode but skipped when run in testMode.

There are 3 parts to this connector

  • The part that create the task
  • The part that collects information using the web-service
  • The part part with incoming event.

Create the task​

This connector renders a form with the fields in the Insurance Data and their types. Users can map each field to the associated input for validation. There others setting to provide. e.g. Task Logo, connected_workflow, task detials, and patientId.

Patient Provides Data​

When a patient is notified of a pending task. They click on the link in the notification which brings them to the actions page of the web-service. Here they can view all pending actions and complete them.

The link should be in the following formats

  • To show them all pending tasks: http://localhost:8080/?code=jOCVxSAF&type=actions
  • To take them to a specific task: http://localhost:8080/?code=jOCVxSAF&type=actions&task=4 where 4 is the id of the task in the database

For the Patient Insurance Task action, already provided fields are populated and fields without data are left for the patient to fill in. Patient cannot submit the form until they have provided all the required fields. For security reason payement card fields ImageCardFront, and ImageCardBack are not returned or displayed on the web-service after submission.

IncomingEvent - Incoming Insurance Event​

Like other incoming event types, this connector always come first. The form data completed by the patient is returned and passed to the rest of the connectors in the workflow.

Insurance Data Interface​

interface InsuranceFields {
  patientFirstName: string;
  patientLastName: string;
  patientDateOfBirth: Date;
  memberId: string;
  policyHolderFirstName: string;
  policyHolderLastName: string;
  policyHolderDateOfBirth: Date;
  imageCardFront: string;
  imageCardBack: string;
}

interface PrimaryInsurance extends InsuranceFields {
  insuranceCompany: string;
  relationShipToSubscriber: string;
}

export interface IncomingInsuranceTaskOutput {
  patientId: string;
  primaryInsurance: PrimaryInsurance;
  secondaryInsurance: InsuranceFields;
}