Интеграция с внешней лабораторией #40117 (в работе)

1. Общая настройка для интеграций с внешними лабораториями

Основной настройкой интеграции является настройка параметров обмена в внешней лаборатории справочника "Лаборатории ЛПУ".  В зависимости от требований интеграций и способов обмена с интеграционными сервисами можно выделить основные поля для заполнения и те, которые заполняются не для всех интеграций

Настройка лаборатории

В справочник «Лаборатории ЛПУ» (Справочники - Лаборатория - Лаборатории ЛПУ) необходимо добавить внешнюю лабораторию и произвести соответствующие настройки (Рисунок 1).

Рисунок 1.

К основным настройкам относятся:

1. Наименование – поле обязательное к заполнению. Заполнить можно произвольно, на механизмы интеграции не влияет.

2. Лаборатория внешняя – признак, который необходимо включить. Открывает доступ к настройкам интеграционных сервисов.

3. Адрес сервиса – адрес для выгрузки заявок. Актуальность адреса следует уточнять у представителей внешней лаборатории.

4. Метод формирования заявки – выбрать соответствующий метод, обычно одноименный

Остальные пункты могут использоваться/не использоваться в зависимости от требований интеграции. Требования к заполнению полей указаны в отдельных инструкциях по каждой интеграции

Для автоматического формирования заявок на основании заказов на платные услуги, необходимо в параметрах ЛПУ, на вкладке «Касса» включить настройку «Внешняя лаборатория» (Рисунок 2). Данная настройка позволяет создавать направления без вызова мастера направлений на лабораторные исследования

Рисунок 2.

2. Принцип работы с внешними лабораториями в КСАМУ:

этапы работы с интеграцией:

Загрузка справочников

Создание направлений

Обработка заявок

Выгрузка обработанных заявок

Получение результатов исследований
 

Загрузка справочников

Для того, чтобы у врача была возможность назначить пациенту лабораторное исследование, выполняемое в внешней лаборатории, необходимо синхронизировать справочники лабораторных исследований. Для этого следует открыть журнал заявок во внешнюю лабораторию (Документы – Лаборатория – Заявки для внешней лаборатории). В журнале следует нажать кнопку «Синхронизация справочников» (Рисунок 3).

Рисунок 3.

После выполнения синхронизации в справочнике лабораторных исследований в лаборатории, в которой корректно указаны интеграционные данные, появятся новые позиции (Рисунок 4).

Рисунок 4.

Помимо синхронизации справочников лабораторных исследований следует проверить другие справочники, используемые в интеграции, например справочник биоматериалов, контейнеров, услуг.

Создание направлений

Направление на исследование оформляется врачом стандартным способом ссылка на инструкцию 

В некоторых интеграциях при отправке заявок может понадобиться указать ответы на вопросы, которые могут потребоваться при выполнении некоторых анализов. Заполнить опросник можно в мастере назначения анализов, направлении и заявке во внешнюю лабораторию. Логично предположить, что опрашивать пациента будет или врач или регистратор, а не сотрудник процедурного кабинета, поэтому перед созданием направления необходимо проверить вкладку "Опросник".

Обработка заявок

Заполнение заявки.

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

"

Описание вкладок заявки

"

В каждой заявке необходимо проверить корректность заполненных данных, например, проверить выбор биоматериала, контейнера, заполнение кода пробирки если требуется в рамках конкретной интеграции и т.п. Если рабочее место оборудовано принтером этикеток, из заявки можно распечатать этикетки для размещения на контейнере с биоматериалом (Рисунок 10).

Рисунок 10.

Выгрузка заявок.

Заполненные и проверенные заявки отправляются во внешнюю лабораторию. Для этого в журнале заявок необходимо нажать кнопку «Заполнить» и в открывшемся списке выбрать пункт «Выгрузка заявок» (Рисунок 12)

Рисунок 12.

Выгружаются только подписанные заявки и только те, которые отображаются по установленным в журнале фильтрам.

Например, за конкретный установленный период или по конкретному пациенту.

В журнале отображаются: статус отправки заявок, статус обработки и статус получения результата. Так же отображается текст ошибки, при наличии (Рисунок 13). Пояснения о тексте ошибок и статусах обработки следует узнавать у представителей внешней лаборатории.

Рисунок 13.

