# Портал госпитализации

# Справочники

Перечень открытых справочников системы, доступных для интеграции в информационные системы

# Справочник «Источники аннулирования направления»

#### Получение всех элементов справочника


```
#!php

/udata/data/getAnnulSources/
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getAnnulSources" generation-time="2.611129">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>1</id>
                <guid>insurance</guid>
                <name>Cтраховые медицинские организации</name>
                <is_active>1</is_active>
            </item>
            <item>
                <id>2</id>
                <guid>hospital</guid>
                <name>Медицинские организации, оказывающие медицинскую помощь в стационарных условиях</name>
                <is_active>1</is_active>
            </item>
            <item>
                <id>3</id>
                <guid>ambulant</guid>
                <name>Медицинские организации, оказывающие первичную медико-санитарную помощь в амбулаторных условиях</name>
                <is_active>1</is_active>
            </item>
        </data>
    </response>
</udata>
```

#### Получение источника аннулирования по GUID

```
#!php

/udata/data/getAnnulSourceByGuid/{$annulSourceGuid}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getAnnulSourceByGuid" generation-time="0.098610">
    <response>
        <code>200</code>
        <data>
            <id>3</id>
            <guid>ambulant</guid>
            <name>Медицинские организации, оказывающие первичную медико-санитарную помощь в амбулаторных условиях</name>
            <is_active>1</is_active>
        </data>
    </response>
</udata>
```

### Получение источника аннулирования по ID

```
#!php

/udata/data/getAnnulSourceById/{$annulSourceId}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getAnnulSourceById" generation-time="0.064843">
    <response>
        <code>200</code>
        <data>
            <id>1</id>
            <guid>insurance</guid>
            <name>Cтраховые медицинские организации</name>
            <is_active>1</is_active>
        </data>
    </response>
</udata>
```

# Справочник «Причины аннулирования направления»

#### Получение всех элементов справочника


```
#!php

/udata/data/getAnnulReasons/
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getAnnulReasons" generation-time="0.378496">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>1</id>
                <guid>absence</guid>
                <name>Неявка пациента на госпитализацию</name>
                <is_active>1</is_active>
            </item>
            <item>
                <id>2</id>
                <guid>docs</guid>
                <name>Непредоставление необходимого пакета документов (отказ медицинской организации, оказывающей медицинскую помощь в стационарных условиях)</name>
                <is_active>1</is_active>
            </item>
            <item>
                <id>3</id>
                <guid>renouncement</guid>
                <name>Инициативный отказ от госпитализации пациентом</name>
                <is_active>1</is_active>
            </item>
            <item>
                <id>4</id>
                <guid>death</guid>
                <name>Смерть</name>
                <is_active>1</is_active>
            </item>
        </data>
    </response>
</udata>
```

#### Получение причины аннулирования по GUID

```
#!php

/udata/data/getAnnulReasonByGuid/{$annulReasonGuid}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getAnnulReasonByGuid" generation-time="0.064594">
    <response>
        <code>200</code>
        <data>
            <id>2</id>
            <guid>docs</guid>
            <name>Непредоставление необходимого пакета документов (отказ медицинской организации, оказывающей медицинскую помощь в стационарных условиях)</name>
            <is_active>1</is_active>
        </data>
    </response>
</udata>
```

### Получение причины аннулирования по ID

```
#!php

/udata/data/getAnnulReasonById/{$annulReasonId}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getAnnulReasonById" generation-time="0.394100">
    <response>
        <code>200</code>
        <data>
            <id>1</id>
            <guid>absence</guid>
            <name>Неявка пациента на госпитализацию</name>
            <is_active>1</is_active>
        </data>
    </response>
</udata>
```

# Справочник «Виды движения пациента»

#### Получение всех элементов справочника


```
#!php

/udata/data/getMoveTypes/
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getMoveTypes" generation-time="0.096385">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>1</id>
                <guid>transfer</guid>
                <name>Перевод</name>
                <is_active>1</is_active>
            </item>
            <item>
                <id>2</id>
                <guid>moveout</guid>
                <name>Выписка</name>
                <is_active>1</is_active>
            </item>
        </data>
    </response>
</udata>
```

### Получение вида движения по GUID

```
#!php

/udata/data/getMoveTypeByGuid/{$id}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getMoveTypeByGuid" generation-time="0.075088">
    <response>
        <code>200</code>
        <data>
            <id>2</id>
            <guid>moveout</guid>
            <name>Выписка</name>
            <is_active>1</is_active>
        </data>
    </response>
</udata>
```

#### Получение вида движения по ID

```
#!php

/udata/data/getMoveTypeById/{$id}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getMoveTypeById" generation-time="0.103495">
    <response>
        <code>200</code>
        <data>
            <id>1</id>
            <guid>transfer</guid>
            <name>Перевод</name>
            <is_active>1</is_active>
        </data>
    </response>
</udata>
```

# Справочник «Профили коек»

#### Получение всех элементов справочника


```
#!php

/udata/data/getBedProfiles/
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getBedProfiles" generation-time="0.512245">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>4</id>
                <department_profile_id>2</department_profile_id>
                <name>беременных и рожениц (акушерство и гинекология)</name>
                <is_active>1</is_active>
            </item>
            ...
            ...
            ...
            <item>
                <id>86</id>
                <department_profile_id>122</department_profile_id>
                <name>эндокринологические</name>
                <is_active>1</is_active>
            </item>
        </data>
    </response>
</udata>
```

#### Получение профиля койки по ID

```
#!php

/udata/data/getBedProfileById/{$id}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getBedProfileById" generation-time="2.447575">
    <response>
        <code>200</code>
        <data>
            <id>1</id>
            <department_profile_id>3</department_profile_id>
            <name>беременных и рожениц (акушерское дело)</name>
            <is_active>0</is_active>
        </data>
    </response>
</udata>
```

# Справочник «Профили отделений»

#### Получение всех элементов справочника


```
#!php

/udata/data/getDepartmentProfiles/
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getDepartmentProfiles" generation-time="0.191558">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>1</id>
                <name>абдоминальной хирургии</name>
                <is_active>1</is_active>
            </item>
            ...
            ...
            ...
            <item>
                <id>123</id>
                <name>эндоскопии</name>
                <is_active>1</is_active>
            </item>
        </data>
    </response>
</udata>
```

#### Получение профиля отделения по ID

```
#!php

/udata/data/getDepartmentProfileById/{$id}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getDepartmentProfileById" generation-time="0.078298">
    <response>
        <code>200</code>
        <data>
            <id>10</id>
            <name>врачебно-летной экспертизе</name>
            <is_active>1</is_active>
        </data>
    </response>
</udata>
```

# Справочник «Экстренность»

#### Получение всех элементов справочника


```
#!php

/udata/data/getEmergencies/
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getEmergencies" generation-time="0.176694">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>1</id>
                <guid>planned</guid>
                <name>плановая</name>
                <is_active>1</is_active>
            </item>
            <item>
                <id>2</id>
                <guid>crashed</guid>
                <name>неотложная</name>
                <is_active>1</is_active>
            </item>
            <item>
                <id>3</id>
                <guid>extra</guid>
                <name>экстренная</name>
                <is_active>1</is_active>
            </item>
        </data>
    </response>
</udata>

```

#### Получение экстренности по GUID

```
#!php

/udata/data/getEmergencyByGuid/{$guid}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getEmergencyByGuid" generation-time="0.081604">
    <response>
        <code>200</code>
        <data>
            <id>3</id>
            <guid>extra</guid>
            <name>экстренная</name>
            <is_active>1</is_active>
        </data>
    </response>
</udata>

```

### Получение экстренности по ID

```
#!php

/udata/data/getEmergencyById/{$id}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getEmergencyById" generation-time="0.090066">
    <response>
        <code>200</code>
        <data>
            <id>1</id>
            <guid>planned</guid>
            <name>плановая</name>
            <is_active>1</is_active>
        </data>
    </response>
</udata>

```

# Справочник «Статусы»

#### Получение всех элементов справочника


```
#!php

/udata/data/getStatuses/
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getStatuses" generation-time="0.113479">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>1</id>
                <guid>added</guid>
                <name>Зарегистрирован</name>
                <is_active>1</is_active>
            </item>
            <item>
                <id>2</id>
                <guid>canceled</guid>
                <name>Аннулирован</name>
                <is_active>1</is_active>
            </item>
            <item>
                <id>3</id>
                <guid>moveouted</guid>
                <name>Выписан</name>
                <is_active>1</is_active>
            </item>
        </data>
    </response>
</udata>

```

#### Получение статуса по GUID

```
#!php

/udata/data/getStatusByGuid/{$guid}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getStatusByGuid" generation-time="0.075594">
    <response>
        <code>200</code>
        <data>
            <id>1</id>
            <guid>added</guid>
            <name>Зарегистрирован</name>
            <is_active>1</is_active>
        </data>
    </response>
</udata>

```

#### Получение статуса по ID

```
#!php

/udata/data/getStatusById/{$id}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getStatusById" generation-time="0.089115">
    <response>
        <code>200</code>
        <data>
            <id>1</id>
            <guid>added</guid>
            <name>Зарегистрирован</name>
            <is_active>1</is_active>
        </data>
    </response>
</udata>

```

# Справочник «Формы оказания помощи»

#### Получение всех элементов справочника ###


```
#!php

/udata/data/getForms/
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getForms" generation-time="0.140142">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>1</id>
                <guid>hospital</guid>
                <name>стационар</name>
                <is_active>1</is_active>
            </item>
            <item>
                <id>2</id>
                <guid>day_hospital</guid>
                <name>дневной стационар</name>
                <is_active>1</is_active>
            </item>
        </data>
    </response>
</udata>

```

#### Получение формы оказания помощи по GUID

```
#!php

/udata/data/getFormByGuid/{$guid}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getFormByGuid" generation-time="0.079654">
    <response>
        <code>200</code>
        <data>
            <id>1</id>
            <guid>hospital</guid>
            <name>стационар</name>
            <is_active>1</is_active>
        </data>
    </response>
</udata>

```

#### Получение формы оказания помощи по ID

```
#!php

/udata/data/getFormById/{$id}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getFormById" generation-time="0.078159">
    <response>
        <code>200</code>
        <data>
            <id>1</id>
            <guid>hospital</guid>
            <name>стационар</name>
            <is_active>1</is_active>
        </data>
    </response>
</udata>

```

