# Clinic: patients, queue and medical record

Section: Selling. Address: https://vende.id/docs/jualan/klinik?lang=en

Register patients with a medical record number, run the queue per poli, fill in each visit's record, then turn procedures and medicines into a till note.

The **Clinic** feature is for primary care clinics, doctors' practices, dentists and midwives. Every patient has a medical record number, every visit has a queue number and the doctor's record, and the procedures and medicines of the examination become a draft note at the clinic till without being typed again.

This is an extra feature. If the menu is not there, ask the Vende team to switch it on. It uses Services, and the doctor fee per procedure uses Service commissions. The new menus are **Master Data → Patients**, **Master Data → Doctor Schedules** and **Transactions → Visits**.

## 1. Register the patient

Under **Master Data → Patients**, tap **Add**:

- A new patient: fill in **Name** and **Phone**. The patient is also a customer from then on.
- An existing customer who is not a patient yet: pick them under **Existing customer**.
- Fill in the **Date of birth**, **Sex**, **NIK**, **Blood type**, **BPJS number** and **Allergies**. All may stay empty, but fill in allergies from the start: everyone who opens the visit sees them, the pharmacy cashier included.

Every patient gets an automatic **Medical record no.** (RM-000001, RM-000002, and so on) that never changes. One NIK and one BPJS number can belong to one patient only. If one is taken, Vende names the patient and the record number so you do not create a twin.

## 2. Register the visit

