Инструкция по работе с шаблоном

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

Поддерживаемые типы файлов

DOCX (.docx)	— ПРИОРИТЕТНЫЙ 1
DOC/DOT (.doc, .dot)	— поддерживается
PDF (.pdf)	— ПРИОРИТЕТНЫЙ 2
RTF (.rtf)	— СТАРЫЙ ФОРМАТ, ВОЗМОЖНЫ ОШИБКИ
OpenDocument (.odt)	— поддерживается

Дополнительно принимаются файлы подписи (.sig, .sign, .p7s, .p7ks) — они сохраняются, но не определяются как данные. Возможно отправить комплект документ с открепленной подписью в таком порядке D = (документ+подпись И документ+подпись И т.д.).

Техническое ограничение размера на запрос: до ~50 МБ.

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

Ожидаемый объём одного отправления до 2 мб.

Где и как размещать данные в документе

Система ищет специальный блок с данными двумя способами. Выберите любой один:

1) Простой блок с квадратными скобками:

[sepData]
patient.idPatientMis: 123456;
patient.familyName: Иванов;
patient.givenName: Иван;
patient.middleName: Иванович;
patient.birthDate: 01.02.1990;
patient.sex: мужской;
patient.telecom.email: ivanov@example.com;
patient.telecom.phone: +7 999 123-45-67;

document.providerName: ОВД УВД СЗАО Г. МОСКВЫ;
document.issuedDate: 2024-12-01;
document.docN: 123;
document.docS: АБ;
document.documentName: паспорт;
document.idDocumentType: 14;

practitioner.mrProxyNumber: 7700-001;
esia:true; 
[/sepData]

2) Альтернатива с «@»:

@sepData@
patient.idPatientMis: 123456;
patient.familyName: Иванов;
patient.givenName: Иван;
patient.middleName: Иванович;
patient.birthDate: 01.02.1990;
patient.sex: мужской;
patient.telecom.email: ivanov@example.com;
patient.telecom.phone: +7 999 123-45-67;

document.providerName: ОВД УВД СЗАО Г. МОСКВЫ;
document.issuedDate: 2024-12-01;
document.docN: 123;
document.docS: АБ;
document.documentName: паспорт;
document.idDocumentType: 14;

practitioner.mrProxyNumber: 7700-001;
esia:true; 
@/sepData@

Обратите внимание: необходимо после каждого значения указывать точку с запятой: document.docN: 123; document.docS: АБ;

Размещайте блок ближе к концу документа или на отдельной странице — это не критично, система ищет его по содержимому.

Какие поля поддерживаются

Поле	Описание	Обязательность
`patient.idPatientMis`	Идентификатор пациента в вашей ИС (обязательно, если недоступен указывайте телефон)	да
`patient.familyName`	Фамилия	да
`patient.givenName`	Имя	да
`patient.middleName`	Отчество (если есть)	нет
`patient.birthDate`	Дата рождения	да
`patient.sex`	Пол	да (можно сменить в виджете)
`patient.telecom.email`	Email	нет
`patient.telecom.phone`	Телефон	да
`document.providerName`	Организация-выдавшая документ	да
`document.issuedDate`	Дата выдачи документа	да
`document.docN`	Номер документа	да
`document.docS`	Серия документа	только паспорт
`document.documentName`	Название документа	да. Если нет, допустимо «Паспорт» «Документ удостоверяющий личность» — тогда будет 14 тип (паспорт по умолчанию). Можно сменить в виджете.
`document.idDocumentType`	Тип документа (число, если используется классификатор минздрава)	нет. Если нет поиск по `document.documentName`
`practitioner.mrProxyNumber`	Номер машиночитаемой доверенности	нет
esia	авторизация ЕСИА для ИДС true или false	нет (Если указано TRUE, то сменить в виджете невозможно — для избежания ошибок).
delivery	способ доставки, с возможностью изменить вручную в личном кабинете. возможные значения max sms mila	нет (По умолчанию СМС) можно сменить в виджете после загрузки

Требования к значениям для корректного распознавания

Дата рождения:

Можно в форматах: 01.02.1990, 1990-02-01, 01/02/1990 — система приведёт к YYYY-MM-DD.

Пол:

Мужской	м, муж, мужской, male, 1
Женский	ж, жен, женский, female, 2

Телефон:

Допустимо: +7 999 123-45-67, 8 (999) 123-45-67, 79991234567 — система преобразует к формату +7XXXXXXXXXX, если возможно.

Частые ошибки

Файл загружается, но данные не подтянулись — проверьте, что блок окружён [sepData]...[/sepData] или @sepData@...@/sepData@
Неверные названия полей — используйте точные имена из раздела «Какие поля поддерживаются»
Телефон/дата/пол не распознаны — проверьте формат; при необходимости система попросит уточнить пол
Тип файла не принимается — используйте форматы из списка «Поддерживаемые типы файлов»
Все или часть значений в одном поле — проверьте наличия разделителя — точки c запятой после каждого значения

Что происходит после загрузки

Документ сохраняется, а данные из блока автоматически подставляются в форму пациента
При обнаружении дубликата пациента система предупредит о том, что загружается файл содержащий иного адресата
Если не указан пол, появится запрос выбрать значение

Вопросы

Если что-то не получается — обратитесь к ответственному специалисту в вашей организации или в поддержку проекта N3Health.

Контакты:
help@mila.online или support@n3health.ru