Для повторной отправки заявки, необходимо либо открыть заявку, снять признак «Отправлено в КДЛ», подписать заявку, либо назаявке, которую требуется переотправить щелкунуть правой кнопкой мыши и выбрать "убрать отметку отправки" и повторить выгрузку, как описано выше.

В журнале есть возможность включить логирование. (Рисунок 14):

Рисунок 14.

Если сохранение логов включено, то при отправке заявок на каждую заявку будет формироваться файл. Эти файлы можно, при необходимости, передавать разработчикам для анализа ошибок. Файлы сохраняются в папку KSAMU (Рисунок 15) и могут называться по разному, в зависимости от интеграции. При закрытии журнала заявок, сохранение лога автоматически отключается.

Рисунок 15.

Получение результатов исследований

Получение результатов по отправленным заявкам производится в ручном режиме, для этого в журнале заявок необходимо нажать кнопку «Заполнить» и в открывшемся списке выбрать пункт «Загрузка результатов» (Рисунок 18):

Рисунок 18.

Врач, назначивший исследование, может просмотреть полученный результат и распечатать его стандартным способом

3. Нюансы разных интеграций:

ЦКЛ:

1. Используется web-сервис
2. Настройка лаборатории:
   

   

3. Формат номера заявки ЦКЛ:
После заполнения необходимо документ подписать и закрыть. Заявке автоматически присвоится номер в формате YYNNNGGGGG, где YY -последние две цифры года, NNN – последние три цифры кода МО, GGGGG – номер заявки в текущем году. В примере: 2022 год, организация с кодом МО, заканчивающимся на 007, заявка 00022.

При необходимости можно в настройках лаборатории изменить значение NNN для формирования заявки. Такой функционал бывает нужен в случаях, когда в МО более одного сервера (более одной рабочей базы). Для этого в настройках лаборатории ЦКЛ необходимо установить признак «Контракт в номере заявки» и в поле «контракт» ввести значение, которое будет подставляться в заявку в блок NNN (Рисунок 11).

4. Особенности интеграции с ЦКЛ:

ВАЖНО! При обработке заявки на стороне ЦКЛ производится проверка не только по коду элемента справочника, но и по наименованию. Несовпадение в названии одного символа приведёт к ошибке выгрузки заявки. Также, обязательным условием отправки заявки является заполнение паспортных данных, полиса, СНИЛС и фактического адреса проживания пациента.

Большинство из используемых справочников - федеральные (перечень федеральных справочников можно проверить по ссылке http://nsi.ffoms.ru/).

Справочник F002 - «Реестр СМО». В КСАМУ: Справочники – Организации – Страховые организации. Пример ошибки: Value 09050 АО "МАКС-М" Карачаево-Черкесская Республика is not allowed for Enumeration|Set Type userField [UserFieldCode:POLIS_SMO]

Необходимо вручную скорректировать наименование СМО в справочнике КСАМУ.

Ошибки при обновлении справочников:

При успешном завершении синхронизации справочников дополнительных действий пользователей не требуется.

Рисунок 5.

При недоступности сервиса, появится следующая ошибка:

Рисунок 6.

Ошибка говорит о недоступности сервиса, с которым МИС КСАМУ пытается связаться. Зачастую причина заключается в полной недоступности сервиса. 

Алгоритм действий при получении подобной ошибки:

1)    Проверьте интернет соединение.

2)    Проверьте подключение по защищенной сети с внешней лабораторией.

3)    Проверьте доступность сервиса внешней лаборатории в браузере по адресу, указанному в ошибке. (Адрес можно скопировать из настроек лаборатории в МИС КСАМУ)

Если при выполнении п.3 адрес доступен – попытайтесь синхронизировать справочники ещё раз. Если адрес не доступен – свяжитесь с техническими специалистами внешней лаборатории, опишите проблему.

 Также можно получить следующую ошибку: об обрыве сети при синхронизации справочников.

Рисунок 7.

Решение - повторите действия, связанные с недоступностью сервиса.

Аналогичные сообщения об ошибках при синхронизации выдаются оператору, запустившему синхронизацию.

Важным моментом является выбор типа оплаты исследований ЦКЛ (Рисунок 9). 

ОМС – оплата выполненного исследования производится из средств ОМС в сторону ЦКЛ.

Платные услуги – исследование выполняется за счёт средств МО в сторону ЦКЛ.