# Справочник «Типы полисов»

#### Получение всех элементов справочника


```
#!php

/udata/data/getPolicyTypes/
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getPolicyTypes" generation-time="0.143510">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>1</id>
                <guid>old</guid>
                <name>Полис ОМС старого образца</name>
                <is_active>1</is_active>
            </item>
            <item>
                <id>2</id>
                <guid>temporary</guid>
                <name>Временное свидетельство</name>
                <is_active>1</is_active>
            </item>
            <item>
                <id>3</id>
                <guid>enp</guid>
                <name>Полис ОМС единого образца</name>
                <is_active>1</is_active>
            </item>
        </data>
    </response>
</udata>

```

#### Получение типа полиса по GUID

```
#!php

/udata/data/getPolicyTypeByGuid/{$guid}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getPolicyTypeByGuid" generation-time="0.074592">
    <response>
        <code>200</code>
        <data>
            <id>3</id>
            <guid>enp</guid>
            <name>Полис ОМС единого образца</name>
            <is_active>1</is_active>
        </data>
    </response>
</udata>

```

#### Получение типа полиса по ID

```
#!php

/udata/data/getPolicyTypeById/{$id}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getPolicyTypeById" generation-time="0.085236">
    <response>
        <code>200</code>
        <data>
            <id>1</id>
            <guid>old</guid>
            <name>Полис ОМС старого образца</name>
            <is_active>1</is_active>
        </data>
    </response>
</udata>

```

# Справочник «Страховые компании»

#### Получение всех элементов справочника


```
#!php

/udata/data/getPolicyCompanies/
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getPolicyCompanies" generation-time="0.219543">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>1</id>
                <code>01001</code>
                <name>ФИЛИАЛ ООО ВТБ МЕДИЦИНА В РЕСПУБЛИКЕ АДЫГЕЯ</name>
                <region_code>01</region_code>
                <is_active>1</is_active>
            </item>
            ...
            ...
            ...
            <item>
                <id>582</id>
                <code>86003</code>
                <name>ООО "МСК "МАКСИМУС"</name>
                <region_code>92</region_code>
                <is_active>1</is_active>
            </item>
        </data>
    </response>
</udata>

```

#### Получение страховой компании по реестровому номеру

```
#!php

/udata/data/getPolicyCompanyByCode/{$guid}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getPolicyCompanyByCode" generation-time="0.078742">
    <response>
        <code>200</code>
        <data>
            <id>582</id>
            <code>86003</code>
            <name>ООО "МСК "МАКСИМУС"</name>
            <region_code>92</region_code>
            <is_active>1</is_active>
        </data>
    </response>
</udata>

```

#### Получение страховой компании по ID

```
#!php

/udata/data/getPolicyCompanyById/{$id}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getPolicyCompanyById" generation-time="0.079509">
    <response>
        <code>200</code>
        <data>
            <id>1</id>
            <code>01001</code>
            <name>ФИЛИАЛ ООО ВТБ МЕДИЦИНА В РЕСПУБЛИКЕ АДЫГЕЯ</name>
            <region_code>01</region_code>
            <is_active>1</is_active>
        </data>
    </response>
</udata>

```

# Справочник «Регионы»

#### Получение всех элементов справочника


```
#!php

/udata/data/getRegions/
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getRegions" generation-time="0.158663">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>01</id>
                <name>Адыгея Респ</name>
                <okato>79000</okato>
            </item>
            ...
            ...
            ...
            <item>
                <id>02</id>
                <name>Башкортостан Респ</name>
                <okato>80000</okato>
            </item>
        </data>
    </response>
</udata>

```

#### Получение региона по коду

```
#!php

/udata/data/getRegionByCode/{$code}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getRegionByCode" generation-time="0.078556">
    <response>
        <code>200</code>
        <data>
            <id>26</id>
            <name>Ставропольский край</name>
            <okato>07000</okato>
        </data>
    </response>
</udata>

```

#### Получение региона по OKATO

```
#!php

/udata/data/getRegionByOkato/{$okato}
```


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getRegionByOkato" generation-time="0.081053">
    <response>
        <code>200</code>
        <data>
            <id>26</id>
            <name>Ставропольский край</name>
            <okato>07000</okato>
        </data>
    </response>
</udata>

```

# Выгрузка данных

Методы по выгрузке на портал данных медицинской организации

# Общие принципы

Портал госпитализации имеет единый интерфейс загрузки данных. Для обращения к интерфейсу отправляется запрос вида:

```
#!php

/udata/data/uploadInterface/{$type}/{$sync}
```


Параметры:

* $type - тип загружаемых данных [branch, beds, direction и т.д.]
* $sync - режим загрузки данных [1 - синхронный, 0 - асинхронный]

Портал госпитализации поддерживает 2 режима загрузки данных - синхронный и асинхронный. Синхронный метод возвращает результат сразу после выполнения запроса на загрузку данных, асинхронный - после обработки данных сервером очередей.

#### Асинхронная загрузка

При асинхронной загрузке данных, в формат запроса для корневой ноды root добавляются дополнительные атрибуты:

* key - уникальный идентификатор файла
* ip - IP адрес сервера, на который надо отправить результат загрузки
* port - порт

**Пример запроса для асинхронной загрузки**

```
#!xml

<?xml version="1.0" encoding="UTF-8"?>
<root key="3400" ip="127.0.0.1" port="30">
	...
</root>
```


**Пример ответа при асинхронной загрузке**


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="uploadInterface" generation-time="0.098592">
    <response>
        <code>200</code>
        <data>
            <key>3400</key>
            <is_success>1</is_success>
            <id>...</id>
        </data>
    </response>
</udata>
```

#### Синхронная загрузка

При синхронной загрузке данных ответ возвращается сразу после обработки данных в ответ на запрос.

**Пример запроса для синхронной загрузки**

```
#!xml

<?xml version="1.0" encoding="UTF-8"?>
<root>
	...
</root>
```


**Пример ответа при синхронной загрузке**


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="uploadInterface" generation-time="0.098592">
    <response>
        <code>200</code>
        <data>
            <is_success>1</is_success>
            <id>...</id>
        </data>
    </response>
</udata>
```

#### Какой режим выбрать?
Общие рекомендации сводятся к следующим пунктам:

* Если загрузка данных критична и необходимо максимально быстрое получение ответа используйте синхронный режим.
* Если загрузка данных не критична по скорости получения ответа - используйте асинхронный режим.

# Регистрация филиала медицинского организации

#### Описание
Для регистрации филиала медицинской организации на портале госпитализации нужно передать XML файл с настройками в общий интерфейс загрузки данных. В ответ на регистрацию интерфейс вернет ID медицинской организации на портале и token для дальнейших запросов. Эти данные необходимо сохранить в БД интегрируемой системы

Для доступа к методу применяется BASIC AUTH, логин и пароль выдаются при обращении к службу поддержки

Адрес метода: **/udata/data/registryBranch/**

#### Формат загружаемых данных

```
#!xml

<?xml version="1.0" encoding="UTF-8"?>
<root key="3400" ip="127.0.0.1" port="30">
	<parent>
		<code>080001</code>
		<num>1</num>
	</parent>
	<name>Регистрация МО2</name>
	<code>260001</code>
	<num>3</num>
	<address>Улица Пушника, дом Колотушника</address>
</root>
```

| Элемент | Обязательное | Описание
|-----|-----|-----|
| parent/code | нет | реестровый номер головной медицинской организации, 6 символов |
| parent/num | нет | код подразделения медицинской организации |
| name | да |наименование филиала медицинской организации |
| code | да |реестровый номер филиала или медицинской организации, 6 символов |
| num | да | код подразделения филиала медицинской организации |
| address | да |адрес филиала|


#### Формат ответа


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="registryBranch" generation-time="4.332759">
    <response>
        <code>200</code>
        <data>
            <is_success>1</is_success>
            <access>
                <token>v2.local.E8H79zjDK3CXCdzYna6XSJ6291zLetUTZktPt41AnBEUq8u6NvwS2ieKtVHOg7AvQhf3CSUy8DKOvAbCV7wKqj5XOg</token>
                <id>71</id>
            </access>
        </data>
    </response>
</udata>
```

| Элемент | Описание |
|-----|-----|
| code | результат обращения к API |
| data/is_success | результат обработки данных |
| data/access/token | уникальный токен для филиала |
| data/access/id | идентификатор филиала на портале |

# Выгрузка филиала

#### Описание
Метод используется для обновления данных филиала на портале. Для доступа к методу применяется авторизация по токену

Адрес метода: **/udata/data/uploadInterface/branch/1**

#### Формат загружаемых данных

```
#!xml

<?xml version="1.0" encoding="UTF-8"?>
<root key="3400" ip="127.0.0.1" port="30">
	<parent>
		<code>080001</code>
		<num>1</num>
	</parent>
	<name>Регистрация МО2</name>
	<code>260001</code>
	<num>3</num>
	<address>Улица Пушника, дом Колотушника</address>
</root>
```

| Элемент | Обязательное | Описание
|-----|-----|-----|
| parent/code | нет | реестровый номер головной медицинской организации, 6 символов |
| parent/num | нет | код подразделения медицинской организации |
| name | да |наименование филиала медицинской организации |
| code | да |реестровый номер филиала или медицинской организации, 6 символов |
| num | нет | код подразделения филиала медицинской организации |
| address | да |адрес филиала|


#### Формат ответа


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="uploadInterface" generation-time="0.098592">
    <response>
        <code>200</code>
        <data>
            <is_success>1</is_success>
            <id>71</id>
        </data>
    </response>
</udata>
```

| Элемент | Описание |
|-----|-----|
| code | результат обращения к API |
| data/is_success | результат обработки данных |
| data/id | идентификатор филиала на портале |

# Выгрузка коечного фонда

#### Описание
Метод используется для загрузке данных коечного филиала на портале. Для доступа к методу применяется авторизация по токену

Адрес метода: **/udata/data/uploadInterface/beds/1**

#### Формат загружаемых данных

```
#!xml

