Skip to main content

Интеграция с ЦКЛ (Innovasystems)

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

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

1.pngРисунок 1. Лаборатория ЦКЛ

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

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

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

Порт – порт, по которому происходит подключение к сервису. Актуальность следует уточнять у представителей ЦКЛ.

Логин и пароль – на данный момент для интеграции с ЦКЛ не используются.

Незаполненные поля на данный момент для интеграции с ЦКЛ не используются.

Заказчик – следует указывать код МО. Посмотреть его можно в параметрах ЛПУ.

Метод формирования заявки – для ЦКЛ следует выбирать из списка значение INNOVASYSTEM

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

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

3.pngРисунок 2. Синхронизация справочников

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

4.pngРисунок 3. Исследования лаборатории ЦКЛ

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

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

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

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

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

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

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

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

24.pngРисунок 4. Успешная синхронизация

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

25.pngРисунок 5. Сервис недоступен

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

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

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

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

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

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

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

26.pngРисунок 6. Обрыв сети

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

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

27.pngРисунок 7. Обрыв сети, сообщение оператору

Оформление направления

Направление на исследование оформляется врачом стандартным способом. Описание процесса назначения есть в справке КСАМУ (F1).

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

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

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

5.pngРисунок 8. Направление на исследование

Проверка и отправка заявок

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

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

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

6.pngРисунок 9. Код пробирки в заявке

Формат номера заявки

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

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

7.pngРисунок 10. Контракт в номере заявки

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

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

8.pngРисунок 11. Выгрузка заявок ЦКЛ

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

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

9.pngРисунок 12. Журнал заявок для внешней лаборатории

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

Начиная с версии КСАМУ 16522, в журнале заявок можно включить логирование. (Рисунок 13):

10.pngРисунок 13. Логирование заявок

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

11.pngРисунок 14. Файлы запроса

Начиная с версии КСАМУ 18821 в журнале заявок для внешней лаборатории реализована фильтрация по дате подписи документа (Рисунок 15). Таким образом, методом выбора из выпадающего списка, фильтрация заявок для отображения в журнале возможна:

·        по дате создания;

·        по дате подписи.

12.pngРисунок 15. Фильтр по дате

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

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

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

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

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

13.pngРисунок 16. Вкладка "Основная информация"

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

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

14.pngРисунок 17. Загрузка результатов

Врач, назначивший исследование, может просмотреть полученный результат и распечатать его стандартным способом, описанным в справке КСАМУ (F1).

Возможные ошибки

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

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

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

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

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

17.pngРисунок 20.

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

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

28.pngРисунок 22.

Решение:

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

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

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

20.pngРисунок 23. Заявки с неактуальными анализами

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

21.pngРисунок 24. Окно ошибки

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

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

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

Решение:

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

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

23.pngРисунок 26. Журнал направлений на исследование

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

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

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

image.png

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

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

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

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

изображение.png

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

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

изображение.png

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

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

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

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

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

изображение.png

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

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

изображение.png

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

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

изображение.pngimage.png

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

image.png

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