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 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.

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