Skip to main content

Patient Management

Overview​

As a nurse, managing patient information and care is a critical part of your role.

The nurse is usually the first point of contact for patients and plays a key role in their care journey.

info

The nurse must have a valid token to complete most of the sections outlined. See Nurse Login for more information.

Adding Facility Patients​

Nurses can add new patients to their facility. The patient's details and contact information must be provided.

mutation CreateFacilityPatient($input: CreateFacilityPatientInput!) {
  createFacilityPatient(input: $input) {
    errors {
      code
      fields
      message
    }
    result {
      id
      name
      email
      phone
      createdHealthFacility {
        id
      }
    }
  }
}

Variables:

{
  "input": {
    "name": "John Doe",
    "email": "example@email.com",
    "phone": "+233123456789"
    }
}

Response:

{
  "errors": null,
  "result": {
    "id": "12345",
    "name": "John Doe",
    "email": "example@email.com"
    }
}

Adding Patients with Insurance Info​

Nurses can add new patients to their facility along with their insurance information.

mutation CreateFacilityPatient($input: CreateFacilityPatientInput!) {
  createFacilityPatient(input: $input) {
    errors {
      code
      fields
      message
    }
    result {
      id
      name
      email
      phone
      createdHealthFacility {
        id
      }
      patientInsuranceInfo {
        insuranceNumber
        validTill
        insuranceType
        ccCode
        insuranceCompany
      }
    }
  }
}

Variables:

{
  "input": {
    "name": "John Doe",
    "email": "example@email.com",
    "phone": "+233123456789",
    "insuranceInfo": {
      "insuranceNumber": "123456789",
      "validTill": "2023-12-31",
      "insuranceType": "Health Insurance",
      "ccCode": "GH",
      "insuranceCompany": "ABC Insurance"
    }
    }
}

Response:

{
  "errors": null,
  "result": {
    "id": "12345",
    "name": "John Doe",
    "email": "example@email.com",
    "phone": "+233123456789",
    "patientInsuranceInfo": {
      "insuranceNumber": "123456789",
      "validTill": "2023-12-31",
      "insuranceType": "Health Insurance",
      "ccCode": "GH",
      "insuranceCompany": "ABC Insurance"
    }
    }
}

When a new patient is added, an SMS is sent to the patient's phone number with their MedTrack ID.

Adding Patients Without Phone​

Nurses can add new patients to their facility even if the patient does not have a phone number. In that case the doesNotHavePhone field should be set to true. and one or more contact persons should be added.

Viewing Facility Patients​

Nurses can view the list of patients in their facility. The list includes patient details and their status.

query GetFacilityPatients($healthFacilityId: ID!) {
  facilityPatients(healthFacilityId: $healthFacilityId) {
    edges {
      node {
        id
        name
      }
    }
    count
    pageInfo {
      endCursor
    }
  }
}

Viewing Patients by Status​

Nurses can view patients in their facility based on their status, such as "ADMITTED" or "IN_WAITING_ROOM".

The response is paginated and you can specify pagination parameters to indicate the number of patients to return.

query ListFacilityPatientsByStatus($healthFacilityId: ID!, $currentStatus: String!) {
  listFacilityPatientsByStatus(healthFacilityId: $healthFacilityId, currentStatus: $currentStatus) {
    edges {
      node {
        patientId
      }
    }
  }
}

Adding Vitals for a Patient​

After a patient is registered, nurses can add vital signs for the patient. Nurses can add vital signs for a patient, such as temperature, blood pressure, heart rate, etc.

mutation AddPatientVitalCheckByNurse($input: AddPatientVitalCheckByNurseInput!) {
  addPatientVitalCheckByNurse(input: $input) {
    errors {
      code
      fields
      message
      shortMessage
      vars
    }
    result {
      nurseId
      healthFacility {
        id
      }
      vitals {
        temperature
        bloodPressureDia
        bloodPressureSys
        heartRate
        weight
        height
        fbs
        oxygenLevel
      }
    }
  }
}

Searching for Patients​

Nurses can search for patients in their facility using various search terms, such as name, phone number, or Ghana Card number.

query SearchPatients($searchTerm: String!, $healthFacilityId: ID) {
  searchPatients(searchTerm: $searchTerm, healthFacilityId: $healthFacilityId) {
    id
    name
    belongsToCurrentFacility
  }
}

Requesting to Add Patient to Facility​

If a patient is already on MedTrack platform, the nurse does not need to register the patient again. Instead, the nurse can request to add the patient to their facility.

If the patient requires authorization, an SMS with an auth code will be sent to the patient. And the patient will be required to authorize the request.

First the nurse must request to add the patient to their facility.

mutation RequestToAddPatientToFacility($patientId: ID!, $healthFacilityId: ID!) {
  requestToAddPatientToFacility(patientId: $patientId, healthFacilityId: $healthFacilityId) {
    success
    message
    requestId
    requiresAuth
  }
}

Variables:

{
  "patientId": "12345",
  "healthFacilityId": "67890"
}

Response:

{
  "success": true,
  "message": "Request to add patient to facility was successful.",
  "requestId": "abcde12345",
  "requiresAuth": true
}

Then the patient will receive an SMS with an auth code.

The next step is to authorize the request using the auth code.

mutation ActivateFacilityPatientWithCode($requestId: ID!, $patientId: ID!, $healthFacilityId: ID!, $code: String!) {
  activateFacilityPatientWithCode(requestId: $requestId, patientId: $patientId, healthFacilityId: $healthFacilityId, code: $code) {
    success
  }
}

Variables:

{
  "requestId": "abcde12345",
  "patientId": "12345",
  "healthFacilityId": "67890",
  "code": "123456"
}

Response:

{
  "success": true
}