Краткое описание сервиса

База данных включает пять разделов. Основной раздел — Номенклатура — набор записей для товарного учета лекарств, зарегистрированных на территории РФ. Каждая позиция номенклатуры — одна торговая (учетная) единица.

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

Раздел Описания представляет собой библиотеку текстов в HTML-формате, содержащую описания лекарственных средств, утвержденные инструкции по медицинскому применению, описания действующих веществ, типовые клинико-фармакологические статьи, описания болезней и состояний, описания фармгрупп.

Раздел Классификации содержит классификаторы МКБ-10, АТХ, Фармгруппы, НТФР, ОКПД+ОКПД-2, списки и различные признаки. Препараты классифицированы по этим классификаторам, т.е. имеют отношение к одному или нескольким их узлам, что позволяет эти препараты анализировать и группировать по схожим свойствам при построении медицинских экспертных систем.

Раздел Оперативные данные служит для публикации быстро меняющейся информации, такой как зарегистрированные предельные цены производителей на жизненно необходимые и важнейшие лекарственные препараты (ЖНВЛП), забракованные, предписанные к изъятию серии лекарственных средств. Эти данные привязаны к номенклатурным позициям и вместе с разделом Номенклатура предназначены для решения задач товарного учета. Допустима частичная подписка на публикуемые данные. Подробно о методах, допустимых параметрах и форматах ответа можно почитать на http://rlsaurora10.azurewebsites.net/Help.

Номенклатура (inventory)

Номенклатурная позиция содержит два концептуальных уровня:

  • уровень препарата — определяет фармакологическую сущность, включает в себя торговое название, действующее вещество, дозировку, характеристику, фирму-производителя, идентифицируется кодом prep_id;
  • уровень торговой (учетной) единицы — определяет элемент товарного учета, включает в себя три уровня упаковки, объемы/размеры, комплектацию, фирму-упаковщика, штрихкод, срок годности, условия хранения, идентифицируется кодом packing_id.
  • В номенклатурном блоке на одну сущность уровня препарата, идентифицируемую одним кодом prep_id, может приходиться изобилие торговых единиц с разнообразными характеристиками и packing_id. Код уровня препарата используется для классификации препаратов в разделе Классификации, код уровня торговой единицы packing_id — для работы с разделом Оперативные данные.

Методы доступа

  • inventory_brief (24 поля) — номенклатура в слабоструктурированной форме представления. Денормализованный и агрегированный набор данных, не требующий никаких дополнительных справочников для организации товарного учета, но содержащий идентификаторы, позволяющие обращаться с запросами в разделы Описания, Классификации и Оперативные данные;
  • inventory_complete (72 поля) — номенклатура в подробно структурированном виде. Денормализованный набор данных, включающий в себя все связанные справочники (идентификаторы, краткие и полные формы записи), а также ссылки для построения запросов к другим разделам;
  • inventory_naked (33 поля) — номенклатура в ссылочной форме представления, требующей наличия связанных данных из раздела Справочники.

Для решения задач товарного учета и интеграции РЛС® Номенклатуры во внедренную информационную систему разработан сервис гармонизации номенклатурных позиций, позволяющий автоматически подобрать варианты из РЛС® Номенклатуры, соответствующие пользовательским номенклатурным позициям. Запросы к сервису гармонизации подаются по протоколу HTTP на адрес http://rlsaurora10.azurewebsites.net/api/inventory_complete?pos={pos}&firm={firms} в соответствии с соглашениями REST. В качестве входных параметров используется неструктурированное описание пользовательской номенклатурной позиции (параметр pos) и перечисление фирм-производителей/упаковщиков/регистраторов (параметр firms). На каждую пользовательскую номенклатурную строку выполняется отдельный запрос. Результаты гармонизации представляются в виде набора номенклатурных строк РЛС®, упорядоченных по релевантности пользовательскому запросу. Ответ системы возвращается в формате XML или JSON (в зависимости от предпочтений пользователя) и содержит определенные поля (в зависимости от выбранной формы представления номенклатурного блока).

