API
API для передачи СЭМД в РЭМД
API предназначено для передачи структурированных электронных медицинских документов (далее — СЭМД) в реестр электронных медицинских документов (далее — РЭМД).
API cодержит методы для создания нового СЭМД, его подписи и получении статуса отправки СЭМД.
Основные требования
для взаимодействия с РЭМД.
Для осуществления взаимодействия с подсистемой РЭМД со стороны МИС должно быть обеспечено выполнение следующих условий:
— Медицинская организация, от которой осуществляется отправка ЭМД в РЭМД, должна быть зарегистрирована в ФРМО;
— Врач, подписавший ЭМД должeн быть зарегистрирован в ФРМР;
— ЭМД должен быть подписан подписью врача, сформированной по формату CMS (Cryptographic Message Syntax);
— У врача, подписавшего ЭМД, должен быть передан СНИЛС;
— У пациента должен быть передан СНИЛС;
— Для формирования указанных УКЭП должны использоваться сертификаты, выданные аккредитованными УЦ. Сертификаты должны соответствовать требованиям ГОСТ Р 34.10–2012 (Согласно выписке из документа ФСБ России N 149/7/1/3–58 от 31.01.2014 «О порядке перехода к использованию новых стандартов ЭЦП и функции хэширования» использование схемы подписи ГОСТ Р 34.10–2001 для формирования подписи после 31.12.2018 года не допускается);
— Файл ЭМД должен иметь XML формат.
Общие требования к использованию API
- Передача сведений осуществляется в рамках защищённого соединения с помощью OpenVPN-ГОСТ;
- Аутентификация: в каждом запросе необходимо передавать параметр access-token;
- Для получения ответа в формате JSON необходимо передавать заголовок запроса Accept:application/json;
- Кодировка ответа UTF-8;
- СЭМД и подпись врача передаются в Base64.
СЭМД
СЭМД — электронный документ, с помощью которого осуществляется передача информации (электронных персональных медицинских записей) из Электронной медицинской карты конкретной медицинской организации в Интегрированную электронную медицинскую карту.
СЭМД содержит информацию из конкретной Электронной персональной медицинской записи (далее — ЭПМЗ) в конкретной медицинской организации, всю необходимую информацию для идентификации субъекта ИЭМК, а также для определения автора данной информации и медицинской организации, несущих ответственность за её содержание.
СЭМД имеет определённую структуру и формат в соответствии с используемыми стандартами и правилами, установленными для взаимодействия с Интегрированным электронным медицинским архивом. ИЭМА также устанавливает регламент обработки СЭМД при его поступлении в ИЭМК. СЭМД должен обеспечивать требования, предъявляемые к медицинскому документу:
— Официальность (юридическую значимость);
— Неизменность;
— Персонифицируемость и неотказуемость, т.е. возможность определить происхождение документа и его автора, несущего ответственность за его медицинское содержание, а также конкретный момент (дату) его создания.
Пример запроса на создание СЭМД*
{"document": {"number": "10","created_at": "2024-09-01 14:00:23","kind": 230,"description": "Профосмотр","content": "документ в base64"},"organization": { "oid": "1.2.643.5.1.13.13.12.2.53.192929","name": "ООО ЕВРОМЕД"},"patient": {"firstname": "Иванов","lastname": "Иванов","patrname": "Иванович","birthdate": "1985-06-01","gender": 0,"snils": "66089818145"},"doctor": {"firstname": "Иванов","lastname": "Иванов","patrname": "Иванович","snils": "66089818145","position_id": 80,"speciality_id": 124}}