РЛС^® Взаимодействие лекарственных средств v2.1

Описание и рекомендации по использованию сервиса

Сервис является интеграционным и встраивается в состав медицинской информационной системы (МИС), метод доступа — REST API, формат данных — JSON/XML.

Существует три способа проверки взаимодействия препаратов:

Первый способ: запрос к методу interact_v2. В качестве входных параметров указываются коды (идентификаторы) действующих веществ из справочника Действующих веществ (/api/dict_active_substances).

• /api/interact_v2?as_ids=2294,3611,217

• /api/interact_v2?as_ids=3808,882

Второй способ: запрос к методу interact_esklp_v2. В качестве входного параметра указываются коды КЛП из Федерального справочника ЕСКЛП https://esklp.egisz.rosminzdrav.ru/, перечисленные через запятую.

• /api/interact_esklp_v2?klp_ids=21.20.10.148-000070-1-00252-2000001052719,%2021.20.10.131-000023-1-00086-2000000550272,%2021.20.10.191-000067-1-00166-2000000957182

• /api/interact_esklp_v2?klp_ids=21.20.10.148-000004-1-00269-2000001149383,21.20.10.232-000054-1-00201-2000000498404

Третий способ: запрос к методу interact_esklp_v2. В качестве входного параметра указываются коды СМНН из Федерального справочника ЕСКЛП https://esklp.egisz.rosminzdrav.ru/, перечисленные через запятую.

• /api/interact_esklp_v2?smnn_ids=21.20.10.148-000070-1-00252-0000000000000,%2021.20.10.131-000023-1-00086-0000000000000,%2021.20.10.191-000067-1-00166-0000000000000

• /api/interact_esklp_v2?smnn_ids=21.20.10.232-000054-1-00201-0000000000000,21.20.10.148-000004-1-00269-0000000000000

Ответ системы возвращается в формате XML или JSON в зависимости от предпочтений пользователя и содержит поля, описанные ниже.

Левая сторона взаимодействия. Левое действующее вещество (сторона) является проверяемым. Сервис выдает ответ о найденном взаимодействии на основании инструкции по медицинскому применению на оригинальное торговое название препарата, содержащего левое действующее вещество, или авторитетных зарубежных источников.

• as1_id_orig – код (id) первого («левого») исходного действующего вещества из справочника dict_active_substances, переданного на проверку (integer);
• as1_name_orig – название первого исходного действующего вещества из справочника dict_active_substances (string);
• as1_id – код (id) действующего вещества из справочника dict_active_substances, непосредственно участвующего во взаимодействии «слева» (integer);
• as1_name – название действующего вещества из справочника dict_active_substances, непосредственно участвующего во взаимодействии «слева» (string).

Для простых, однокомпонентных, веществ значения полей as1_id_orig и as1_name_orig будут, соответственно, совпадать с as1_id и as1_name; для многокомпонентных действующих веществ в общем случае указанные пары значений будут отличаться: например, когда для исходного действующего вещества с кодом as1_id_orig информация о наличии взаимодействия с другой стороной отсутствует, но при этом имеются данные о таком взаимодействии для входящего в его состав компонента (простого вещества) с кодом as1_id.

Для ЕСКЛП:

• klp_1 – код КЛП первого препарата из справочника ЕСКЛП (string);
• mnn_1 – международное непатентованное название первого взаимодействующего вещества из справочника ЕСКПЛ (допустимо многокомпонентное действующее вещество) (string);
• smnn_1 – код СМНН первого взаимодействующего вещества из справочника ЕСКПЛ (string).

Правая сторона взаимодействия. Правое действующее вещество (сторона) – действующее вещество, взаимодействие с которым найдено в инструкции по медицинскому применению на оригинальное торговое название препарата, содержащего левое действующее вещество, или авторитетных зарубежных источниках.

• as2_id_orig – код (id) второго («правого») исходного действующего вещества из справочника dict_active_substances, переданного на проверку (integer);
• as2_name_orig – название второго исходного действующего вещества из справочника dict_active_substances (string);
• as2_id – код (id) действующего вещества из справочника dict_active_substances, непосредственно участвующего во взаимодействии «справа» (integer);
• as2_name – название действующего вещества из справочника dict_active_substances, непосредственно участвующего во взаимодействии «справа» (string);
• as2_phg_id – код (id) фармгруппы, к которой относится действующее вещество, непосредственно участвующее во взаимодействии «справа» (integer);
• as2_phg_name – название фармгруппы, к которой относится действующее вещество, непосредственно участвующее во взаимодействии «справа» (string).

Для простых, однокомпонентных, веществ значения полей as2_id_orig и as2_name_orig будут, соответственно, совпадать с as2_id и as2_name; для многокомпонентных действующих веществ в общем случае указанные пары значений будут отличаться: например, когда для исходного действующего вещества с кодом as2_id_orig информация о наличии взаимодействия с другой стороной отсутствует, но при этом имеются данные о таком взаимодействии для входящего в его состав компонента (простого вещества) с кодом as2_id.

Пара полей as2_phg_id и as2_phg_name будут пустыми (null) в случаях, когда описанное взаимодействие происходит по типу «действующее вещество – действующее вещество», т.е. непосредственно касается проверяемых сторон; в ситуациях, когда информация о взаимодействии представлена по типу «действующее вещество – фармгруппа», указанные атрибуты будут хранить идентификатор и название фармгруппы для «правого» действующего вещества соответственно.

Для ЕСКЛП:

• klp_2 – код КЛП второго препарата из справочника ЕСКЛП (string);
• mnn_2 – международное непатентованное название второго взаимодействующего вещества из справочника ЕСКПЛ (допустимо многокомпонентное действующее вещество) (string);
• smnn_2 – код СМНН второго взаимодействующего вещества из справочника ЕСКПЛ (string).

Результат взаимодействия

• id – код (id) записи о взаимодействии (integer);
• class_id – числовое представление класса/категории взаимодействия; возможные значения: 1, 2, 3 (integer);
• class_name – название класса взаимодействия (string);
• subclass_id – числовое представление подкласса взаимодействия в рамках дополнительной классификации; возможные непустые значения: 1–6 (integer);
• subclass_name – название подкласса взаимодействия (string);

Поля subclass_id и subclass_name актуальны (не null) для взаимодействий, имеющих class_id=2.

• direction_id – числовое представление направленности взаимодействия; возможные значения: 1, 2, 3, 4 (integer);
• direction_name – расшифровка направленности взаимодействия (string);
• official_src_name – название основного, официального, источника, из которого взята информация о взаимодействии (string);
• official_src_date – дата последней актуализации сведений из основного источника (date);
• official_src_note – текстовое описание взаимодействия, взятое из основного источника (string);
• alternative_src_name – название дополнительного авторитетного источника, из которого взята информация о взаимодействии; в случае нескольких источников – будут указаны все, разделены между собой слеш-символом / (string);
• alternative_src_date – дата последней актуализации сведений из дополнительного источника; в случае нескольких источников – будет указана наиболее актуальная среди всех имеющихся (date);
• alternative_src_note – текстовое описание взаимодействия, взятое из дополнительного источника; в случае нескольких источников – будут последовательно представлены все имеющиеся фрагменты с указанием в заголовке названия источника (string).

Свидетельства о государственной регистрации