Входные параметры номенклатурных блоков

  • packing_id = {int} — идентификатор номенклатурной позиции. Возвращается одна структура данных, соответствующая указанному идентификатору;
  • OnDate = {dd.mm.yyyy} — дата обновления. Возвращается набор данных, для которых actdate больше или равен значению OnDate, т.е. те записи, которые были добавлены или изменены в период с OnDate до текущего момента. Допустимые значения параметра — в течение предыдущих 6 месяцев с момента выполнения запроса. Для получения данных за предыдущее время нужно воспользоваться методом без параметров, который вернет полный массив данных на 1-е число текущего месяца в виде файла-архива;
  • ean={string(13)} — штрихкод. Возвращаются записи, содержащие переданный штрихкод. Таких записей может быть более одной, т.к. штрихкод не является уникальным идентификатором товарной позиции;
  • pos={string}&firm={string} — пользовательская номенклатурная позиция pos и название фирмы-производителя firm предназначены для поиска соответствия передаваемым данным в РЛС® Номенклатуре. В параметре pos одной строкой передаются все известные пользователю атрибуты — торговое название, форма выпуска, дозировка, упаковка, количество, характеристика, штрихкод, регистрационное удостоверение и т.д. В параметре firm передается название фирмы-производителя или фирмы-упаковщика в том виде, в каком оно известно пользователю. Чем больше атрибутов будет передано пользователем в систему, тем точнее будет выполнен поиск. В результате возвращается набор данных, упорядоченный по релевантности пользовательскому запросу.

Справочники (dict)

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

Отдельно от номенклатурного блока справочники можно использовать в качестве наборов данных для организации пользовательского интерфейса МИС с множественным выбором параметров.

Элементарные справочники

  • dict_active_substances — справочник действующих веществ. Содержит названия на разных языках, в том числе латинском (в родительном падеже - для рецептов), химические формулы, ссылки на описания ДВ;
  • dict_completeness — справочник комплектаций. Необязательная характеристика товарной упаковки;
  • dict_countries — справочник стран;
  • dict_dosage_form — древовидный справочник форм выпуска (лекарственных форм). Атрибут уровня препарата;
  • dict_dosage_form_char — справочник характеристик лекарственных форм. Необязательный атрибут уровня препарата;
  • dict_lifetimes — справочник сроков годности. Атрибут уровня упаковки;
  • dict_storecond — справочник условий хранения. Атрибут уровня упаковки;
  • dict_pack — справочник видов упаковки. Атрибут уровня упаковки;
  • dict_tradenames — справочник торговых названий. Атрибут уровня препарата;
  • dict_latnames — справочник торговых названий на латинице. Атрибут уровня препарата;
  • dict_firm — справочник фирм с названиями, адресами и телефонами. Используется для определения фирм-производителей, упаковщиков, владельцев регистрационных удостоверений;
  • dict_registry — справочник регистрационных удостоверений. Используется для определения атрибутов актуального регистрационного удостоверения препарата или для построения истории перерегистрации препарата.

Классификации (classes)

В разделе Классификации представляются наборы данных двух типов — классификаторы и отношения препаратов к узлам классификаторов. В базе данных РЛС® доступны классификаторы МКБ-10 (classcode=mkb), АТХ (classcode=atc), Фармгруппы (classcode=phg), ОКПД-2 (classcode=okpd), НТФР (classcode=ntfr). Кроме того, для каждого препарата указано, является ли он ядовитым, сильнодействующим, безрецептурным, жизненно важным, входит ли в минимальный аптечный ассортимент, список препаратов для лечения редких заболеваний (12 нозологий), список наркотических средств и прекурсоров.

Методы доступа

  • classes?classcode={classcode} — классификатор с кодом classcode.

Метод возвращает архивированный файл, который заливается в целевую МИС и используется для классификации препаратов ссылочной формы представления.

Для получения классификаций реализованы три метода:

  • classes_prep — полная классификация препаратов с расшифровкой классов;
  • classes_prep_naked — классификация препаратов в ссылочной форме записи;
  • classes_prep_marks — особые признаки препаратов.

Методы допускают ограничение набора данных по нужному классу при помощи параметра classcode и представление набора данных по препарату, определяемому входным параметром prep_id из номенклатурного блока. Кроме того, возможно получение набора данных, состоящего из записей, добавленных или измененных, начиная с даты OnDate по текущий момент, для организации периодических обновлений целевой МИС.

Описания (library)

В разделе Описания реализованы методы доступа к html-статьям, содержащим описания лекарственных средств, действующих веществ, фармгрупп и т.д. Описания имеют различную структуру, определяемую его типом.