В каждой заявке необходимо проверить корректность заполненных данных, и на вкладке «Данные заявки» вписать с клавиатуры или отсканировать штрих-код пробирки в столбец «Код пробирки». Если рабочее место оборудовано принтером этикеток, можно сгенерировать штрих-код кнопкой «Пронумеровать» и распечатать для размещения на контейнере с биоматериалом (Рисунок 10).

Для некоторых лабораторных исследований, заказываемых во внешней лаборатории, критична информация:

1)    фаза цикла;

2)    неделя беременности;

3)    код контингента.

Все эти данные возможно указать на вкладке «Основная информация» (Рисунок 16):

5. Ошибки:

 Наименование страховой компании не соответствует справочнику F002:Рисунок 19.

Решение -Изменить наименование страховой организации (см. пункт 2 «Синхронизация и проверка справочников» инструкции).

2. Для пробы указан недопустимый биоматериал с кодом 5. Для данной пробы допустимый биоматериал с кодом 208.Рисунок 20.

Решение – изменить в заявке биоматериал на допустимый, либо менять номер пробирки

Объяснение: в одном контейнере не может быть двух биоматериалов (например, кровь и моча не собираются в одну пробирку), поэтому если в заявке у двух различных биоматериалов указан один номер контейнера, программа выдаст ошибку, указанную на фотографии выше. Нужно либо менять биоматериал на допустимый, либо менять номер пробирки (Рисунок 20).

Рисунок 21.

3.     В табличной части «Оказанные услуги» ошибка! Поле направление не заполнено.
Рисунок 22.

Причина возникновения – удаление документа направления, попавшего в заявку в внешнюю лабораторию.

Рисунок 23.

Решение:

1. Очистить табличную часть «Внешние документы» от лишних записей.
2. Очистить табличную часть «Данные заявки» от незаказанных услуг.

4.     Заявки, выделенные красным цветом. 

В случае заказа не актуальной услуги внешней лаборатории заявка в журнале выделяется цветом.

Рисунок 24.

В случае открытия такой заявки появляется предупреждающее окно:

Рисунок 25. Внешние документы

Рисунок 26.

В табличной части «Внешние документы» проблемное направление будет выделено цветом.

Цветом выделяются направления, в которых заказаны услуги, отсутствующие в справочнике внешней лаборатории. Проверка в КСАМУ проводится после синхронизации справочника с внешней лабораторией, то есть после получения МИС КСАМУ актуального справочника внешней лаборатории. 

Решение:

1. Провести синхронизацию справочников.
2. Уведомить врача, оформившего направление о необходимости создать новое направление.
3. Удалить старое направление из таблицы «Внешние документы».
4. Удалить не актуальную услугу из таблицы «Данные заявки».
5. Если заявка не подписана и случай не закрыт, новое направление в заявку попадёт автоматически.
6. Если заявка подписана или случай (талон) закрыт, или направление оформляется из нового случая (талона), направление попадёт в новую заявку и его нужно обработать отдельно.

Если новое направление обязано быть в старой заявке, то его возможно отобрать в заявку в ручную.

Рисунок 28.

5. Результаты пришли, но пустые:

Рисунок 28. БракВ данном случает в результате стоит пометка о выбраковке пробы - гемолиз. То есть из-за брака исследование не было проведено - соответственно результат пустой.

6. Пользователь пытается изменить состав исследований после доставки проб в лабораторию.

Рисунок 29.

Так как пробы были доставлены и приняты в работу, то изменения состава исследований уже запрещены. Если заказчик "передумал" после доставки проб и принятия их в работу лабораторией, то необходимо делать новые заявки с новыми пробами и составом исследований. Если ни одна проба в заявке не доставлена, то изменения состава исследований или тестов в заявке возможны. После доставки хотя бы одной пробы в заявке в лабораторию заказчику остаётся только ждать результатов тех исследований и тестов, которые он запросил в заявке до доставки проб.

7. Сообщения при синхронизации справочников.

С версии МИС КСАМУ 21331 добавлено логирование синхронизации справочников в истории действий пользователя. История действий пользователя доступна по пути в МИС КСАМУ: Сервис -> Администрирование -> История действий пользователя.

7.1. Сообщение при успешной синхронизации:

Рисунок 30.

При таком завершении синхронизации справочников дополнительных действий пользователей не требуется

7.2. Сообщение о недоступности сервиса: 

Рисунок 31.

