Часто задаваемые вопросы по работе со справочной информацией

А что такое required_specimen и specimen в запросе nomenclature?

Required_specimen - это обязательные виды БМ для исследования, справочная информация, в дальнейшим запросах не участвует. В запрос преаналитики и опросника передавать НЕ нужно.

Specimen - это виды БМ на выбор. Можно выбрать только один. Передается в запрос преаналитики и опросников. Название Specimen, а не какое-либо другое появилось по историческим причинам. В начале было только поле Specimen, а потом Required_specimen, было решено не ломать контракт.

Зачем bodysite_code, container_type номенклатуре, если данные о типе контейнера возвращает преаналитика?

Они нужны для запроса преаналитики и опросников, например, общий анализ крови делается из венозной и капиллярной крови, преаналитика не может угадывать какие пробирки давать? В вашем контракте может не быть капилярной крови, это пример.

У многих полей "bodysite_code": null, "bodysite_name": "", "container_type": null, "container_name": "" Нужны ли эти поля в опросниках, преаналитике?

Если null, то можно не передавать.

У моем контракте нет ни одного поля, где bodysite_code или container_type были бы заполены, можно их не использовать?

Если оно заполнено, вы должны его передать, это требование API. Если не заполнено, то можно не передавать, если будет заполнено, но вы не передадите, то лаборатория может сделать не то исследование.

Цены, которые будут возвращаться в номенклатуре, они действительные?

Данное поле может заполняться лабораторией и иметь разную логику для b2c и b2b контрактов. Необходимо уточнять по конкретной лаборатории.

Зачем в Questionnaire передавать тип биоматериала и прочее, почему недостаточно только кода исследования?

Сейчас во внутренних системах есть несколько исследований в группе "Цитологические, морфологические и гистохимические исследования", у которых состав опросников отличается в зависимости от типа биоматериала. Эти исследования сейчас не используются в интеграции, но сервис используется и внутри лаборатории.

Параметры "required": true, "repeats": false в ответе Questionnaire встречаются в каждом Item, как их интерпретировать?

Поле с типом required должно быть заполнено в ответе опросника, где required false может быть не заполнено.

Repeats - может ли в заполненном опроснике ответ на этот вопрос встречаться несколько раз.

Почему guid в ответе преаналитики состоят из нулей?

Чтобы узнать к каким товарным позициям относится какой тип БМ необходимо в запросе корзины каждой товарной позиции создать guid. В ответе у образцов будет массив с guid из запроса. Если не указать guid у товарных позиций, то расчет преаналитики не знает как их сгенерировать и они заполняются 0.

label - в ответе преаналитики это штрих код, как мне интерпретировать null?

Label может не отдаваться при работе с бухтами штрихкодов или прештрихкодированными пробирками, в таком случае не нужен номер для печати. Так же такая функциональность может работать для тестовых контрактов, поэтому возвращается null. Если клиника хочет печатать ШК на своём принтере, то возвращается значение ШК.

Какой формат штрихкода придет в label?

Код задается конечной лабораторией. Для тестирования заявок на исследования необходимо запросить ш/к, которые можно будет использовать как тестовые.

Почему в ответе преаналитики для одной и той же пробирки "quantity": 63 и "quantity": 1100? И почему преаналитика не схлопнула эти две пробирки в одну. Что указывается в quantity?

Как считается преаналитика решает лаборатория. У нее на это могут быть завязаны рабочие потоки или иная логика.

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

Quantity в преаналитике, в каких она единицах?

Измерение идёт в микролитрах.

Где можно найти тип биоматериала (в PDF "Тип биоматериала, из справочника SampleType, поле Name")?

Контрагенты должны работать только с теми типами биоматериала, которые им вернет вызов расчета преаналитики.

В описании сервиса интеграции через ftp было два очень полезных справочника - сроки выполнения исследований и временные изменения выполняемых исследований. В REST эти функции реализованы или планируются к реализации? Под временными изменениями выполняемых исследований подразумевается NomenclatureExceptions, Сроки - это SpecialProperties.

Для получения сроков выполнения исследования реализован REST метод eta. Так же сроки есть в договоре. В случае задержек или временного невыполнения делается рассылка, а также обновляется информация в справочниках. Нормативные, зафиксированные в договоре сроки не изменяются. В случае смены аутсорсера или лаб. Комплекса - скорее всего подписывается доп.соглашение.