Методы доступа

  • library_as_description — описание действующего вещества;
  • library_description — описание лекарственных средств.

Оперативные данные (operational)

В разделе Оперативные данные представлены наборы данных из различных источников, привязанные к номенклатурному множеству РЛС®.

Методы доступа

  • operational_lp_prices — Реестр предельных цен на ЖНВЛП, зарегистрированных производителями;
  • operational_rejectedseries — Реестр забракованных серий.

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

В демонстрационном режиме наборы данных, отдаваемые сервисами, определены для номенклатурных позиций с packing_id, кратным 100, т.е. набор данных номенклатурного блока inventory содержит только позиции 100, 200.... 17300 ... и т.д. Для блока Классификации (classes) - соответствующие только этим позициям привязки препаратов (prep_id) к классификаторам. Для блока Описания (library) — соответствующие только этим позициям (desc_id, as_id) тексты описаний. Для блока Оперативные данные (operational) — соответствующие только этим позициям (packing_id) цены на ЖНВЛП и забракованные серии.

Запросы к сервисам могут подаваться через веб-браузер или прямым HTTP-запросом от информационной
системы (ИС). Запрос формируется в виде:
http://rlsaurora10.azurewebsites.net/api/{имя_метода}?{имя_параметра=значение}&{имя_параметра=значение}

Заголовки пакета-запроса

При использовании веб-браузера при первом обращении к сервису запрашивается имя пользователя и пароль. Если они подходят, то запоминаются в cookies. Авторизационная информация передается в заголовках пакета-запроса (RequestHeaders) в выражении Authorization, в котором закодированы имя пользователя и пароль с использованием base64.

  • Authorization: Basic ZGVtbzoxMjM0NTY=

Формат возвращаемых данных

Методы возвращают данные в XML-, либо в JSON-формате. Формат ответа определяется заголовком пакета-запроса в выражении:

  • Accept: application/xml
  • Accept: application/json

Для браузера Chrome пакет формируется с Accept: application/xml — сервис дает ответ в XML, для браузера Microsoft IE пакет не содержит Accept: application/xml, поэтому ответ в JSON-формате. При формировании прямого HTTP-запроса из информационной системы необходимо учитывать эти аспекты и формировать заголовки с использованием Authorization и Accept.

Примеры запросов к системе в демонстрационном режиме

(при первом обращении потребуется ввести имя пользователя и пароль)

Номенклатурные блоки в виде архивов:

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

Заявка на демоверсию

Заполните и отправьте заявку на демоверсию. Наш менеджер свяжется с вами в ближайшее время.

Частые вопросы