Ошибка говорит о полном недоступности сервиса, с которым МИС КСАМУ пытается связаться. Зачастую причина заключается в полной недоступности сервиса.  

Алгоритм действий при получении подобной ошибки:

1. Проверьте интернет соединение.
2. Проверьте подключение по защищенной сети с внешней лабораторией.
3. Проверьте доступность сервиса внешней лаборатории в браузере по адресу, указанному в ошибке. (Адрес можно скопировать из настроек лаборатории в МИС КСАМУ)

Если при выполнении п.3 адрес доступен – попытайтесь синхронизировать справочники ещё раз. Если адрес не доступен – свяжитесь с техническими специалистами внешней лаборатории, опишите проблему.

7.3. Сообщение об обрыве сети при синхронизации справочников:

Рисунок 32.

Повторите действия, описанные в пункте 7.2.

Аналогичные сообщения об ошибках при синхронизации выдаются оператору, запустившему синхронизацию. 

Рисунок 33.

8. Статус обработки "Не указан адрес проживания/регистрации", заявка не отправляется. 

Проверить разбивку по КЛАДР

Рисунок 34.

Нажать на многоточие и проверить заполнение полей, при пустых полях, нажать "Разделить" и сохранить изменения.

Рисунок 35.

Попробовать еще раз выгрузить заявку.

9. Сервис ЦКЛ был недоступен в момент отправки заявки.

Рисунок 36.

Необходимо повторно отправить заявку. 
Для этого необходимо зайти в заявку, которую вы хотите повторно отправить. Убрать галочку в чекбоксе "отправка в КДЛ".

Рисунок 37.

Подписать и закрыть документ.

Рисунок 38.

И выгрузите заявку повторно.

Рисунок 39.

10. Неизвестная внутрення ошибка, обратитесь к разработчику.

В данному случае необходимо чтоб клиент уточнял проблемы по данной заявке у исполнителя.

Биотест:

ЦКЛ и Биотест используют одну платформу Innovasystems, поэтому большая часть настроек, особенностей и ошибок будет идентична, различается формат номера заявки Биотест

Формат заявки Биотест:
После заполнения необходимо документ подписать и закрыть. Заявке автоматически присвоится номер в формате ZZZDDMMYYGGG, где ZZZ – код региона филиала, DDMMYY – день, месяц, год формирования заявки, GGG – номер заявки в текущий день. 

КДЛ Домодедово:

1. Используется ftp-сервер
2. Настройка лаборатории

Нюанс. У анализов активно используется признак обязательности у биоматериалов и контейнеров.
Биоматериалы. Если признак обязательности не установлен ни у одного биоматериала, галочка "по умолчанию" присваивается первому загруженному. Е

Интеграция на текущий момент с анализами, в которых несколько обязательных биоматериалов работает только с галочкой в ЛПУ-Касса-генерировать направление из заказа на оплату.

Требование к функции маркировки биоматериала

Количество распечатываемых этикеток должно соответствовать количеству контейнеров для биоматериала, определенных модулем интеграции и присутствующих в заявке.2.     В рамках одной заявки все контейнеры маркируются в соответствии со следующими правилами: Если номер заявки состоит из 10 знаков, то для каждого контейнера печатается отдельная этикетка с одинаковым номером заявки, с добавлением одиннадцатого и двенадцатого знаков в конце, которые обозначают порядковый номер контейнера (от 01 до 99) в рамках одной заявки. Каждый биоматериал, перечисленный в справочнике локусов должен получить отдельный порядковый номер в рамках номера заявки. Порядковый номер контейнерам присваивается динамически, без привязки конкретного биоматериала к конкретному порядковому номеру.

Инвитро:

1. Сервис: Интеграционный модуль ИНВИТРО, представляющий собой приложение invitroscape и ssl сертификат, отправка и загрузка заявок возможна только на компьютере, на котором они установлены
2. Нюансы настройки лаборатории:
   

   
   
   

   
   

Результаты заявок через включенный сервис загружаются в папку C:\Invitro\Results, откуда уже по кнопке загрузки результатов загружаются в КСАМУ

Ситилаб:

1. Используется веб-сервис http://labhostname/websync.asmx (может меняться в зависимости от региона) 

2. Настройки лаборатории

а Этикетку выводится информация из поля "контрагент" из справочникиа "Лаборатории ЛПУ"