Phase 1: Bi-Directional Patient Card Click-Through and Patient Export 

For correct patient import and matching, the existing export function in the AIS must include the following columns:

Required Columns

- First Name (Jméno): Patient’s first name.

- Last Name (Příjmení): Patient’s last name.

- Phone Number (Telefonní číslo): Primary phone number (used for SMS from Medevio).

^- Secondary Phone Number (Sekundární telefonní číslo): Additional phone number (stored in notes).

- Email (E-mail): Primary email (used for emails from Medevio).

- Secondary Email (Sekundární e-mail): Additional email (stored in notes).

- Birth ID Number (Rodné číslo): With or without a slash.

- Date of Birth (Datum narození): Format dd.mm.yyyy or dd/mm/yy(yy).

- Insurance Company (Pojišťovna): Numeric code.

- Note (Poznámka): Any text related to the patient.

Future (Recommended) Columns

- Gender (Pohlaví): M / m / 1 = male; all others = female.

- Street (Ulice)

- City (Město)

- Postal Code (PSČ)

The goal is to significantly streamline doctors’ workflow by enabling seamless switching between both systems directly to the specific patient’s card. 

1. Click-Through from Medevio to AIS

Method: Medevio triggers the desktop AIS via a localhost HTTP request.

The AIS integration should prioritize Option A. Only implement Option B if the AIS is technically unable to handle new patient data pre-population.

- Method: Medevio calls desktop applications via localhost.

- Parameter Sent: Patient’s Birth ID Number (RČ).

- Requirement: AIS must open the corresponding patient card based on the Birth ID Number.

- “Patient Not Found” Scenario: AIS should ideally support receiving additional parameters (name, RČ, date of birth, etc.) to create a new patient record automatically.

Option A: Create or Open Patient (Preferred)

This option provides a seamless workflow for both existing and new patients.

• Scenario: Medevio sends a request containing the patient's full demographic data.

• AIS Logic:

  1. If the patient exists (matched by Personal ID / Birth Number): The AIS opens the existing patient card.

  2. If the patient does NOT exist: The AIS opens the "New Patient" form with all fields pre-populated from the URL parameters.

Example Request:http://localhost:8000/ui/addopenrc?rodcis=9003166106&prijmeni=mojeprijmeni&jmeno=mojejmeno&titul=Ing.&poj=111&telefon=123456789&email=priklad@priklad.cz&obec=Ostrava&psc=70030&ulice=Zavodni

Option B: Open Existing Patient Only (Fallback)

Use this method only if your system cannot support the automated creation/pre-population of new patient records.

• Scenario: Medevio sends the patient's identification.

• AIS Logic: The AIS searches for the patient by Personal ID (Rodné číslo). If found, it opens the patient record. If not found, the AIS typically displays an "Archive not found" alert or remains idle.

Example Request:http://localhost:8000/ui/openrc?rodcis=9003166106

Example / Reference:

https://www.medevio.cz/napoveda/smartmedix-integrace 

2. Click-Through from AIS to Medevio

- Method: AIS opens a specific URL in the browser.

- URL Structure: Must contain the clinic’s unique slug (e.g., doktorcinatl) and patient parameters.

- Logic: Medevio attempts to find the patient. If no match exists, it creates a new patient using the provided data.

General Link Format

All values must be URL-encoded.

https://my.medevio.cz/:slug/klinika/import/ais/?datum-narozeni=DD.MM.YYYY&email=jarda@seznam.cz&pojistovna=111&jmeno=Jaroslav&telefon=+420777123456&prijmeni=Novak&rc=1234567890&pohlavi=M&ulice=Americka%20123&mesto=Praha&psc=10000 

Parameter Format and Logic

Parameter	Format	Notes
datum-narozeni	DD.MM.YYYY	Used if the Birth ID Number (RČ) is not valid.
email	Valid email
jmeno	Text
prijmeni	Text
pojistovna	3-digit number
rc	Text	Priority. If valid, date of birth and gender are extracted from it.
pohlavi	M / m / 1	Male; used if RČ is not valid.
ulice	Text
mesto	Text
psc	Number

Phase 2: Integration via API

In the next phase, deeper integration is possible using the open Medevio API. API documentation is provided https://developers.medevio.cz/medevio-api .

Resources and Testing

- General Information:https://www.medevio.cz/pro-lekare

- Detailed Help:https://www.medevio.cz/napoveda

- Test Practice Registration:https://my.medevio.cz/registrace-lekare