Не нашли ответа на свой вопрос? Напишите нам.

  • Можно ли получить тестовый доступ к сервисам?

    Да, обратитесь к своему персональному менеджеру или заполните заявку на сайте.
  • Обязателен ли выход в интернет на рабочем месте в ЛПУ?

    Для работы с данными РЛС® достаточно периодически обновлять сервер внутренней информационной системы через доверенный шлюз. Доступ в интернет с каждого рабочего места не нужен.
  • Можно ли приобрести фрагменты базы данных или сервисов, если мне нужен ограниченный набор данных?

    Используя сервисы РЛС®, пользователь может подписываться на те фрагменты данных, которые нужны.
  • Система пользователя будет зависима от работы облачного сервиса?

    Нет, не будет. Пользователь скачивает данные в свою систему, в дальнейшем обращаясь к сервисам только за обновлениями.
  • Как происходит обмен данными?

    После оплаты вы получаете полный доступ к базе данных. Заходите на наш сервер и скачиваете базу (выбранные поля из анкеты), она будет храниться у вас в системе. Далее вы будете обращаться на наш облачный сервис только за обновлениями.
  • Как часто обновляется кэш РЛС® Авроры?

    Для любых наборов данных (кроме массивов Номенклатуры и Описаний) новые кэши в полном объеме создаются каждый день, поэтому запрашивать справочники dict_... без параметров можно ежедневно. Номенклатурный массив слишком большой, для того чтобы перестраивать его полностью каждый день. Таким образом, полный массив выкачивается раз в месяц запросом без параметров, а изменения — по удобному графику с параметром OnDate.
  • Осуществляется ли техподдержка клиентов?

    Да, техподдержка оказывается всем клиентам РЛС® и клиентам партнеров РЛС® с понедельника по пятницу с 9.00 до 17.00 по московскому времени.
  • Как связаться с техподдержкой?

    Если возникли вопросы, напишите на почту techsupport@rlsnet.ru. Также можно связаться со специалистом по телефону: +7 (499) 281-91-91, доб. 143
  • Что такое Словари комплектаций?

    Это справочники, которые содержат информацию о комплектации коробки препарата: флакон со шприцем-дозатором, ампулы с ампульным ножом и т.д.
  • Что такое Словари упаковок?

    Это справочники, которые содержат информацию о видах упаковок: блистер, коробка и т.д.
  • Что такое Словари характеристик?

    Это справочники, которые содержат информацию о характеристиках, которые нельзя отнести к той или иной группе: вкус сиропа.
  • Что обозначают метки ОНЛС и 7-ВЗН?

    Это специальные метки, которыми помечены препараты, включенные в соответствующие перечни: ОНЛС — препараты, входящие в программу «Обеспечение необходимыми лекарственными средствами»; 7-ВЗН — препараты для лечения 12 высокозатратных нозологий.
  • Есть ли в сервисах информация о РУ, а также возможность их просмотра и выгрузки?

    В базе есть информация о номере и дате РУ (регистрационное удостоверение), сканов удостоверений нет.
  • Изображения упаковок препаратов представлены только в таких разрешениях, как в примере, или их размеры можно изменять?

    Изображения такие же, как в примере демоверсии.
  • Что такое синонимы фармгрупп?

    Это варианты названий фармгрупп: фармгруппа — иммунодепрессивные средства, синоним — иммунодепрессанты.
  • Что такое синонимы болезней и состояний?

    Это варианты названий болезней, синдромов или симптомов, принятые в отечественной и мировой медицинской практике, но не имеющие точного соответствия рубрикам МКБ-10: МКБ-10 — I10 Эссенциальная (первичная) гипертензия, синоним — гипертония.
  • Что такое компонентный состав?

    Это совокупность и дозировки действующих веществ, содержащихся в многокомпонентном препарате. Например, в состав Амоксиклава 500 мг + 125 мг входит 500 мг амоксициллина тригидрата и 125 мг клавулановой кислоты.
  • Какие статусы может иметь РУ и чем они отличаются?

    РУ (регистрационное удостоверение) может иметь следующие статусы: «действует» — РУ действительно на территории РФ; «заменено» — в РУ произошли изменения, повлекшие за собой изменение позиции товара (например, поменялся производитель), такой препарат может присутствовать на рынке в течение срока годности; «истек срок» — срок действия регистрации препарата закончился; «исключен из Госреестра» — препарат исключен из ГРЛС (Государственный реестр лекарственных средств) по решению Минздрава РФ.
  • Где можно посмотреть соответствие значений статусов РУ (reg_status) их кодам (reg_status_id)?

    Соответствие между полями есть в блоке Номенклатура.
  • Где в результатах выдачи по api найти штрихкод позиции?

    Штрихкод находится в номенклатурной позиции в методе inventory_complete в поле barcode https://rlsaurora10.azurewebsites.net/Help/Api/GET-api-inventory_complete_packing_id.
  • Можно ли в XML получить фото товара?

    В XML картинок нет. Описание, как и картинка, по смыслу дополняют Номенклатуру (inventory). Номенклатурные строки содержат ссылку как на описания desc_id, так и на картинку picname.
    http://rlsaurora10.azurewebsites.net/api/inventory_brief?packing_id=553700
    Отдельный запрос к описанию: http://rlsaurora10.azurewebsites.net/api/library_description?desc_id=65583.
    Отдельный запрос к картинке: http://rlsaurora10.azurewebsites.net/api/inventory_pics?picaname=a553702.jpg.
    Другого соответствия (кроме Номенклатуры (inventory) между описанием и картинкой нет.
  • Как посмотреть общее количество действующего вещества в упаковке, где содержится несколько ампул?

    В поле Компонентный состав указано количество действующего вещества в одной ампуле, следовательно, пользователю необходимо умножить количество действующего вещества в одной ампуле на общее количество ампул.
  • Как вступить в партнерскую программу?

    Напишите нам на почту cd@rlsnet.ru.
  • Кто может стать партнером?

    Юридические лица, подписавшие договор с РЛС®.