# Интеграция Innovasystems (ЦКЛ, Биотест)
## Настройка лаборатории
В справочник «Лаборатории ЛПУ» (Справочники - Лаборатория - Лаборатории ЛПУ) необходимо добавить лабораторию ЦКЛ и произвести соответствующие настройки (Рисунок 1).
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/38c1.png)Рисунок 1.
**Наименование** – поле обязательное к заполнению. Заполнить можно произвольно, на механизмы интеграции не влияет.
**Лаборатория внешняя** – признак, который необходимо включить. Открывает доступ к настройкам интеграционных сервисов.
**Адрес сервиса** – адрес для выгрузки заявок. **Актуальность адреса следует уточнять у представителей ЦКЛ или Биотест.**
**Порт** – порт, по которому происходит подключение к сервису. **Актуальность следует уточнять у представителей ЦКЛ или Биотест.**
**Логин и пароль** – на данный момент для интеграции с innova не используются.
Незаполненные поля на данный момент для интеграции с innova не используются.
**Заказчик** – следует указывать код МО. Посмотреть его можно в параметрах ЛПУ.
**Метод формирования заявки** – для ЦКЛ и Биотест следует выбирать из списка значение INNOVASYSTEM
Для автоматического формирования заявок на основании заказов на платные услуги, необходимо в параметрах ЛПУ, на вкладке «Касса» включить настройку «Внешняя лаборатория» (Рисунок 2)
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-10/euwimage.png)
Рисунок 2.
## Синхронизация и проверка справочников
Для того, чтобы у врача была возможность назначить пациенту лабораторное исследование, выполняемое в ЦКЛ, необходимо синхронизировать справочники лабораторных исследований. Для этого следует открыть журнал заявок во внешнюю лабораторию (Документы – Лаборатория – Заявки для внешней лаборатории). В журнале следует нажать кнопку «Синхронизация справочников» (Рисунок 3).
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/CyJ3.png)Рисунок 3.
После выполнения синхронизации в справочнике лабораторных исследований появятся новые позиции (Рисунок 4).
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/S1J4.png)Рисунок 4.
Помимо синхронизации справочников лабораторных исследований следует проверить другие справочники, используемые в интеграции.
**ВАЖНО!** При обработке заявки на стороне ЦКЛ производится проверка не только по коду элемента справочника, но и по наименованию. Несовпадение в названии одного символа приведёт к ошибке выгрузки заявки. Также, обязательным условием отправки заявки является заполнение паспортных данных, полиса, СНИЛС и фактического адреса проживания пациента.
Большинство из используемых справочников - федеральные (перечень федеральных справочников можно проверить по ссылке [http://nsi.ffoms.ru/](http://nsi.ffoms.ru/)).
Справочник **F002 -** «Реестр СМО». В КСАМУ: Справочники – Организации – Страховые организации. Пример ошибки: Value 09050 АО "МАКС-М" Карачаево-Черкесская Республика is not allowed for Enumeration|Set Type userField \[UserFieldCode:POLIS\_SMO\]
Необходимо вручную скорректировать наименование СМО в справочнике КСАМУ.
Сообщения при синхронизации справочников
С версии МИС КСАМУ 21331 добавлено логирование синхронизации справочников в истории действий пользователя. История действий пользователя доступна по пути в МИС КСАМУ: Сервис -> Администрирование -> История действий пользователя.
При успешном завершении синхронизации справочников дополнительных действий пользователей не требуется.
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/WWR24.png)Рисунок 5.
При недоступности сервиса, появится следующая ошибка:
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/wFK25.png)Рисунок 6.
Ошибка говорит о недоступности сервиса, с которым МИС КСАМУ пытается связаться. Зачастую причина заключается в полной недоступности сервиса.
Алгоритм действий при получении подобной ошибки:
1\) Проверьте интернет соединение.
2\) Проверьте подключение по защищенной сети с внешней лабораторией.
3\) Проверьте доступность сервиса внешней лаборатории в браузере по адресу, указанному в ошибке. (Адрес можно скопировать из настроек лаборатории в МИС КСАМУ)
Если при выполнении п.3 адрес доступен – попытайтесь синхронизировать справочники ещё раз. Если адрес не доступен – свяжитесь с техническими специалистами внешней лаборатории, опишите проблему.
Также можно получить следующую ошибку: об обрыве сети при синхронизации справочников.
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/tBL26.png)Рисунок 7.
Решение - повторите действия, связанные с недоступностью сервиса.
Аналогичные сообщения об ошибках при синхронизации выдаются оператору, запустившему синхронизацию.
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/vla27.png)Рисунок 8.
## Оформление направления
Направление на исследование оформляется врачом стандартным способом. Описание процесса назначения есть в справке КСАМУ (F1).
Важным моментом является выбор типа оплаты исследований ЦКЛ (Рисунок 9).
ОМС – оплата выполненного исследования производится из средств ОМС в сторону ЦКЛ.
Платные услуги – исследование выполняется за счёт средств МО в сторону ЦКЛ.
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/ssX5.png)Рисунок 9.
## Проверка и отправка заявок
### Заполнение заявки.
При оформлении направления на исследования, выполняемые в ЦКЛ, автоматически создаётся заявка. Заявки хранятся в журнале заявок. (Документы – Лаборатория – Заявки для внешней лаборатории). После создания заявки заполнены частично и требуют окончательного заполнения сотрудником. Логично предположить, что выполнять проверку и отправку будет сотрудник процедурного кабинета после взятия биоматериала у пациента, однако решение о назначении данных обязанностей принимается в каждой МО индивидуально.
В каждой заявке необходимо проверить корректность заполненных данных, и на вкладке «Данные заявки» вписать с клавиатуры или отсканировать штрих-код пробирки в столбец «Код пробирки». Если рабочее место оборудовано принтером этикеток, можно сгенерировать штрих-код кнопкой «Пронумеровать» и распечатать для размещения на контейнере с биоматериалом (Рисунок 10).
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/7DU6.png)Рисунок 10.
### Формат номера заявки ЦКЛ
После заполнения необходимо документ подписать и закрыть. Заявке автоматически присвоится номер в формате YYNNNGGGGG, где YY -последние две цифры года, NNN – последние три цифры кода МО, GGGGG – номер заявки в текущем году. В примере: 2022 год, организация с кодом МО, заканчивающимся на 007, заявка 00022.
При необходимости можно в настройках лаборатории изменить значение NNN для формирования заявки. Такой функционал бывает нужен в случаях, когда в МО более одного сервера (более одной рабочей базы). Для этого в настройках лаборатории ЦКЛ необходимо установить признак «Контракт в номере заявки» и в поле «контракт» ввести значение, которое будет подставляться в заявку в блок NNN (Рисунок 11).
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/fwn7.png)Рисунок 11.
### Формат номера заявки в Биотест.
После заполнения необходимо документ подписать и закрыть. Заявке автоматически присвоится номер в формате ZZZDDMMYYGGG, где ZZZ – код региона филиала, DDMMYY – день, месяц, год формирования заявки, GGG – номер заявки в текущий день.
### Формат номера пробы
Код пробы определяется по тем же правилам, что и номер заявки. Нумерация проб/заявок сквозная в течении дня для каждого из филиалов ЛПУ.
### Выгрузка заявок в ЦКЛ.
Заполненные и проверенные заявки следует передать в ЦКЛ. Для этого в журнале заявок необходимо нажать кнопку «Заполнить» и в открывшемся списке выбрать пункт «Выгрузка заявок» (Рисунок 12)
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/z8F8.png)Рисунок 12.
**Выгружаются только подписанные заявки.**
В журнале отображаются: статус отправки заявок, статус обработки и статус получения результата. Так же отображается текст ошибки из ЦКЛ, при наличии (Рисунок 13). Пояснения о тексте ошибок и статусах обработки следует узнавать у представителей ЦКЛ.
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/LEG9.png)Рисунок 13.
Для **повторной отправки заявки**, необходимо открыть заявку, снять признак «Отправка в КДЛ», подписать заявку и повторить выгрузку, как описано выше.
Начиная с версии КСАМУ 16522, в журнале заявок можно включить логирование. (Рисунок 14):
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/Hwb10.png)Рисунок 14.
Если сохранение логов включено, то при отправке заявок в ЦКЛ на каждую заявку будет формироваться файл запроса в формате XML. Эти файлы можно, при необходимости, передавать разработчикам для анализа ошибки. Расположены они в папке KSAMU (Рисунок 15). При закрытии журнала заявок, сохранение лога автоматически отключается.
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/NeB11.png)Рисунок 15.
Начиная с версии КСАМУ 18821 в журнале заявок для внешней лаборатории реализована фильтрация по дате подписи документа (Рисунок 16). Таким образом, методом выбора из выпадающего списка, фильтрация заявок для отображения в журнале возможна:
· по дате создания;
· по дате подписи.
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/1VB12.png)Рисунок 16.
Для некоторых лабораторных исследований, заказываемых во внешней лаборатории, критична информация:
1) фаза цикла;
2) неделя беременности;
3) код контингента.
Все эти данные возможно указать на вкладке «Основная информация» (Рисунок 16):
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/SfR13.png)Рисунок 17.
## Получение результатов исследований
Получение результатов по отправленным заявкам производится в ручном режиме, для этого в журнале заявок необходимо нажать кнопку «Заполнить» и в открывшемся списке выбрать пункт «Загрузка результатов» (Рисунок 18):
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/O5j14.png)Рисунок 18.
Врач, назначивший исследование, может просмотреть полученный результат и распечатать его стандартным способом, описанным в справке КСАМУ (F1).
## Возможные ошибки
#### 1. Наименование страховой компании не соответствует справочнику F002:[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/15.png)Рисунок 19.
**Решение** -Изменить наименование страховой организации (см. пункт 2 «Синхронизация и проверка справочников» инструкции).
#### 2. Для пробы указан недопустимый биоматериал с кодом 5. Для данной пробы допустимый биоматериал с кодом 208.[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/ios16.png)Рисунок 20.
**Решение** – изменить в заявке биоматериал на допустимый, либо менять номер пробирки
Объяснение: в одном контейнере не может быть двух биоматериалов (например, кровь и моча не собираются в одну пробирку), поэтому если в заявке у двух различных биоматериалов указан один номер контейнера, программа выдаст ошибку, указанную на фотографии выше. Нужно либо менять биоматериал на допустимый, либо менять номер пробирки (Рисунок 20).
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/17.png)Рисунок 21.
#### 3. В табличной части «Оказанные услуги» ошибка! Поле направление не заполнено.
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/faJ18.png)Рисунок 22.
Причина возникновения – удаление документа направления, попавшего в заявку в внешнюю лабораторию.
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/RuU28.png)Рисунок 23.
**Решение: **
1. Очистить табличную часть «Внешние документы» от лишних записей.
2. Очистить табличную часть «Данные заявки» от незаказанных услуг.
#### 4. Заявки, выделенные красным цветом.
В случае заказа не актуальной услуги внешней лаборатории заявка в журнале выделяется цветом.
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/NOs20.png)Рисунок 24.
В случае открытия такой заявки появляется предупреждающее окно:
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/X0L21.png)Рисунок 25. Внешние документы
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/fH422.png)Рисунок 26.
В табличной части «Внешние документы» проблемное направление будет выделено цветом.
Цветом выделяются направления, в которых заказаны услуги, отсутствующие в справочнике внешней лаборатории. Проверка в КСАМУ проводится после синхронизации справочника с внешней лабораторией, то есть после получения МИС КСАМУ актуального справочника внешней лаборатории.
**Решение:**
1. Провести синхронизацию справочников.
2. Уведомить врача, оформившего направление о необходимости создать новое направление.
3. Удалить старое направление из таблицы «Внешние документы».
4. Удалить не актуальную услугу из таблицы «Данные заявки».
5. Если заявка не подписана и случай не закрыт, новое направление в заявку попадёт автоматически.
6. Если заявка подписана или случай (талон) закрыт, или направление оформляется из нового случая (талона), направление попадёт в новую заявку и его нужно обработать отдельно.
Если новое направление обязано быть в старой заявке, то его возможно отобрать в заявку в ручную.
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/ZPI23.png)Рисунок 28.
#### 5. Результаты пришли, но пустые:
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-02/pRB29.png)Рисунок 28. Брак В данном случает в результате стоит пометка о выбраковке пробы - гемолиз. То есть из-за брака исследование не было проведено - соответственно результат пустой.
#### 6. Пользователь пытается изменить состав исследований после доставки проб в лабораторию.
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-03/rVHimage.png)Рисунок 29.
Так как пробы были доставлены и приняты в работу, то изменения состава исследований уже запрещены. Если заказчик "передумал" после доставки проб и принятия их в работу лабораторией, то необходимо делать новые заявки с новыми пробами и составом исследований. Если ни одна проба в заявке не доставлена, то изменения состава исследований или тестов в заявке возможны. После доставки хотя бы одной пробы в заявке в лабораторию заказчику остаётся только ждать результатов тех исследований и тестов, которые он запросил в заявке до доставки проб.
#### 7. Сообщения при синхронизации справочников.
С версии МИС КСАМУ 21331 добавлено логирование синхронизации справочников в истории действий пользователя. История действий пользователя доступна по пути в МИС КСАМУ: Сервис -> Администрирование -> История действий пользователя.
##### 7.1. Сообщение при успешной синхронизации:
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-03/0gPizobrazenie.png)Рисунок 30.
При таком завершении синхронизации справочников дополнительных действий пользователей не требуется
##### 7.2. Сообщение о недоступности сервиса:
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-03/1f0izobrazenie.png)Рисунок 31.
Ошибка говорит о полном недоступности сервиса, с которым МИС КСАМУ пытается связаться. Зачастую причина заключается в полной недоступности сервиса.
Алгоритм действий при получении подобной ошибки:
1. Проверьте интернет соединение.
2. Проверьте подключение по защищенной сети с внешней лабораторией.
3. Проверьте доступность сервиса внешней лаборатории в браузере по адресу, указанному в ошибке. (Адрес можно скопировать из настроек лаборатории в МИС КСАМУ)
Если при выполнении п.3 адрес доступен – попытайтесь синхронизировать справочники ещё раз. Если адрес не доступен – свяжитесь с техническими специалистами внешней лаборатории, опишите проблему.
##### 7.3. Сообщение об обрыве сети при синхронизации справочников:
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-03/pZ3izobrazenie.png)Рисунок 32.
Повторите действия, описанные в пункте 7.2.
Аналогичные сообщения об ошибках при синхронизации выдаются оператору, запустившему синхронизацию.
Рисунок 33.
##### 8. Статус обработки "Не указан адрес проживания/регистрации", заявка не отправляется.
Проверить разбивку по КЛАДР
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-04/gqximage.png)Рисунок 34.
Нажать на многоточие и проверить заполнение полей, при пустых полях, нажать "Разделить" и сохранить изменения.
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-04/XlRimage.png)Рисунок 35.
Попробовать еще раз выгрузить заявку.
#### 9. Сервис ЦКЛ был недоступен в момент отправки заявки.
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-07/4C2image.png)Рисунок 36.
Необходимо повторно отправить заявку.
Для этого необходимо зайти в заявку, которую вы хотите повторно отправить. Убрать галочку в чекбоксе "отправка в КДЛ".
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-07/3gCimage.png)Рисунок 37.
Подписать и закрыть документ.
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-07/4Tnimage.png)Рисунок 38.
И выгрузите заявку повторно.
[](https://docs.medicine-it.ru/uploads/images/gallery/2024-07/yxPimage.png)Рисунок 39.
#### 10. Неизвестная внутрення ошибка, обратитесь к разработчику.
В данному случае необходимо чтоб клиент уточнял проблемы по данной заявке у исполнителя.
*Рисунок 40.*