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

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

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

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 Название документа
document.idDocumentType Тип документа (число, если используется классификатор минздрава)
practitioner.mrProxyNumber Номер машиночитаемой доверенности
esia авторизация ЕСИА для ИДС true или false

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

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

Можно в форматах: 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, если возможно.

Рекомендации

  • Приоритет формату файлов — DOCX
  • Файлы — один подписант. При добавлении файла с отличающимися данными система предложит утвердить добавление еще одного подписанта
  • Не используйте сложное форматирование внутри тега — обычный текст надёжнее
  • Допустимо сделать все одной строкой белого или близкого цвета размером шрифта 2, чтобы его не было видно при печати
  • Для PDF: минимальный допустимый размер шрифта 2pt
  • Для DOC форматов: допустимо использовать белый цвет и размер шрифта 1
  • Для DOCX допустимо использовать опцию «скрытый шрифт»
  • Если ваша система выводит только PDF — возможно необходимо сделать не чистый белый, а близкий к белому
  • Допустимо добавление файлов открепленной подписи в комплект отправления
  • При авторизации ЕСИА для ИДС проверяется СНИЛС, если его нет — запрос данных СНИЛС исходя из данных документа удостоверяющего личность

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

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

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

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

Вопросы

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

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