Интеграция с ARMED: что проверить клинике в Армении

ARMED — государственная система электронного здравоохранения Армении. В описании оператора она представлена как платформа обмена клиническими, административными и финансовыми данными. Запись визита во внутренней CRM ещё не означает передачу в ARMED. Конкретные процессы стоматологии, эстетической клиники, центра трансплантации волос, косметологии, диагностики или многопрофильного центра уточняйте у оператора и ответственных органов: они могут зависеть от услуг, договоров и применимых требований.

Начните с официального разрешения и документации

До разработки уточните у оператора допустимый способ интеграции и доступность официального API для вашего случая. Учётная запись сотрудника для входа в систему не означает разрешение на автоматический обмен. Запросите актуальную документацию, порядок предоставления доступа и технического ответственного. Помните, что техническое подключение само по себе не подтверждает выполнение клиникой всех применимых правовых требований.

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

Сопоставляйте идентификаторы, а не только имена

Между локальной записью пациента и записью внешней системы нужна явная сохраняемая связь. Не полагайтесь только на совпадение имени или телефона. Выбирайте идентификаторы, разрешённые официальной документацией, и определите действия при отсутствующих, противоречивых или повторяющихся данных. Неуверенное совпадение передавайте сотруднику на проверку: не объединяйте карты по догадке. При последующем исправлении идентификации должно быть понятно, почему прежняя связь появилась и кто её изменил.

Аналогично проверяйте сопоставление клиники, филиала, врача, услуги и других необходимых справочников по реальной документации. Внутренний код не обязательно означает то же самое во внешней системе. В мультитенантной CRM связи должны принадлежать правильной клинике: нельзя использовать идентификатор организации или доступ другой клиники при передаче. Неизвестное значение справочника нельзя произвольно заменять похожим значением только ради успешной отправки.

Повторная попытка не должна создавать новый визит

Идемпотентная синхронизация означает, что повтор одной операции не создаёт новый дублирующий результат. Сохраняемая очередь отправки должна связывать локальную операцию, её версию и внешний ответ. Если официальный API поддерживает ключ распознавания повторов, используйте его документированным способом. Обнаружение одного сообщения во внутренней очереди полезно, но само по себе не доказывает отсутствие дубля во внешней системе. Этот предел нужно явно учитывать при испытаниях.

Тайм-аут не означает, что внешняя система ничего не сохранила: она могла принять данные, а ответ потерялся. Пометьте результат как неопределённый и проверьте приём разрешённым запросом или согласованной сверкой. Без подтверждённого способа предотвращения дублей нельзя вслепую повторять создание записи. Администратор должен различать ожидающие отправки, подтверждённые, отклонённые и неопределённые операции и понимать, когда и кому передавать проблему для разбора.

Когда данные систем расходятся

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

Аудит, по которому можно проследить передачу

Запись аудита должна показывать клинику, пользователя или службу, инициировавшую действие, время, переданную версию и полученный результат. Идентификатор связи должен помогать находить повторные попытки и конфликты, разобранные вручную. Хранить полное медицинское содержание, пароли и ключи доступа в общедоступном журнале — плохое решение. Определите минимально необходимые данные, права доступа, защиту от изменений и сроки хранения, уточнив требования у специалистов и оператора системы.

Как работа с ARMED устроена в MedOne

В MedOne обмен с ARMED вынесен в отдельный модуль интеграции: очередь отправки, повторные попытки, сопоставление идентификаторов пациентов и справочников и журнал аудита. Расхождения между системами не перезаписываются автоматически — они передаются сотруднику для ручного разбора, а подписанные медицинские записи остаются неизменными. Подключение конкретной клиники к ARMED выполняется после получения официального доступа и документации у оператора.