Руководство к использованию стандарта FHIR в ЦИСЗ
0.2.7060 - ci-build

OperationDefinition: Операция получения идентификатора ЭЛН

Официальный URL: https://fhir.by/OperationDefinition/get-eln-id
Unknown as of 2026-08-27 Имя: get-document-id

Операция позволяет получить уникальный идентификатор электронного листка нетрудоспособности (ЭЛН) на основе основного структурированного уникального идентификатора случая временной нетрудоспособности (случай ВН).

Уникальный идентификатор ЭЛН формируется в ЦИСЗ согласно следующей структуре:

DD-GGGGGGGGG-YYYYNNNNNNNNNNNN-PP,

где:
DD — код вида электронного документа (2 цифры), для ЭЛН: DD = 01;
GGGGGGGGG — УНП организации здравоохранения (9 цифр);
YYYYNNNNNNNNNNNN — основной структурированный уникальный идентификатор случая ВН (16 цифр, первые 4 цифры - год);
PP — уникальный порядковый номер ЭЛН в рамках одного случая ВН (2 цифры).

Код вида электронного документа задается значением из справочника Вид электронного документа (DigitalDocumentKind).

Например: 01-19408675-2025567890123456-01.

Для получения идентификатора ЭЛН необходимо выполнить операцию $get-eln-id, указав основной структурированный уникальный идентификатор случая ВН.

Программные интерфейсы ЦИСЗ защищены сервером авторизации с использованием технологии OAuth 2.0 (Авторизация в ЦИСЗ). При каждом вызове операции клиентское приложение (МИС ОЗ) должно передавать токен доступа (токен организации) в заголовке запроса.

Вызов операции получения идентификатора ЭЛН осуществляется с помощью HTTP POST команды:

POST [FHIR_BASE]/$get-eln-id

Request Headers
    Accept: application/json 
    Authorization: Bearer [access_token]

Пример запроса:

Body
{
"resourceType" : "Parameters",
"parameter" : [{
    "name" : "identifier-tdsum",
    "valueString" : "2026000000000149"
}]
}

Метод возвращает:

  • HTTP-статус “200 OK” и уникальный идентификатор ЭЛН в теле ответа в виде ресурса Parameters (identifier - DD-GGGGGGGGG-YYYYNNNNNNNNNNNN-PP). Полученный уникальный идентификатор ЭЛН необходимо использовать при передаче ЭЛН в ЦИСЗ в качестве идентификатора Bundle;
  • HTTP-статус “400 Bad Request”: неверно задан параметр.

URL: [base]/$get-eln-id

Параметры

ИспользоватьНаименованиеСфера действияКардинальностьТипПривязкаДокументация
INidentifier-tdsum1..1id

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

OUTidentifier1..1id

Уникальный идентификатор электронного документа ЭЛН.

Примечания:

Результатом успешного запроса является ресурс Parameters.

Пример ответа:

{
  "resourceType" : "Parameters",
  "parameter" : [{
    "name" : "identifier",
    "valueString" : "01-193605729-2026000000000149-02"
  }]
}

При передаче параметра identifier-tdsum, не соответствующего требуемому формату, возвращается ресурс OperationOutcome.

Пример ответа:

{
  "resourceType": "OperationOutcome",
  "id": "6f38e3ed-e759-4c31-9492-25cbaac1270e",
  "meta": {
    "lastUpdated": "2026-08-26T13:20:10.982746+00:00"
  },
  "issue": [
    {
      "severity": "error",
      "code": "invalid",
      "details": {
        "text": "Неверный формат параметра. Требуемый формат: 'YYYYNNNNNNNNNNNN'. Параметр должен содержать 16 цифр, первые 4 из которых - год (должен быть равен либо меньше текущего года)."
      },
      "diagnostics": "При обработке запроса произошла ошибка на стороне МИС."
    }
  ]
}