<?xml version="1.0" encoding="UTF-8"?>
<root key="3400" ip="127.0.0.1" port="30">
	<items>
		<item id="1">
			<profile_id>72</profile_id>
			<started>2019-07-22</started>
			<total>10</total>
			<woman>10</woman>
			<man>10</man>
			<child>10</child>
		</item>
		<item id="2">
			<profile_id>1</profile_id>
			<started>2019-07-30</started>
			<total>100</total>
			<woman>10</woman>
			<man>30</man>
			<child>0</child>
		</item>
	</items>
</root>
```

| Элемент | Обязательное | Описание
|-----|-----|-----|
| profile_id | да | ID профиля койки [#](https://bitbucket.org/panda_tamara/g-storage/wiki/Профили%20коек) |
| started | да | дата начала актуальности данных в формате Y-m-d |
| total | да | общее количество мест |
| woman | нет | количество женских коек |
| man | нет | количество мужских коек |
| child | нет | количество детских коек |


#### Формат ответа


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="uploadInterface" generation-time="0.366723">
    <response>
        <code>200</code>
        <data>
            <is_success>1</is_success>
        </data>
    </response>
</udata>
```

| Элемент | Описание |
|-----|-----|
| code | результат обращения к API |
| data/is_success | результат обработки данных |

# Выгрузка направления

#### Описание
Метод используется для выгрузки информации о направлении на портале. В случае успешной загрузки, на запрос будет отправлен номер направления, сгенерированный на портале

Адрес метода: **/udata/data/uploadInterface/direction/1**

#### Формат загружаемых данных #

```
#!xml

<?xml version="1.0" encoding="UTF-8"?>
<root key="3400" ip="127.0.0.1" port="30">
	<date>2019-07-22</date>
	<form>hospital</form>
	<emergency>planned</emergency>
	<datein_plan>2019-08-01</datein_plan>
	<patient>
		<birthday>1991-06-10</birthday>
		<sex>м</sex>
		<phone>89188892937</phone>
		<fname>Петр</fname>
		<sname>Ивашов</sname>
		<lname>Карлович</lname>
		<policy>
			<type>enp</type>
			<company_code>03107</company_code>
			<num>2658800825000197</num>
		</policy>
	</patient>
	<original>
		<doctor>
			<fio>Храпунов Владимир Игнатович</fio>
			<snils>156-564-800 90</snils>
		</doctor>
		<diagnosis>I60.2</diagnosis>
	</original>
	<destination>
		<branch>
			<name>Наименование принимающего МО</name>
			<code>080001</code>
			<num>7</num>
		</branch>
		<profiles>
			<department>97</department>
			<bed>72</bed>
		</profiles>
	</destination>
</root>
```

