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

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

Чтобы выполнить поиск и привязку пользовательского номенклатурного набора в Номенклатуре РЛС, нужно загрузть файл в формате MS Excel на обработку. В списке позиций, необходимо указать уникальный код строки (ОБЯЗАТЕЛЬНО В ПЕРВОЙ КОЛОНКЕ!), торговое название, лекарственную форму, дозировку, упаковку, количество, штрихкод и прочие атрибуты, как можно более точно описывающие номенклатурную позицию. Атрибуты, малозначимые для точной идентификации позиций (цены, даты и др.), указывать не нужно. Кроме того, не следует использовать списки длиннее 25000 позиций и шире 10 колонок, а также передавать файлы, содержащие более трех листов.

   

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

  • packing_id – идентификатор уровня товарной упаковки. Главный идентификатор номенклатурной позиции (integer);
  • desc_id – ID описания препарата из блока Описания (метод library_description) (integer);
  • prep_id – идентификатор уровня препарата (integer);
  • trade_name_id – идентификатор торгового названия (integer);
  • trade_name_rus – торговое название (string);
  • trade_name_rus_html – торговое название в HTML-формате. Может включать знаки зарегистрированной торговой марки (string);
  • lat_name_id – идентификатор оригинального торгового названия (integer);
  • lat_name – оригинальное торговое название, например, на английском языке (string);
  • dosage_form_id – идентификатор формы выпуска (integer);
  • dosage_form_full_name – форма выпуска в полном виде (string);
  • dosage_form_short_name – форма выпуска в сокращенном виде. Например, "р-р для в/в и в/м введ." - раствор для внутривенного и внутримышечного введения (string);
  • dose – дозировка. Например, "0,1%", "0.3 мг+5 мг/мл" (string);
  • dosage_form_size – размерная характеристика препарата. Допустима форма записи любой сложности, например, с указанием длины, ширины, кодов размеров и т.д. (string);
  • dose_amount – количество доз в упаковке (integer);
  • pack_dosage – объем/масса упаковки. Например, "500 мл", "200 г" (string);
  • pack1_id – идентификатор названия упаковки первого уровня (integer);
  • pack1sn – сокращенное название первичной упаковки. Например, "фл. д/кровезам." - флакон для кровезаменителей (string);
  • pack1n – полное название первичной упаковки. Например, "флакон для кровезаменителей" (string);
  • amount1 – количество элементов в первичной упаковке. Например, количество таблеток в блистере (integer);
  • pack2_id – идентификатор названия упаковки второго уровня (integer);
  • pack2sn – сокращенное название вторичной упаковки. Например, "уп. контурн. пластик. (поддоны)" - упаковка контурная пластиковая (поддоны) (string);
  • pack2n – полное название вторичной упаковки. Например, "упаковка контурная пластиковая (поддоны)" (string);
  • amount2 – количество элементов во вторичной упаковке. Например, количество блистеров в картонной пачке (integer);
  • pack3_id – идентификатор упаковки третьего уровня (integer);
  • pack3sn – сокращенное название упаковки третьего уровня. Например, "пач. картон." - пачка картонная (string);
  • pack3n – полное название упаковки третьего уровня. Например, "пачка картонная" (string);
  • amount3 – количество элементов в упаковке третьего уровня. Например, количество пачек картонных в картонной коробке (integer);
  • packing_short – описание товарной упаковки в сокращенном виде. Включает в себя первичную упаковку, количество первичных упаковок, вторичную упаковку, количество вторичных упаковок, упаковку третьего уровня. Например, "амп. 2 мл (5) - уп. контурн. пластик. (поддоны) (2) - пач. картон.". Здесь внутри картонной пачки находятся две пластиковые контурные упаковки, каждая из которых содержит 5 ампул по 2 мл (string);
  • packing_full – описание товарной упаковки в полном виде. Включает в себя первичную упаковку, количество первичных упаковок, вторичную упаковку, количество вторичных упаковок, упаковку третьего уровня. Например, "ампулы 2 мл (5) - упаковка контурная пластиковая (поддоны) (2) - пачка картонная". Здесь внутри картонной пачки находятся две пластиковые контурные упаковки, каждая из которых содержит 5 ампул по 2 мл (string);
  • as_id – идентификатор действующего вещества (integer);
  • as_name_rus – название действующего вещества на русском языке (string);
  • producer_id – идентификатор фирмы-производителя (integer);
  • producer_tran – название фирмы-производителя на русском языке (string);
  • producer_orig – оригинальное название фирмы-производителя (string);
  • producer_country_id – код страны фирмы-производителя (integer);
  • producer_country – страна фирмы-производителя (string);
  • packer_id – идентификатор фирмы-упаковщика (integer);
  • packer_tran – название фирмы-упаковщика на русском языке (string);
  • packer_orig – оригинальное название фирмы-упаковщика (string);
  • packer_country_id – код страны фирмы-упаковщика (integer);
  • packer_country – страна фирмы-упаковщика (string);
  • amount – общее количество таблеток/ампул (integer);
  • barcode – штрихкод (string);
  • dfc_id – идентификатор лекарственной характеристики (integer);
  • dfc_full_name – характеристика в полном виде (string);
  • dfc_short_name – характеристика в сокращенном виде (string);
  • completeness_id – идентификатор комплектации (integer);
  • completeness_name – комплектация в полном виде (string);
  • completeness_short_name – комплектация в сокращенном виде. Например, "с крышк.-капельн." - с крышкой-капельницей (string);
  • reg_id – идентификатор регистрационного удостоверения (integer);
  • reg_number – номер регистрационного удостоверения (string);
  • reg_date – дата регистрации (date);
  • reg_cancel_date – дата прекращения действия регистрации (date);
  • reg_status_id – код статуса регистрационного удостоверения (integer);
  • reg_status – статус регистрационного удостоверения. "Действует", "Истек срок", "Аннулировано" (string);
  • registrator_id – ID фирмы-регистратора (integer);
  • registrator_tran – название фирмы-регистратора на русском языке (string);
  • registrator_orig – оригинальное название фирмы-регистратора (string);
  • registrator_country_id – код страны фирмы-регистратора (integer);
  • registrator_country – страна фирмы-регистратора (string);
  • ntfr_id – код классификатора НТФР (integer);
  • ntfr_name – название класса НТФР (string);
  • lt_id – ID срока хранения (integer);
  • lt_name – срок хранения (string);
  • lt_month – срок хранения в месяцах (decimal number);
  • lte_name – срок хранения (расширенное поле) (string);
  • sc_id – ID условий хранения (integer);
  • sc_name – условия хранения (string);
  • sc_short_name – условия хранения в сокращенной форме (string);
  • sc_text – условия хранения (расширенное поле) (string);
  • actdate – дата актуализации записи (date);
  • weight – оценка соответствия поисковому запросу (decimal number).

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

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

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

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

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

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

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

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

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

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

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

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

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

    Если возникли вопросы, напишите на почту sales@rls-aurora.ru.
  • Что такое гармонизация и как ее провести?

    Гармонизация — способ привязки пользовательских номенклатурных позиций к номенклатурным позициям РЛС®.

    Пользовательская номенклатурная позиция может быть описана произвольно, но желательно максимально полно.

    Например, при запросе "Контрактубекс" подаем на вход метода гармонизации номенклатурный метод inventory_brief с параметром pos:

    /api/inventory_brief?pos=Контрактубекс

    В ответ система присылает две позиции:

                          <ArrayOfBrief_inventory xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                          <brief_inventory>
                            <packing_id>21139</packing_id>
                            <desc_id>48387</desc_id>
                            <prep_id>6853</prep_id>
                            <prep_short>КОНТРАКТУБЕКС гель д/наружн. прим.</prep_short>
                            <prep_full>КОНТРАКТУБЕКС гель для наружного применения</prep_full>
                            <packing_short>туб. алюм. 50 г - пач. картон.</packing_short>
                            <packing_full>туба алюминиевая 50 г - пачка картонная</packing_full>
                            <barcode>4008491309783, 4046222309787</barcode>
                            <firms_id>1020</firms_id>
                            <firms>Мерц Фарма ГмбХ и Ко. КГаА (Германия)</firms>
                            <as_id>681</as_id>
                            <as_name_rus>Аллантоин + Гепарин натрия + Лука репчатого луковиц экстракт</as_name_rus>
                            <reg_id>7322</reg_id>
                            <reg_status_id>2</reg_status_id>
                            <registration>П N015096/01 (16.07.2010) - Мерц Фарма ГмбХ и Ко. КГаА (Германия) - действует</registration>
                            <ntfr_id>4</ntfr_id>
                            <ntfr_name>Лекарственные средства</ntfr_name>
                            <lifetime_text>4 года</lifetime_text>
                            <lifetime_month>48.00</lifetime_month>
                            <sc_short>Сух., t не выше 25 °C</sc_short>
                            <sc_text>В сухом месте, при температуре не выше 25 °C</sc_text>
                            <actdate>2020-01-13T00:00:00</actdate>
                            <weight>180</weight>
                            <dosage_form_id>60</dosage_form_id>
                            <dosage_form_full_name>гель для наружного применения</dosage_form_full_name>
                          </brief_inventory>
    
                          <brief_inventory>
                            <packing_id>21138</packing_id>
                            <desc_id>48387</desc_id>
                            <prep_id>6853</prep_id>
                            <prep_short>КОНТРАКТУБЕКС гель д/наружн. прим.</prep_short>
                            <prep_full>КОНТРАКТУБЕКС гель для наружного применения</prep_full>
                            <packing_short>туб. алюм. 20 г - пач. картон.</packing_short>
                            <packing_full>туба алюминиевая 20 г - пачка картонная</packing_full>
                            <barcode>4008491309790, 4046222309794</barcode>
                            <firms_id>1020</firms_id>
                            <firms>Мерц Фарма ГмбХ и Ко. КГаА (Германия)</firms>
                            <as_id>681</as_id>
                            <as_name_rus>Аллантоин + Гепарин натрия + Лука репчатого луковиц экстракт</as_name_rus>
                            <reg_id>7322</reg_id>
                            <reg_status_id>2</reg_status_id>
                            <registration>П N015096/01 (16.07.2010) - Мерц Фарма ГмбХ и Ко. КГаА (Германия) - действует</registration>
                            <ntfr_id>4</ntfr_id>
                            <ntfr_name>Лекарственные средства</ntfr_name>
                            <lifetime_text>4 года</lifetime_text>
                            <lifetime_month>48.00</lifetime_month>
                            <sc_short>Сух., t не выше 25 °C</sc_short>
                            <sc_text>В сухом месте, при температуре не выше 25 °C</sc_text>
                            <actdate>2020-01-13T00:00:00</actdate>
                            <weight>180</weight>
                            <picname>193.gif</picname>
                            <dosage_form_id>60</dosage_form_id>
                            <dosage_form_full_name>гель для наружного применения</dosage_form_full_name>
                          </brief_inventory>
                          </ArrayOfBrief_inventory>
                          

    В каждой позиции указан вес релевантности <weight>180</weight>.

    Если указать более точный входной запрос, например "Контрактубекс 50 г":

    /api/inventory_brief?pos=Контрактубекс_50г

    То система также вернет две позиции, но позиция <packing_id>21139</packing_id> будет иметь вес <weight>230</weight>, т.к. дополнительно совпадет объем тубы, а позиция <packing_id>21138</packing_id> только <weight>180</weight>. Таким образом, выбрав из предложенных вариантов первый, мы получим более точное совпадение. Из этих номенклатурных позиций РЛС можно получить полезный атрибут <desc_id>48387</desc_id>, с которым можно обратиться в метод получения текста описания:

    /api/library_solid_description?desc_id=48387.

    Таким образом, подписчик должен создать программу, которая:

    1) последовательно запись за записью передает пользовательскую номенклатурную строку в метод гармонизации с параметром posfirm, если есть) — api/inventory_brief?pos=...&firm=...;

    2) автоматически выбирает из результирующих записей первый, самый подходящий вариант или предоставляет эксперту возможность выбрать вариант из предложенных;

    3) сохраняет в собственной базе данных в специальных таблицах соответствие польз_номен_ID <-> packing_id и польз_номен_ID <-> desc_id.

    Для обращения к системе будут использованы коды РЛС® Авроры из этих таблиц соответствий. Таким образом, подписчик проводит гармонизацию при помощи поискового метода Авроры и результаты гармонизации сохраняются только у подписчика.

    Если не хочется заниматься с номенклатурой РЛС®, а также учитывая, что не каждая номенклатурная позиция РЛС® имеет ссылку на описание/инструкцию, то методом /api/library_solid_description (БЕЗ ПАРАМЕТРОВ!) можно получить полный список доступных через сервис описаний со ссылками desc_id. Затем необходимо привязать этот список к пользовательской номенклатуре самостоятельно, например, просматривая два списка.

  • Как установить соответствие между старыми (Номенклатура++ и др.) и новыми кодами РЛС®?

    Соответствие новых номенклатурных кодов packing_id и старых номенклатурных кодов NOMEN.ID определяется набором данных mapping_nomenid.
  • Как привязать номенклатуру товаров к другим справочникам?

    Для связки необходимо использовать метод гармонизации с параметрами pos и firms /Help/Api/GET-api-inventory_complete_pos_firm.
  • В течение какого времени я получу файл соответствия?

    Файл соответствия в зависимости от его размеров вы получите примерно через 2 часа (25 000 записей) после оплаты.
  • Почему в тестовом режиме я не могу найти соответствия для старого кода в mapping_nomenid?

    В тестовом режиме возвращаются данные, соответствующие позициям с packing_id, кратным 100. Вполне вероятно, что нужная позиция не имеет соответствия, кратного 100, поэтому не видна в тестовом режиме.
  • Как вступить в партнерскую программу?

    Напишите нам на почту sales@rls-aurora.ru.
  • Кто может стать партнером?

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