Under **Transactions → Visits**, tap **Register** (or **Register a visit** on the patient's row):

1. Find the patient by name, medical record number, NIK or BPJS number.
2. Fill in the **Poli** (for example General, Dental, Mother and Child) and pick the **Doctor**. Below the doctor it says who practises today according to the Doctor Schedules.
3. Pick the **Payer**: **General** (the patient pays), **Insurance** (pick the customer that is billed, with its own payment terms) or **BPJS** (the patient must have a BPJS number).
4. Write the **Complaint** and save. The queue number comes out per poli per day: 1, 2, 3 and so on.

The same patient cannot be registered twice in the same poli on the same day while the visit is not finished. Vende names the visit and queue number that already exist.

## 3. The queue and calling

The **Today** tab shows the day's queue by poli and queue number, the **Not done** tab every visit still waiting or in examination from any day. On the row or the visit page:

- **Call** marks the patient Called and notes the time.
- **Start examination** moves the visit to In examination. Saving the medical record moves it too.
- **Cancel** closes a visit that did not happen.

Visit statuses: Waiting, Called, In examination, Done and Cancelled.

## 4. The medical record

The doctor or nurse opens the visit and taps **Medical record**. Every field may stay empty:

- **Vital signs**: blood pressure, pulse, temperature, respiration, oxygen saturation, weight and height. A figure outside the plausible range is refused with the range. The BMI is worked out on the visit page.
- **SOAP notes**: Subjective, Objective, Assessment and Plan.
- **Diagnoses (ICD-10)**: type the code (for example J06.9) and the name fills in for a common code. A free code of the ICD-10 shape is accepted too. Only one diagnosis may be marked **Primary**.
- **Procedures and medicines**: services (consultation, wound stitching, injection) and goods (medicines, consumables) to be billed, with the quantity and, for medicines, the **dosage**.
- **Sick letter and referral**: fill in **Sick leave** (days) and or **Referred to** when needed.

The record can be changed while the visit is not closed and billed. A visit closed without a note can still be given procedures or medicines and billed again with **Finish & Bill**, and so can one whose draft note was deleted. Once it has a note, the record is locked, and the next examination is a new visit.

## 5. Finish and bill

Tap **Finish & Bill** on the visit page. The examination is closed and:

- **General**: the procedures and medicines become a **draft note** in the patient's name at the clinic till. The cashier opens it, checks the medicines and takes the payment like any note. The note carries the visit number and the doctor's name as the prescription number and doctor.
- **Insurance**: a draft note in the name of the insurer or company, with the patient's name in its note. The bill is a receivable with that customer's terms and credit limit.
- **BPJS**: medicines and supplies leave stock at a price of Rp 0 and their cost goes to the cost of goods sold (a cost of care, not Promotion Expense), while the consultation and procedures are recorded at a price of Rp 0, so there is no income per visit. BPJS capitation is recorded as income through an ordinary **Income**.

The doctor fee: the services on the note use the visit's doctor as the performer, so the commission is worked out when the note is posted by the rates under **Master Data → Commission Rates** and summed up in **Reports → Service Staff Commissions**. A visit with no procedures or medicines is just closed, with no note.

## 6. Sick letter and referral

On a visit page whose medical record holds sick leave days or a referral target, the **Sick letter** and **Referral letter** buttons print an A4 PDF with the shop's letterhead, the patient's name, record number and the doctor's name to sign. Every print goes on the visit's history.

## 7. Doctor schedules

Under **Master Data → Doctor Schedules**, add each doctor's practice days and hours per branch and poli. A doctor is a service staff under **Master Data → Service Staff**. The schedule is only a hint on the registration form and does not refuse a registration outside practice hours.

## 8. Send to SATUSEHAT

SATUSEHAT is the health data platform of the Ministry of Health. This feature is **optional and off** until the clinic fills in its credentials; while they are empty nothing is sent and there is no send button.

1. Get the clinic's **organization ID**, **client ID** and **client secret** from the Ministry of Health through the SATUSEHAT Platform portal.
2. Open **Settings → SATUSEHAT** (the owner), pick the **Environment** (start with testing), fill in the three and save. The client secret is stored encrypted, not shown again, and is not part of any export, backup or AI Access. Fill it again only to replace it.
3. Press **Test connection**. Vende asks SATUSEHAT for access with what is saved and tells you plainly how it went.
4. Fill in the patient's **NIK** under **Master Data → Patients** and the **doctor's NIK** under **Master Data → Service Staff**. SATUSEHAT knows patients and doctors by NIK.

After that, in the **Production** environment, every visit closed with **Finish & Bill** is sent by itself in the background. In the **Testing** environment nothing is sent by itself, so real patient data does not reach the testing server: a visit is sent with the **Send to SATUSEHAT** button. What is sent: the visit (Encounter), the ICD-10 diagnoses (Condition) and the vital signs (Observation) in one submission, so it is stored whole or not at all. A poli gets its location in SATUSEHAT once, the first time it is used. Closing the visit never waits for SATUSEHAT and never fails because of it.

On the visit page the **SATUSEHAT** section shows **Waiting to be sent**, **Sent** (with its visit ID in SATUSEHAT) or **Failed** with the reason from the server or from Vende. A temporary problem is tried again up to three times; any other reason (no NIK, an unknown NIK, refused data) becomes Failed at once, with how to fix it. The **Send to SATUSEHAT** button (**Send to SATUSEHAT again** after a failure; Medical Staff and the owner) is there while the visit is not sent, so fix what the reason says first. If the connection drops while sending, Vende does not try again by itself because the visit may already be accepted: check in SATUSEHAT, then send again. A visit without a doctor cannot be sent; register a new visit with the doctor. A visit that was sent is never sent twice and its medical record can no longer be changed, so it stays the same as what is recorded in SATUSEHAT. The Visits list has a **SATUSEHAT** column and filter (including **Not sent yet**) to find the failed or unsent ones. Changing the environment or the organization ID makes every visit sendable again to the new one.

What is sent now: the visit, the diagnoses and the vital signs. Procedures and medicines are not sent yet, because SATUSEHAT asks for terminology codes (SNOMED, KFA) that Vende's service and goods lists do not hold.

## 9. Who may open the medical record

Patient data is sensitive.

- **Registration** (Cashier Operator and Head Cashier) sees and corrects patients and sees the queue, allergies and the payer, but not the vital signs, the SOAP notes or the diagnoses.
- **Medical Staff** (the role for doctors and nurses) calls, examines, writes the medical record and closes visits, and takes no money.
- The **owner** opens everything.
- Every opening of a medical record and every change is written to the **Activity History**.
- The contents of the medical record (vital signs and SOAP notes) do not go to the Activity History, AI Access or Ask Vende.

Give the **Medical Staff** role under **Settings → Users**. See [Roles and permissions](https://vende.id/docs/pengaturan/peran-dan-hak-akses?lang=en).