| Элемент | Обязательное | Описание
|-----|-----|-----|
| date | да | дата выдачи направления в формате Y-m-d |
| form | да | форма оказания медицинской помощи [#](https://bitbucket.org/panda_tamara/g-storage/wiki/Формы%20оказания%20помощи)  |
| emergency | да | экстренность оказания помощи [#](https://bitbucket.org/panda_tamara/g-storage/wiki/Экстренность) |
| datein_plan | да | дата плановой госпитализации в формате Y-m-d |
| num | да | код подразделения филиала медицинской организации |
| patient | да |  данные пациента |
| member | нет |  данные представителя пациента |
| original | да |  нода содержит данные направившего учреждения |
| original/doctor/fio | да |  ФИО направившего врача |
| original/doctor/snils | да |  СНИЛС направившего врача |
| original/diagnosis | да |  код МКБ диагноза, направившего учреждения |
| destination | да |  нода содержит данные учреждения, в которое направляется пациент |
| destination/branch/name | да |  наименование филиала медицинской организации |
| destination/branch/code | да |  реестровый номер филиала или медицинской организации, 6 символов |
| destination/branch/num | нет |  код подразделения филиала медицинской организации |
| destination/profiles/department | да |  профиль отделения [#](https://bitbucket.org/panda_tamara/g-storage/wiki/Профили%20отделений) |
| destination/profiles/bed | да |  профиль койки [#](https://bitbucket.org/panda_tamara/g-storage/wiki/Профили%20коек) |


#### Формат ответа


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="uploadInterface" generation-time="0.903030">
    <response>
        <code>200</code>
        <data>
            <is_success>1</is_success>
            <id>08000119000010</id>
        </data>
    </response>
</udata>
```

| Элемент | Описание |
|-----|-----|
| code | результат обращения к API |
| data/is_success | результат обработки данных |
| data/id | уникальный номер направления |

# Выгрузка аннулирования направления

#### Описание
Метод используется для выгрузки информации о аннулировании направления на портале. Для доступа к методу применяется авторизация по токену

Адрес метода: **/udata/data/uploadInterface/annulment/1**

#### Формат загружаемых данных

```
#!xml

<?xml version="1.0" encoding="UTF-8"?>
<root key="3400" ip="127.0.0.1" port="30">
	<date>2019-08-05</date>
	<direction>
		<num>08000119000008</num>
		<date>2019-07-22</date>
	</direction>
	<reason>docs</reason>
	<source>hospital</source>
	<branch>
		<name>Наименование МО отменившей направление</name>
		<code>080020</code>
		<num>3</num>
	</branch>
</root>
```

| Элемент | Обязательное | Описание
|-----|-----|-----|
| date | да | дата аннулирования в формате Y-m-d |
| direction/num | да | номер направления |
| direction/date | да | дата направления в формате Y-m-d |
| reason | да | GUID или ID причины аннулирования [#](https://bitbucket.org/panda_tamara/g-storage/wiki/Причины%20аннулирования%20направления) |
| source | да | GUID или ID источника аннулирования [#](https://bitbucket.org/panda_tamara/g-storage/wiki/Источники%20аннулирования%20направления) |
| branch/name | да | наименование филиала или медицинской организации, отменившей направление |
| branch/code | да | реестровый номер филиала медицинской организации, 6 символов |
| branch/num | нет | код подразделения филиала медицинской организации |


#### Формат ответа

```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="uploadInterface" generation-time="0.098592">
    <response>
        <code>200</code>
        <data>
            <is_success>1</is_success>
            <id>1</id>
        </data>
    </response>
</udata>
```

| Элемент | Описание |
|-----|-----|
| code | результат обращения к API |
| data/is_success | результат обработки данных |
| data/id | идентификатор документа аннулирования на портале |

# Выгрузка госпитализации

#### Описание

Метод используется для выгрузки информации о госпитализации на портале. В случае успешной загрузки, возвращает ID госпитализации на портале

Адрес метода: **/udata/data/uploadInterface/hospitalization/1**

#### Формат загружаемых данных

```
#!xml

<?xml version="1.0" encoding="UTF-8"?>
<root key="3400" ip="127.0.0.1" port="30">
	<direction>
		<num>08000119000008</num>
		<date>2019-07-22</date>
	</direction>
	<form>hospital</form>
	<emergency>planned</emergency>
	<card>20034</card>
	<datein_fact>2019-08-01 13:14:00</datein_fact>
	<dateout_plan>2019-08-21</dateout_plan>
	<characteristics>
        <telemedicine>
            <used>true</used>
            <date>2019-08-01</date>
            <clinic>
                <name>Наименование организации</name>
                <inn>0000000000</inn>
                <type>1</type>
            </clinic>
        </telemedicine>
    </characteristics>
	<patient>
		<birthday>1991-06-10</birthday>
		<sex>м</sex>
		<phone>89188892937</phone>
		<fname>Петр</fname>
		<sname>Ивашов</sname>
		<lname>Карлович</lname>
		<policy>
			<type>enp</type>
			<company_code>03107</company_code>
			<num>2658800825000197</num>
		</policy>
	</patient>
	<original>
		<branch>
			<name>Наименование направившего МО</name>
			080001
			<num>3</num>
		</branch>
	</original>
	<destination>
		<profiles>
			<department>97</department>
			<bed>72</bed>
		</profiles>
		<diagnosis>I60.2</diagnosis>
	</destination>
</root>

```

<table id="bkmrk-%D0%AD%D0%BB%D0%B5%D0%BC%D0%B5%D0%BD%D1%82-%D0%9E%D0%B1%D1%8F%D0%B7%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D0%B5"><thead><tr><th>Элемент</th><th>Обязательное</th><th>Описание</th></tr></thead><tbody><tr><td>direction/num</td><td>усл.</td><td>номер направления. Обязательное поле, если госпитализация не экстренная</td></tr><tr><td>direction/num</td><td>усл.</td><td>дата выдачи направления в формате Y-m-d. Обязательное поле, если госпитализация не экстренная</td></tr><tr><td>form</td><td>да</td><td>форма оказания медицинской помощи [\#](https://bitbucket.org/panda_tamara/g-storage/wiki/%D0%A4%D0%BE%D1%80%D0%BC%D1%8B%20%D0%BE%D0%BA%D0%B0%D0%B7%D0%B0%D0%BD%D0%B8%D1%8F%20%D0%BF%D0%BE%D0%BC%D0%BE%D1%89%D0%B8)</td></tr><tr><td>emergency</td><td>да</td><td>экстренность оказания помощи [\#](https://bitbucket.org/panda_tamara/g-storage/wiki/%D0%AD%D0%BA%D1%81%D1%82%D1%80%D0%B5%D0%BD%D0%BD%D0%BE%D1%81%D1%82%D1%8C)</td></tr><tr><td>card</td><td>да</td><td>номер карты</td></tr><tr><td>datein\_fact</td><td>да</td><td>дата и время факта госпитализации пациента в формате Y-m-d H:i:s</td></tr><tr><td>dateout\_plan</td><td>да</td><td>дата планового окончания госпитализации в формате Y-m-d</td></tr><tr><td>characteristics/telemedicine</td><td>да</td><td>использовалась телемедицина</td></tr><tr><td>patient</td><td>да</td><td>данные пациента</td></tr><tr><td>member</td><td>нет</td><td>данные представителя пациента</td></tr><tr><td>original</td><td>да</td><td>нода содержит данные направившего учреждения</td></tr><tr><td>original/branch/name</td><td>да</td><td>наименование филиала медицинской организации</td></tr><tr><td>original/branch/code</td><td>да</td><td>реестровый номер филиала или медицинской организации, 6 символов</td></tr><tr><td>original/branch/num</td><td>нет</td><td>код подразделения филиала медицинской организации</td></tr><tr><td>destination</td><td>да</td><td>нода содержит данные учреждения, в которое госпитализируется пациент</td></tr><tr><td>destination/profiles/department</td><td>да</td><td>профиль отделения [\#](https://bitbucket.org/panda_tamara/g-storage/wiki/%D0%9F%D1%80%D0%BE%D1%84%D0%B8%D0%BB%D0%B8%20%D0%BE%D1%82%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D0%B9)</td></tr><tr><td>destination/profiles/bed</td><td>да</td><td>профиль койки [\#](https://bitbucket.org/panda_tamara/g-storage/wiki/%D0%9F%D1%80%D0%BE%D1%84%D0%B8%D0%BB%D0%B8%20%D0%BA%D0%BE%D0%B5%D0%BA)</td></tr><tr><td>destination/diagnosis</td><td>да</td><td>код МКБ диагноза приемного отделения</td></tr></tbody></table>

#### Формат ответа

```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="uploadInterface" generation-time="0.903030">
    <response>
        200
        <data>
            <is_success>1</is_success>
            <id>50</id>
        </data>
    </response>
</udata>

```

<table id="bkmrk-%D0%AD%D0%BB%D0%B5%D0%BC%D0%B5%D0%BD%D1%82-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-cod"><thead><tr><th>Элемент</th><th>Описание</th></tr></thead><tbody><tr><td>code</td><td>результат обращения к API</td></tr><tr><td>data/is\_success</td><td>результат обработки данных</td></tr><tr><td>data/id</td><td>ID документа госпитализации на портале</td></tr></tbody></table>

# Выгрузка выписки

#### Описание

Метод используется для выгрузки информации о выписки пациента из Мо. В случае успешной загрузки, возвращает ID документа движения на портале

Адрес метода: **/udata/data/uploadInterface/movement/1**

#### Формат загружаемых данных

```
#!xml

<?xml version="1.0" encoding="UTF-8"?>
<root key="3400" ip="127.0.0.1" port="30">
	<date>2019-09-05</date>
	<type>moveout</type>
	<card>20034</card>
    <characteristics>
        <telemedicine>
            <used>true</used>
            <date>2019-08-01</date>
            <clinic>
                <name>Наименование организации</name>
                <inn>0000000000</inn>
                <type>1</type>
            </clinic>
        </telemedicine>
    </characteristics>
</root>

```

<table id="bkmrk-%D0%AD%D0%BB%D0%B5%D0%BC%D0%B5%D0%BD%D1%82-%D0%9E%D0%B1%D1%8F%D0%B7%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D0%BE%D0%B5" style="width: 100.001%; height: 211.361px;"><thead><tr style="height: 29.537px;"><th style="width: 33.3033%; height: 29.537px;">Элемент</th><th style="width: 33.3033%; height: 29.537px;">Обязательное</th><th style="width: 33.3033%; height: 29.537px;">Описание</th></tr></thead><tbody><tr style="height: 29.537px;"><td style="width: 33.3033%; height: 29.537px;">date</td><td style="width: 33.3033%; height: 29.537px;">да</td><td style="width: 33.3033%; height: 29.537px;">дата выписки в формате Y-m-d</td></tr><tr style="height: 35.1389px;"><td style="width: 33.3033%; height: 35.1389px;">type</td><td style="width: 33.3033%; height: 35.1389px;">да</td><td style="width: 33.3033%; height: 35.1389px;">ID или GUID вида движения [\#](https://bitbucket.org/panda_tamara/g-storage/wiki/%D0%92%D0%B8%D0%B4%D1%8B%20%D0%B4%D0%B2%D0%B8%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F%20%D0%BF%D0%B0%D1%86%D0%B8%D0%B5%D0%BD%D1%82%D0%B0)</td></tr><tr style="height: 29.537px;"><td style="width: 33.3033%; height: 29.537px;">card</td><td style="width: 33.3033%; height: 29.537px;">да</td><td style="width: 33.3033%; height: 29.537px;">номер карты</td></tr><tr style="height: 29.537px;"><td style="width: 33.3033%; height: 29.537px;">characteristics</td><td style="width: 33.3033%; height: 29.537px;">нет</td><td style="width: 33.3033%; height: 29.537px;">особые отметки</td></tr><tr style="height: 28.537px;"><td style="width: 33.3033%; height: 28.537px;">characteristics/clinic/type</td><td style="width: 33.3033%; height: 28.537px;">нет</td><td style="width: 33.3033%; height: 28.537px;">Тип организации. 1 - региональная МО, 2 - НИИ</td></tr></tbody></table>

#### Формат ответа

```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="uploadInterface" generation-time="0.903030">
    <response>
        200
        <data>
            <is_success>1</is_success>
            <id>1</id>
        </data>
    </response>
</udata>

```

<table id="bkmrk-%D0%AD%D0%BB%D0%B5%D0%BC%D0%B5%D0%BD%D1%82-%D0%9E%D0%BF%D0%B8%D1%81%D0%B0%D0%BD%D0%B8%D0%B5-cod"><thead><tr><th>Элемент</th><th>Описание</th></tr></thead><tbody><tr><td>code</td><td>результат обращения к API</td></tr><tr><td>data/is\_success</td><td>результат обработки данных</td></tr><tr><td>data/id</td><td>ID документа выписки на портале</td></tr></tbody></table>

# Выгрузка перевода

#### Описание

Метод используется для выгрузки информации о переводе пациента в другую МО или палату. В случае успешной загрузки, возвращает ID документа движения на портале

Адрес метода: **/udata/data/uploadInterface/movement/1**

#### Формат загружаемых данных

```
#!xml

<?xml version="1.0" encoding="UTF-8"?>
<root key="3400" ip="127.0.0.1" port="30">
	<date>2019-09-01</date>
	<type>transfer</type>
	<card>20034</card>
	<destination>
		<branch>
			<name>Наименование принимающего МО</name>
			080001
			<num>7</num>
		</branch>
		<profiles>
			<department>96</department>
			<bed>73</bed>
		</profiles>
	</destination>
</root>

```

<table><thead><tr><th>Элемент</th><th>Обязательное</th><th>Описание</th></tr></thead><tbody><tr><td>date</td><td>да</td><td>дата выписки в формате Y-m-d</td></tr><tr><td>type</td><td>да</td><td>ID или GUID вида движения пациента [\#](https://bitbucket.org/panda_tamara/g-storage/wiki/%D0%92%D0%B8%D0%B4%D1%8B%20%D0%B4%D0%B2%D0%B8%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F%20%D0%BF%D0%B0%D1%86%D0%B8%D0%B5%D0%BD%D1%82%D0%B0)</td></tr><tr><td>card</td><td>да</td><td>номер карты</td></tr><tr><td>destination</td><td>да</td><td>нода содержит данные учреждения, в которое направляется пациент</td></tr><tr><td>destination/branch/name</td><td>да</td><td>наименование филиала медицинской организации</td></tr><tr><td>destination/branch/code</td><td>да</td><td>реестровый номер филиала или медицинской организации, 6 символов</td></tr><tr><td>destination/branch/num</td><td>нет</td><td>код подразделения филиала медицинской организации</td></tr><tr><td>destination/profiles/department</td><td>да</td><td>ID профиля отделения [\#](https://bitbucket.org/panda_tamara/g-storage/wiki/%D0%9F%D1%80%D0%BE%D1%84%D0%B8%D0%BB%D0%B8%20%D0%BE%D1%82%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D0%B9)</td></tr><tr><td>destination/profiles/bed</td><td>да</td><td>ID профиля койки [\#](https://bitbucket.org/panda_tamara/g-storage/wiki/%D0%9F%D1%80%D0%BE%D1%84%D0%B8%D0%BB%D0%B8%20%D0%BA%D0%BE%D0%B5%D0%BA)</td></tr></tbody></table>

##### Формат ответа

```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="uploadInterface" generation-time="0.903030">
    <response>
        200
        <data>
            <is_success>1</is_success>
            <id>1</id>
        </data>
    </response>
</udata>

```

<table><thead><tr><th>Элемент</th><th>Описание</th></tr></thead><tbody><tr><td>code</td><td>результат обращения к API</td></tr><tr><td>data/is\_success</td><td>результат обработки данных</td></tr><tr><td>data/id</td><td>ID документа движения на портале</td></tr></tbody></table>

# Выгрузка телемедицины

#### Описание

Метод используется для выгрузки информации о случае оказания телемедицинской консультации. В случае успешной загрузки, возвращает ID документа

Адрес метода: **/udata/data/uploadInterface/telemedicine/1**

#### Формат загружаемых данных

```
#!xml

<?xml version="1.0" encoding="UTF-8"?>
<root key="3400" ip="127.0.0.1" port="30">
    <id>1</id>
    <dateout_plan>2019-08-21</dateout_plan>
    <card>20034</card>
    <patient>
        <birthday>1991-06-10</birthday>
        <sex>м</sex>
        <phone>89188892937</phone>
        <fname>Петр</fname>
        <sname>Ивашов</sname>
        <lname>Карлович</lname>
        <policy>
            <type>enp</type>
            <company_code>03107</company_code>
            <num>2658800825000197</num>
        </policy>
    </patient>
    <clinic>
        <name>Наименование организации</name>
        <inn>0000000000</inn>
        <type>1</type>
    </clinic>
    <characteristics>Проверка</characteristics>
    <period>
        <from>2019-09-05</from>
        <to>2019-09-05</to>
    </period>
</root>

```

<table><thead><tr><th>Элемент</th><th>Обязательное</th><th>Описание</th></tr></thead><tbody><tr><td>id</td><td>да</td><td>Идентификация истории болезни</td></tr><tr><td>dateout_plan</td><td>нет</td><td>дата выписки в формате Y-m-d</td></tr><tr><td>card</td><td>да</td><td>Номер карты</td></tr><tr><td>patient</td><td>да</td><td>Пациент</td></tr><tr><td>clinic</td><td>да</td><td>Организация, проводившая телемедицину</td></tr><tr><td>characteristics</td><td>нет</td><td>Особые отметки</td></tr><tr><td>period</td><td>да</td><td>Период проведения телемедицина</td></tr></tbody></table>

##### Формат ответа

```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="uploadInterface" generation-time="0.903030">
    <response>
        200
        <data>
            <is_success>1</is_success>
            <id>1</id>
        </data>
    </response>
</udata>

```

<table><thead><tr><th>Элемент</th><th>Описание</th></tr></thead><tbody><tr><td>code</td><td>результат обращения к API</td></tr><tr><td>data/is\_success</td><td>результат обработки данных</td></tr><tr><td>data/id</td><td>ID документа движения на портале</td></tr></tbody></table>

# Получение данных

Методы по получению данных с портала госпитализации

# Новая страница



# Список направлений на госпитализацию

#### Описание

Возвращает список направлений на госпитализацию. Для доступа к методу применяется авторизация по токену

```
#!php

/udata/data/getDirections/{$planDateIn}/{$mode}/{$status}/{$form}/{$emergency}
```

| Параметр | Описание |
|-----|-----|
| $planDateIn | дата плановой госпитализации в формате 'Y-m-d' |
| $mode | объем возвращаемых данных: full или base |
| $status | ID или GUID статуса [#](https://docs.medicine-it.ru/books/portal-gospitalizacii/page/spravocnik-statusy) |
| $form | ID или GUID формы оказания помощи [#](https://docs.medicine-it.ru/books/portal-gospitalizacii/page/spravocnik-formy-okazaniia-pomoshhi) |
| $emergency | ID или GUID экстренности [#](https://docs.medicine-it.ru/books/portal-gospitalizacii/page/spravocnik-ekstrennost) |

#### Формат ответа в режиме FULL


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getDirections" generation-time="0.472266">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>20</id>
                <num>08000119000001</num>
                <date>2019-07-22</date>
                <datein_plan>2019-08-01</datein_plan>
                <dateon>2019-07-23 14:31:23</dateon>
                <dateupdate></dateupdate>
                <status>
                    <id>1</id>
                    <guid>added</guid>
                    <name>Зарегистрирован</name>
                    <is_active>1</is_active>
                </status>
                <form>
                    <id>1</id>
                    <guid>hospital</guid>
                    <name>стационар</name>
                    <is_active>1</is_active>
                </form>
                <emergency>
                    <id>1</id>
                    <guid>planned</guid>
                    <name>плановая</name>
                    <is_active>1</is_active>
                </emergency>
                <patient>
                    <id>24</id>
                    <birthday>1991-06-10</birthday>
                    <sex>м</sex>
                    <fname>Петр</fname>
                    <sname>Ивашов</sname>
                    <lname>Карлович</lname>
                    <phone>89188892937</phone>
                </patient>
                <policy>
                    <id>47</id>
                    <citizen_id>24</citizen_id>
                    <num>2658800825000197</num>
                    <is_active>1</is_active>
                    <type>
                        <id>3</id>
                        <guid>enp</guid>
                        <name>Полис ОМС единого образца</name>
                        <is_active>1</is_active>
                    </type>
                    <company>
                        <id>25</id>
                        <code>03107</code>
                        <name>ООО "СК "ИНГОССТРАХ-М"</name>
                        <region_code>03</region_code>
                        <is_active>1</is_active>
                    </company>
                </policy>
                <member></member>
                <member_policy></member_policy>
                <dir_branch>
                    <id>4</id>
                    <parent_id>1</parent_id>
                    <name>Наименование направившего МО</name>
                    <code>080001</code>
                    <num>3</num>
                    <address></address>
                    <is_active>1</is_active>
                </dir_branch>
                <dir_doctor>
                    <id>59</id>
                    <name>Храпунов Владимир Игнатович</name>
                    <branch_id>4</branch_id>
                    <snils>156-564-800 90</snils>
                    <is_active>1</is_active>
                </dir_doctor>
                <dir_diagnosis>
                    <id>5</id>
                    <code>I60.2</code>
                    <name>I60.2 - Субарахноидальное кровоизлияние из передней соединительной артерии</name>
                    <period_ksg>6</period_ksg>
                </dir_diagnosis>
                <dest_branch>
                    <id>168</id>
                    <parent_id></parent_id>
                    <name>Наименование принимающего МО</name>
                    <code>080001</code>
                    <num>7</num>
                    <address></address>
                    <is_active>1</is_active>
                </dest_branch>
                <dest_department>
                    <id>97</id>
                    <name>терапии</name>
                    <is_active>1</is_active>
                </dest_department>
                <dest_bed>
                    <id>72</id>
                    <department_profile_id>97</department_profile_id>
                    <name>терапевтические</name>
                    <is_active>1</is_active>
                </dest_bed>
            </item>
        </data>
    </response>
</udata>
```

#### Формат ответа в режиме BASE


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getDirections" generation-time="0.077477">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>20</id>
                <num>08000119000001</num>
                <date>2019-07-22</date>
                <status_id>1</status_id>
                <form_id>1</form_id>
                <emergency_id>1</emergency_id>
                <patient_id>24</patient_id>
                <policy_id>47</policy_id>
                <member_id></member_id>
                <member_policy_id></member_policy_id>
                <dir_branch_id>4</dir_branch_id>
                <dir_doctor_id>59</dir_doctor_id>
                <dir_diagnosis_id>5</dir_diagnosis_id>
                <dest_branch_id>168</dest_branch_id>
                <dest_department_id>97</dest_department_id>
                <dest_bed_id>72</dest_bed_id>
                <datein_plan>2019-08-01</datein_plan>
                <dateon>2019-07-23 14:31:23</dateon>
                <dateupdate></dateupdate>
            </item>
        </data>
    </response>
</udata>

```

# Список госпитализаций

#### Описание

Возвращает cписок госпитализаций. Для доступа к методу применяется авторизация по токену

```
#!php

/udata/data/getHospitalizations/{$date}/{$mode}/{$status}/{$form}/{$emergency}
```

| Параметр | Описание |
|-----|-----|
| $date | дата госпитализации в формате 'Y-m-d' |
| $mode | объем возвращаемых данных: full или base |
| $status | ID или GUID статуса [#](https://docs.medicine-it.ru/books/portal-gospitalizacii/page/spravocnik-statusy) |
| $form | ID или GUID формы оказания помощи [#](https://docs.medicine-it.ru/books/portal-gospitalizacii/page/spravocnik-formy-okazaniia-pomoshhi) |
| $emergency | ID или GUID экстренности [#](https://docs.medicine-it.ru/books/portal-gospitalizacii/page/spravocnik-ekstrennost) |

#### Формат ответа в режиме FULL


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getHospitalizations" generation-time="0.787981">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>7</id>
                <direction_id></direction_id>
                <date>2019-08-01</date>
                <dest_card_num>20036</dest_card_num>
                <datein_fact>2019-08-01 13:14:00</datein_fact>
                <dateout_plan>2019-08-21</dateout_plan>
                <dateout_fact></dateout_fact>
                <dateon>2019-08-01 10:51:59</dateon>
                <dateupdate></dateupdate>
                <status>
                    <id>1</id>
                    <guid>added</guid>
                    <name>Зарегистрирован</name>
                    <is_active>1</is_active>
                </status>
                <form>
                    <id>1</id>
                    <guid>hospital</guid>
                    <name>стационар</name>
                    <is_active>1</is_active>
                </form>
                <emergency>
                    <id>3</id>
                    <guid>extra</guid>
                    <name>экстренная</name>
                    <is_active>1</is_active>
                </emergency>
                <patient>
                    <id>24</id>
                    <birthday>1991-06-10</birthday>
                    <sex>м</sex>
                    <fname>Петр</fname>
                    <sname>Ивашов</sname>
                    <lname>Карлович</lname>
                    <phone>89188892937</phone>
                </patient>
                <policy>
                    <id>47</id>
                    <citizen_id>24</citizen_id>
                    <num>2658800825000197</num>
                    <is_active>1</is_active>
                    <type>
                        <id>3</id>
                        <guid>enp</guid>
                        <name>Полис ОМС единого образца</name>
                        <is_active>1</is_active>
                    </type>
                    <company>
                        <id>25</id>
                        <code>03107</code>
                        <name>ООО "СК "ИНГОССТРАХ-М"</name>
                        <region_code>03</region_code>
                        <is_active>1</is_active>
                    </company>
                </policy>
                <member></member>
                <member_policy></member_policy>
                <dir_branch>
                    <id>4</id>
                    <parent_id>1</parent_id>
                    <name>Наименование направившего МО</name>
                    <code>080001</code>
                    <num>3</num>
                    <address></address>
                    <is_active>1</is_active>
                </dir_branch>
                <dest_branch>
                    <id>6</id>
                    <parent_id>1</parent_id>
                    <name>Пример добавления</name>
                    <code>080002</code>
                    <num>5</num>
                    <address>Ул Ромашка</address>
                    <is_active>1</is_active>
                </dest_branch>
                <dest_diagnosis>
                    <id>5</id>
                    <code>I60.2</code>
                    <name>I60.2 - Субарахноидальное кровоизлияние из передней соединительной артерии</name>
                    <period_ksg>6</period_ksg>
                </dest_diagnosis>
                <dest_department>
                    <id>97</id>
                    <name>терапии</name>
                    <is_active>1</is_active>
                </dest_department>
                <dest_bed>
                    <id>72</id>
                    <department_profile_id>97</department_profile_id>
                    <name>терапевтические</name>
                    <is_active>1</is_active>
                </dest_bed>
            </item>
        </data>
    </response>
</udata>
```

#### Формат ответа в режиме BASE


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getHospitalizations" generation-time="0.113177">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>7</id>
                <direction_id></direction_id>
                <date>2019-08-01</date>
                <status_id>1</status_id>
                <form_id>1</form_id>
                <emergency_id>3</emergency_id>
                <patient_id>24</patient_id>
                <policy_id>47</policy_id>
                <member_id></member_id>
                <member_policy_id></member_policy_id>
                <dir_branch_id>4</dir_branch_id>
                <dest_branch_id>6</dest_branch_id>
                <dest_diagnosis_id>5</dest_diagnosis_id>
                <dest_department_id>97</dest_department_id>
                <dest_bed_id>72</dest_bed_id>
                <dest_card_num>20036</dest_card_num>
                <datein_fact>2019-08-01 13:14:00</datein_fact>
                <dateout_plan>2019-08-21</dateout_plan>
                <dateout_fact></dateout_fact>
                <dateon>2019-08-01 10:51:59</dateon>
                <dateupdate></dateupdate>
            </item>
        </data>
    </response>
</udata>

```

# Список документов аннулирования направлений

#### Описание

Возвращает список документов аннулирования направлений на госпитализацию. Для доступа к методу применяется авторизация по токену

```
#!php

/udata/data/getAnnulments/{$date}/{$mode}/{$reason}/{$source}
```

| Параметр | Описание |
|-----|-----|
| $date | дата аннулирования в формате 'Y-m-d' |
| $mode | объем возвращаемых данных: full или base |
| $reason | ID или GUID причины аннулирования [#](https://docs.medicine-it.ru/books/portal-gospitalizacii/page/spravocnik-priciny-annulirovaniia-napravleniia) |
| $source | ID или GUID источника аннулирования [#](https://docs.medicine-it.ru/books/portal-gospitalizacii/page/spravocnik-istocniki-annulirovaniia-napravleniia) |

#### Формат ответа в режиме FULL


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getAnnulments" generation-time="0.080738">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>1</id>
                <date>2019-08-05</date>
                <direction_id>27</direction_id>
                <dateon>2019-08-05 09:58:17</dateon>
                <dateupdate></dateupdate>
                <reason>
                    <id>2</id>
                    <guid>docs</guid>
                    <name>Непредоставление необходимого пакета документов (отказ медицинской организации, оказывающей медицинскую помощь в стационарных условиях)</name>
                    <is_active>1</is_active>
                </reason>
                <source>
                    <id>2</id>
                    <guid>hospital</guid>
                    <name>Медицинские организации, оказывающие медицинскую помощь в стационарных условиях</name>
                    <is_active>1</is_active>
                </source>
                <branch>
                    <id>227</id>
                    <parent_id></parent_id>
                    <name>Наименование МО отменившей напрвление</name>
                    <code>080020</code>
                    <num>3</num>
                    <address></address>
                    <is_active>1</is_active>
                </branch>
            </item>
        </data>
    </response>
</udata>
```

#### Формат ответа в режиме BASE


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getAnnulments" generation-time="0.080819">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>1</id>
                <date>2019-08-05</date>
                <direction_id>27</direction_id>
                <reason_id>2</reason_id>
                <source_id>2</source_id>
                <branch_id>227</branch_id>
                <dateon>2019-08-05 09:58:17</dateon>
                <dateupdate></dateupdate>
            </item>
        </data>
    </response>
</udata>

```

# Список движений пациента

#### Описание

Возвращает информацию о документах движения пациента по номеру карты. Для доступа к методу применяется авторизация по токену

```
#!php

/udata/data/getMovementsByHospitalizationCard/{$cardNum}/{$mode}/
```

| Параметр | Описание
|-----|-----|
| $cardNum | номер карты |
| $mode | объем возвращаемых данных: full или base |

#### Формат ответа в режиме FULL


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getMovementsByHospitalizationCard" generation-time="0.246800">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>1</id>
                <date>2019-08-05</date>
                <hospitalization_id>7</hospitalization_id>
                <dateon>2019-08-08 13:48:53</dateon>
                <dateupdate></dateupdate>
                <type>
                    <id>2</id>
                    <guid>moveout</guid>
                    <name>Выписка</name>
                    <is_active>1</is_active>
                </type>
                <dest_branch></dest_branch>
                <dest_department></dest_department>
                <dest_bed></dest_bed>
            </item>
            <item>
                <id>10</id>
                <date>2019-09-01</date>
                <hospitalization_id>7</hospitalization_id>
                <dateon>2019-08-08 14:58:30</dateon>
                <dateupdate></dateupdate>
                <type>
                    <id>1</id>
                    <guid>transfer</guid>
                    <name>Перевод</name>
                    <is_active>1</is_active>
                </type>
                <dest_branch>
                    <id>168</id>
                    <parent_id></parent_id>
                    <name>Наименование принимающего МО</name>
                    <code>080001</code>
                    <num>7</num>
                    <address></address>
                    <is_active>1</is_active>
                </dest_branch>
                <dest_department>
                    <id>96</id>
                    <name>сурдологии-оториноларингологии</name>
                    <is_active>1</is_active>
                </dest_department>
                <dest_bed>
                    <id>73</id>
                    <department_profile_id>98</department_profile_id>
                    <name>токсикологические</name>
                    <is_active>1</is_active>
                </dest_bed>
            </item>
        </data>
    </response>
</udata>
```

#### Формат ответа в режиме BASE


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getMovementsByHospitalizationCard" generation-time="0.091602">
    <response>
        <code>200</code>
        <data>
            <item>
                <id>1</id>
                <date>2019-08-05</date>
                <hospitalization_id>7</hospitalization_id>
                <type_id>2</type_id>
                <dest_branch_id></dest_branch_id>
                <dest_department_id></dest_department_id>
                <dest_bed_id></dest_bed_id>
                <dateon>2019-08-08 13:48:53</dateon>
                <dateupdate></dateupdate>
            </item>
            <item>
                <id>10</id>
                <date>2019-09-01</date>
                <hospitalization_id>7</hospitalization_id>
                <type_id>1</type_id>
                <dest_branch_id>168</dest_branch_id>
                <dest_department_id>96</dest_department_id>
                <dest_bed_id>73</dest_bed_id>
                <dateon>2019-08-08 14:58:30</dateon>
                <dateupdate></dateupdate>
            </item>
        </data>
    </response>
</udata>

```

# Информация о направлении

#### Описание

Возвращает информацию о направлении по номеру. Для доступа к методу применяется авторизация по токену

```
#!php

/udata/data/getDirectionByNum/{$directionNum}/{$mode}/
```

| Параметр | Описание
|-----|-----|
| $directionNum | номер направления |
| $mode | объем возвращаемых данных: full или base |

#### Формат ответа в режиме FULL #


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getDirectionByNum" generation-time="4.091034">
    <response>
        <code>200</code>
        <data>
            <id>27</id>
            <num>08000119000008</num>
            <date>2019-07-22</date>
            <datein_plan>2019-08-01</datein_plan>
            <dateon>2019-07-23 16:43:46</dateon>
            <dateupdate></dateupdate>
            <status>
                <id>2</id>
                <guid>canceled</guid>
                <name>Аннулирован</name>
                <is_active>1</is_active>
            </status>
            <form>
                <id>1</id>
                <guid>hospital</guid>
                <name>стационар</name>
                <is_active>1</is_active>
            </form>
            <emergency>
                <id>1</id>
                <guid>planned</guid>
                <name>плановая</name>
                <is_active>1</is_active>
            </emergency>
            <patient>
                <id>24</id>
                <birthday>1991-06-10</birthday>
                <sex>м</sex>
                <fname>Петр</fname>
                <sname>Ивашов</sname>
                <lname>Карлович</lname>
                <phone>89188892937</phone>
            </patient>
            <policy>
                <id>47</id>
                <citizen_id>24</citizen_id>
                <num>2658800825000197</num>
                <is_active>1</is_active>
                <type>
                    <id>3</id>
                    <guid>enp</guid>
                    <name>Полис ОМС единого образца</name>
                    <is_active>1</is_active>
                </type>
                <company>
                    <id>25</id>
                    <code>03107</code>
                    <name>ООО "СК "ИНГОССТРАХ-М"</name>
                    <region_code>03</region_code>
                    <is_active>1</is_active>
                </company>
            </policy>
            <member></member>
            <member_policy></member_policy>
            <dir_branch>
                <id>4</id>
                <parent_id>1</parent_id>
                <name>Наименование направившего МО</name>
                <code>080001</code>
                <num>3</num>
                <address></address>
                <is_active>1</is_active>
            </dir_branch>
            <dir_doctor>
                <id>59</id>
                <name>Храпунов Владимир Игнатович</name>
                <branch_id>4</branch_id>
                <snils>156-564-800 90</snils>
                <is_active>1</is_active>
            </dir_doctor>
            <dir_diagnosis>
                <id>5</id>
                <code>I60.2</code>
                <name>I60.2 - Субарахноидальное кровоизлияние из передней соединительной артерии</name>
                <period_ksg>6</period_ksg>
            </dir_diagnosis>
            <dest_branch>
                <id>168</id>
                <parent_id></parent_id>
                <name>Наименование принимающего МО</name>
                <code>080001</code>
                <num>7</num>
                <address></address>
                <is_active>1</is_active>
            </dest_branch>
            <dest_department>
                <id>97</id>
                <name>терапии</name>
                <is_active>1</is_active>
            </dest_department>
            <dest_bed>
                <id>72</id>
                <department_profile_id>97</department_profile_id>
                <name>терапевтические</name>
                <is_active>1</is_active>
            </dest_bed>
        </data>
    </response>
</udata>
```

##### Формат ответа в режиме BASE


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getDirectionByNum" generation-time="0.100544">
    <response>
        <code>200</code>
        <data>
            <id>27</id>
            <num>08000119000008</num>
            <date>2019-07-22</date>
            <status_id>2</status_id>
            <form_id>1</form_id>
            <emergency_id>1</emergency_id>
            <patient_id>24</patient_id>
            <policy_id>47</policy_id>
            <member_id></member_id>
            <member_policy_id></member_policy_id>
            <dir_branch_id>4</dir_branch_id>
            <dir_doctor_id>59</dir_doctor_id>
            <dir_diagnosis_id>5</dir_diagnosis_id>
            <dest_branch_id>168</dest_branch_id>
            <dest_department_id>97</dest_department_id>
            <dest_bed_id>72</dest_bed_id>
            <datein_plan>2019-08-01</datein_plan>
            <dateon>2019-07-23 16:43:46</dateon>
            <dateupdate></dateupdate>
        </data>
    </response>
</udata>

```

# Информация о госпитализации по номеру направления

#### Описание

Возвращает информацию о госпитализации по номеру направления. Для доступа к методу применяется авторизация по токену

```
#!php

/udata/data/getHospitalizationByDirectionNum/{$directionNum}/{$mode}/
```

| Параметр | Описание
|-----|-----|
| $directionNum | номер направления |
| $mode | объем возвращаемых данных: full или base |

#### Формат ответа в режиме FULL


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getHospitalizationByDirectionNum" generation-time="2.469769">
    <response>
        <code>200</code>
        <data>
            <id>3</id>
            <direction_id>27</direction_id>
            <date>2019-08-01</date>
            <dest_card_num>20034</dest_card_num>
            <datein_fact>2019-08-01 13:14:00</datein_fact>
            <dateout_plan>2019-08-21</dateout_plan>
            <dateout_fact>2019-08-05</dateout_fact>
            <dateon>2019-08-01 10:44:27</dateon>
            <dateupdate></dateupdate>
            <status>
                <id>1</id>
                <guid>added</guid>
                <name>Зарегистрирован</name>
                <is_active>1</is_active>
            </status>
            <form>
                <id>1</id>
                <guid>hospital</guid>
                <name>стационар</name>
                <is_active>1</is_active>
            </form>
            <emergency>
                <id>1</id>
                <guid>planned</guid>
                <name>плановая</name>
                <is_active>1</is_active>
            </emergency>
            <patient>
                <id>24</id>
                <birthday>1991-06-10</birthday>
                <sex>м</sex>
                <fname>Петр</fname>
                <sname>Ивашов</sname>
                <lname>Карлович</lname>
                <phone>89188892937</phone>
            </patient>
            <policy>
                <id>47</id>
                <citizen_id>24</citizen_id>
                <num>2658800825000197</num>
                <is_active>1</is_active>
                <type>
                    <id>3</id>
                    <guid>enp</guid>
                    <name>Полис ОМС единого образца</name>
                    <is_active>1</is_active>
                </type>
                <company>
                    <id>25</id>
                    <code>03107</code>
                    <name>ООО "СК "ИНГОССТРАХ-М"</name>
                    <region_code>03</region_code>
                    <is_active>1</is_active>
                </company>
            </policy>
            <member>
                <id>24</id>
                <birthday>1991-06-10</birthday>
                <sex>м</sex>
                <fname>Петр</fname>
                <sname>Ивашов</sname>
                <lname>Карлович</lname>
                <phone>89188892937</phone>
            </member>
            <member_policy>
                <id>47</id>
                <citizen_id>24</citizen_id>
                <num>2658800825000197</num>
                <is_active>1</is_active>
                <type>
                    <id>3</id>
                    <guid>enp</guid>
                    <name>Полис ОМС единого образца</name>
                    <is_active>1</is_active>
                </type>
                <company>
                    <id>25</id>
                    <code>03107</code>
                    <name>ООО "СК "ИНГОССТРАХ-М"</name>
                    <region_code>03</region_code>
                    <is_active>1</is_active>
                </company>
            </member_policy>
            <dir_branch>
                <id>4</id>
                <parent_id>1</parent_id>
                <name>Наименование направившего МО</name>
                <code>080001</code>
                <num>3</num>
                <address></address>
                <is_active>1</is_active>
            </dir_branch>
            <dest_branch>
                <id>168</id>
                <parent_id></parent_id>
                <name>Наименование принимающего МО</name>
                <code>080001</code>
                <num>7</num>
                <address></address>
                <is_active>1</is_active>
            </dest_branch>
            <dest_diagnosis>
                <id>5</id>
                <code>I60.2</code>
                <name>I60.2 - Субарахноидальное кровоизлияние из передней соединительной артерии</name>
                <period_ksg>6</period_ksg>
            </dest_diagnosis>
            <dest_department>
                <id>96</id>
                <name>сурдологии-оториноларингологии</name>
                <is_active>1</is_active>
            </dest_department>
            <dest_bed>
                <id>73</id>
                <department_profile_id>98</department_profile_id>
                <name>токсикологические</name>
                <is_active>1</is_active>
            </dest_bed>
        </data>
    </response>
</udata>
```

#### Формат ответа в режиме BASE


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getHospitalizationByDirectionNum" generation-time="0.093314">
    <response>
        <code>200</code>
        <data>
            <id>3</id>
            <direction_id>27</direction_id>
            <date>2019-08-01</date>
            <status_id>1</status_id>
            <form_id>1</form_id>
            <emergency_id>1</emergency_id>
            <patient_id>24</patient_id>
            <policy_id>47</policy_id>
            <member_id>24</member_id>
            <member_policy_id>47</member_policy_id>
            <dir_branch_id>4</dir_branch_id>
            <dest_branch_id>168</dest_branch_id>
            <dest_diagnosis_id>5</dest_diagnosis_id>
            <dest_department_id>96</dest_department_id>
            <dest_bed_id>73</dest_bed_id>
            <dest_card_num>20034</dest_card_num>
            <datein_fact>2019-08-01 13:14:00</datein_fact>
            <dateout_plan>2019-08-21</dateout_plan>
            <dateout_fact>2019-08-05</dateout_fact>
            <dateon>2019-08-01 10:44:27</dateon>
            <dateupdate></dateupdate>
        </data>
    </response>
</udata>

```

# Информация о госпитализации по номеру карты

#### Описание

Возвращает информацию о госпитализации по номеру карты. Для доступа к методу применяется авторизация по токену

```
#!php

/udata/data/getHospitalizationByCardNum/{$card}/{$mode}/
```

| Параметр | Описание
|-----|-----|
| $card | номер карты |
| $mode | объем возвращаемых данных: full или base |

#### Формат ответа в режиме FULL


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getHospitalizationByCardNum" generation-time="0.137682">
    <response>
        <code>200</code>
        <data>
            <id>3</id>
            <direction_id>27</direction_id>
            <date>2019-08-01</date>
            <dest_card_num>20034</dest_card_num>
            <datein_fact>2019-08-01 13:14:00</datein_fact>
            <dateout_plan>2019-08-21</dateout_plan>
            <dateout_fact>2019-08-05</dateout_fact>
            <dateon>2019-08-01 10:44:27</dateon>
            <dateupdate></dateupdate>
            <status>
                <id>1</id>
                <guid>added</guid>
                <name>Зарегистрирован</name>
                <is_active>1</is_active>
            </status>
            <form>
                <id>1</id>
                <guid>hospital</guid>
                <name>стационар</name>
                <is_active>1</is_active>
            </form>
            <emergency>
                <id>1</id>
                <guid>planned</guid>
                <name>плановая</name>
                <is_active>1</is_active>
            </emergency>
            <patient>
                <id>24</id>
                <birthday>1991-06-10</birthday>
                <sex>м</sex>
                <fname>Петр</fname>
                <sname>Ивашов</sname>
                <lname>Карлович</lname>
                <phone>89188892937</phone>
            </patient>
            <policy>
                <id>47</id>
                <citizen_id>24</citizen_id>
                <num>2658800825000197</num>
                <is_active>1</is_active>
                <type>
                    <id>3</id>
                    <guid>enp</guid>
                    <name>Полис ОМС единого образца</name>
                    <is_active>1</is_active>
                </type>
                <company>
                    <id>25</id>
                    <code>03107</code>
                    <name>ООО "СК "ИНГОССТРАХ-М"</name>
                    <region_code>03</region_code>
                    <is_active>1</is_active>
                </company>
            </policy>
            <member>
                <id>24</id>
                <birthday>1991-06-10</birthday>
                <sex>м</sex>
                <fname>Петр</fname>
                <sname>Ивашов</sname>
                <lname>Карлович</lname>
                <phone>89188892937</phone>
            </member>
            <member_policy>
                <id>47</id>
                <citizen_id>24</citizen_id>
                <num>2658800825000197</num>
                <is_active>1</is_active>
                <type>
                    <id>3</id>
                    <guid>enp</guid>
                    <name>Полис ОМС единого образца</name>
                    <is_active>1</is_active>
                </type>
                <company>
                    <id>25</id>
                    <code>03107</code>
                    <name>ООО "СК "ИНГОССТРАХ-М"</name>
                    <region_code>03</region_code>
                    <is_active>1</is_active>
                </company>
            </member_policy>
            <dir_branch>
                <id>4</id>
                <parent_id>1</parent_id>
                <name>Наименование направившего МО</name>
                <code>080001</code>
                <num>3</num>
                <address></address>
                <is_active>1</is_active>
            </dir_branch>
            <dest_branch>
                <id>168</id>
                <parent_id></parent_id>
                <name>Наименование принимающего МО</name>
                <code>080001</code>
                <num>7</num>
                <address></address>
                <is_active>1</is_active>
            </dest_branch>
            <dest_diagnosis>
                <id>5</id>
                <code>I60.2</code>
                <name>I60.2 - Субарахноидальное кровоизлияние из передней соединительной артерии</name>
                <period_ksg>6</period_ksg>
            </dest_diagnosis>
            <dest_department>
                <id>96</id>
                <name>сурдологии-оториноларингологии</name>
                <is_active>1</is_active>
            </dest_department>
            <dest_bed>
                <id>73</id>
                <department_profile_id>98</department_profile_id>
                <name>токсикологические</name>
                <is_active>1</is_active>
            </dest_bed>
        </data>
    </response>
</udata>
```

#### Формат ответа в режиме BASE


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getHospitalizationByCardNum" generation-time="0.063423">
    <response>
        <code>200</code>
        <data>
            <id>3</id>
            <direction_id>27</direction_id>
            <date>2019-08-01</date>
            <status_id>1</status_id>
            <form_id>1</form_id>
            <emergency_id>1</emergency_id>
            <patient_id>24</patient_id>
            <policy_id>47</policy_id>
            <member_id>24</member_id>
            <member_policy_id>47</member_policy_id>
            <dir_branch_id>4</dir_branch_id>
            <dest_branch_id>168</dest_branch_id>
            <dest_diagnosis_id>5</dest_diagnosis_id>
            <dest_department_id>96</dest_department_id>
            <dest_bed_id>73</dest_bed_id>
            <dest_card_num>20034</dest_card_num>
            <datein_fact>2019-08-01 13:14:00</datein_fact>
            <dateout_plan>2019-08-21</dateout_plan>
            <dateout_fact>2019-08-05</dateout_fact>
            <dateon>2019-08-01 10:44:27</dateon>
            <dateupdate></dateupdate>
        </data>
    </response>
</udata>

```

# Информация об аннулировании

#### Описание

Возвращает информацию о документе аннулирования по номеру направления. Для доступа к методу применяется авторизация по токену

```
#!php

/udata/data/getAnnulmentByDirectionNum/{$directionNum}/{$mode}/
```

| Параметр | Описание
|-----|-----|-----|
| $directionNum | номер направления |
| $mode | объем возвращаемых данных: full или base |

#### Формат ответа в режиме FULL


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getAnnulmentByDirectionNum" generation-time="3.691715">
    <response>
        <code>200</code>
        <data>
            <id>1</id>
            <date>2019-08-05</date>
            <direction_id>27</direction_id>
            <dateon>2019-08-05 09:58:17</dateon>
            <dateupdate></dateupdate>
            <reason>
                <id>2</id>
                <guid>docs</guid>
                <name>Непредоставление необходимого пакета документов (отказ медицинской организации, оказывающей медицинскую помощь в стационарных условиях)</name>
                <is_active>1</is_active>
            </reason>
            <source>
                <id>2</id>
                <guid>hospital</guid>
                <name>Медицинские организации, оказывающие медицинскую помощь в стационарных условиях</name>
                <is_active>1</is_active>
            </source>
            <branch>
                <id>227</id>
                <parent_id></parent_id>
                <name>Наименование МО отменившей напрвление</name>
                <code>080020</code>
                <num>3</num>
                <address></address>
                <is_active>1</is_active>
            </branch>
        </data>
    </response>
</udata>
```

#### Формат ответа в режиме BASE


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getAnnulmentByDirectionNum" generation-time="0.092778">
    <response>
        <code>200</code>
        <data>
            <id>1</id>
            <date>2019-08-05</date>
            <direction_id>27</direction_id>
            <reason_id>2</reason_id>
            <source_id>2</source_id>
            <branch_id>227</branch_id>
            <dateon>2019-08-05 09:58:17</dateon>
            <dateupdate></dateupdate>
        </data>
    </response>
</udata>

```

# Информация о наличии свободных мест на госпитализацию

#### Описание

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

#### Формат запроса

```
#!php

/udata/stat/getAvailabilityBedsReport/{$codeMO}/{$date}/
```

| Параметр | Описание
|-----|-----|
| $codeMO | реестровый номер медицинской организации, 6 символов |
| $date | дата, за которую нужны сведения |

#### Формат ответа


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="stat" method="getAvailabilityBedsReport" generation-time="0.251231">
    <response>
        <code>200</code>
        <data>
            <branches>
                <branch code="260001" num="30">
                    <profiles>
                        <profile id="4" name="беременных и рожениц (акушерство и гинекология)">
                            <patients>
                                <register>0</register>
                                <movein>0</movein>
                                <moveout>0</moveout>
                                <planned>0</planned>
                            </patients>
                            <beds>
                                <total>0</total>
                                <man>0</man>
                                <woman>0</woman>
                                <child>0</child>
                            </beds>
                        </profile>
                        <profile id="72" name="терапевтические">
                            <patients>
                                <register>1</register>
                                <movein>0</movein>
                                <moveout>0</moveout>
                                <planned>1</planned>
                            </patients>
                            <beds>
                                <total>109</total>
                                <man>29</man>
                                <woman>10</woman>
                                <child>0</child>
                            </beds>
                        </profile>
                    </profiles>
                </branch>
            </branches>
        </data>
    </response>
</udata>
```

| Нода | Описание
|-----|-----|
| branch | филиал медицинской организации |
| profile | профиль койки |
| patients/register | общее количество пациентов, находящихся на госпитализации |
| patients/movein | количество поступивших пациентов за дату $date|
| patients/moveout | количество выписанных пациентов за дату $date |
| patients/planned | количество запланированных госпитализаций на дату $date |
| beds/total | количество свободных коек на дату $date |
| beds/man | количество мужских свободных коек на дату $date |
| beds/woman | количество женских свободных коек на дату $date |
| beds/child | количество детских свободных коек на дату $date |

# Информация о наличии направлении по номеру

#### Описание

Возвращает факт наличия на портале госпитализации направления с указанным номером и датой выдачи (опционально)

#### Формат запроса

```
#!php

/udata/data/isExistDirectionByNum/{$directionNum}/{$directionDate}/
```

| Параметр | Описание
|-----|-----|
| $directionNum | номер направления |
| $directionDate | дата выдачи направления |

#### Формат ответа


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="isExistDirectionByNum" generation-time="0.059321">
    <response>
        <code>200</code>
        <data>1</data>
    </response>
</udata>
```

| Нода | Описание
|-----|-----|
| data| 1 - направление найдено. Нода отсутствует, если направления нет |

# Информация о наличии направлении по параметрам

#### Описание

Возвращает факт наличия на портале госпитализации направления с поиском по произвольным параметрам направления

#### Формат запроса

```
#!php

/udata/data/isExistDirectionByParams/?data[param1]=value1&data[param2]=value2....&data[paramN]=valueN
```

| Параметры поиска | Описание
|-----|-----|
| num| номер направления |
| date | дата выдачи направления |
| policy | номер полиса пациента |
| dir_branch_code | реестровый номер направившего МО, 6 символов |
| dest_branch_code | реестровый номер МО, в которое направили пациента 6 символов |
| is_used | проводилась ли госпитализация по направлению |


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

```
#!php

/udata/data/isExistDirectionByParams/?data[num]=08000120000003&data[date]=2020-03-05&data[policy]=0678950824000019&data[dir_branch_code]=060013&data[dest_branch_code]=060003
```


#### Формат ответа


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="isExistDirectionByParams" generation-time="0.059321">
    <response>
        <code>200</code>
        <data>1</data>
    </response>
</udata>
```

| Нода | Описание
|-----|-----|
| data| 1 - направление найдено. Нода отсутствует, если направления нет |

# Дополнительно



# Авторизация по токену

<p id="bkmrk-%D0%94%D0%BB%D1%8F-%D0%BE%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%BA%D0%B8-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE"><span style="color: rgb(23, 43, 77); font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; display: inline !important; float: none;">Для отправки запросов на выгрузку или выдачу данных, клиенты филиалов медицинских учреждений должны проходить авторизацию по уникальному токену. Описание процедуры получения токена</span><span style="color: rgb(23, 43, 77); font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial; display: inline !important; float: none;">. Токен не имеет времени жизни и должен отправляться при каждом запросе в HTTP Authorization header</span></p>
<h5 id="bkmrk-%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80-%D0%B7%D0%B0%D0%B3%D0%BE%D0%BB%D0%BE%D0%B2%D0%BA%D0%B0-%D0%B4%D0%BB%D1%8F">Пример заголовка для авторизации</h5>
<pre id="bkmrk-authorization%3A-beare">Authorization: Bearer v2.local.E8H79zjDK3CXCdzYna6XSJ6291zLetUTZktPt41AnBEUq8u6NvwS2ieKtVHOg7AvQhf3CSUy8DKOvAbCV7wKqj5XOg
</pre>

# Внешний IP филиала

<p id="bkmrk-%D0%92-%D1%81%D0%BB%D1%83%D1%87%D0%B0%D0%B5%2C-%D0%B5%D1%81%D0%BB%D0%B8-%D1%83-%D1%84%D0%B8%D0%BB" style="margin: 12px 0px 0px; padding: 0px; overflow-wrap: break-word; color: rgb(23, 43, 77); font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;">В случае, если у филиала нет белого статического IP адреса, информацию о внешнем IP вы можете получить по этому методу</p>
<p id="bkmrk-%2Fudata%2Fdata%2Fgetbranc" style="margin: 12px 0px 0px; padding: 0px; overflow-wrap: break-word; color: rgb(23, 43, 77); font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"><code>/udata/data/getBranchRemoteIp/</code></p>
<h5 id="bkmrk-%D0%A4%D0%BE%D1%80%D0%BC%D0%B0%D1%82-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0">Формат ответа</h5>
<pre id="bkmrk-%3C%3Fxml-version%3D%221.0%22-"><code class="language-xml">&lt;?xml version="1.0" encoding="utf-8"?&gt;
&lt;udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="getBranchRemoteIp" generation-time="0.104480"&gt;
    &lt;response&gt;
        &lt;code&gt;200&lt;/code&gt;
        &lt;data&gt;168.200.0.1&lt;/data&gt;
    &lt;/response&gt;
&lt;/udata&gt;</code></pre>
<p id="bkmrk-" style="margin: 12px 0px 0px; padding: 0px; overflow-wrap: break-word; color: rgb(23, 43, 77); font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"></p>

# Описание ошибок

##### Формат


```
#!xml

<?xml version="1.0" encoding="utf-8"?>
<udata xmlns:xlink="http://www.w3.org/TR/xlink" module="data" method="uploadInterface" generation-time="0.903030">
    <response>
        <code>200</code>
        <data>
            <is_success>0</is_success>
            <error>205</error>
            <message>Не корректный код МО «1002»</message>
        </data>
    </response>
</udata>
```

| Код ошибки |  Описание |
|-----|-----|
| **100** | Не передан XML файл |
| **101** | Ошибка, при сохранении XML |
| **102** | Ошибка при чтения XML файла |
| **103** | Неизвестный тип файла |
| **104** | Ошибка, при выполнении SQL запроса |
| **105** | У ноды «%s» отсутствует обязательный параметр или нода «%s» |
| **106** | Дублирование уникальных идентификаторов в одном файле. %s |
| **107** | Не передан тип загружаемых данных |
| **108** | Не переданы данные для отправки результата загрузки |
| **109** | Загрузка данных прошла с ошибками |
| **110** | Филиал медицинской организация не распознан |
| **200** | Передан не известный GUID «%s» |
| **201** | Не корректный снилс %s |
| **202** | Не корректный номер телефона %s |
| **203** | Не корректный номер полиса %s |
| **205** | Не корректный код МО «%s» |
| **206** | Не корректный формат даты «%s» |
| **207** | Запись «%s» содержит не числовые символы |
| **300** | Не указан номер направления |
| **301** | Направление с номером «%s» не найдено |
| **302** | Госпитализация с направлением «%s» уже загружалась |
| **303** | Госпитализации с картой «%s» не найдено |
| **304** | Госпитализация для карты «%s» уже закрыта |
| **305** | Страховая с кодом «%s» не найдена |
| **306** | Филиал с кодом «%s» не зарегистрирован на портале |
| **307** | Направление с номером «%s» выдано в другое учреждение |
| **308** | В филиале с кодом «%s» нет свободных коек с профилем «%s» |
| **309** | Передан не известный диагноз «%s» |
| **401** | Неудачная попытка авторизации |