API (Кинт) — различия между версиями

Материал из КинтВики
Перейти к: навигация, поиск
(Изменение документов)
(СписокПриложений)
 
(не показано 60 промежуточных версий 3 участников)
Строка 41: Строка 41:
 
   |<code>Реквизиты</code>
 
   |<code>Реквизиты</code>
 
   |<code>Fields</code>
 
   |<code>Fields</code>
   |Задаёт перечень реквизитов, которые должны быть переданы вместе с ссылками на элементы
+
   |Задаёт перечень реквизитов, которые должны быть переданы вместе с ссылками на элементы. Поддерживается получение нестандартных реквизитов: ПредставлениеОбъекта, Идентификатор, GUID.
 
   |<code>Ссылка,Контрагент,КонтактноеЛицо,Договор</code>
 
   |<code>Ссылка,Контрагент,КонтактноеЛицо,Договор</code>
 
   |''Не задано''
 
   |''Не задано''
Строка 139: Строка 139:
  
 
Если произвести авторизацию не представляется возможным, можно произвести публикацию базы с беcпарольной аутентификацией (когда пользователь и его пароль прописаны на веб-сервере в '''<code>default.vrd</code>'''), но имейте в виду, что в таком случае любой, у кого будет ссылка на неё, сможет заходить в базу через режим 1С: Предприятие, если соответствующие права у пользователя имеются.
 
Если произвести авторизацию не представляется возможным, можно произвести публикацию базы с беcпарольной аутентификацией (когда пользователь и его пароль прописаны на веб-сервере в '''<code>default.vrd</code>'''), но имейте в виду, что в таком случае любой, у кого будет ссылка на неё, сможет заходить в базу через режим 1С: Предприятие, если соответствующие права у пользователя имеются.
 +
 +
== Пагинация ==
 +
Доступно получение не всего результата запроса, а частями по страницам с сохранением порядка записей.
 +
Для получения количества записей можно воспользоваться методом [[#КоличествоЭлементов|КоличествоЭлементов]].
 +
 +
{| class="wikitable"
 +
  !|Имя параметра на русском
 +
  !|Имя параметра на английском
 +
  !|Описание
 +
  !|Пример значения
 +
  !|Значение по умолчанию
 +
 +
  |-
 +
 +
  |<code>КоличествоЭлементов</code>
 +
  |<code>CountOnPage</code>
 +
  |Количество элементов в результате запроса.
 +
  |<code>100</code>
 +
  |<code>0</code>
 +
 +
  |-
 +
 +
  |<code>НомерСтраницы</code>
 +
  |<code>PageNumber</code>
 +
  |Номер требуемой части результата запроса.
 +
  |<code>10</code>
 +
  |<code>1</code>
 +
|}
 +
 +
Методы с поддержкой пагинации:
 +
* [[#GetCatalog (СписокЭлементов)|GetCatalog (СписокЭлементов)]]. Пагинация доступна только для объектов, у которых есть свойство «Ссылка».
 +
* [[#ПолучитьИзмененияПоУзлу|ПолучитьИзмененияПоУзлу]].
 +
* [[#GetAvailableRooms|GetAvailableRooms]].
 +
 +
; Пример вызова:
 +
<pre>/hs/KintAPI.hs/GetData?Method=GetCatalog&CatalogName=яъФизическиеЛица&PageNumber=6&CountOnPage=10 </pre>
  
 
= Общие методы =
 
= Общие методы =
Строка 178: Строка 214:
 
   |Вид объекта, по умолчанию "Справочник".
 
   |Вид объекта, по умолчанию "Справочник".
 
   |<code>Справочник</code>
 
   |<code>Справочник</code>
 +
 
|}
 
|}
  
Строка 186: Строка 223:
 
* Пример вызова с отбором:
 
* Пример вызова с отбором:
 
*; <pre>/GetData?Method=GetCatalog&CatalogName=Организации&Fields=Ссылка,ИНН,КПП&Filter={"ГоловнаяОрганизация":%20{"ID":"e1cib/data/Справочник.Организации?ref=ad5c5404a66e4a8911e37e83f3ef6892"}}</pre>
 
*; <pre>/GetData?Method=GetCatalog&CatalogName=Организации&Fields=Ссылка,ИНН,КПП&Filter={"ГоловнаяОрганизация":%20{"ID":"e1cib/data/Справочник.Организации?ref=ad5c5404a66e4a8911e37e83f3ef6892"}}</pre>
 +
* Пример вызова с пагинацией:
 +
*; <pre>GetData?Method=GetCatalog&CatalogName=яъФизическиеЛица&Fields=Наименование,Пол&PageNumber=24&CountOnPage=100&Filter={"Пол": "Перечисление.яъПол.Мужской"}</pre>
 
;Пример ответа:
 
;Пример ответа:
 
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
Строка 259: Строка 298:
  
 
=== GetPrintForm (ПолучитьПечатнуюФорму) ===
 
=== GetPrintForm (ПолучитьПечатнуюФорму) ===
Позволяет получить сформированную печатную форму в формате '''BASE64'''.
+
Позволяет получить сформированную печатную форму в выбранном формате.
  
 
Параметры:
 
Параметры:
 
* Объект (GUID, обязательный) - для кого получаем значение параметра
 
* Объект (GUID, обязательный) - для кого получаем значение параметра
 
* ПечатнаяФорма (GUID, не обязательный только в случае получения значения параметра) - может использоваться для расширения списка параметров. Без печатной формы список параметров может быть ограничен.
 
* ПечатнаяФорма (GUID, не обязательный только в случае получения значения параметра) - может использоваться для расширения списка параметров. Без печатной формы список параметров может быть ограничен.
* ТипФайла (не обязательный только в случае получения значения параметра) - доступны значения: DOCX, HTML5, MXL, PDF, TXT, XLS
+
* Формат (не обязательный только в случае получения значения параметра) - доступны значения: DOCX, HTML5, MXL, PDF, TXT, XLS
 
* ИмяПараметра (Строка, не обязательный) - если передан, то вернется не печатная форма, а значение переданного параметра. По умолчанию доступны параметры на вкладках «Основные» + «Доступные» + «Дополнительные» в форме настройки печатной формы.
 
* ИмяПараметра (Строка, не обязательный) - если передан, то вернется не печатная форма, а значение переданного параметра. По умолчанию доступны параметры на вкладках «Основные» + «Доступные» + «Дополнительные» в форме настройки печатной формы.
 +
* стрТипВыходныхДанных (Строка, не обязательный) - может использоваться тип данных Base64 или ДвоичныеДанные, в ином случае возвращает содержимое файла. Значение по умолчанию Base64.
  
 
;Пример вызова:
 
;Пример вызова:
Строка 489: Строка 529:
 
* '''Отбор''': структура с общим отбором реквизитов для всех получаемых объектов.
 
* '''Отбор''': структура с общим отбором реквизитов для всех получаемых объектов.
 
* '''ОтменитьРегистрацию''': отменять ли регистрацию объектов в узле после получения. По умолчанию - Истина.
 
* '''ОтменитьРегистрацию''': отменять ли регистрацию объектов в узле после получения. По умолчанию - Истина.
 +
* '''КоличествоЭлементов''': количество объектов в результате. Может быть задан для каждого объекта, так и для отдельного.
 +
* '''НомерСтраницы''': Номер результата пагинации. Может быть задан для каждого объекта, так и для отдельного.
  
 
;Пример запроса:
 
;Пример запроса:
Строка 584: Строка 626:
 
</pre>
 
</pre>
  
= Кинт: Управление санаторием =
+
;Пример запроса с пагинацией:
== Методы ==
+
<pre>
 +
/hs/KintAPI.hs/GetData?Method=ПолучитьИзмененияПоУзлу&Узел={"Идентификатор": "e1cib/data/ПланОбмена.ОбменКУСБухгалтерия20?ref=bc74d85ed320709611ecbf16523724ef"}&Объекты=[{"ИдОбъекта": "Номенклатура", "стрРеквизиты": "Наименование"}, {"ИдОбъекта": "Контрагенты", "стрРеквизиты": "Наименование"}, {"ИдОбъекта": "яъФизическиеЛица", "стрРеквизиты": "Наименование", "КоличествоЭлементов": 20, "НомерСтраницы": 5}]&ОтменитьРегистрацию=Ложь&КоличествоЭлементов=10&НомерСтраницы=4
 +
</pre>
 +
 
 +
=== КоличествоЭлементов ===
 +
* '''Тип HTTP-запроса''': GET
 +
* '''Описание''': Получение количества объектов
  
=== Общие ===
+
{| class="wikitable"
 +
  |+Параметры
 +
  !|Наименование
 +
  !|Обязателен?
 +
  !|Тип данных
 +
  !|Описание
 +
  !|Пример
  
==== GetNews ====
+
  |-
Содержимое ленты новостей.
 
  
Необязательные параметры:
+
  |<code>ВидыОбъектов</code> / <code>ВидОбъекта</code>
* '''Параметры''': структура параметров, которые используются в шаблонах страницы.
+
  |Да
** '''Развернуть''': если значение «Истина», то новости будут развернуты при загрузке страницы.
+
  |<code>Строка</code>, <code>Массив</code>
** '''ОграничитьШирину''': если значение «Истина», то новости будут отображаться посередине экрана, образуя «Ленту» новостей.
+
  |Тип объекта (По умолчанию справочник), вид объекта
* '''ВКонтейнер''': если значение «Истина», то к макетам будет подключена стандартная библиотека.
+
  |<code>Организации,Документ.Путевка</code>
  
;Пример вызова:
+
  |-
<pre>
 
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetNews&raw&Параметры={"Развернуть":true,"ОграничитьШирину":true}
 
</pre>
 
  
;Пример ответа:
+
  |<code>Отбор</code> / <code>Filter</code>
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
+
  |Нет
<script>
+
  |<code>Структура</code>
function showMoreInfo(el) {
+
  |Структура, указывающая, по каким реквизитам и их значениям необходимо делать отбор
let elDescription = el.children[1];
+
  |<code>{"ИНН": "1835012280"}</code>
elDescription.classList.toggle("event-header-description");
 
  
let elInfo = el.parentNode.children[1];
+
  |-
elInfo.classList.toggle("hide");
 
}
 
function expandAllNews() {
 
document.querySelectorAll('.event-container').forEach(function(event){
 
showMoreInfo(event);
 
});
 
}
 
</script>
 
  
<style>
+
  |<code>Узел</code>
 +
  |Нет
 +
  |<code>Ссылка на узел плана обмена</code>
 +
  |В результате окажется количество изменений по узлу
 +
  |<code>{"Идентификатор": "e1cib/data/ПланОбмена.ОбменКУСБухгалтерия20?ref=9a4a60a44c379a5b11e91efe3f9ca517"}</code>
  
.news-container
+
  |-
{
 
margin: 0 auto;
 
width: 40%;
 
}
 
  
.event-image
+
|<code>КоличествоНаСтранице</code> / <code>CountOnPage</code>
{
+
  |Нет
border-radius: 10px;
+
  |<code>Число</code>
max-width: 100%;
+
  |Количество элементов на странице, с указанным параметром будет выводится количество страниц
margin: 15px 0px;
+
  |<code>100</code>
}
 
  
.no-events
+
  |-
{
 
text-align: center;
 
color: #9b9b9b;
 
}
 
  
body
+
|}
{
 
background-color: #E0E0E0;
 
font-family: verdana;
 
}
 
  
.hide
+
* Пример вызова 1:
{
+
*; <pre>/GetData?Method=КоличествоЭлементов&КоличествоНаСтранице=100&ВидОбъекта=яъФизическиеЛица</pre>
display: none;
+
Пример ответа:
}
+
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
    [
 +
        {
 +
            "ВидОбъекта": "Справочник.яъФизическиеЛица",
 +
            "КоличествоОбъектов": 6733,
 +
            "КоличествоСтраниц": 68
 +
        }
 +
    ]
 +
</pre>
 +
* Пример вызова 2 (Получение количества для нескольких объектов):
 +
*; <pre>/GetData?Method=КоличествоЭлементов&ВидыОбъектов=яъФизическиеЛица,Документ.КартаГостя,РегистрСведений.КурсыВалют</pre>
 +
Пример ответа:
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
    [
 +
        {
 +
            "ВидОбъекта": "Справочник.яъФизическиеЛица",
 +
            "КоличествоОбъектов": 6764
 +
        },
 +
        {
 +
            "ВидОбъекта": "Документ.КартаГостя",
 +
            "КоличествоОбъектов": 3000
 +
        },
 +
        {
 +
            "ВидОбъекта": "РегистрСведений.КурсыВалют",
 +
            "КоличествоОбъектов": 3
 +
        }
 +
    ]
 +
</pre>
 +
* Пример вызова 3 (Получение количества с общим отбором):
 +
*; <pre>/GetData?Method=КоличествоЭлементов&ВидыОбъектов=яъФизическиеЛица,Контрагенты,Сотрудники&Отбор={"Код": "000000001"}</pre>
 +
Пример ответа:
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
    [
 +
        {
 +
            "ВидОбъекта": "Справочник.яъФизическиеЛица",
 +
            "КоличествоОбъектов": 1
 +
        },
 +
        {
 +
            "ВидОбъекта": "Справочник.Контрагенты",
 +
            "КоличествоОбъектов": 1
 +
        },
 +
        {
 +
            "ВидОбъекта": "Справочник.Сотрудники",
 +
            "КоличествоОбъектов": 0
 +
        }
 +
    ]
 +
</pre>
 +
* Пример вызова 4 (Получение количества с общим отбором, дополнительным отбором по физ. лицам, отключенным отбором по коду для сотрудников):
 +
*; <pre>/GetData?Method=КоличествоЭлементов&ВидыОбъектов=[{ "ВидОбъекта":"яъФизическиеЛица", "Отбор": {"Наименование": "Макадзару"} },{ "ВидОбъекта":"Контрагенты" },{ "ВидОбъекта":"Сотрудники", "Отбор": {"Код": ""} }]&Отбор={"Код": "000000001"}</pre>
 +
Пример ответа:
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
    [
 +
        {
 +
            "ВидОбъекта": "Справочник.яъФизическиеЛица",
 +
            "КоличествоОбъектов": 0
 +
        },
 +
        {
 +
            "ВидОбъекта": "Справочник.Контрагенты",
 +
            "КоличествоОбъектов": 1
 +
        },
 +
        {
 +
            "ВидОбъекта": "Справочник.Сотрудники",
 +
            "КоличествоОбъектов": 124
 +
        }
 +
    ]
 +
</pre>
  
.event-container
+
* Пример вызова 5 (Получение количества изменений по общему узлу и получение количества физ. лиц по другому узлу):
{
+
*; <pre>/GetData?Method=КоличествоЭлементов&ВидыОбъектов=[{ "ВидОбъекта":"яъФизическиеЛица" },{ "ВидОбъекта":"Контрагенты" },{ "ВидОбъекта":"Сотрудники"},{ "ВидОбъекта": "яъФизическиеЛица", "Узел": {"Идентификатор": "e1cib/data/ПланОбмена.ОбменКУСБухгалтерия20?ref=bc74d85ed320709611ecbf16523724ef"} }]&Узел={"Идентификатор": "e1cib/data/ПланОбмена.ОбменКУСБухгалтерия20?ref=9a4a60a44c379a5b11e91efe3f9ca517"}</pre>
background-color: white;
+
Пример ответа:
border-radius: 15px;
+
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
padding: 10px;
+
    [
box-shadow: -1px 1px 7px -4px #000000;
+
        {
cursor: pointer;
+
            "ВидОбъекта": "Справочник.яъФизическиеЛица",
}  
+
            "КоличествоОбъектов": 6733
 +
        },
 +
        {
 +
            "ВидОбъекта": "Справочник.Контрагенты",
 +
            "КоличествоОбъектов": 3050
 +
        },
 +
        {
 +
            "ВидОбъекта": "Справочник.Сотрудники",
 +
            "КоличествоОбъектов": 124
 +
        },
 +
        {
 +
            "ВидОбъекта": "Справочник.яъФизическиеЛица",
 +
            "КоличествоОбъектов": 622
 +
        }
 +
    ]
 +
</pre>
  
.event-shell
+
=== ЗаписатьПриложения ===
{
+
* '''Тип HTTP-запроса''': GET/POST
background-color: #F5F5F5;
+
* '''Описание''': Запись приложений (например, картинок) к объекту. Можно отправлять как массив, так и структуру. Возвращает список индексов созданных приложений.
box-shadow: -1px 1px 7px -4px #000000;
 
border-radius: 15px;
 
width: 100%;
 
margin-bottom: 15px;
 
line-height: 1.5;
 
color: #3F3F3F;
 
}
 
  
.event-title
+
{| class="wikitable"
{
+
  |+Параметры
font-weight: bold;
+
  !|Наименование
font-size: 18px;
+
  !|Обязателен?
}
+
  !|Тип данных
 +
  !|Описание
 +
  !|Пример
  
.event-container .event-title
+
  |-
{
 
width: 100%;
 
word-break: break-all;
 
}
 
  
.event-subtitle
+
  |<code>Владелец</code>
{
+
  |Да
font-weight: bold;
+
  |<code>Ссылка на объект</code>
font-size: 14px;
+
  |Владелец приложения
}
+
  |<code>{"id": "e1cib/data/Справочник.яъКультуры?ref=96d5708bcda2156111eef01513b24eef"}</code>
  
.event-header
+
  |-
{
 
display: flex;
 
}
 
  
.event-time
+
  |<code>Индекс</code>
{
+
  |Нет
border-radius: 6px;
+
  |<code>Число</code>
padding: 3px;
+
  |С указанным параметром перезаписывает старое приложение
font-size: 14px;
+
  |<code>1</code>
text-align: center;
 
background-color: #33a7d4;
 
color: white;
 
font-weight: bold;
 
white-space: nowrap;
 
}
 
  
.event-description
+
  |-
{
 
font-size: 14px;
 
}
 
  
.event-header-description
+
  |<code>Файл</code>
{
+
  |Да
height: 3em;
+
  |<code>Строка</code>
overflow: hidden;
+
  |Данные файла в Base64-строке
background: linear-gradient(180deg, #3F3F3F 50%, gray 90%, white 97%);
+
  |<code>"/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBxMTEhUTExMV..."</code>
-webkit-background-clip: text;
 
-webkit-text-fill-color: transparent;
 
}
 
  
.event-more-info
+
  |-
{
 
padding: 10px;
 
}
 
  
p
+
  |<code>Представление</code>
{
+
  |Да
margin-bottom: 0px;
+
  |<code>Строка</code>
margin-top: 5px;
+
  |Имя файла с расширением
}
+
  |<code>Арбуз.png</code>
  
.marks-container
+
  |-
{
 
white-space: nowrap;
 
color: white;
 
font-weight: bold;
 
}
 
  
</style>  
+
  |<code>яъКомментарий</code>
 +
  |Нет
 +
  |<code>Строка</code>
 +
  |Комментарий приложения
 +
  |<code>Создан из приложения «Кинт: Мобильный ТСД»</code>
 +
|}
  
 +
* Пример вызова
 +
*; <pre>/GetData?Method=ЗаписатьПриложения&Владелец={"id": "e1cib/data/Справочник.яъКультуры?ref=96d5708bcda2156111eef01513b24eef"}&Файл="/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBxMTEhUTExMV..."&Представление=Арбуз.png</pre>
 +
Пример ответа:
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
    [
 +
        {
 +
            "Индекс": 11
 +
        }
 +
    ]
 +
</pre>
  
 +
=== УдалитьПриложение ===
 +
* '''Тип HTTP-запроса''': GET
 +
* '''Описание''': Удаление приложения
  
 +
{| class="wikitable"
 +
  |+Параметры
 +
  !|Наименование
 +
  !|Обязателен?
 +
  !|Тип данных
 +
  !|Описание
 +
  !|Пример
  
 +
  |-
  
 +
  |<code>Владелец</code>
 +
  |Да
 +
  |<code>Ссылка на объект</code>
 +
  |Владелец приложения
 +
  |<code>{"id": "e1cib/data/Справочник.яъКультуры?ref=96d5708bcda2156111eef01513b24eef"}</code>
  
 +
  |-
  
 +
  |<code>Индекс</code>
 +
  |Да
 +
  |<code>Число</code>
 +
  |Номер удаляемого приложения
 +
  |<code>11</code>
 +
|}
  
 +
* Пример вызова
 +
*; <pre>/GetData?Method=УдалитьПриложение&Владелец={"id": "e1cib/data/Справочник.яъКультуры?ref=96d5708bcda2156111eef01513b24eef"}&Индекс=11</pre>
 +
Пример ответа:
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
    true
 +
</pre>
  
<script>
+
=== СписокПриложений ===
document.addEventListener("DOMContentLoaded", function() {
+
* '''Тип HTTP-запроса''': GET
expandAllNews();
+
* '''Описание''': Получение списка приложений объекта
});
 
</script>
 
  
 +
{| class="wikitable"
 +
  |+Параметры
 +
  !|Наименование
 +
  !|Обязателен?
 +
  !|Тип данных
 +
  !|Описание
 +
  !|Пример
  
 +
  |-
  
<div class = 'news-container'>
+
  |<code>Владелец</code>
 +
  |Да
 +
  |<code>Ссылка на объект</code>
 +
  |Владелец приложений, которые хотим получить
 +
  |<code>{"id": "e1cib/data/Справочник.яъФизическиеЛица?ref=96d5708bcda2156111eef01513b24eef"}</code>
 +
 
 +
  |-
  
<div>  
+
  |<code>СФайлами</code>
<div>    
+
  |Нет
<div class = "event-shell">
+
  |<code>Булево</code>
<div class = "event-container" onclick = "showMoreInfo(this)">
+
  |Нужно ли получить файл в Base64-строке
<div class = "event-header">
+
  |<code>Истина</code>
<span class = "event-title">День "Пролетника"</span>
 
<span class = "marks-container">
 
<span class = "event-time">12 сент.</span>
 
</span>
 
</div>
 
  
<p class = "event-description event-header-description">
+
  |-
Сегодня птицы массово улетают на юг! Становится прохладнее, дожди начинают идти чаще. <br>
 
Самое время собирать травы, которые в столь знаменательный день обладают целебными свойствами!
 
</p>
 
</div>
 
  
<div class = "event-more-info hide">
+
  |<code>Колонки</code>
 +
  |Нет
 +
  |<code>Строка</code>
 +
  |Список колонок, который необходимо получить в результате
 +
  |<code>Представление,Индекс,яъКомментарий,ИндексТипаПриложения,Файл</code>
 +
|}
  
 +
* '''Описание колонок в результате'''
 +
** Представление - представление приложения
 +
** Индекс - индекс приложения в пределах владельца
 +
** Автор - пользователь, добавивший приложение
 +
** Дата - дата добавления приложения
 +
** фВнешнее - приложение является ссылкой на файл
 +
** ВидПриложения - не используется
 +
** ПутьКДанным - полное имя файла, где хранится приложение
 +
** СостояниеПриложения - 1 (захвачено для редактирования), 0 (никем не редактируется)
 +
** яъКомментарий - комментарий приложения
 +
** ИндексТипаПриложения - 1 (картинка), 2 (каталог), 3 (URL-ссылка), 0 (всё остальное)?
 +
** Файл - файл в Base64-строке
 +
** Расширение - расширение файла
  
<img src = "https://krasivosti.pro/uploads/posts/2021-07/1627080338_22-krasivosti-pro-p-karavan-ptits-ptitsi-krasivo-foto-25.jpg" class = "event-image">
+
* Пример вызова
 +
*; <pre>/GetData?Method=СписокПриложений&Владелец={"id": "e1cib/data/Справочник.яъКультуры?ref=96d5708bcda2156111eef01513b24eef"}&Колонки=Представление,Индекс,Дата,яъКомментарий,Файл&СФайлами=Истина</pre>
 +
Пример ответа:
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
    [
 +
        {
 +
            "Представление": "images.jpeg",
 +
            "Индекс": 1,
 +
            "Дата": "2024-09-17T18:33:57",
 +
            "яъКомментарий": "",
 +
            "Файл": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBxMTEhUTExMV..."
 +
        }
 +
    ]
 +
</pre>
  
 +
=== СоздатьЗадачу (PostTask)  ===
 +
* '''Тип HTTP-запроса''': POST
 +
* '''Описание''': Создание документа «Задача».
  
</div>
 
</div>
 
  
</div>
+
=== ПолучитьСписокЗадач (GetTaskList)  ===
</div>
+
* '''Тип HTTP-запроса''': GET
 +
* '''Описание''': Список документов с отбором.
  
<div>   
 
<div>    
 
<div class = "event-shell">
 
<div class = "event-container" onclick = "showMoreInfo(this)">
 
<div class = "event-header">
 
<span class = "event-title">День рождения компании "Кинт"!</span>
 
<span class = "marks-container">
 
<span class = "event-time">10 окт.</span>
 
</span>
 
</div>
 
  
<p class = "event-description event-header-description">
+
=== ПолучитьСодержаниеЗадачи (GetTaskContent)  ===
Ежегодное собрание сотрудников предприятия состоится в октябре!
+
* '''Тип HTTP-запроса''': GET
Приносите себя и мягкие стулья! <br>
+
* '''Описание''': Получает все комментарии по документу в формате HTML.
Непьющих просьба не приходить - презентации смотреть только под коньяк!
 
  
  
</p>
+
=== ПервыйКомментарий (GetFirstMessage)  ===
</div>
+
* '''Тип HTTP-запроса''': GET
 +
* '''Описание''': Получает первый комментарий  по документу. Первый комментарий считается "Содержанием" документа.
  
<div class = "event-more-info hide">
 
  
 +
=== ПоследнийКомментарий (GetLastMessage)  ===
 +
* '''Тип HTTP-запроса''': GET
 +
* '''Описание''': Получает последний комментарий по документу.
  
<img src = "https://algo-s.ru/upload/iblock/345/f02b34eee0160c1cec0a0819b5.png" class = "event-image">
 
  
 +
=== ИзменитьЭтапПроцесса (ChangeProcessStage)  ===
 +
* '''Тип HTTP-запроса''': GET
 +
* '''Описание''': Изменение этапа процесса документа.
  
  
<div class = "event-title">
+
=== ДобавитьКомментарий (PostMessage) ===
Выступления руководителей отделов
+
* '''Тип HTTP-запроса''': POST
</div>
+
* '''Описание''': Добавление комментария к документу.
  
 +
= Кинт: Управление санаторием =
 +
== Методы ==
  
 +
=== Общие ===
  
<div class = "event-description">
+
==== GetNews ====
Сотрудники от каждого отдела расскажут о поставленных и достигнутых целях.  
+
Содержимое ленты новостей.
</div>
 
  
 +
Необязательные параметры:
 +
* '''Параметры''': структура параметров, которые используются в шаблонах страницы.
 +
** '''Развернуть''': если значение «Истина», то новости будут развернуты при загрузке страницы.
 +
** '''ОграничитьШирину''': если значение «Истина», то новости будут отображаться посередине экрана, образуя «Ленту» новостей.
 +
* '''ВКонтейнер''': если значение «Истина», то к макетам будет подключена стандартная библиотека.
  
 +
;Пример вызова:
 +
<pre>
 +
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetNews&raw&Параметры={"Развернуть":true,"ОграничитьШирину":true}
 +
</pre>
  
<div class = "event-subtitle">  
+
;Пример ответа:
Будут ли мягкие стулья?
+
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
</div>
+
<script>
 +
function showMoreInfo(el) {
 +
let elDescription = el.children[1];
 +
elDescription.classList.toggle("event-header-description");
  
 +
let elInfo = el.parentNode.children[1];
 +
elInfo.classList.toggle("hide");
 +
}
 +
function expandAllNews() {
 +
document.querySelectorAll('.event-container').forEach(function(event){
 +
showMoreInfo(event);
 +
});
 +
}
 +
</script>
  
 +
<style>
  
<div class = "event-description">
+
.news-container
А задачу написали?
+
{
</div>
+
margin: 0 auto;
 
+
width: 40%;
 
+
}
</div>
 
</div>
 
  
</div>
+
.event-image
</div>
+
{
 +
border-radius: 10px;
 +
max-width: 100%;
 +
margin: 15px 0px;
 +
}
  
</div>
+
.no-events
</pre>
+
{
 +
text-align: center;
 +
color: #9b9b9b;
 +
}
  
==== ИзменитьСтатусУчастникаМероприятия ====
+
body
Изменение статуса участника на мероприятии. Если участник не числился, то он будет добавлен.
+
{
 +
background-color: #E0E0E0;
 +
font-family: verdana;
 +
}
  
Параметры:
+
.hide
* '''Участник''': участник ([[Документ "Карта гостя" (КУС)|карта гостя]] или [[Справочник "Физические лица" (КУС)|физлицо]]), у которого необходимо изменить статус.
+
{
* '''Мероприятие''': [[Документ "Мероприятие" (КУС)|мероприятие]], на котором необходимо изменить статус участника.
+
display: none;
 +
}
  
Необязательные параметры:
+
.event-container
* '''Статус''': требуемый статус участника (ПотенциальныйУчастник, БудетУчаствовать, ПринялУчастие, Отказ). Если не передан, то будет установлен «Принял участие».
+
{
 +
background-color: white;
 +
border-radius: 15px;
 +
padding: 10px;
 +
box-shadow: -1px 1px 7px -4px #000000;
 +
cursor: pointer;
 +
}
  
;Пример вызова:
+
.event-shell
<pre>
 
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ИзменитьСтатусУчастникаМероприятия&Участник={"Идентификатор": "e1cib/data/Справочник.яъФизическиеЛица?ref=8e086451060d98bd11e5c8f3aff6f11f"}&Мероприятие={"Идентификатор": "1cib/data/Документ.яъМероприятие?ref=9511a85e4511756911ee74bb0ffc8d41"}&Статус=Отказ
 
</pre>
 
 
 
;Пример ответа:
 
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 
 
{
 
{
"Success": true,
+
background-color: #F5F5F5;
"Result": {
+
box-shadow: -1px 1px 7px -4px #000000;
"Результат": true,
+
border-radius: 15px;
"Описание": "Статус участия изменен на «Отказ»"
+
width: 100%;
},
+
margin-bottom: 15px;
"Messages": []
+
line-height: 1.5;
 +
color: #3F3F3F;
 
}
 
}
</pre>
 
  
==== PaymentStatusByDocument ====
+
.event-title
Состояние оплаты по документа.
+
{
 +
font-weight: bold;
 +
font-size: 18px;
 +
}
  
Параметры:
+
.event-container .event-title
* '''Document''': документ, по которому нужно получить состояние оплаты.
+
{
 +
width: 100%;
 +
word-break: break-all;
 +
}
  
Необязательные параметры:
+
.event-subtitle
* '''Детализация''': в результат будет помещена таблица с расшифровкой состояния оплаты по каждому счету.
+
{
 +
font-weight: bold;
 +
font-size: 14px;
 +
}
  
;Пример вызова:
+
.event-header
<pre>
+
{
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=PaymentStatusByDocument&Document={"Идентификатор": "e1cib/data Документ.НазначениеУслуг?ref=bca2d85ed320709611ed8129e69655fb"}
+
display: flex;
</pre>
+
}
  
;Пример ответа:
+
.event-time
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 
 
{
 
{
"Success": true,
+
border-radius: 6px;
"Result": {
+
padding: 3px;
"СуммаДокумента": 0,
+
font-size: 14px;
"Выставлено": 1495,
+
text-align: center;
"Оплачено": 1495
+
background-color: #33a7d4;
},
+
color: white;
"Messages": []
+
font-weight: bold;
 +
white-space: nowrap;
 
}
 
}
</pre>
 
  
==== КонтактыОрганизации ====
+
.event-description
Контактные данные рабочей организации.
+
{
 +
font-size: 14px;
 +
}
  
;Пример вызова:
+
.event-header-description
<pre>
+
{
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=КонтактыОрганизации
+
height: 3em;
</pre>
+
overflow: hidden;  
 +
background: linear-gradient(180deg, #3F3F3F 50%, gray 90%, white 97%);
 +
-webkit-background-clip: text;
 +
-webkit-text-fill-color: transparent;
 +
}
  
;Пример ответа:
+
.event-more-info
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 
 
{
 
{
[
+
padding: 10px;
 +
}
 +
 
 +
p
 
{
 
{
"Владелец": "Санаторий \"Родные просторы\"",
+
margin-bottom: 0px;
"Свойство": "Портье",
+
margin-top: 5px;
"ТипЗначения": "Контактные данные",
+
}
"КодСвойства": "1",
+
 
"Период": "2023-03-03T00:00:00",
+
.marks-container
"_Индекс": 0,
 
"ЗначениеСвойства": "+7(3412)50-11-99",
 
"Редактор": "Стеньшина Любовь Александровна (суперюзер)",
 
"Код": "1"
 
},
 
 
{
 
{
"Владелец": "Санаторий \"Родные просторы\"",
+
white-space: nowrap;
"Свойство": "Ресепшен",
+
color: white;
"ТипЗначения": "Контактные данные",
+
font-weight: bold;
"КодСвойства": "23",
+
}  
"Период": "1980-01-01T00:00:00",
+
 
"_Индекс": 0,
+
</style>
"ЗначениеСвойства": "+7(3412)64-68-58",
+
 
"Редактор": "Абдулов Юрий Владимирович (директор)",
+
 
"Код": "23"
+
 
},
+
 
{
+
 
"Владелец": "Санаторий \"Родные просторы\"",
+
 
"Свойство": "Приемная",
 
"ТипЗначения": "Контактные данные",
 
"КодСвойства": "тел01",
 
"Период": "2022-10-25T00:00:00",
 
"_Индекс": 0,
 
"ЗначениеСвойства": "+7(3412)69-77-72",
 
"Редактор": "Абдулов Юрий Владимирович (директор)",
 
"Код": "тел01"
 
}
 
]
 
}
 
</pre>
 
  
==== ПользовательПоНаименованию ====
 
Данные пользователя по наименованию.
 
  
Параметры:
 
* '''Наименование''': наименование пользователя.
 
  
;Пример вызова:
+
<script>
<pre>
+
document.addEventListener("DOMContentLoaded", function() {
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ПользовательПоНаименованию&Наименование=Администратор
+
expandAllNews();
</pre>
+
});
 +
</script>
  
;Пример ответа:
 
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 
{
 
"Ссылка": {
 
"ПометкаУдаления": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"Наименование": "Администратор",
 
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=94fca85e4511756911edad038ee22d63"
 
},
 
"ПользовательИБ": "Администратор"
 
}
 
</pre>
 
  
==== ОфициальныеОрганы ====
 
Список официальных органов.
 
  
;Пример вызова:
+
<div class = 'news-container'>
<pre>
+
 
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ОфициальныеОрганы
+
<div>   
</pre>
+
<div>    
 +
<div class = "event-shell">
 +
<div class = "event-container" onclick = "showMoreInfo(this)">
 +
<div class = "event-header">
 +
<span class = "event-title">День "Пролетника"</span>
 +
<span class = "marks-container">
 +
<span class = "event-time">12 сент.</span>
 +
</span>
 +
</div>
 +
 
 +
<p class = "event-description event-header-description">
 +
Сегодня птицы массово улетают на юг! Становится прохладнее, дожди начинают идти чаще. <br>
 +
Самое время собирать травы, которые в столь знаменательный день обладают целебными свойствами!
 +
</p>
 +
</div>  
 +
 
 +
<div class = "event-more-info hide">
 +
 
  
;Пример ответа:
+
<img src = "https://krasivosti.pro/uploads/posts/2021-07/1627080338_22-krasivosti-pro-p-karavan-ptits-ptitsi-krasivo-foto-25.jpg" class = "event-image">
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
+
 
[
+
 
{
+
</div>
"Код": "200-006",
+
</div>  
"Наименование": "ОТДЕЛЕНИЕ УФМС РОССИИ ПО ЧЕЧЕНСКОЙ РЕСПУБЛИКЕ В СТАРОПРОМЫСЛОВСКОМ Р-НЕ Г. ГРОЗНОГО",
 
"ДатаОкончания": "0001-01-01T00:00:00",
 
"Идентификатор": "10000",
 
"КатегорияВладельца":
 
{
 
"ПометкаУдаления": false,
 
"Предопределенный": true,
 
"ИмяПредопределенныхДанных": "ОрганВыдачиДокументов",
 
"Наименование": "Орган выдачи документов",
 
"Идентификатор": "e1cib/data/Справочник.яъКатегории?ref=9a4e60a44c379a5b11e9c40aadd85b17"
 
}
 
},
 
{
 
"Код": "240-011",
 
"Наименование": "ТП УФМС РОССИИ ПО КРАСНОЯРСКОМУ КРАЮ В КАНСКОМ Р-НЕ",
 
"ДатаОкончания": "0001-01-01T00:00:00",
 
"Идентификатор": "10017",
 
"КатегорияВладельца":
 
{
 
"ПометкаУдаления": false,
 
"Предопределенный": true,
 
"ИмяПредопределенныхДанных": "ОрганВыдачиДокументов",
 
"Наименование": "Орган выдачи документов",
 
"Идентификатор": "e1cib/data/Справочник.яъКатегории?ref=9a4e60a44c379a5b11e9c40aadd85b17"
 
}
 
}
 
]
 
</pre>
 
  
==== РабочаяОрганизация ====
+
</div>
Рабочая организация по настройке.
+
</div>
  
Параметры:
+
<div>   
* '''стрРеквизиты''' (не поддерживается): список реквизитов для получения.
+
<div>    
 +
<div class = "event-shell">
 +
<div class = "event-container" onclick = "showMoreInfo(this)">
 +
<div class = "event-header">
 +
<span class = "event-title">День рождения компании "Кинт"!</span>
 +
<span class = "marks-container">
 +
<span class = "event-time">10 окт.</span>
 +
</span>
 +
</div>
  
;Пример вызова:
+
<p class = "event-description event-header-description">
 +
Ежегодное собрание сотрудников предприятия состоится в октябре!
 +
Приносите себя и мягкие стулья! <br>
 +
Непьющих просьба не приходить - презентации смотреть только под коньяк!
  
<pre>
 
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=РабочаяОрганизация&стрРеквизиты=Код,Наименование
 
</pre>
 
  
;Пример ответа:
+
</p>
 +
</div>
  
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
+
<div class = "event-more-info hide">
{
 
"ПометкаУдаления": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"Наименование": "Санаторий \"Родные просторы\"",
 
"Код": "9999999/2",
 
"Идентификатор": "e1cib/data/Справочник.Организации?ref=9bc8e4800e39484c4b1e680675db5963"
 
}
 
</pre>
 
  
==== GetHtmlForms ====
 
Макеты HTML виджетов.
 
  
Параметры:
+
<img src = "https://algo-s.ru/upload/iblock/345/f02b34eee0160c1cec0a0819b5.png" class = "event-image">
* '''Категория''': ссылка на категорию (владельца) или ее полный идентификатор.
 
  
Необязательные параметры:
 
* '''Вычислить''': если значение «Истина», то макеты будут вычислены на стороне конфигурации.
 
* '''ВКонтейнер''': если значение «Истина», то к макетам будет подключена стандартная библиотека.
 
* '''Параметры''': структура с параметрами, которые используются в макетах.
 
  
;Пример вызова:
 
  
<pre>
+
<div class = "event-title">  
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetHtmlForms&Категория=Справочник.яъКатегории.ВиджетНовости&Вычислить=Истина&ВКонтейнер=Ложь
+
Выступления руководителей отделов
</pre>
+
</div>
  
;Пример ответа:
 
  
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 
{
 
"Success": true,
 
"Result": [
 
{
 
"Ссылка": {
 
"ПометкаУдаления": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"Наименование": "Распродажа носков",
 
"Код": 0,
 
"Идентификатор": "e1cib/data/Справочник.яъПечатныеФормы?ref=9500a85e4511756911edd2da71e3489a"
 
},
 
"Code": "РаспродажаНосков",
 
"Шаблон": "<table> \n\n\u0009<tr>\n\u0009\u0009<th>Материал</th>\n\u0009\u0009<th>Цена</th>\n\u0009</tr> \n\u0009\n\u0009<tr>\n\u0009\u0009<td>Мохровые</td>\n\u0009\u0009<td>199</td>\n\u0009</tr>\n\u0009\n\u0009<tr>\n\u0009\u0009<td>Бархатные</td>\n\u0009\u0009<td>350</td>\n\u0009</tr>\n\u0009\n\u0009<tr>\n\u0009\u0009<td>Дырявые</td>\n\u0009\u0009<td>999999</td>\n\u0009</tr>\n\n</table>\n"
 
}
 
],
 
"Messages": []
 
}
 
</pre>
 
  
=== Модуль «Гостиница» ===
+
<div class = "event-description">
 +
Сотрудники от каждого отдела расскажут о поставленных и достигнутых целях.
 +
</div>
 +
 
 +
 
 +
 
 +
<div class = "event-subtitle">
 +
Будут ли мягкие стулья?
 +
</div>
 +
 
 +
 
 +
 
 +
<div class = "event-description">
 +
А задачу написали?
 +
</div>
 +
 
 +
 
 +
</div>
 +
</div>
 +
 
 +
</div>
 +
</div>
 +
 
 +
</div>
 +
</pre>
  
==== GetAvailableDates ====
+
==== ИзменитьСтатусУчастникаМероприятия ====
Доступные интервалы заезда за период.
+
Изменение статуса участника на мероприятии. Если участник не числился, то он будет добавлен.
  
 
Параметры:
 
Параметры:
* '''ArrivalFrom/ЗаездС''': начало периода заезда.
+
* '''Участник''': участник ([[Документ "Карта гостя" (КУС)|карта гостя]] или [[Справочник "Физические лица" (КУС)|физлицо]]), у которого необходимо изменить статус.
* '''ArrivalTo/ЗаездПо''': конец периода заезда.
+
* '''Мероприятие''': [[Документ "Мероприятие" (КУС)|мероприятие]], на котором необходимо изменить статус участника.
* '''Days/КоличествоДней''': желаемое количество дней проживания.
 
  
 
Необязательные параметры:
 
Необязательные параметры:
* '''RoomCategory/КатегорияНомера''': желаемая категория номера.
+
* '''Статус''': требуемый статус участника (ПотенциальныйУчастник, БудетУчаствовать, ПринялУчастие, Отказ). Если не передан, то будет установлен «Принял участие».
* '''Block/Корпус''': желаемый корпус.
 
* '''QuotaID/Квота''': требуемая квота (учитываются только квоты по номерам).
 
  
 
;Пример вызова:
 
;Пример вызова:
 
<pre>
 
<pre>
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetAvailableDates&ArrivalFrom=30.08.2023&ArrivalTo=05.09.2023&Days=4&RoomCategory={"Идентификатор":%20"e1cib/data/Справочник.НоменклатураПомещений?ref=ac2360a44c379a5b11e565e573e3b690"}&Block={"Идентификатор":%20"e1cib/data/Справочник.Здания?ref=bd4860a44c379a5b11e3a8f481c4453e"}&QuotaID={"Идентификатор":%20"e1cib/data/Справочник.Квоты?ref=9a6860a44c379a5b11eb9d1bc1a84df1"}
+
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ИзменитьСтатусУчастникаМероприятия&Участник={"Идентификатор": "e1cib/data/Справочник.яъФизическиеЛица?ref=8e086451060d98bd11e5c8f3aff6f11f"}&Мероприятие={"Идентификатор": "1cib/data/Документ.яъМероприятие?ref=9511a85e4511756911ee74bb0ffc8d41"}&Статус=Отказ
 
</pre>
 
</pre>
  
Строка 1106: Строка 1255:
 
{
 
{
 
"Success": true,
 
"Success": true,
"Result": [
+
"Result": {
{
+
"Результат": true,
"Room": {
+
"Описание": "Статус участия изменен на «Отказ»"
"ПометкаУдаления": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"Наименование": "102",
 
"Код": "1102",
 
"ЭтоГруппа": false,
 
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
 
},
 
"ДатаЗаезда": "2023-08-30T00:00:00",
 
"ДатаВыезда": "2023-09-03T00:00:00",
 
"Свободно": 2
 
 
},
 
},
 +
"Messages": []
 +
}
 +
</pre>
 +
 +
==== PaymentStatusByDocument ====
 +
Состояние оплаты по документа.
 +
 +
Параметры:
 +
* '''Document''': документ, по которому нужно получить состояние оплаты.
 +
 +
Необязательные параметры:
 +
* '''Детализация''': в результат будет помещена таблица с расшифровкой состояния оплаты по каждому счету.
 +
 +
;Пример вызова:
 +
<pre>
 +
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=PaymentStatusByDocument&Document={"Идентификатор": "e1cib/data Документ.НазначениеУслуг?ref=bca2d85ed320709611ed8129e69655fb"}
 +
</pre>
 +
 +
;Пример ответа:
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 
{
 
{
"Room": {
+
"Success": true,
"ПометкаУдаления": false,
+
"Result": {
"Предопределенный": false,
+
"СуммаДокумента": 0,
"ИмяПредопределенныхДанных": "",
+
"Выставлено": 1495,
"Наименование": "102",
+
"Оплачено": 1495
"Код": "1102",
 
"ЭтоГруппа": false,
 
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
 
},
 
"ДатаЗаезда": "2023-08-31T00:00:00",
 
"ДатаВыезда": "2023-09-04T00:00:00",
 
"Свободно": 2
 
 
},
 
},
 +
"Messages": []
 +
}
 +
</pre>
 +
 +
==== КонтактыОрганизации ====
 +
Контактные данные рабочей организации.
 +
 +
;Пример вызова:
 +
<pre>
 +
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=КонтактыОрганизации
 +
</pre>
 +
 +
;Пример ответа:
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
{
 +
[
 
{
 
{
"Room": {
+
"Владелец": "Санаторий \"Родные просторы\"",
"ПометкаУдаления": false,
+
"Свойство": "Портье",
"Предопределенный": false,
+
"ТипЗначения": "Контактные данные",
"ИмяПредопределенныхДанных": "",
+
"КодСвойства": "1",
"Наименование": "102",
+
"Период": "2023-03-03T00:00:00",
"Код": "1102",
+
"_Индекс": 0,
"ЭтоГруппа": false,
+
"ЗначениеСвойства": "+7(3412)50-11-99",
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
+
"Редактор": "Стеньшина Любовь Александровна (суперюзер)",
},
+
"Код": "1"
"ДатаЗаезда": "2023-09-01T00:00:00",
 
"ДатаВыезда": "2023-09-05T00:00:00",
 
"Свободно": 2
 
 
},
 
},
 
{
 
{
"Room": {
+
"Владелец": "Санаторий \"Родные просторы\"",
"ПометкаУдаления": false,
+
"Свойство": "Ресепшен",
"Предопределенный": false,
+
"ТипЗначения": "Контактные данные",
"ИмяПредопределенныхДанных": "",
+
"КодСвойства": "23",
"Наименование": "102",
+
"Период": "1980-01-01T00:00:00",
"Код": "1102",
+
"_Индекс": 0,
"ЭтоГруппа": false,
+
"ЗначениеСвойства": "+7(3412)64-68-58",
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
+
"Редактор": "Абдулов Юрий Владимирович (директор)",
},
+
"Код": "23"
"ДатаЗаезда": "2023-09-02T00:00:00",
 
"ДатаВыезда": "2023-09-06T00:00:00",
 
"Свободно": 2
 
 
},
 
},
 
{
 
{
"Room": {
+
"Владелец": "Санаторий \"Родные просторы\"",
 +
"Свойство": "Приемная",
 +
"ТипЗначения": "Контактные данные",
 +
"КодСвойства": "тел01",
 +
"Период": "2022-10-25T00:00:00",
 +
"_Индекс": 0,
 +
"ЗначениеСвойства": "+7(3412)69-77-72",
 +
"Редактор": "Абдулов Юрий Владимирович (директор)",
 +
"Код": "тел01"
 +
}
 +
]
 +
}
 +
</pre>
 +
 
 +
==== ПользовательПоНаименованию ====
 +
Данные пользователя по наименованию.
 +
 
 +
Параметры:
 +
* '''Наименование''': наименование пользователя.
 +
 
 +
;Пример вызова:
 +
<pre>
 +
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ПользовательПоНаименованию&Наименование=Администратор
 +
</pre>
 +
 
 +
;Пример ответа:
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
{
 +
"Ссылка": {
 
"ПометкаУдаления": false,
 
"ПометкаУдаления": false,
 
"Предопределенный": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"ИмяПредопределенныхДанных": "",
"Наименование": "102",
+
"Наименование": "Администратор",
"Код": "1102",
+
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=94fca85e4511756911edad038ee22d63"
"ЭтоГруппа": false,
 
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
 
},
 
"ДатаЗаезда": "2023-09-03T00:00:00",
 
"ДатаВыезда": "2023-09-07T00:00:00",
 
"Свободно": 2
 
 
},
 
},
 +
"ПользовательИБ": "Администратор"
 +
}
 +
</pre>
 +
 +
==== ОфициальныеОрганы ====
 +
Список официальных органов.
 +
 +
;Пример вызова:
 +
<pre>
 +
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ОфициальныеОрганы
 +
</pre>
 +
 +
;Пример ответа:
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
[
 +
{
 +
"Код": "200-006",
 +
"Наименование": "ОТДЕЛЕНИЕ УФМС РОССИИ ПО ЧЕЧЕНСКОЙ РЕСПУБЛИКЕ В СТАРОПРОМЫСЛОВСКОМ Р-НЕ Г. ГРОЗНОГО",
 +
"ДатаОкончания": "0001-01-01T00:00:00",
 +
"Идентификатор": "10000",
 +
"КатегорияВладельца":
 
{
 
{
"Room": {
 
 
"ПометкаУдаления": false,
 
"ПометкаУдаления": false,
"Предопределенный": false,
+
"Предопределенный": true,
"ИмяПредопределенныхДанных": "",
+
"ИмяПредопределенныхДанных": "ОрганВыдачиДокументов",
"Наименование": "102",
+
"Наименование": "Орган выдачи документов",
"Код": "1102",
+
"Идентификатор": "e1cib/data/Справочник.яъКатегории?ref=9a4e60a44c379a5b11e9c40aadd85b17"
"ЭтоГруппа": false,
+
}
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
 
},
 
"ДатаЗаезда": "2023-09-04T00:00:00",
 
"ДатаВыезда": "2023-09-08T00:00:00",
 
"Свободно": 2
 
 
},
 
},
 
{
 
{
"Room": {
+
"Код": "240-011",
 +
"Наименование": "ТП УФМС РОССИИ ПО КРАСНОЯРСКОМУ КРАЮ В КАНСКОМ Р-НЕ",
 +
"ДатаОкончания": "0001-01-01T00:00:00",
 +
"Идентификатор": "10017",
 +
"КатегорияВладельца":
 +
{
 
"ПометкаУдаления": false,
 
"ПометкаУдаления": false,
"Предопределенный": false,
+
"Предопределенный": true,
"ИмяПредопределенныхДанных": "",
+
"ИмяПредопределенныхДанных": "ОрганВыдачиДокументов",
"Наименование": "102",
+
"Наименование": "Орган выдачи документов",
"Код": "1102",
+
"Идентификатор": "e1cib/data/Справочник.яъКатегории?ref=9a4e60a44c379a5b11e9c40aadd85b17"
"ЭтоГруппа": false,
+
}
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
+
}
},
+
]
"ДатаЗаезда": "2023-09-05T00:00:00",
+
</pre>
"ДатаВыезда": "2023-09-09T00:00:00",
+
 
"Свободно": 2
+
==== РабочаяОрганизация ====
},
+
Рабочая организация по настройке.
 +
 
 +
Параметры:
 +
* '''стрРеквизиты''' (не поддерживается): список реквизитов для получения.
 +
 
 +
;Пример вызова:
 +
 
 +
<pre>
 +
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=РабочаяОрганизация&стрРеквизиты=Код,Наименование
 +
</pre>
 +
 
 +
;Пример ответа:
 +
 
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 
{
 
{
"Room": {
 
 
"ПометкаУдаления": false,
 
"ПометкаУдаления": false,
 
"Предопределенный": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"ИмяПредопределенныхДанных": "",
"Наименование": "103",
+
"Наименование": "Санаторий \"Родные просторы\"",
"Код": "1103",
+
"Код": "9999999/2",
"ЭтоГруппа": false,
+
"Идентификатор": "e1cib/data/Справочник.Организации?ref=9bc8e4800e39484c4b1e680675db5963"
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
+
}
},
+
</pre>
"ДатаЗаезда": "2023-08-30T00:00:00",
+
 
"ДатаВыезда": "2023-09-03T00:00:00",
+
==== GetHtmlForms ====
"Свободно": 2
+
Макеты HTML виджетов.
},
+
 
 +
Параметры:
 +
* '''Категория''': ссылка на категорию (владельца) или ее полный идентификатор.
 +
 
 +
Необязательные параметры:
 +
* '''Вычислить''': если значение «Истина», то макеты будут вычислены на стороне конфигурации.
 +
* '''ВКонтейнер''': если значение «Истина», то к макетам будет подключена стандартная библиотека.
 +
* '''Параметры''': структура с параметрами, которые используются в макетах.
 +
 
 +
;Пример вызова:
 +
 
 +
<pre>
 +
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetHtmlForms&Категория=Справочник.яъКатегории.ВиджетНовости&Вычислить=Истина&ВКонтейнер=Ложь
 +
</pre>
 +
 
 +
;Пример ответа:
 +
 
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
{
 +
"Success": true,
 +
"Result": [
 
{
 
{
"Room": {
+
"Ссылка": {
 
"ПометкаУдаления": false,
 
"ПометкаУдаления": false,
 
"Предопределенный": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"ИмяПредопределенныхДанных": "",
"Наименование": "103",
+
"Наименование": "Распродажа носков",
"Код": "1103",
+
"Код": 0,
"ЭтоГруппа": false,
+
"Идентификатор": "e1cib/data/Справочник.яъПечатныеФормы?ref=9500a85e4511756911edd2da71e3489a"
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
 
},
 
"ДатаЗаезда": "2023-08-31T00:00:00",
 
"ДатаВыезда": "2023-09-04T00:00:00",
 
"Свободно": 2
 
 
},
 
},
 +
"Code": "РаспродажаНосков",
 +
"Шаблон": "<table> \n\n\u0009<tr>\n\u0009\u0009<th>Материал</th>\n\u0009\u0009<th>Цена</th>\n\u0009</tr> \n\u0009\n\u0009<tr>\n\u0009\u0009<td>Мохровые</td>\n\u0009\u0009<td>199</td>\n\u0009</tr>\n\u0009\n\u0009<tr>\n\u0009\u0009<td>Бархатные</td>\n\u0009\u0009<td>350</td>\n\u0009</tr>\n\u0009\n\u0009<tr>\n\u0009\u0009<td>Дырявые</td>\n\u0009\u0009<td>999999</td>\n\u0009</tr>\n\n</table>\n"
 +
}
 +
],
 +
"Messages": []
 +
}
 +
</pre>
 +
 +
=== Модуль «Гостиница» ===
 +
 +
==== GetAvailableDates ====
 +
Доступные интервалы заезда за период.
 +
 +
Параметры:
 +
* '''ArrivalFrom/ЗаездС''': начало периода заезда.
 +
* '''ArrivalTo/ЗаездПо''': конец периода заезда.
 +
* '''Days/КоличествоДней''': желаемое количество дней проживания.
 +
 +
Необязательные параметры:
 +
* '''RoomCategory/КатегорияНомера''': желаемая категория номера.
 +
* '''Block/Корпус''': желаемый корпус.
 +
* '''QuotaID/Квота''': требуемая квота (учитываются только квоты по номерам).
 +
 +
;Пример вызова:
 +
<pre>
 +
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetAvailableDates&ArrivalFrom=30.08.2023&ArrivalTo=05.09.2023&Days=4&RoomCategory={"Идентификатор":%20"e1cib/data/Справочник.НоменклатураПомещений?ref=ac2360a44c379a5b11e565e573e3b690"}&Block={"Идентификатор":%20"e1cib/data/Справочник.Здания?ref=bd4860a44c379a5b11e3a8f481c4453e"}&QuotaID={"Идентификатор":%20"e1cib/data/Справочник.Квоты?ref=9a6860a44c379a5b11eb9d1bc1a84df1"}
 +
</pre>
 +
 +
;Пример ответа:
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
{
 +
"Success": true,
 +
"Result": [
 
{
 
{
 
"Room": {
 
"Room": {
Строка 1238: Строка 1501:
 
"Предопределенный": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"ИмяПредопределенныхДанных": "",
"Наименование": "103",
+
"Наименование": "102",
"Код": "1103",
+
"Код": "1102",
 
"ЭтоГруппа": false,
 
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
+
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
 
},
 
},
"ДатаЗаезда": "2023-09-01T00:00:00",
+
"ДатаЗаезда": "2023-08-30T00:00:00",
"ДатаВыезда": "2023-09-05T00:00:00",
+
"ДатаВыезда": "2023-09-03T00:00:00",
 
"Свободно": 2
 
"Свободно": 2
 
},
 
},
Строка 1252: Строка 1515:
 
"Предопределенный": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"ИмяПредопределенныхДанных": "",
"Наименование": "103",
+
"Наименование": "102",
"Код": "1103",
+
"Код": "1102",
 
"ЭтоГруппа": false,
 
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
+
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
 
},
 
},
"ДатаЗаезда": "2023-09-02T00:00:00",
+
"ДатаЗаезда": "2023-08-31T00:00:00",
"ДатаВыезда": "2023-09-06T00:00:00",
+
"ДатаВыезда": "2023-09-04T00:00:00",
 
"Свободно": 2
 
"Свободно": 2
 
},
 
},
Строка 1266: Строка 1529:
 
"Предопределенный": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"ИмяПредопределенныхДанных": "",
"Наименование": "103",
+
"Наименование": "102",
"Код": "1103",
+
"Код": "1102",
 
"ЭтоГруппа": false,
 
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
+
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
 
},
 
},
"ДатаЗаезда": "2023-09-03T00:00:00",
+
"ДатаЗаезда": "2023-09-01T00:00:00",
"ДатаВыезда": "2023-09-07T00:00:00",
+
"ДатаВыезда": "2023-09-05T00:00:00",
 
"Свободно": 2
 
"Свободно": 2
 
},
 
},
Строка 1280: Строка 1543:
 
"Предопределенный": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"ИмяПредопределенныхДанных": "",
"Наименование": "103",
+
"Наименование": "102",
"Код": "1103",
+
"Код": "1102",
 
"ЭтоГруппа": false,
 
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
+
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
 
},
 
},
"ДатаЗаезда": "2023-09-04T00:00:00",
+
"ДатаЗаезда": "2023-09-02T00:00:00",
"ДатаВыезда": "2023-09-08T00:00:00",
+
"ДатаВыезда": "2023-09-06T00:00:00",
 
"Свободно": 2
 
"Свободно": 2
 
},
 
},
Строка 1294: Строка 1557:
 
"Предопределенный": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"ИмяПредопределенныхДанных": "",
"Наименование": "103",
+
"Наименование": "102",
"Код": "1103",
+
"Код": "1102",
 
"ЭтоГруппа": false,
 
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
+
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
 
},
 
},
"ДатаЗаезда": "2023-09-05T00:00:00",
+
"ДатаЗаезда": "2023-09-03T00:00:00",
"ДатаВыезда": "2023-09-09T00:00:00",
+
"ДатаВыезда": "2023-09-07T00:00:00",
 
"Свободно": 2
 
"Свободно": 2
 
},
 
},
Строка 1308: Строка 1571:
 
"Предопределенный": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"ИмяПредопределенныхДанных": "",
"Наименование": "101",
+
"Наименование": "102",
"Код": "1101",
+
"Код": "1102",
 
"ЭтоГруппа": false,
 
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
+
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
 
},
 
},
"ДатаЗаезда": "2023-08-30T00:00:00",
+
"ДатаЗаезда": "2023-09-04T00:00:00",
"ДатаВыезда": "2023-09-03T00:00:00",
+
"ДатаВыезда": "2023-09-08T00:00:00",
 
"Свободно": 2
 
"Свободно": 2
 
},
 
},
Строка 1322: Строка 1585:
 
"Предопределенный": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"ИмяПредопределенныхДанных": "",
"Наименование": "101",
+
"Наименование": "102",
"Код": "1101",
+
"Код": "1102",
 
"ЭтоГруппа": false,
 
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
+
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
 
},
 
},
"ДатаЗаезда": "2023-08-31T00:00:00",
+
"ДатаЗаезда": "2023-09-05T00:00:00",
"ДатаВыезда": "2023-09-04T00:00:00",
+
"ДатаВыезда": "2023-09-09T00:00:00",
 
"Свободно": 2
 
"Свободно": 2
 
},
 
},
Строка 1336: Строка 1599:
 
"Предопределенный": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"ИмяПредопределенныхДанных": "",
"Наименование": "101",
+
"Наименование": "103",
"Код": "1101",
+
"Код": "1103",
 
"ЭтоГруппа": false,
 
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
+
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
 
},
 
},
"ДатаЗаезда": "2023-09-01T00:00:00",
+
"ДатаЗаезда": "2023-08-30T00:00:00",
"ДатаВыезда": "2023-09-05T00:00:00",
+
"ДатаВыезда": "2023-09-03T00:00:00",
 
"Свободно": 2
 
"Свободно": 2
 
},
 
},
Строка 1350: Строка 1613:
 
"Предопределенный": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"ИмяПредопределенныхДанных": "",
"Наименование": "101",
+
"Наименование": "103",
"Код": "1101",
+
"Код": "1103",
 
"ЭтоГруппа": false,
 
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
+
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
 
},
 
},
"ДатаЗаезда": "2023-09-02T00:00:00",
+
"ДатаЗаезда": "2023-08-31T00:00:00",
"ДатаВыезда": "2023-09-06T00:00:00",
+
"ДатаВыезда": "2023-09-04T00:00:00",
 
"Свободно": 2
 
"Свободно": 2
 
},
 
},
Строка 1364: Строка 1627:
 
"Предопределенный": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"ИмяПредопределенныхДанных": "",
"Наименование": "101",
+
"Наименование": "103",
"Код": "1101",
+
"Код": "1103",
 
"ЭтоГруппа": false,
 
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
+
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
 
},
 
},
"ДатаЗаезда": "2023-09-03T00:00:00",
+
"ДатаЗаезда": "2023-09-01T00:00:00",
"ДатаВыезда": "2023-09-07T00:00:00",
+
"ДатаВыезда": "2023-09-05T00:00:00",
 
"Свободно": 2
 
"Свободно": 2
 
},
 
},
Строка 1378: Строка 1641:
 
"Предопределенный": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"ИмяПредопределенныхДанных": "",
"Наименование": "101",
+
"Наименование": "103",
"Код": "1101",
+
"Код": "1103",
 
"ЭтоГруппа": false,
 
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
+
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
 +
},
 +
"ДатаЗаезда": "2023-09-02T00:00:00",
 +
"ДатаВыезда": "2023-09-06T00:00:00",
 +
"Свободно": 2
 +
},
 +
{
 +
"Room": {
 +
"ПометкаУдаления": false,
 +
"Предопределенный": false,
 +
"ИмяПредопределенныхДанных": "",
 +
"Наименование": "103",
 +
"Код": "1103",
 +
"ЭтоГруппа": false,
 +
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
 +
},
 +
"ДатаЗаезда": "2023-09-03T00:00:00",
 +
"ДатаВыезда": "2023-09-07T00:00:00",
 +
"Свободно": 2
 +
},
 +
{
 +
"Room": {
 +
"ПометкаУдаления": false,
 +
"Предопределенный": false,
 +
"ИмяПредопределенныхДанных": "",
 +
"Наименование": "103",
 +
"Код": "1103",
 +
"ЭтоГруппа": false,
 +
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
 
},
 
},
 
"ДатаЗаезда": "2023-09-04T00:00:00",
 
"ДатаЗаезда": "2023-09-04T00:00:00",
Строка 1392: Строка 1683:
 
"Предопределенный": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"ИмяПредопределенныхДанных": "",
"Наименование": "101",
+
"Наименование": "103",
"Код": "1101",
+
"Код": "1103",
 
"ЭтоГруппа": false,
 
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
+
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
 
},
 
},
 
"ДатаЗаезда": "2023-09-05T00:00:00",
 
"ДатаЗаезда": "2023-09-05T00:00:00",
 
"ДатаВыезда": "2023-09-09T00:00:00",
 
"ДатаВыезда": "2023-09-09T00:00:00",
 
"Свободно": 2
 
"Свободно": 2
}
+
},
],
+
{
"Messages": []
+
"Room": {
}
+
"ПометкаУдаления": false,
</pre>
+
"Предопределенный": false,
 
+
"ИмяПредопределенныхДанных": "",
==== GetPrice ====
+
"Наименование": "101",
Стоимость проживания за период по различным параметрам.
+
"Код": "1101",
 
+
"ЭтоГруппа": false,
Необязательные параметры:
+
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
* '''DateFrom/НачалоПериода/ДатаЗаезда''': начало периода проживания. Значение по умолчанию - начало текущего дня.
+
},
* '''DateTo/КонецПериода/ДатаВыезда''': конец периода проживания. Значение по умолчанию - конец текущего дня.
+
"ДатаЗаезда": "2023-08-30T00:00:00",
* '''ВариантРасчетаЦен''': вариант расчета цены. Значение по умолчанию будет получено из настройки.
+
"ДатаВыезда": "2023-09-03T00:00:00",
* '''Контекст''': структура с различными дополнительными параметрами (Организация, Прайс, Время суток заезда, Время суток выезда, Заезд вечером, Выезд вечером).
+
"Свободно": 2
* '''ВидЦен''': Идентификатор или ссылка на вид цены. Значение по умолчанию - цена брони.
+
},
* '''Details/Расшифровка''': развернуть цену по дням.
 
 
 
;Пример вызова:
 
<pre>
 
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetPrice&Контекст={"DateFrom": "15.02.2023", "DateTo":"18.02.2023"}
 
</pre>
 
 
 
;Пример ответа:
 
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 
 
{
 
{
"Success": true,
+
"Room": {
"Result": [
 
{
 
"НомерСтроки": 0,
 
"Date": "2023-02-15T00:00:00",
 
"Стоимость": 13000,
 
"СтоимостьЛечения": 0,
 
"СтоимостьПитания": 0,
 
"СтоимостьПроживания": 13000,
 
"фРучнаяСтоимость": false,
 
"Скидка": 0,
 
"СтоимостьБезСкидки": 13000,
 
"Price": {
 
 
"ПометкаУдаления": false,
 
"ПометкаУдаления": false,
"Предопределенный": true,
+
"Предопределенный": false,
"ИмяПредопределенныхДанных": "ОсновнойПрайсПродаж",
+
"ИмяПредопределенныхДанных": "",
"Наименование": "Основной прайс продаж",
+
"Наименование": "101",
"Код": "000000001",
+
"Код": "1101",
"Идентификатор": "e1cib/data/Справочник.Прайсы?ref=9b7996e6d857ebf811e3a8f3d7479350"
+
"ЭтоГруппа": false,
 +
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
 
},
 
},
"КодСтроки": 0,
+
"ДатаЗаезда": "2023-08-31T00:00:00",
"РучнаяСкидка": 0,
+
"ДатаВыезда": "2023-09-04T00:00:00",
"Ответственный": {
+
"Свободно": 2
"ПометкаУдаления": null,
 
"Предопределенный": null,
 
"ИмяПредопределенныхДанных": null,
 
"Наименование": null,
 
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=00000000000000000000000000000000"
 
}
 
 
},
 
},
 
{
 
{
"НомерСтроки": 0,
+
"Room": {
"Date": "2023-02-16T00:00:00",
 
"Стоимость": 13000,
 
"СтоимостьЛечения": 0,
 
"СтоимостьПитания": 0,
 
"СтоимостьПроживания": 13000,
 
"фРучнаяСтоимость": false,
 
"Скидка": 0,
 
"СтоимостьБезСкидки": 13000,
 
"Price": {
 
 
"ПометкаУдаления": false,
 
"ПометкаУдаления": false,
"Предопределенный": true,
+
"Предопределенный": false,
"ИмяПредопределенныхДанных": "ОсновнойПрайсПродаж",
+
"ИмяПредопределенныхДанных": "",
"Наименование": "Основной прайс продаж",
+
"Наименование": "101",
"Код": "000000001",
+
"Код": "1101",
"Идентификатор": "e1cib/data/Справочник.Прайсы?ref=9b7996e6d857ebf811e3a8f3d7479350"
+
"ЭтоГруппа": false,
 +
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
 
},
 
},
"КодСтроки": 0,
+
"ДатаЗаезда": "2023-09-01T00:00:00",
"РучнаяСкидка": 0,
+
"ДатаВыезда": "2023-09-05T00:00:00",
"Ответственный": {
+
"Свободно": 2
"ПометкаУдаления": null,
 
"Предопределенный": null,
 
"ИмяПредопределенныхДанных": null,
 
"Наименование": null,
 
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=00000000000000000000000000000000"
 
}
 
 
},
 
},
 
{
 
{
"НомерСтроки": 0,
+
"Room": {
"Date": "2023-02-17T00:00:00",
 
"Стоимость": 13000,
 
"СтоимостьЛечения": 0,
 
"СтоимостьПитания": 0,
 
"СтоимостьПроживания": 13000,
 
"фРучнаяСтоимость": false,
 
"Скидка": 0,
 
"СтоимостьБезСкидки": 13000,
 
"Price": {
 
 
"ПометкаУдаления": false,
 
"ПометкаУдаления": false,
"Предопределенный": true,
+
"Предопределенный": false,
"ИмяПредопределенныхДанных": "ОсновнойПрайсПродаж",
+
"ИмяПредопределенныхДанных": "",
"Наименование": "Основной прайс продаж",
+
"Наименование": "101",
"Код": "000000001",
+
"Код": "1101",
"Идентификатор": "e1cib/data/Справочник.Прайсы?ref=9b7996e6d857ebf811e3a8f3d7479350"
+
"ЭтоГруппа": false,
 +
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
 
},
 
},
"КодСтроки": 0,
+
"ДатаЗаезда": "2023-09-02T00:00:00",
"РучнаяСкидка": 0,
+
"ДатаВыезда": "2023-09-06T00:00:00",
"Ответственный": {
+
"Свободно": 2
"ПометкаУдаления": null,
 
"Предопределенный": null,
 
"ИмяПредопределенныхДанных": null,
 
"Наименование": null,
 
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=00000000000000000000000000000000"
 
}
 
 
},
 
},
 
{
 
{
"НомерСтроки": 0,
+
"Room": {
"Date": "2023-02-18T00:00:00",
+
"ПометкаУдаления": false,
"Стоимость": 6500,
+
"Предопределенный": false,
"СтоимостьЛечения": 0,
+
"ИмяПредопределенныхДанных": "",
"СтоимостьПитания": 0,
+
"Наименование": "101",
"СтоимостьПроживания": 6500,
+
"Код": "1101",
"фРучнаяСтоимость": false,
+
"ЭтоГруппа": false,
"Скидка": 0,
+
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
"СтоимостьБезСкидки": 6500,
+
},
"Price": {
+
"ДатаЗаезда": "2023-09-03T00:00:00",
 +
"ДатаВыезда": "2023-09-07T00:00:00",
 +
"Свободно": 2
 +
},
 +
{
 +
"Room": {
 
"ПометкаУдаления": false,
 
"ПометкаУдаления": false,
"Предопределенный": true,
+
"Предопределенный": false,
"ИмяПредопределенныхДанных": "ОсновнойПрайсПродаж",
+
"ИмяПредопределенныхДанных": "",
"Наименование": "Основной прайс продаж",
+
"Наименование": "101",
"Код": "000000001",
+
"Код": "1101",
"Идентификатор": "e1cib/data/Справочник.Прайсы?ref=9b7996e6d857ebf811e3a8f3d7479350"
+
"ЭтоГруппа": false,
 +
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
 +
},
 +
"ДатаЗаезда": "2023-09-04T00:00:00",
 +
"ДатаВыезда": "2023-09-08T00:00:00",
 +
"Свободно": 2
 
},
 
},
"КодСтроки": 0,
+
{
"РучнаяСкидка": 0,
+
"Room": {
"Ответственный": {
+
"ПометкаУдаления": false,
"ПометкаУдаления": null,
+
"Предопределенный": false,
"Предопределенный": null,
+
"ИмяПредопределенныхДанных": "",
"ИмяПредопределенныхДанных": null,
+
"Наименование": "101",
"Наименование": null,
+
"Код": "1101",
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=00000000000000000000000000000000"
+
"ЭтоГруппа": false,
}
+
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
 +
},
 +
"ДатаЗаезда": "2023-09-05T00:00:00",
 +
"ДатаВыезда": "2023-09-09T00:00:00",
 +
"Свободно": 2
 
}
 
}
 
],
 
],
Строка 1544: Строка 1795:
 
</pre>
 
</pre>
  
==== КартыГостя ====
+
==== GetPrice ====
Список карт гостей физического лица.
+
Стоимость проживания за период по различным параметрам.
  
Параметры:
+
Необязательные параметры:
* '''ФизЛицо''': физическое лицо, по которому необходимо получить карты гостя.
+
* '''DateFrom/НачалоПериода/ДатаЗаезда''': начало периода проживания. Значение по умолчанию - начало текущего дня.
* '''стрРеквизиты''' (не поддерживается): список реквизитов для получения.
+
* '''DateTo/КонецПериода/ДатаВыезда''': конец периода проживания. Значение по умолчанию - конец текущего дня.
 +
* '''ВариантРасчетаЦен''': вариант расчета цены. Значение по умолчанию будет получено из настройки.  
 +
* '''Контекст''': структура с различными дополнительными параметрами (Организация, Прайс, Время суток заезда, Время суток выезда, Заезд вечером, Выезд вечером).
 +
* '''ВидЦен''': Идентификатор или ссылка на вид цены. Значение по умолчанию - цена брони.
 +
* '''Details/Расшифровка''': развернуть цену по дням.
  
 
;Пример вызова:
 
;Пример вызова:
 
<pre>
 
<pre>
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=КартыГостя&стрРеквизиты="Дата"&ФизЛицо={"Идентификатор":"e1cib/data/Справочник.яъФизическиеЛица?ref=b20b6451060d98bd11e59cb64e7de21e"}
+
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetPrice&Контекст={"DateFrom": "15.02.2023", "DateTo":"18.02.2023"}
 
</pre>
 
</pre>
  
 
;Пример ответа:
 
;Пример ответа:
 
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
[
 
 
{
 
{
"Дата": "2023-03-14T10:44:55",
+
"Success": true,
"Номер": "23/00083      ",
+
"Result": [
"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fea85e4511756911edc233ba474f2a"
 
},
 
 
{
 
{
"Дата": "2021-09-20T14:39:07",
+
"НомерСтроки": 0,
"Номер": "21/00058      ",
+
"Date": "2023-02-15T00:00:00",
"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=9a6d60a44c379a5b11ec19fefb04ce3a"
+
"Стоимость": 13000,
}
+
"СтоимостьЛечения": 0,
]
+
"СтоимостьПитания": 0,
</pre>
+
"СтоимостьПроживания": 13000,
 
+
"фРучнаяСтоимость": false,
==== ДанныеОбОсновнойКартеЛояльности ====
+
"Скидка": 0,
Данные об основной карте лояльности гостя.
+
"СтоимостьБезСкидки": 13000,
 
+
"Price": {
Параметры:
 
* '''КартаГостя''': карта гостя, по которой необходимо получить карту лояльности.
 
 
 
Необязательные параметры:
 
* '''НаДату''': дата актуальности бонусов. Если не передана, то будет получено общее количество бонусов на карте.
 
 
 
;Пример вызова:
 
<pre>
 
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ДанныеОбОсновнойКартеЛояльности&КартаГостя={"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fda85e4511756911edb98261ada96f"}&НаДату=01.04.2023
 
</pre>
 
 
 
;Пример ответа:
 
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 
{
 
"Success": true,
 
"Result": {
 
"Ссылка": {
 
"Дата": "2023-03-06T09:51:55",
 
"Номер": "22/00000003              ",
 
"Идентификатор": "e1cib/data/Документ.яъКартаПокупателя?ref=94fda85e4511756911edb9bb423b5329"
 
},
 
"ПометкаУдаления": false,
 
"Number": "22/00000003              ",
 
"Date": "2023-03-06T09:51:55",
 
"Проведен": true,
 
"Client": {
 
"ПометкаУдаления": false,
 
"Предопределенный": false,
 
"ИмяПредопределенныхДанных": "",
 
"Наименование": "Романов Игорь Егорович",
 
"Код": "dem000026",
 
"ЭтоГруппа": false,
 
"Родитель": {
 
 
"ПометкаУдаления": false,
 
"ПометкаУдаления": false,
 
"Предопределенный": true,
 
"Предопределенный": true,
"ИмяПредопределенныхДанных": "ФизическиеЛица",
+
"ИмяПредопределенныхДанных": "ОсновнойПрайсПродаж",
"Наименование": "Физические лица",
+
"Наименование": "Основной прайс продаж",
 
"Код": "000000001",
 
"Код": "000000001",
"ЭтоГруппа": true,
+
"Идентификатор": "e1cib/data/Справочник.Прайсы?ref=9b7996e6d857ebf811e3a8f3d7479350"
"Идентификатор": "e1cib/data/Справочник.Контрагенты?ref=9b7996e6d857ebf811e3a8f3debae377"
 
 
},
 
},
"Идентификатор": "e1cib/data/Справочник.Контрагенты?ref=980360a44c379a5b11e6913a7733af63"
+
"КодСтроки": 0,
},
+
"РучнаяСкидка": 0,
"ВидСкидки": {
+
"Ответственный": {
 
"ПометкаУдаления": null,
 
"ПометкаУдаления": null,
 
"Предопределенный": null,
 
"Предопределенный": null,
 
"ИмяПредопределенныхДанных": null,
 
"ИмяПредопределенныхДанных": null,
 
"Наименование": null,
 
"Наименование": null,
"Код": null,
+
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=00000000000000000000000000000000"
"Идентификатор": "e1cib/data/ПланСчетов.яъЦены?ref=00000000000000000000000000000000"
+
}
 
},
 
},
"СрокОкончания": "0001-01-01T00:00:00",
+
{
"Номинал": 0,
+
"НомерСтроки": 0,
"БонуснаяПрограмма": {
+
"Date": "2023-02-16T00:00:00",
 +
"Стоимость": 13000,
 +
"СтоимостьЛечения": 0,
 +
"СтоимостьПитания": 0,
 +
"СтоимостьПроживания": 13000,
 +
"фРучнаяСтоимость": false,
 +
"Скидка": 0,
 +
"СтоимостьБезСкидки": 13000,
 +
"Price": {
 
"ПометкаУдаления": false,
 
"ПометкаУдаления": false,
"Предопределенный": false,
+
"Предопределенный": true,
"ИмяПредопределенныхДанных": "",
+
"ИмяПредопределенныхДанных": "ОсновнойПрайсПродаж",
"Наименование": "Основная",
+
"Наименование": "Основной прайс продаж",
 
"Код": "000000001",
 
"Код": "000000001",
"Идентификатор": "e1cib/data/Справочник.яъБонусныеПрограммы?ref=94fda85e4511756911edb9bb423b5327"
+
"Идентификатор": "e1cib/data/Справочник.Прайсы?ref=9b7996e6d857ebf811e3a8f3d7479350"
 
},
 
},
"Телефон": "",
+
"КодСтроки": 0,
"яъАвтор": {
+
"РучнаяСкидка": 0,
"ПометкаУдаления": false,
+
"Ответственный": {
"Предопределенный": false,
+
"ПометкаУдаления": null,
"ИмяПредопределенныхДанных": "",
+
"Предопределенный": null,
"Наименование": "Стеньшина Любовь Александровна (суперюзер)",
+
"ИмяПредопределенныхДанных": null,
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=b20b6451060d98bd11e5a7eb037adb81"
+
"Наименование": null,
 +
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=00000000000000000000000000000000"
 +
}
 
},
 
},
"DocumentType": {
+
{
 +
"НомерСтроки": 0,
 +
"Date": "2023-02-17T00:00:00",
 +
"Стоимость": 13000,
 +
"СтоимостьЛечения": 0,
 +
"СтоимостьПитания": 0,
 +
"СтоимостьПроживания": 13000,
 +
"фРучнаяСтоимость": false,
 +
"Скидка": 0,
 +
"СтоимостьБезСкидки": 13000,
 +
"Price": {
 
"ПометкаУдаления": false,
 
"ПометкаУдаления": false,
 
"Предопределенный": true,
 
"Предопределенный": true,
"ИмяПредопределенныхДанных": "_ДисконтнаяКарта",
+
"ИмяПредопределенныхДанных": "ОсновнойПрайсПродаж",
"Наименование": "Карта лояльности",
+
"Наименование": "Основной прайс продаж",
"Код": "00081",
+
"Код": "000000001",
"Идентификатор": "e1cib/data/Справочник.яъВидыДокументов?ref=9a4a60a44c379a5b11e935b5799a1a4b"
+
"Идентификатор": "e1cib/data/Справочник.Прайсы?ref=9b7996e6d857ebf811e3a8f3d7479350"
 
},
 
},
"Comment": "",
+
"КодСтроки": 0,
"яъОрганизация": {
+
"РучнаяСкидка": 0,
"ПометкаУдаления": false,
+
"Ответственный": {
"Предопределенный": false,
+
"ПометкаУдаления": null,
"ИмяПредопределенныхДанных": "",
+
"Предопределенный": null,
"Наименование": "Санаторий \"Родные просторы\"",
+
"ИмяПредопределенныхДанных": null,
"Код": "9999999/2",
+
"Наименование": null,
"Идентификатор": "e1cib/data/Справочник.Организации?ref=9bc8e4800e39484c4b1e680675db5963"
+
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=00000000000000000000000000000000"
 +
}
 
},
 
},
"МоментВремени": "06.03.2023 9:51:55; Карта лояльности № 22/00000003 от 06.03.2023",
+
{
"Основная": true,
+
"НомерСтроки": 0,
"Статус": {
+
"Date": "2023-02-18T00:00:00",
 +
"Стоимость": 6500,
 +
"СтоимостьЛечения": 0,
 +
"СтоимостьПитания": 0,
 +
"СтоимостьПроживания": 6500,
 +
"фРучнаяСтоимость": false,
 +
"Скидка": 0,
 +
"СтоимостьБезСкидки": 6500,
 +
"Price": {
 
"ПометкаУдаления": false,
 
"ПометкаУдаления": false,
 
"Предопределенный": true,
 
"Предопределенный": true,
"ИмяПредопределенныхДанных": "Активна",
+
"ИмяПредопределенныхДанных": "ОсновнойПрайсПродаж",
"Наименование": "Активирована",
+
"Наименование": "Основной прайс продаж",
"Идентификатор": "e1cib/data/Справочник.яъКатегории?ref=94fca85e4511756911edad18caf195a8"
+
"Код": "000000001",
},
+
"Идентификатор": "e1cib/data/Справочник.Прайсы?ref=9b7996e6d857ebf811e3a8f3d7479350"
"Актуальна": true,
 
"БонусовНаКарте": 0,
 
"ШтрихКод": "iVBORw0KGgoAAAANSUhEUgAAALQAAAC0AQAAAAAVtjufAAABgklEQVR4Ae2V0W0D\r\nMQxDtYH231IbuHxU7tIW/SuTrzjG9fxSQLFJ0XX+HPPhb+NV1aP3nulTzTLKW7Om\r\ntSp/zYzy6tbf6ecyzmtGs/c3vIAfZmnWC7imdqZXlecfTpYj9Lfxww8JvkPWAs5v\r\nP/+fqw5TwmAtyTNZjuTaCbalLzSy3D0x+hw7S/J0mI/IKdXUsp7nFuLaFyXLr5pX\r\nA+a4JMe9tfL0XTfE2Q6hRzqdfSY5ntVabnLytRUKcsyqTVl8a/PwVYzXhof1qVU+\r\nybct2BG+pek6yulon5pKSpz9KsjHBEORSpisoxzjPhbe0eXbGEdynviLH3H5Lcbp\r\niU0mGyzMMRNpvbnNxrLclVg4txWAc59bhOusatMCUs/7OsZrbwSdnC08aX6ce2pp\r\nxXbd936KM2g4Gpr8vu7NFPd1wG6oicMedVPcQuirs5cyjyxHdYpSUCHbl+5J7rRw\r\naytDTp7jLOeSzy7LHdl4SpV9bWa5dedWQ291+H3vhPhf48PfxL8AV0I85xcDVSAA\r\nAAAASUVORK5CYII="
 
 
},
 
},
 +
"КодСтроки": 0,
 +
"РучнаяСкидка": 0,
 +
"Ответственный": {
 +
"ПометкаУдаления": null,
 +
"Предопределенный": null,
 +
"ИмяПредопределенныхДанных": null,
 +
"Наименование": null,
 +
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=00000000000000000000000000000000"
 +
}
 +
}
 +
],
 
"Messages": []
 
"Messages": []
 
}
 
}
 
</pre>
 
</pre>
  
==== GetRoomQuota ====
+
==== КартыГостя ====
Получение данных о квоте номеров за период, обязательно передавать период, за который требуется получить данные: параметры запроса '''DateFrom''' и '''DateTo'''.
+
Список карт гостей физического лица.
  
Необязательные параметры
+
Параметры:
* '''RoomCategory''': если требуется получить данные по определенной категории(ям) номеров, пример &RoomCategory={"ID":"e1cib/data/Справочник.НоменклатураПомещений?ref=88575404a66e4a8911e340740eaeea25"};
+
* '''ФизЛицо''': физическое лицо, по которому необходимо получить карты гостя.
* '''Seats''': будет учитываться количество свободных мест при определении доступной квоты, пример вызова: &Seats=true
+
* '''стрРеквизиты''' (не поддерживается): список реквизитов для получения.
* '''TypeOfQuota''': вид документа онлайн-квоты, по которым требуется получить квоту. Доступные значения: '''Travelline''', '''Wubook''', '''KintAPI''', пример вызова: &TypeOfQuota=KintAPI
 
* '''OrganizationOfStay''': если требуется получить квоту, привязанную к определенной организации (актуально для баз в которых ведется учет по нескольким организациям), пример вызова: &OrganizationOfStay={"ID":"e1cib/data/Справочник.Организации?ref=8e8150e54935bd5411e25bc6880bb616"}
 
  
 
;Пример вызова:
 
;Пример вызова:
 
<pre>
 
<pre>
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetRoomQuota&DateFrom=2018-08-01T00:00:00&DateTo=2018-08-31T00:00:00
+
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=КартыГостя&стрРеквизиты="Дата"&ФизЛицо={"Идентификатор":"e1cib/data/Справочник.яъФизическиеЛица?ref=b20b6451060d98bd11e59cb64e7de21e"}
 
</pre>
 
</pre>
  
 
;Пример ответа:
 
;Пример ответа:
 
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
[
 
{
 
{
"Success": true,
+
"Дата": "2023-03-14T10:44:55",
"Result": [
+
"Номер": "23/00083      ",
 +
"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fea85e4511756911edc233ba474f2a"
 +
},
 
{
 
{
"RoomCategory": {
+
"Дата": "2021-09-20T14:39:07",
"Name": "Люкс 2к",
+
"Номер": "21/00058      ",
"ID": "e1cib/data/Справочник.НоменклатураПомещений?ref=88575404a66e4a8911e340740eaeea25"
+
"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=9a6d60a44c379a5b11ec19fefb04ce3a"
},
 
"DateFrom": "2018-08-06T00:00:00",
 
"Qty": 2,
 
"DateTo": "2018-08-31T23:59:59"
 
"QuotaID": {
 
"Date": "2018-10-08T12:14:10",
 
"Number": "demA00025",
 
"ID": "e1cib/data/Документ.УстановкаКвоты?ref=9a4660a44c379a5b11e8cad221b146ad",
 
"GUID": "21b146ad-cad2-11e8-9a46-60a44c379a5b"
 
}
 
 
}
 
}
 
]
 
]
}
 
 
</pre>
 
</pre>
  
==== GetAvailableRooms ====
+
==== ДанныеОбОсновнойКартеЛояльности ====
Получение данных о доступных (свободных) номерах за период, обязательно передавать период, за который требуется получить данные. Возвращает массив структур с описанием номеров гостиницы. Все доступные поля отображены в разделе "Пример ответа".
+
Данные об основной карте лояльности гостя.
Обязательные параметры запроса
 
'''DateFrom''' - начало периода проживания
 
'''DateTo''' - конец периода проживания
 
  
Необязательные параметры
+
Параметры:
* '''Qty''' - количество мест в одном номере. Будут подобраны все номера где есть требуемое количество свободных мест. Если не передан - будут подобраны все доступные номера.
+
* '''КартаГостя''': карта гостя, по которой необходимо получить карту лояльности.
* '''Vacant''': если передано значение '''true''' - будут подобраны только полностью свободные номера;
 
* '''RoomCategory''': если требуется получить данные по определенной категории(ям) номеров;
 
* '''Room''': проверка доступности определенного номера гостиницы;
 
* '''OrganizationOfStay''': если требуется получить номера, привязанные к определенной организации (актуально для баз в которых ведется учет по нескольким организациям)
 
* '''QuotaID''': поиск номеров, привязанных к определенной квоте; Например &QuotaID={"ID":"e1cib/data/Справочник.Квоты?ref=813800155d1e281211ec0952ca92c338"}
 
* '''ДополнительныеСвойства''': вывод дополнительных свойств номера гостиницы;
 
  
Время заезда и выезда берется из настроек гостиницы.
+
Необязательные параметры:
 +
* '''НаДату''': дата актуальности бонусов. Если не передана, то будет получено общее количество бонусов на карте.
  
 
;Пример вызова:
 
;Пример вызова:
 
<pre>
 
<pre>
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetAvailableRooms&DateFrom=2019-09-24T00:00:00&DateTo=2019-09-29T00:00:00&Vacant=true&Qty=2
+
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ДанныеОбОсновнойКартеЛояльности&КартаГостя={"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fda85e4511756911edb98261ada96f"}&НаДату=01.04.2023
 
</pre>
 
</pre>
  
Строка 1742: Строка 1979:
 
{
 
{
 
"Success": true,
 
"Success": true,
"Result": [
+
"Result": {
{
+
"Ссылка": {
"ДатаЗаезда": "2019-09-24T00:00:00",
+
"Дата": "2023-03-06T09:51:55",
"ДатаВыезда": "2019-09-29T23:59:59",
+
"Номер": "22/00000003              ",
"Room": {
+
"Идентификатор": "e1cib/data/Документ.яъКартаПокупателя?ref=94fda85e4511756911edb9bb423b5329"
"Наименование": "Номер 201",
+
},
"Код": "ТТ00000012",
+
"ПометкаУдаления": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=b8f7001bfc34542111df326af0fbf7c5",
+
"Number": "22/00000003              ",
 +
"Date": "2023-03-06T09:51:55",
 +
"Проведен": true,
 +
"Client": {
 
"ПометкаУдаления": false,
 
"ПометкаУдаления": false,
 +
"Предопределенный": false,
 +
"ИмяПредопределенныхДанных": "",
 +
"Наименование": "Романов Игорь Егорович",
 +
"Код": "dem000026",
 
"ЭтоГруппа": false,
 
"ЭтоГруппа": false,
 
"Родитель": {
 
"Родитель": {
"Наименование": "Номера лаптя",
 
"Код": "666",
 
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=bb9c5404a66e4a8911e7f79b39f2da3e",
 
 
"ПометкаУдаления": false,
 
"ПометкаУдаления": false,
"ЭтоГруппа": true
+
"Предопределенный": true,
}
+
"ИмяПредопределенныхДанных": "ФизическиеЛица",
 +
"Наименование": "Физические лица",
 +
"Код": "000000001",
 +
"ЭтоГруппа": true,
 +
"Идентификатор": "e1cib/data/Справочник.Контрагенты?ref=9b7996e6d857ebf811e3a8f3debae377"
 
},
 
},
"Block": {
+
"Идентификатор": "e1cib/data/Справочник.Контрагенты?ref=980360a44c379a5b11e6913a7733af63"
"Наименование": "Корпус 2",
 
"Код": "000000005",
 
"Идентификатор": "e1cib/data/Справочник.Здания?ref=b72f90e6baabdd1411e291efe183744d",
 
"ПометкаУдаления": false
 
 
},
 
},
"RoomCategory": {
+
"ВидСкидки": {
"Наименование": "Люкс 2к",
+
"ПометкаУдаления": null,
"Код": "Lux",
+
"Предопределенный": null,
"Идентификатор": "e1cib/data/Справочник.НоменклатураПомещений?ref=88575404a66e4a8911e340740eaeea25",
+
"ИмяПредопределенныхДанных": null,
"ПометкаУдаления": false
+
"Наименование": null,
 +
"Код": null,
 +
"Идентификатор": "e1cib/data/ПланСчетов.яъЦены?ref=00000000000000000000000000000000"
 
},
 
},
"МестВНомере": 2,
+
"СрокОкончания": "0001-01-01T00:00:00",
"Category": {
+
"Номинал": 0,
"Наименование": "Гостиничный номер",
+
"БонуснаяПрограмма": {
"Код": "",
+
"ПометкаУдаления": false,
"Идентификатор": "e1cib/data/Справочник.яъКатегории?ref=81bba100d9d99e6248a9bf544ade9963",
+
"Предопределенный": false,
"ПометкаУдаления": false
+
"ИмяПредопределенныхДанных": "",
 +
"Наименование": "Основная",
 +
"Код": "000000001",
 +
"Идентификатор": "e1cib/data/Справочник.яъБонусныеПрограммы?ref=94fda85e4511756911edb9bb423b5327"
 
},
 
},
"НачалоПериодаКвоты": null,
+
"Телефон": "",
"КонецПериодаКвоты": null,
+
"яъАвтор": {
"ТребуетсяУборка": true,
 
"С": 1,
 
"Свободно": 1,
 
"До": 12.5,
 
"Стоимость": 0,
 
"ПериодПребывания": "с 24 по 29.09.2019 (5.5 суток)",
 
"ОтВыезда": 6,
 
"ДоЗаезда": 15,
 
"ДатаРаботы": "2018-12-19T00:00:00",
 
"Работа": {
 
"Наименование": "Смена белья",
 
"Код": "ТТ0000010",
 
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=9cf55404a66e4a8911e4285c09474fc0",
 
 
"ПометкаУдаления": false,
 
"ПометкаУдаления": false,
"ЭтоГруппа": false
+
"Предопределенный": false,
 +
"ИмяПредопределенныхДанных": "",
 +
"Наименование": "Стеньшина Любовь Александровна (суперюзер)",
 +
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=b20b6451060d98bd11e5a7eb037adb81"
 
},
 
},
"РаботыВНомере": "19.12.2018, Смена белья"
+
"DocumentType": {
 +
"ПометкаУдаления": false,
 +
"Предопределенный": true,
 +
"ИмяПредопределенныхДанных": "_ДисконтнаяКарта",
 +
"Наименование": "Карта лояльности",
 +
"Код": "00081",
 +
"Идентификатор": "e1cib/data/Справочник.яъВидыДокументов?ref=9a4a60a44c379a5b11e935b5799a1a4b"
 +
},
 +
"Comment": "",
 +
"яъОрганизация": {
 +
"ПометкаУдаления": false,
 +
"Предопределенный": false,
 +
"ИмяПредопределенныхДанных": "",
 +
"Наименование": "Санаторий \"Родные просторы\"",
 +
"Код": "9999999/2",
 +
"Идентификатор": "e1cib/data/Справочник.Организации?ref=9bc8e4800e39484c4b1e680675db5963"
 +
},
 +
"МоментВремени": "06.03.2023 9:51:55; Карта лояльности № 22/00000003 от 06.03.2023",
 +
"Основная": true,
 +
"Статус": {
 +
"ПометкаУдаления": false,
 +
"Предопределенный": true,
 +
"ИмяПредопределенныхДанных": "Активна",
 +
"Наименование": "Активирована",
 +
"Идентификатор": "e1cib/data/Справочник.яъКатегории?ref=94fca85e4511756911edad18caf195a8"
 +
},
 +
"Актуальна": true,
 +
"БонусовНаКарте": 0,
 +
"ШтрихКод": "iVBORw0KGgoAAAANSUhEUgAAALQAAAC0AQAAAAAVtjufAAABgklEQVR4Ae2V0W0D\r\nMQxDtYH231IbuHxU7tIW/SuTrzjG9fxSQLFJ0XX+HPPhb+NV1aP3nulTzTLKW7Om\r\ntSp/zYzy6tbf6ecyzmtGs/c3vIAfZmnWC7imdqZXlecfTpYj9Lfxww8JvkPWAs5v\r\nP/+fqw5TwmAtyTNZjuTaCbalLzSy3D0x+hw7S/J0mI/IKdXUsp7nFuLaFyXLr5pX\r\nA+a4JMe9tfL0XTfE2Q6hRzqdfSY5ntVabnLytRUKcsyqTVl8a/PwVYzXhof1qVU+\r\nybct2BG+pek6yulon5pKSpz9KsjHBEORSpisoxzjPhbe0eXbGEdynviLH3H5Lcbp\r\niU0mGyzMMRNpvbnNxrLclVg4txWAc59bhOusatMCUs/7OsZrbwSdnC08aX6ce2pp\r\nxXbd936KM2g4Gpr8vu7NFPd1wG6oicMedVPcQuirs5cyjyxHdYpSUCHbl+5J7rRw\r\naytDTp7jLOeSzy7LHdl4SpV9bWa5dedWQ291+H3vhPhf48PfxL8AV0I85xcDVSAA\r\nAAAASUVORK5CYII="
 +
},
 +
"Messages": []
 +
}
 +
</pre>
 +
 
 +
==== GetRoomQuota ====
 +
Получение данных о квоте номеров за период, обязательно передавать период, за который требуется получить данные: параметры запроса '''DateFrom''' и '''DateTo'''.
 +
 
 +
Необязательные параметры
 +
* '''RoomCategory''': если требуется получить данные по определенной категории(ям) номеров, пример &RoomCategory={"ID":"e1cib/data/Справочник.НоменклатураПомещений?ref=88575404a66e4a8911e340740eaeea25"};
 +
* '''Seats''': будет учитываться количество свободных мест при определении доступной квоты, пример вызова: &Seats=true
 +
* '''TypeOfQuota''': вид документа онлайн-квоты, по которым требуется получить квоту. Доступные значения: '''Travelline''', '''Wubook''', '''KintAPI''', пример вызова: &TypeOfQuota=KintAPI
 +
* '''OrganizationOfStay''': если требуется получить квоту, привязанную к определенной организации (актуально для баз в которых ведется учет по нескольким организациям), пример вызова: &OrganizationOfStay={"ID":"e1cib/data/Справочник.Организации?ref=8e8150e54935bd5411e25bc6880bb616"}
 +
 
 +
;Пример вызова:
 +
<pre>
 +
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetRoomQuota&DateFrom=2018-08-01T00:00:00&DateTo=2018-08-31T00:00:00
 +
</pre>
 +
 
 +
;Пример ответа:
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
{
 +
"Success": true,
 +
"Result": [
 +
{
 +
"RoomCategory": {
 +
"Name": "Люкс 2к",
 +
"ID": "e1cib/data/Справочник.НоменклатураПомещений?ref=88575404a66e4a8911e340740eaeea25"
 +
},
 +
"DateFrom": "2018-08-06T00:00:00",
 +
"Qty": 2,
 +
"DateTo": "2018-08-31T23:59:59"
 +
"QuotaID": {
 +
"Date": "2018-10-08T12:14:10",
 +
"Number": "demA00025",
 +
"ID": "e1cib/data/Документ.УстановкаКвоты?ref=9a4660a44c379a5b11e8cad221b146ad",
 +
"GUID": "21b146ad-cad2-11e8-9a46-60a44c379a5b"
 +
}
 +
}
 +
]
 +
}
 +
</pre>
 +
 
 +
==== GetAvailableRooms ====
 +
Получение данных о доступных (свободных) номерах за период, обязательно передавать период, за который требуется получить данные. Возвращает массив структур с описанием номеров гостиницы. Все доступные поля отображены в разделе "Пример ответа".
 +
Обязательные параметры запроса
 +
'''DateFrom''' - начало периода проживания
 +
'''DateTo''' - конец периода проживания
 +
 
 +
Необязательные параметры
 +
* '''Qty''' - количество мест в одном номере. Будут подобраны все номера где есть требуемое количество свободных мест. Если не передан - будут подобраны все доступные номера.
 +
* '''Vacant''': если передано значение '''true''' - будут подобраны только полностью свободные номера;
 +
* '''RoomCategory''': если требуется получить данные по определенной категории(ям) номеров;
 +
* '''Room''': проверка доступности определенного номера гостиницы;
 +
* '''OrganizationOfStay''': если требуется получить номера, привязанные к определенной организации (актуально для баз в которых ведется учет по нескольким организациям)
 +
* '''QuotaID''': поиск номеров, привязанных к определенной квоте; Например &QuotaID={"ID":"e1cib/data/Справочник.Квоты?ref=813800155d1e281211ec0952ca92c338"}
 +
* '''ДополнительныеСвойства''': вывод дополнительных свойств номера гостиницы;
 +
 
 +
Время заезда и выезда берется из настроек гостиницы.
 +
 
 +
;Пример вызова:
 +
<pre>
 +
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetAvailableRooms&DateFrom=2019-09-24T00:00:00&DateTo=2019-09-29T00:00:00&Vacant=true&Qty=2
 +
</pre>
 +
 
 +
;Пример ответа:
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
{
 +
"Success": true,
 +
"Result": [
 +
{
 +
"ДатаЗаезда": "2019-09-24T00:00:00",
 +
"ДатаВыезда": "2019-09-29T23:59:59",
 +
"Room": {
 +
"Наименование": "Номер 201",
 +
"Код": "ТТ00000012",
 +
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=b8f7001bfc34542111df326af0fbf7c5",
 +
"ПометкаУдаления": false,
 +
"ЭтоГруппа": false,
 +
"Родитель": {
 +
"Наименование": "Номера лаптя",
 +
"Код": "666",
 +
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=bb9c5404a66e4a8911e7f79b39f2da3e",
 +
"ПометкаУдаления": false,
 +
"ЭтоГруппа": true
 +
}
 +
},
 +
"Block": {
 +
"Наименование": "Корпус 2",
 +
"Код": "000000005",
 +
"Идентификатор": "e1cib/data/Справочник.Здания?ref=b72f90e6baabdd1411e291efe183744d",
 +
"ПометкаУдаления": false
 +
},
 +
"RoomCategory": {
 +
"Наименование": "Люкс 2к",
 +
"Код": "Lux",
 +
"Идентификатор": "e1cib/data/Справочник.НоменклатураПомещений?ref=88575404a66e4a8911e340740eaeea25",
 +
"ПометкаУдаления": false
 +
},
 +
"МестВНомере": 2,
 +
"Category": {
 +
"Наименование": "Гостиничный номер",
 +
"Код": "",
 +
"Идентификатор": "e1cib/data/Справочник.яъКатегории?ref=81bba100d9d99e6248a9bf544ade9963",
 +
"ПометкаУдаления": false
 +
},
 +
"НачалоПериодаКвоты": null,
 +
"КонецПериодаКвоты": null,
 +
"ТребуетсяУборка": true,
 +
"С": 1,
 +
"Свободно": 1,
 +
"До": 12.5,
 +
"Стоимость": 0,
 +
"ПериодПребывания": "с 24 по 29.09.2019 (5.5 суток)",
 +
"ОтВыезда": 6,
 +
"ДоЗаезда": 15,
 +
"ДатаРаботы": "2018-12-19T00:00:00",
 +
"Работа": {
 +
"Наименование": "Смена белья",
 +
"Код": "ТТ0000010",
 +
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=9cf55404a66e4a8911e4285c09474fc0",
 +
"ПометкаУдаления": false,
 +
"ЭтоГруппа": false
 +
},
 +
"РаботыВНомере": "19.12.2018, Смена белья"
 +
}
 +
]
 +
}
 +
</pre>
 +
 
 +
;Пример вызова:
 +
<pre>
 +
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetAvailableRooms&DateFrom=2024-08-23T00:00:00&DateTo=2024-08-29T00:00:00&Vacant=true&КоличествоЭлементов=12&НомерСтраницы=3
 +
</pre>
 +
 
 +
==== GetAvailableCategories ====
 +
Работает аналогично методу '''GetAvailableRooms''', сворачивает результат по категориям номеров гостиницы.
 +
 
 +
 
 +
==== RoomOccupancy====
 +
* '''Тип HTTP-запроса''': GET
 +
* '''Описание''': Получение таблицы с интервалами занятости мест в номерах гостиницы в указанном периоде.
 +
 
 +
{| class="wikitable"
 +
  |+Параметры
 +
  !|Наименование
 +
  !|Обязателен?
 +
  !|Тип данных
 +
  !|Описание
 +
  !|Пример
 +
 
 +
  |-
 +
 
 +
  |<code>ДатаНачала (DateFrom)</code>
 +
  |Да
 +
  |<code>Дата</code>
 +
  |Дата передается в формате dd.mm.yyyy, либо в формате ISO
 +
  |<code>01.01.2024</code>
 +
 
 +
  |-
 +
 
 +
  |<code>ДатаОкончания (DateTo)</code>
 +
  |Да
 +
  |<code>Дата</code>
 +
  |Дата передается в формате dd.mm.yyyy, либо в формате ISO
 +
  |<code>31.01.2024</code>
 +
 
 +
  |-
 +
 
 +
  |<code>КатегорияНомера (RoomCategory)</code>
 +
  |Нет
 +
  |<code>Ссылка на категорию номера</code>
 +
  |Фильтрация результата по полю "Категория номера".
 +
  |<code>{"ID": "e1cib/data/Справочник.НоменклатураПомещений?ref=a33f60a44c379a5b11e586d4889feee7"}</code>
 +
 
 +
  |-
 +
 
 +
|}
 +
 
 +
==== PostBooking ====
 +
Отправка данных для создания новой заявки, в случае успеха метод возвращает номер, дату и идентификатор созданного документа.
 +
 
 +
Данные для создания заявки передаются в теле запроса в формате json.
 +
 
 +
Если запрос содержит параметр '''Test''', в качестве результата метода вернется тело POST-запроса и текст в формате JSON, полученный после преобразования данных для создания заявки. Можно использовать для отладки.
 +
 
 +
Если запрос содержит параметр '''MakeReservation''', будет выполнено предварительное бронирование заявки. Если в периоде пребывания по заявке свободных мест не найдено - заявка создана не будет.
 +
 
 +
Запрос может содержать массив с данными для одновременной передачи нескольких заявок. В этом случае ответом сервиса является массив с результатом обработки каждой заявки, количество элементов в ответе равно количеству во входящем массиве.
 +
 
 +
Параметры пребывания могут быть переданы как в шапке, так и в строке массива гостей. Если параметр передан и в строке и в шапке - приоритетным считаем параметр строки.
 +
Если передан параметр '''Room''' - заявка забронирует места в переданном номере гостиницы.
 +
 
 +
Данные для создания гостей могут быть переданы двумя способами:
 +
* отдельным элементом строки массива гостей с именем "ФизЛицо", "Гость" или "Guest";
 +
* параметры для создания гостя находятся непосредственно в строке массива гостей.
 +
 
 +
Ключи структуры JSON можно передавать как кириллицей, так и латиницей. Рекомендуется использовать кириллицу.
 +
 
 +
Если в контексте создания заявки передан идентификатор заявки (навигационная ссылка или уникальный идентификатор (ID), дата и номер входящего документа (InboundDate, InboundNumber), будет выполнен поиск заявки и обновление реквизитов. Новая заявка создается в том случае, если по идентификатору ничего не найдено.
 +
 
 +
Структура поля «Guest» может содержать ключ '''ВидУдостоверения''', в этом случае будут заполнены данные об удостоверении личности гостя. В значении этого поля должно быть значение «Паспорт» или произвольное наименование удостоверения, которое есть в базе данных (справочник [[Справочник "Виды удостоверений" (КУС)|Справочник «Виды удостоверений»]]).
 +
 
 +
Также структура поля «Guest» может содержать ключ '''Телефон''', который необходимо вводить в соответствии с маской страны физлица или контрагента. Телефон используется как ключ уникальности для физлиц (Параметр «ЭтоФизЛицо» = Истина или явно передана категория «Физическое лицо»).
 +
 
 +
Поля для заполнения данных удостоверения личности: ДокументСерия, ДокументНомер, ДокументДатаВыдачи, ДокументКемВыдан, ДокументКодПодразделения, ДатаРегистрацииПоМестуЖительства.
 +
 
 +
Передача поля '''Адрес регистрации''': поиск адреса выполняется по ключевому полю '''ИдентификаторФИАС''' или '''FIAS_ID'''. Если идентификатор не передан, выполняется поиск по наименованию. В запросе это одно из полей: '''Raw''', '''Наименование''', '''Name'''.
 +
 
 +
Так же, может быть передан '''АдресФактический'''. Если его нет, но есть '''АдресРегистрации''', то в фактический будет записан адрес регистрации.
 +
 
 +
;Пример вызова:
 +
<pre>
 +
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/PostData?Method=PostBooking
 +
</pre>
 +
;Тело запроса (параметры в шапке):
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
{
 +
"Client": {
 +
"Name": "Иванов Иван Иванович",
 +
"BirthDate": "1980-11-11T00:00:00",
 +
"Sex": "М",
 +
"RegAddress": {},
 +
"FactAddress": {}
 +
},
 +
"Guests": [
 +
{
 +
"Name": "Иванов Сергей Иванович",
 +
"BirthDate": "1995-01-11T00:00:00",
 +
"Sex": "Мужской",
 +
"Relation": {
 +
"Name": "Сын",
 +
"ID": "e1cib/data/Справочник.яъСтепениРодстваФЛ?ref=95965404a66e4a8911e3c1440ad6102b"
 +
}
 +
}
 +
],
 +
"OrganizationOfStay": {
 +
"ID": "e1cib/data/Справочник.Организации?ref=8e8150e54935bd5411e25bc6880bb616"
 +
},
 +
"DateFrom": "2018-10-01T00:00:00",
 +
"Days": 10,
 +
"RoomCategory": {
 +
"ID": "e1cib/data/Справочник.НоменклатураПомещений?ref=88575404a66e4a8911e340740eaeea25"
 +
},
 +
"File": "iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAQAAADZc7J/AAAABGdBTUEAALGPC/xh..."
 +
}
 +
</pre>
 +
 
 +
;Тело запроса (параметры в строке):
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
{
 +
"Client": {
 +
"Name": "Иванов Иван Иванович",
 +
"Телефон": "+7(999)999-99-99",
 +
"ЭтоФизЛицо": true,
 +
"BirthDate": "1980-11-11T00:00:00",
 +
"Sex": "М",
 +
"RegAddress": {},
 +
"FactAddress": {}
 +
},
 +
"Guests": [
 +
{
 +
"Guest": {
 +
"Name": "Иванов Сергей Иванович",
 +
"Телефон": "+7(999)999-99-99",
 +
"BirthDate": "1995-01-11T00:00:00",
 +
"Sex": "Мужской"
 +
},
 +
"DateFrom": "2023-10-01T00:00:00",
 +
"Days": "10",
 +
"RoomCategory": {
 +
"ID": "e1cib/data/Справочник.НоменклатураПомещений?ref=9a4a60a44c379a5b11e91e3b538636ab"
 +
}
 +
}
 +
],
 +
"OrganizationOfStay": {
 +
"ID": "e1cib/data/Справочник.Организации?ref=9bc8e4800e39484c4b1e680675db5963"
 
}
 
}
]
 
 
}
 
}
 
</pre>
 
</pre>
  
==== GetAvailableCategories ====
+
;Пример ответа:
Работает аналогично методу '''GetAvailableRooms''', сворачивает результат по категориям номеров гостиницы.
+
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 
+
{
==== PostBooking ====
+
"Success": true,
Отправка данных для создания новой заявки, в случае успеха метод возвращает номер, дату и идентификатор созданного документа.
+
"Result": {
 +
"Date": "2018-08-21T11:07:37",
 +
"Number": "ТТ0000000173",
 +
"ID": "e1cib/data/Документ.ЗаявкаПокупателя?ref=b4535404a66e4a8911e8a510e223144c"
 +
}
 +
}
 +
</pre>
  
Данные для создания заявки передаются в теле запроса в формате json.
+
Есть возможность передачи данных для создания медицинской справки для каждого из гостей по заявке. Возможно передать несколько справок.
 +
;Пример заполнения полей справки:
  
Если запрос содержит параметр '''Test''', в качестве результата метода вернется тело POST-запроса и текст в формате JSON, полученный после преобразования данных для создания заявки. Можно использовать для отладки.
+
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
 +
"MedicalCertificate": [
 +
    {
 +
        "InboundDate":"2018-02-04T00:00:00",
 +
        "InboundNumber":"RR-123123",
 +
        "MKB10":"W26.6",
 +
        "MedicalInstitution":"СПб ГБУЗ Городская Мариинская больница",
 +
        "File":"DFHHFGFM<JGKFYJBDVBDGdBTUEAALGPC/xh..."
 +
    },
 +
    {
 +
        "InboundDate":"2018-09-01T00:00:00",
 +
        "InboundNumber":"RR-123124",
 +
        "MKB10":"W25.6",
 +
        "MedicalInstitution":"СПб ГБУЗ Городская Мариинская больница",
 +
        "File":"DFHHFGFM<JGKFYJBDVBDGdBTUEAALGPC/xh..."
 +
    }
 +
]
 +
</pre>
  
Если запрос содержит параметр '''MakeReservation''', будет выполнено предварительное бронирование заявки. Если в периоде пребывания по заявке свободных мест не найдено - заявка создана не будет.
+
===== Дополнительные свойства =====
 +
Есть возможность установки дополнительных свойств при создании объектов. Для этого в контексте объекта должно быть установлено поле '''AdditionalProperties'''. Значение массива - структура описания свойства: поле '''Property''' содержит ссылку на свойство (поля '''ID''' или '''GUID''') или строковый '''код''' свойства, поле '''Value''' - его значение.
  
Запрос может содержать массив с данными для одновременной передачи нескольких заявок. В этом случае ответом сервиса является массив с результатом обработки каждой заявки, количество элементов в ответе равно количеству во входящем массиве.
+
Пример заполнения поля:
  
Параметры пребывания могут быть переданы как в шапке, так и в строке массива гостей. Если параметр передан и в строке и в шапке - приоритетным считаем параметр строки.
+
<pre>
Если передан параметр '''Room''' - заявка забронирует места в переданном номере гостиницы.
+
[
 
+
{
Данные для создания гостей могут быть переданы двумя способами:
+
"Property": "Цвет",
* отдельным элементом строки массива гостей с именем "ФизЛицо", "Гость" или "Guest";
+
"Value": "Красный"
* параметры для создания гостя находятся непосредственно в строке массива гостей.
+
},
 +
{
 +
"Property": {
 +
"GUID": "e2634e5a-13e4-22g7-bded-1206a89t4e19"
 +
},
 +
"Value": {
 +
"GUID": "a56e244a-19e5-11e3-bded-5404a66e4a89"
 +
}
 +
}
 +
]
 +
</pre>
  
Ключи структуры JSON можно передавать как кириллицей, так и латиницей. Рекомендуется использовать кириллицу.
+
Для передачи контактных данных в поле '''Property''' можно передать идентификатор вида контактной информации: '''ЭлектроннаяПочта''' или '''Телефон'''.
 +
<pre class="toccolours mw-collapsible mw-collapsed" style="width:300px; overflow:auto;">
 +
[
 +
{
 +
"Property": "ЭлектроннаяПочта",
 +
"Value": "example@example.com"
 +
},
 +
{
 +
"Property": "Телефон",
 +
"Value": "1-234-567-890"
 +
}
 +
]
 +
</pre>
  
Если в контексте создания заявки передан идентификатор заявки (навигационная ссылка или уникальный идентификатор (ID), дата и номер входящего документа (InboundDate, InboundNumber), будет выполнен поиск заявки и обновление реквизитов. Новая заявка создается в том случае, если по идентификатору ничего не найдено.
+
===== Пример кода на PHP =====
 +
Приведённый ниже код демонстрирует, как можно обращаться к этому методу API на языке программирования PHP, который широко используется в разработке веб-сайтов. Он отправляет заявку на бронирование для двух гостей, и указывает одного из них в качестве плательщика (контрагента).
 +
<syntaxhighlight lang="php" class="toccolours mw-collapsible mw-collapsed" style="overflow: auto">
 +
<?php
  
Структура поля «Guest» может содержать ключ '''ВидУдостоверения''', в этом случае будут заполнены данные об удостоверении личности гостя. В значении этого поля должно быть значение «Паспорт» или произвольное наименование удостоверения, которое есть в базе данных (справочник [[Справочник "Виды удостоверений" (КУС)|Справочник «Виды удостоверений»]]).
+
/**
 +
* Минимальный пример создания заявок в программе «Кинт: Управление санаторием»
 +
* с помощью HTTP API.
 +
*
 +
* Пример разрабатывался и тестировался на PHP 5.4, требует расширение cURL и
 +
* JSON.
 +
*/
  
Также структура поля «Guest» может содержать ключ '''Телефон''', который необходимо вводить в соответствии с маской страны физлица или контрагента. Телефон используется как ключ уникальности для физлиц (Параметр «ЭтоФизЛицо» = Истина или явно передана категория «Физическое лицо»).  
+
$configuration = [];
 +
$configuration['url'] = 'http://127.0.0.1/kus'; // Адрес публикации КУС.
 +
$configuration['username'] = 'API'; // Имя пользователя.
 +
$configuration['password'] = ''; // Пароль (если установлен).
 +
$configuration['timeout'] = 30; // Время, через которое запрос будет сброшен. В секундах.
  
Поля для заполнения данных удостоверения личности: ДокументСерия, ДокументНомер, ДокументДатаВыдачи, ДокументКемВыдан, ДокументКодПодразделения, ДатаРегистрацииПоМестуЖительства.
+
$configuration['service_name'] = 'KintAPI.hs';
 +
$configuration['full_url'] = sprintf('%s/hs/%s', $configuration['url'], $configuration['service_name']);
 +
 
 +
// Объекты для API (если они уже есть в удалённой базе) сериализуются в
 +
// примитивном виде - в виде структуры с одним полем: "Идентификатор".
 +
$quota = ['Идентификатор' => 'e1cib/data/Справочник.Квоты?ref=b4b85404a66e4a8911eb906c7437a068'];
 +
// Если достоверно известно, что используемый объект - предопределенный, то
 +
// можно записать просто путь к нему без массива. У квот нет предопределенных
 +
// объектов, но предположим, что такой есть, и он называется "Общий". Тогда
 +
// запись будет выглядеть так:
 +
// $quota = 'Справочник.Квоты.Общий';
 +
 
 +
// Заполним массив гостей произвольными данными.
 +
$currentTime = time(); // Сохраним текущее время для дальнейших манипуляций
 +
$guests = [
 +
    [
 +
        // Заезд оформляем через неделю в 8 утра
 +
        'ДатаЗаезда' => date('c', $currentTime + (86400 * 7)),
 +
        'ВремяСутокЗаезда' => 'Справочник.ВидыВременныхИнтервалов.ДоЗавтрака',
 +
 
 +
        // А выезд - через две и вечером
 +
        'ДатаВыезда' => date('c', $currentTime + (86400 * 21)),
 +
        'ВремяСутокВыезда' => 'Справочник.ВидыВременныхИнтервалов.ПослеУжина',
  
Передача поля '''Адрес регистрации''': поиск адреса выполняется по ключевому полю '''ИдентификаторФИАС''' или '''FIAS_ID'''. Если идентификатор не передан, выполняется поиск по наименованию. В запросе это одно из полей: '''Raw''', '''Наименование''', '''Name'''.
+
        // Если требуется ручной выбор номера - указываем сам номер
 +
        'НомерГостиницы' => ['Идентификатор' => 'e1cib/data/Справочник.Помещения?ref=b8fd001bfc34542111df38c571c15995'],
  
Так же, может быть передан '''АдресФактический'''. Если его нет, но есть '''АдресРегистрации''', то в фактический будет записан адрес регистрации.
+
        // Стоимость. Заполняется, если требуется.
 +
        // 'Стоимость' => 2800,          // Общая стоимость
 +
        // 'СтоимостьЛечения' => 500,    // Стоимость лечения
 +
        // 'СтоимостьПитания' => 1000,   // Стоимость питания
 +
        // 'СтоимостьПроживания' => 1300, // Стоимость проживания
  
;Пример вызова:
+
        // ФизЛицо - отдельная структура с информацией о нашем госте, который заезжает.
<pre>
+
        'ФизЛицо' => [
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/PostData?Method=PostBooking
+
            'ДатаРождения' => '1965-07-31T00:00:00', // Мы родились 31-го июля 1965 года
</pre>
+
            'Наименование' => 'Роулинг Джоан Кэтлин',
;Тело запроса (параметры в шапке):
+
            'Пол' => 'Ж',
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
+
 
{
+
            'ДополнительныеСвойства' => [
"Client": {
+
                [
"Name": "Иванов Иван Иванович",
+
                    'Свойство' => 'ЭлектроннаяПочта',
"BirthDate": "1980-11-11T00:00:00",
+
                    'Значение' => 'example@mail.ru'
"Sex": "М",
+
                ],
"RegAddress": {},
 
"FactAddress": {}
 
},
 
"Guests": [
 
{
 
"Name": "Иванов Сергей Иванович",
 
"BirthDate": "1995-01-11T00:00:00",
 
"Sex": "Мужской",
 
"Relation": {
 
"Name": "Сын",
 
"ID": "e1cib/data/Справочник.яъСтепениРодстваФЛ?ref=95965404a66e4a8911e3c1440ad6102b"
 
}
 
}
 
],
 
"OrganizationOfStay": {
 
"ID": "e1cib/data/Справочник.Организации?ref=8e8150e54935bd5411e25bc6880bb616"
 
},
 
"DateFrom": "2018-10-01T00:00:00",
 
"Days": 10,
 
"RoomCategory": {
 
"ID": "e1cib/data/Справочник.НоменклатураПомещений?ref=88575404a66e4a8911e340740eaeea25"
 
},
 
"File": "iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAQAAADZc7J/AAAABGdBTUEAALGPC/xh..."
 
}
 
</pre>
 
  
;Тело запроса (параметры в строке):
+
                [
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
+
                    'Свойство' => 'Телефон',
{
+
                    'Значение' => '+79121112233'
"Client": {
+
                ]
"Name": "Иванов Иван Иванович",
+
            ],
"Телефон": "+7(999)999-99-99",
 
"ЭтоФизЛицо": true,
 
"BirthDate": "1980-11-11T00:00:00",
 
"Sex": "М",
 
"RegAddress": {},
 
"FactAddress": {}
 
},
 
"Guests": [
 
{
 
"Guest": {
 
"Name": "Иванов Сергей Иванович",
 
"Телефон": "+7(999)999-99-99",
 
"BirthDate": "1995-01-11T00:00:00",
 
"Sex": "Мужской"
 
},
 
"DateFrom": "2023-10-01T00:00:00",
 
"Days": "10",
 
"RoomCategory": {
 
"ID": "e1cib/data/Справочник.НоменклатураПомещений?ref=9a4a60a44c379a5b11e91e3b538636ab"
 
}
 
}
 
],
 
"OrganizationOfStay": {
 
"ID": "e1cib/data/Справочник.Организации?ref=9bc8e4800e39484c4b1e680675db5963"
 
}
 
}
 
</pre>
 
  
;Пример ответа:
+
            // Можно передать паспортные данные или любой иной документ.
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
+
            'ВидУдостоверения' => 'Паспорт',
{
+
            'ДокументСерия' => '9400',
"Success": true,
+
            'ДокументНомер' => '999999',
"Result": {
+
            'ДокументДатаВыдачи' => '2000-01-01T00:00:00',
"Date": "2018-08-21T11:07:37",
+
            'ДокументКемВыдан' => 'ОТДЕЛ МИГРАЦИОННОГО УЧЕТА И ОФОРМЛЕНИЯ ВИЗ УФМС РОССИИ ПО Г. МОСКВЕ',
"Number": "ТТ0000000173",
+
            'ДокументКодПодразделения' => '770-001',
"ID": "e1cib/data/Документ.ЗаявкаПокупателя?ref=b4535404a66e4a8911e8a510e223144c"
 
}
 
}
 
</pre>
 
  
Есть возможность передачи данных для создания медицинской справки для каждого из гостей по заявке. Возможно передать несколько справок.
+
            'ИНН' => '1234567890123',
;Пример заполнения полей справки:
 
  
<pre class="toccolours mw-collapsible mw-collapsed" style="width:600px; overflow:auto;">
+
            'АдресРегистрации' => ['ИдентификаторФИАС' => 'afeea607-0207-467f-8c59-562fc634f924'],
"MedicalCertificate": [
+
            'АдресФактический' => ['ИдентификаторФИАС' => 'deb1d05a-71ce-40d1-b726-6ba85d70d58f'],
    {
+
            // 'Гражданство' => ['Код' => 'RUS'],
        "InboundDate":"2018-02-04T00:00:00",
+
            // 'яъКомментарий' => 'Описание для вставки в Физлицо',
        "InboundNumber":"RR-123123",
+
         ],
        "MKB10":"W26.6",
+
 
         "MedicalInstitution":"СПб ГБУЗ Городская Мариинская больница",
+
         'Справка' => [
         "File":"DFHHFGFM<JGKFYJBDVBDGdBTUEAALGPC/xh..."
+
            [
    },
+
                'ДатаВходящегоДокумента' => '2000-01-01T00:00:00',
    {
+
                'НомерВходящегоДокумента' => '000001',
        "InboundDate":"2018-09-01T00:00:00",
+
                'ДиагнозНаправившегоУчреждения' => 'W26.6',
        "InboundNumber":"RR-123124",
+
                'ЛечебноеУчреждение' => 'СПб ГБУЗ Городская Мариинская больница',
        "MKB10":"W25.6",
 
        "MedicalInstitution":"СПб ГБУЗ Городская Мариинская больница",
 
        "File":"DFHHFGFM<JGKFYJBDVBDGdBTUEAALGPC/xh..."
 
    }
 
]
 
</pre>
 
  
===== Дополнительные свойства =====
+
                // Содержимое файла передаётся в BASE64 формате.
Есть возможность установки дополнительных свойств при создании объектов. Для этого в контексте объекта должно быть установлено поле '''AdditionalProperties'''. Значение массива - структура описания свойства: поле '''Property''' содержит ссылку на свойство (поля '''ID''' или '''GUID''') или строковый '''код''' свойства, поле '''Value''' - его значение.
+
                // base64_encode(file_get_contents('/var/www/.../file.png'))
 +
                'Файл' => ''
 +
            ],
  
Пример заполнения поля:
+
            // Можно передать несколько справок, начиная с релиза 21.07 (21-1822).
 +
            // Для этого просто продублируйте структуру выше столько раз, сколько Вам нужно.
 +
        ],
  
<pre>
+
        // Ещё можно прикладывать дополнительно файл к заявке в контексте строки гостя.
[
+
        // Содержимое файла передаётся в BASE64 формате.
{
+
        // base64_encode(file_get_contents('/var/www/.../file.png'))
"Property": "Цвет",
+
        // 'Файл' => ''
"Value": "Красный"
+
    ],
},
 
{
 
"Property": {
 
"GUID": "e2634e5a-13e4-22g7-bded-1206a89t4e19"
 
},
 
"Value": {
 
"GUID": "a56e244a-19e5-11e3-bded-5404a66e4a89"
 
}
 
}
 
]
 
</pre>
 
  
Для передачи контактных данных в поле '''Property''' можно передать идентификатор вида контактной информации: '''ЭлектроннаяПочта''' или '''Телефон'''.
+
    [
<pre class="toccolours mw-collapsible mw-collapsed" style="width:300px; overflow:auto;">
+
        'ДатаЗаезда' => date('c', $currentTime + (86400 * 7)),
[
+
        'ВремяСутокЗаезда' => 'Справочник.ВидыВременныхИнтервалов.ДоЗавтрака',
{
+
        'ДатаВыезда' => date('c', $currentTime + (86400 * 21)),
"Property": "ЭлектроннаяПочта",
+
        'ВремяСутокВыезда' => 'Справочник.ВидыВременныхИнтервалов.ПослеУжина',
"Value": "example@example.com"
 
},
 
{
 
"Property": "Телефон",
 
"Value": "1-234-567-890"
 
}
 
]
 
</pre>
 
  
===== Пример кода на PHP =====
+
        // А этот гость с номером не определился. Зато он определился с категорией.
Приведённый ниже код демонстрирует, как можно обращаться к этому методу API на языке программирования PHP, который широко используется в разработке веб-сайтов. Он отправляет заявку на бронирование для двух гостей, и указывает одного из них в качестве плательщика (контрагента).
+
        'КатегорияНомера' => ['Идентификатор' => 'e1cib/data/Справочник.НоменклатураПомещений?ref=88575404a66e4a8911e340740eaeea25'],
<syntaxhighlight lang="php" class="toccolours mw-collapsible mw-collapsed" style="overflow: auto">
 
<?php
 
  
/**
+
        'ФизЛицо' => [
* Минимальный пример создания заявок в программе «Кинт: Управление санаторием»
+
            'ДатаРождения' => '1928-12-06T00:00:00',
* с помощью HTTP API.
+
            'Наименование' => 'Рубеус Хагрид',
*
+
            'Пол' => 'М'
* Пример разрабатывался и тестировался на PHP 5.4, требует расширение cURL и
+
        ]
* JSON.
+
    ]
*/
+
];
  
$configuration = [];
+
// Подготавливаем тело запроса.
$configuration['url'] = 'http://127.0.0.1/kus'; // Адрес публикации КУС.
+
$getBody = [
$configuration['username'] = 'API'; // Имя пользователя.
+
    // Если требуется сразу "Забронировать" заявку.
$configuration['password'] = ''; // Пароль (если установлен).
+
    'MakeReservation' => ''
$configuration['timeout'] = 30; // Время, через которое запрос будет сброшен. В секундах.
+
];
 +
$postBody = [
 +
    'Гости' => $guests,
  
$configuration['service_name'] = 'KintAPI.hs';
+
    // Считаем, что наш контрагент - это самый первый гость.  Для корректной
$configuration['full_url'] = sprintf('%s/hs/%s', $configuration['url'], $configuration['service_name']);
+
    // обработки со стороны КУС, добавим ему атрибут "фЭтоФизЛицо".
 +
    'Контрагент' => array_merge($guests[0]['ФизЛицо'], [
 +
        'ЭтоФизЛицо' => true
 +
    ]),
  
// Объекты для API (если они уже есть в удалённой базе) сериализуются в
+
    'Квота' => $quota,
// примитивном виде - в виде структуры с одним полем: "Идентификатор".
+
    'яъКомментарий' => "Это комментарий к заявке.\nВ нём можно использовать переносы строк, если нужно."
$quota = ['Идентификатор' => 'e1cib/data/Справочник.Квоты?ref=b4b85404a66e4a8911eb906c7437a068'];
+
];
// Если достоверно известно, что используемый объект - предопределенный, то
 
// можно записать просто путь к нему без массива. У квот нет предопределенных
 
// объектов, но предположим, что такой есть, и он называется "Общий". Тогда
 
// запись будет выглядеть так:
 
// $quota = 'Справочник.Квоты.Общий';
 
  
// Заполним массив гостей произвольными данными.
+
// Отправляем запрос.
$currentTime = time(); // Сохраним текущее время для дальнейших манипуляций
+
$request = curl_init($configuration['full_url'] . '/PostBooking?' . http_build_query($getBody));
$guests = [
+
curl_setopt($request, CURLOPT_RETURNTRANSFER, true);
    [
+
curl_setopt($request, CURLOPT_TIMEOUT, $configuration['timeout'] * 1000);
        // Заезд оформляем через неделю в 8 утра
+
curl_setopt($request, CURLOPT_USERPWD, sprintf('%s:%s', $configuration['username'], $configuration['password']));
        'ДатаЗаезда' => date('c', $currentTime + (86400 * 7)),
+
curl_setopt($request, CURLOPT_POSTFIELDS, json_encode($postBody));
        'ВремяСутокЗаезда' => 'Справочник.ВидыВременныхИнтервалов.ДоЗавтрака',
+
curl_setopt($request, CURLOPT_HTTPHEADER, [
 +
    'Content-Type: application/json'
 +
]);
 +
 
 +
$responseBody = @json_decode(curl_exec($request), true);
 +
if (!$responseBody)
 +
{
 +
    echo('Произошла критическая ошибка при разборе ответа сервера' . PHP_EOL);
 +
    exit();
 +
}
  
        // А выезд - через две и вечером
+
$exitCode = 0;
        'ДатаВыезда' => date('c', $currentTime + (86400 * 21)),
+
$text = '';
        'ВремяСутокВыезда' => 'Справочник.ВидыВременныхИнтервалов.ПослеУжина',
+
if ($responseBody['Success'])
 +
{
 +
    $text = sprintf('Заявка успешно создана под номером %s', trim($responseBody['Result']['Ссылка']['Номер']));
 +
}
 +
else
 +
{
 +
    $text = sprintf('Заявку создать не удалось, ошибка %d: %s', $responseBody['Result']['КодОшибки'], $responseBody['Result']['Error']);
 +
    $exitCode = $responseBody['Result']['КодОшибки'];
 +
}
  
        // Если требуется ручной выбор номера - указываем сам номер
+
echo($text . PHP_EOL);
        'НомерГостиницы' => ['Идентификатор' => 'e1cib/data/Справочник.Помещения?ref=b8fd001bfc34542111df38c571c15995'],
+
exit($exitCode);
  
        // Стоимость. Заполняется, если требуется.
+
</syntaxhighlight>
        // 'Стоимость' => 2800,          // Общая стоимость
 
        // 'СтоимостьЛечения' => 500,    // Стоимость лечения
 
        // 'СтоимостьПитания' => 1000,    // Стоимость питания
 
        // 'СтоимостьПроживания' => 1300, // Стоимость проживания
 
  
        // ФизЛицо - отдельная структура с информацией о нашем госте, который заезжает.
+
==== GetBookingInvoice====
        'ФизЛицо' => [
+
* '''Тип HTTP-запроса''': GET
            'ДатаРождения' => '1965-07-31T00:00:00', // Мы родились 31-го июля 1965 года
+
* '''Описание''': Метод создает (переформировывает) документ «Счет на оплату» по документу бронирования и возвращает печатную форму «Счета на оплату» в виде двоичных данных.
            'Наименование' => 'Роулинг Джоан Кэтлин',
 
            'Пол' => 'Ж',
 
  
            'ДополнительныеСвойства' => [
+
{| class="wikitable"
                [
+
  |+Параметры
                    'Свойство' => 'ЭлектроннаяПочта',
+
  !|Наименование
                    'Значение' => 'example@mail.ru'
+
  !|Обязателен?
                ],
+
  !|Тип данных
 +
  !|Описание
 +
  !|Пример
  
                [
+
  |-
                    'Свойство' => 'Телефон',
 
                    'Значение' => '+79121112233'
 
                ]
 
            ],
 
  
            // Можно передать паспортные данные или любой иной документ.
+
  |<code>Booking</code>
            'ВидУдостоверения' => 'Паспорт',
+
  |Да
            'ДокументСерия' => '9400',
+
  |<code>Документ.ЗаявкаПокупателя, Документ.Путевка</code>
            'ДокументНомер' => '999999',
+
  |Ссылка на документ «Заявка покупателя» или «Путевка».
            'ДокументДатаВыдачи' => '2000-01-01T00:00:00',
+
  |<code>{"ID": "e1cib/data/Документ.ЗаявкаПокупателя?ref=bca9d85ed320709611ef70efeed77b90"}</code>
            'ДокументКемВыдан' => 'ОТДЕЛ МИГРАЦИОННОГО УЧЕТА И ОФОРМЛЕНИЯ ВИЗ УФМС РОССИИ ПО Г. МОСКВЕ',
 
            'ДокументКодПодразделения' => '770-001',
 
  
            'ИНН' => '1234567890123',
+
  |-
  
            'АдресРегистрации' => ['ИдентификаторФИАС' => 'afeea607-0207-467f-8c59-562fc634f924'],
+
  |<code>PrintForm</code>
            'АдресФактический' => ['ИдентификаторФИАС' => 'deb1d05a-71ce-40d1-b726-6ba85d70d58f'],
+
  |Да
            // 'Гражданство' => ['Код' => 'RUS'],
+
  |<code>Справочник.яъПечатныеФормы</code>
            // 'яъКомментарий' => 'Описание для вставки в Физлицо',
+
  |Ссылка на печатную форму документа «Счет на оплату»
        ],
+
  |<code>{"ID": "e1cib/data/Справочник.яъПечатныеФормы?ref=9b7996e6d857ebf811e3a8f3debae343"}</code>
  
        'Справка' => [
+
  |-
            [
 
                'ДатаВходящегоДокумента' => '2000-01-01T00:00:00',
 
                'НомерВходящегоДокумента' => '000001',
 
                'ДиагнозНаправившегоУчреждения' => 'W26.6',
 
                'ЛечебноеУчреждение' => 'СПб ГБУЗ Городская Мариинская больница',
 
  
                // Содержимое файла передаётся в BASE64 формате.
+
|}
                // base64_encode(file_get_contents('/var/www/.../file.png'))
 
                'Файл' => ''
 
            ],
 
  
            // Можно передать несколько справок, начиная с релиза 21.07 (21-1822).
+
==== ОтметитьВыполнениеПотребностей ====
            // Для этого просто продублируйте структуру выше столько раз, сколько Вам нужно.
+
Создание [[Документ "Отметка услуг" (КУС)|документа «Отметка услуг»]]
        ],
 
 
 
        // Ещё можно прикладывать дополнительно файл к заявке в контексте строки гостя.
 
        // Содержимое файла передаётся в BASE64 формате.
 
        // base64_encode(file_get_contents('/var/www/.../file.png'))
 
        // 'Файл' => ''
 
    ],
 
 
 
    [
 
        'ДатаЗаезда' => date('c', $currentTime + (86400 * 7)),
 
        'ВремяСутокЗаезда' => 'Справочник.ВидыВременныхИнтервалов.ДоЗавтрака',
 
        'ДатаВыезда' => date('c', $currentTime + (86400 * 21)),
 
        'ВремяСутокВыезда' => 'Справочник.ВидыВременныхИнтервалов.ПослеУжина',
 
 
 
        // А этот гость с номером не определился. Зато он определился с категорией.
 
        'КатегорияНомера' => ['Идентификатор' => 'e1cib/data/Справочник.НоменклатураПомещений?ref=88575404a66e4a8911e340740eaeea25'],
 
 
 
        'ФизЛицо' => [
 
            'ДатаРождения' => '1928-12-06T00:00:00',
 
            'Наименование' => 'Рубеус Хагрид',
 
            'Пол' => 'М'
 
        ]
 
    ]
 
];
 
 
 
// Подготавливаем тело запроса.
 
$getBody = [
 
    // Если требуется сразу "Забронировать" заявку.
 
    'MakeReservation' => ''
 
];
 
$postBody = [
 
    'Гости' => $guests,
 
 
 
    // Считаем, что наш контрагент - это самый первый гость.  Для корректной
 
    // обработки со стороны КУС, добавим ему атрибут "фЭтоФизЛицо".
 
    'Контрагент' => array_merge($guests[0]['ФизЛицо'], [
 
        'ЭтоФизЛицо' => true
 
    ]),
 
 
 
    'Квота' => $quota,
 
    'яъКомментарий' => "Это комментарий к заявке.\nВ нём можно использовать переносы строк, если нужно."
 
];
 
 
 
// Отправляем запрос.
 
$request = curl_init($configuration['full_url'] . '/PostBooking?' . http_build_query($getBody));
 
curl_setopt($request, CURLOPT_RETURNTRANSFER, true);
 
curl_setopt($request, CURLOPT_TIMEOUT, $configuration['timeout'] * 1000);
 
curl_setopt($request, CURLOPT_USERPWD, sprintf('%s:%s', $configuration['username'], $configuration['password']));
 
curl_setopt($request, CURLOPT_POSTFIELDS, json_encode($postBody));
 
curl_setopt($request, CURLOPT_HTTPHEADER, [
 
    'Content-Type: application/json'
 
]);
 
 
 
$responseBody = @json_decode(curl_exec($request), true);
 
if (!$responseBody)
 
{
 
    echo('Произошла критическая ошибка при разборе ответа сервера' . PHP_EOL);
 
    exit();
 
}
 
 
 
$exitCode = 0;
 
$text = '';
 
if ($responseBody['Success'])
 
{
 
    $text = sprintf('Заявка успешно создана под номером %s', trim($responseBody['Result']['Ссылка']['Номер']));
 
}
 
else
 
{
 
    $text = sprintf('Заявку создать не удалось, ошибка %d: %s', $responseBody['Result']['КодОшибки'], $responseBody['Result']['Error']);
 
    $exitCode = $responseBody['Result']['КодОшибки'];
 
}
 
 
 
echo($text . PHP_EOL);
 
exit($exitCode);
 
 
 
</syntaxhighlight>
 
 
 
==== ОтметитьВыполнениеПотребностей ====
 
Создание [[Документ "Отметка услуг" (КУС)|документа «Отметка услуг»]]
 
  
 
Параметры:
 
Параметры:
Строка 5084: Строка 5551:
  
 
==== Изменение документов ====
 
==== Изменение документов ====
Для вида документа «яъЗаказПокупателя» поддерживается изменение реквизитов. Для этого в тело запроса необходимо передать параметр '''Идентификатор''' (идентификатор заказа возвращается при успешном выполнении метода PostDocument). Реквизиты документа будут перезаполнены по входящим данным.
+
Для вида документа «яъЗаказПокупателя» поддерживается изменение реквизитов. Для этого в тело запроса необходимо передать параметр '''Идентификатор''' (идентификатор заказа возвращается при успешном выполнении метода PostDocument). Реквизиты для изменения рекомендуется передавать в параметре «стРеквизиты», а не в теле запроса, так как реквизиты из тела запроса не всегда изменяются при вызове обработки заполнения документа.
 
Если в запросе передана таблица товаров, позиции будут добавлены к существующим, если позиция уже есть в заказе, будет увеличено количество в строке.
 
Если в запросе передана таблица товаров, позиции будут добавлены к существующим, если позиция уже есть в заказе, будет увеличено количество в строке.
 
Если в запросе передан параметр '''Режим''' со значением '''УдалениеТоваров''', количество товара будет уменьшено. В случае, если количество стало меньше или равно нулю, строка из заказа будет удалена.
 
Если в запросе передан параметр '''Режим''' со значением '''УдалениеТоваров''', количество товара будет уменьшено. В случае, если количество стало меньше или равно нулю, строка из заказа будет удалена.
 
Данный функционал доступен начиная с версии 3.24.04.
 
Данный функционал доступен начиная с версии 3.24.04.
  
;Пример запроса для изменения реквизита «Договор»:
+
;Пример запроса для изменения реквизитов «Контрагент» и «Договор»:
 
<pre>
 
<pre>
 
{
 
{
   "Идентификатор": "e1cib/data/Документ.яъЗаказ?ref=9d415404a66e4a8911ef224f2be07e9b",
+
   "Идентификатор": "e1cib/data/Документ.яъЗаказ?ref=bca9d85ed320709611ef2232d2aed537",
   "ДоговорКонтрагента": {
+
   "стРеквизиты": {
    "Идентификатор": "e1cib/data/Справочник.ДоговорыКонтрагентов?ref=9d415404a66e4a8911ef23e18196f290"
+
    "Контрагент": {
 +
      "Идентификатор": "e1cib/data/Справочник.Контрагенты?ref=9a58f2e8cf1cc29211ea4d76137ec466"
 +
    },
 +
    "ДоговорКонтрагента": {
 +
      "Идентификатор": "e1cib/data/Справочник.ДоговорыКонтрагентов?ref=bca6d85ed320709611eeb4f2fc6d1fb8"
 +
    }
 
   }
 
   }
}
+
}</pre>
</pre>
 
  
 
;Пример запроса для уменьшения количества номенклатуры:
 
;Пример запроса для уменьшения количества номенклатуры:

Текущая версия на 17:33, 23 октября 2024

Содержание

Общая информация

Введение

API программного продукта позволяет делать интеграции с другим ПО. Например, реализовать личный кабинет на сайте. Для этого, разработчики могут обращаться в базу как для операций обычного чтения, так и для записи.

Требования

  1. База, к которой обращаются, должна быть опубликована на веб-сервере.
    1. При публикации базы, должна быть выполнена активация HTTP-сервиса KintAPI.
    2. Проверить правильность выполнения публикации можно путём обращения к методу GetDBInfo. Пример: https://demo.kint.ru/kus_demo/hs/KintAPI.hs/GetData?Method=GetDBInfo
  2. Разработчик должен иметь хотя бы минимальные представления о том, что такое HTTP-протокол и JSON-сериализация
    1. Что такое тело запроса, и чем оно отличается от параметров
    2. Unified Request Location и Unified Request Identifier не должны быть пустыми определениями
    3. Виды запросов (POST, GET, OPTIONS) и чем они отличаются
    4. Базовая авторизация (если публикация выполнена без предопределения аутентификационных данных)

Вызов методов

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

До версии 21.07, единственным способом вызвать какую-либо функцию, была передача названия в предопределенном параметре Method на URI /pub/hs/KintAPI.hs/GetData или /pub/hs/KintAPI.hs/PostData, в зависимости от типа запроса.

Начиная с релиза 21.07, имя вызываемого метода стало частью URI, и вместо GetData / PostData, стало возможным прописывать имя метода (например, /pub/hs/KintAPI.hs/GetDBInfo). Старый способ вызова методов сохранился для поддержания совместимости с уже реализованными интеграциями.

Помните, что для веб-сервера регистр букв важен, и запрос вида /pub/hs/kintapi.hs/getdbinfo гарантированно приведёт к ошибке 404.

Предопределенные параметры запроса

На поведение сериализатора и API можно влиять путём передачи специальных параметров. Имена параметров можно передавать как на русском, так и на английском языке.

Имя параметра на русском Имя параметра на английском Описание Пример значения Значение по-умолчанию
Реквизиты Fields Задаёт перечень реквизитов, которые должны быть переданы вместе с ссылками на элементы. Поддерживается получение нестандартных реквизитов: ПредставлениеОбъекта, Идентификатор, GUID. Ссылка,Контрагент,КонтактноеЛицо,Договор Не задано
ДополнительныеСвойства AdditionalProperties Перечень свойств, которые должны быть добавлены в тело ответа. Ключ под свойство добавляется даже в случае отсутствия какого-либо значения. Телефон,ЭлектроннаяПочта Не задано
ПреобразоватьКлючи ConvertKeys Указывает, необходимо ли переводить ключи с русского на английский (если в встроенном словаре имеется сопоставление). true Включено
- test Предназначено более для тестов сериализации. API не будет вызывать метод, и просто вернёт JSON так, как она его получила и "пропарсила" из POST-запроса. Значение не требуется, достаточно просто передать параметр Не используется
- raw Возвращает ответ (если представляется возможным) сырым телом, без какой-либо сериализации. Не должно использоваться в нормальных ситуациях. Значение не требуется, достаточно просто передать параметр Не используется

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

API возвращает ответы всегда в формате JSON, даже если запрашивается иной через заголовок Accept. В качестве Content-Type задано значение application/json;charset=utf-8.

Структура ответа содержит два поля:

  • Success - флаг успешности выполнения, присутствует всегда
  • Result - результат выполнения

В зависимости от Success и вызываемого метода, результат может быть разным. Для случаев, когда вызов завершился ошибкой, структура гарантированно следующая:

  • Error - описание ошибки
  • КодОшибки - код ошибки
{
    "Success": false,
    "Result": {
        "Error": "Метод конфигурации «ИмяМетода» не найден!",
        "КодОшибки": 1000
    }
}

Коды ошибок

Есть небольшой набор предопределенных кодов ошибок, которые могут быть вызваны по тем или иным причинам в любом продукте.

Код ошибки (ErrorCode) Описание
1000 Передано некорректное или не существующее имя метода
1001 Переданы некорректные параметры запроса
1002 Передан некорректный текст POST запроса
1010 Внутренняя ошибка конфигурации, при возникновении ошибки напишите об этом на spp@kint.ru
1032 При отмене заявки оказалось что она уже отменена, необходимо со стороны сайта написать обработчик такой ситуации
1100 Не передан параметр с видом справочника
1101 Переданный вид справочника отсутствует в конфигурации
1102 Элемент справочника не найден по полям поиска
1103 По полям поиска найдено несколько подходящих элементов
1104 Ошибка записи элемента справочника, возможно переданы не все обязательные реквизиты

Запрос

Передача параметров методу зависит от самого метода, но есть некоторые принятые стандарты в их отношении.

  • Если параметр требует передачу любого ссылочного объекта - передаётся JSON-структура с одним из ключевых полей: ID или GUID.
    • ID - навигационная ссылка на объект в базе 1С: Предприятия: e1cib/data/Справочник.НоменклатураПомещений?ref=b4585404a66e4a8911e8bb0449fde0fc
    • GUID - уникальный идентификатор ссылки: 49fde0fc-bb04-11e8-b458-5404a66e4a89
    • Важное замечание: Поиск по ID работает быстрее поиска по GUID, потому приоритет остаётся за ним при передаче двух полей одновременно.
  • Для предопределенных значений и элементов перечислений доступен поиск по имени предопределенного элемента, например Перечисление.яъПол.Мужской.
  • Файлы приложений должны быть закодированы в формат base64 и переданы внутри тела JSON-объекта, в ключе File.

Авторизация

Для подключения к базе-источнику требуется передать имя и пароль пользователя базы данных: пользователь должен быть добавлен в список пользователей информационной базы. Это ограничение, накладываемое платформой 1С: Предприятие. Передача данных передаётся с помощью стандартного механизма HTTP-аутентификации, подробнее о нём прочитать можно здесь.

Если произвести авторизацию не представляется возможным, можно произвести публикацию базы с беcпарольной аутентификацией (когда пользователь и его пароль прописаны на веб-сервере в default.vrd), но имейте в виду, что в таком случае любой, у кого будет ссылка на неё, сможет заходить в базу через режим 1С: Предприятие, если соответствующие права у пользователя имеются.

Пагинация

Доступно получение не всего результата запроса, а частями по страницам с сохранением порядка записей. Для получения количества записей можно воспользоваться методом КоличествоЭлементов.

Имя параметра на русском Имя параметра на английском Описание Пример значения Значение по умолчанию
КоличествоЭлементов CountOnPage Количество элементов в результате запроса. 100 0
НомерСтраницы PageNumber Номер требуемой части результата запроса. 10 1

Методы с поддержкой пагинации:

Пример вызова
/hs/KintAPI.hs/GetData?Method=GetCatalog&CatalogName=яъФизическиеЛица&PageNumber=6&CountOnPage=10 

Общие методы

В данном разделе описаны методы, доступные в любой конфигурации. В скобках указано наименование кириллицей, если оно есть.

GetCatalog (СписокЭлементов)

  • Тип HTTP-запроса: GET
  • Описание: Возвращает перечень элементов по заданному отбору. Можно использовать для получения списка организаций, категорий номеров и прочего.
Параметры
Наименование Обязателен? Тип данных Описание Пример
Вид / CatalogName Да Строка Имя объекта, из которого формируется выдача Организации
Отбор / Filter Нет Структура Структура, указывающая, по каким реквизитам и их значениям необходимо делать отбор {"ИНН": "1835012280"}
Тип / CatalogType Нет Строка Вид объекта, по умолчанию "Справочник". Справочник
  • Пример вызова:
    /GetData?Method=GetCatalog&CatalogName=Организации&Fields=Ссылка,ИНН,КПП
  • Пример вызова для списка документов:
    /GetData?Method=GetCatalog&CatalogName=ПоступлениеТоваровУслуг&CatalogType=Документ&Fields=Номер,Дата
  • Пример вызова с отбором:
    /GetData?Method=GetCatalog&CatalogName=Организации&Fields=Ссылка,ИНН,КПП&Filter={"ГоловнаяОрганизация":%20{"ID":"e1cib/data/Справочник.Организации?ref=ad5c5404a66e4a8911e37e83f3ef6892"}}
  • Пример вызова с пагинацией:
    GetData?Method=GetCatalog&CatalogName=яъФизическиеЛица&Fields=Наименование,Пол&PageNumber=24&CountOnPage=100&Filter={"Пол": "Перечисление.яъПол.Мужской"}
Пример ответа
{
    "Success": true,
    "Result":
    [
        {
            "Ссылка":
            {
                "Name": "ОАО санаторий \"Родные просторы\"",
                "ID": "e1cib/data/Справочник.Организации?ref=8e8150e54935bd5411e25bc6880bb616"
            },
            "ИНН": "1835012280",
            "КПП": "184101001"
        },
        {
            "Ссылка":
            {
                "Name": "ООО \"Италмас\"",
                "ID": "e1cib/data/Справочник.Организации?ref=b72f90e6baabdd1411e271b038722897"
            },
            "ИНН": "",
            "КПП": ""
        }
    ]
}

GetDBInfo (ДанныеИБ)

Возвращает информацию о версии информационной базы. Параметров нет. Можно использовать для проверки работоспособности API.

Пример вызова
/GetDBInfo
Проверка работоспособности API
https://<адрес_сервера>/<имя_публикации>/hs/KintAPI.hs/GetDBInfo
Пример ответа
{
    "Success": true,
    "Result": {
        "ВерсияAPI": "1.1",
        "НомерРелиза": "21.11.01"
    }
}

QRCode (КартинкаQR)

  • Тип HTTP-запроса: GET
  • Описание: Получает картинку QR-кода по навигационной ссылке переданного объекта в формате BASE64.

ОбъектПоНавигационнойСсылке

  • Тип HTTP-запроса: GET
  • Описание:
Параметры
Наименование Обязателен? Тип данных Описание Пример
НавигационнаяСсылка Да Строка Навигационная ссылка на объект в информационной базе e1cib/data/Справочник.яъФизическиеЛица?ref=9a6c5404a66e4a8911e5bb8e2aa0771f

GetPrintForm (ПолучитьПечатнуюФорму)

Позволяет получить сформированную печатную форму в выбранном формате.

Параметры:

  • Объект (GUID, обязательный) - для кого получаем значение параметра
  • ПечатнаяФорма (GUID, не обязательный только в случае получения значения параметра) - может использоваться для расширения списка параметров. Без печатной формы список параметров может быть ограничен.
  • Формат (не обязательный только в случае получения значения параметра) - доступны значения: DOCX, HTML5, MXL, PDF, TXT, XLS
  • ИмяПараметра (Строка, не обязательный) - если передан, то вернется не печатная форма, а значение переданного параметра. По умолчанию доступны параметры на вкладках «Основные» + «Доступные» + «Дополнительные» в форме настройки печатной формы.
  • стрТипВыходныхДанных (Строка, не обязательный) - может использоваться тип данных Base64 или ДвоичныеДанные, в ином случае возвращает содержимое файла. Значение по умолчанию Base64.
Пример вызова
/GetData?Method=GetPrintForm&Объект={"GUID":%20"dc7970e4-e673-11e9-b48d-5404a66e4a89"}&ПечатнаяФорма={"GUID":%20"09c83fe6-f918-4388-a2ee-b0a3276941d4"}&Формат=PDF
Пример ответа
{
"Success": true,
"Result": "JVBERi0xLjcKJeLjz9MKMSAwIG9iago8PAovRmlsdGVyIC9GbGF0ZURlY29kZQovTGVuZ3RoIDIgMCBSCi9MZW5ndGgxIDU0Nzk2Ci9MZW5ndGgyIDAKL0 ... UlRU9GCg=="
}
Пример вызова для получения значения параметра
/GetData?Method=GetPrintForm&Объект={"GUID":%20"dc7970e4-e673-11e9-b48d-5404a66e4a89"}&ПечатнаяФорма={"GUID":%20"09c83fe6-f918-4388-a2ee-b0a3276941d4"}&ИмяПараметра=ФизЛицо
Пример ответа
{
"Success": true,
"Result": {
"Наименование": "Иванов Иван Иванович",
"Код": "000000793 ",
"Идентификатор": "e1cib/data/Справочник.яъФизическиеЛица?ref=813b5404a66e4a8911e35761a7492167",
"ПометкаУдаления": false,
"ЭтоГруппа": false
}
}

GetReport (РезультатУФО)

Позволяет получить результат отчета в переданном формате.

Параметры:

  • Отчет (GUID, обязательный) - навигационная ссылка на отчет.
  • ТипФайла - формат результата.
    • JSON, CSV позволяют получить таблицу данных отчета
    • XLSX, PDF, TXT, DOCX, MXL позволяют получить результат отчета в том же виде, в котором сохраняется табличный документ результата отчета в режиме «1С: Предприятие», данные закодированы в строку BASE64.
Пример вызова
/hs/KintAPI.hs/РезультатУФО?Отчет={"Идентификатор":%20"e1cib/data/Справочник.яъОтчеты?ref=9c415404a66e4a8911e4dcfb89878423"}&Формат=JSON
Пример ответа
{
"Success": true,
"Result": "[
{"Корпус": "Корпус 2","Заехало": 1,"ЗапланированЗаезд": 1},
{"Корпус": "Корпус 33","Заехало": 0,"ЗапланированЗаезд": 0}
]"
}

GetDataSourceInfo (ОписаниеИсточникаДанных)

Позволяет получить описание источника данных в формате JSON.

Параметры:

  • ИсточникДанных (GUID, обязательный) - навигационная ссылка на источник данных.
Пример вызова
/hs/KintAPI.hs/ОписаниеИсточникаДанных?ИсточникДанных=e1cib/data/Справочник.яъИсточникиДанных?ref=bca1d85ed320709611ed397243b5eb7d
Пример ответа
{
"Success": true,
"Result": "{"Наименование": "Тестовый источник данных","яъКатегория": "Запрос","яъКомментарий": "Используется для примеров и тестирования API","яъАвтор": "Иванов Иван","Измерения": "НомерСтроки,Наименование,Идентификатор,Физлицо,УчетнаяЗапись","Ресурсы": "Количество","Параметры": "","HTTPЗапрос": "http://localhost/base_name/hs/KintAPI.hs/ТаблицаИсточникаДанных?ИсточникДанных=e1cib/data/Справочник.яъИсточникиДанных?ref=bca1d85ed320709611ed397243b5eb7d"n}",
"Messages": []
}

GetDataSource (ТаблицаИсточникаДанных)

Позволяет получить таблицу источника данных в формате JSON.

Параметры:

  • ИсточникДанных (GUID, обязательный) - навигационная ссылка на источник данных.
Пример вызова
/hs/KintAPI.hs/ТаблицаИсточникаДанных?ИсточникДанных=e1cib/data/Справочник.яъИсточникиДанных?ref=bc79d85ed320709611e346049adc3ab1
Пример вызова с передачей параметров формирования результата
/hs/KintAPI.hs/ТаблицаИсточникаДанных?ИсточникДанных=e1cib/data/Справочник.яъИсточникиДанных?ref=bc79d85ed320709611e346049adc3ab1&НачалоПериода=01.01.2022&КонецПериода=31.01.2022&ИНН=123456788900&Измерения=Контрагент,Договор&Ресурсы=Количество,Сумма
Пример ответа
{
"Success": true,
"Result": "[{"Дело": "Разное","Количество": 7},{"Дело": "КП","Количество": 2},{"Дело": "К:БУ","Количество": 1}]"
}

ЕстьПраваАдминистратора

  • Тип HTTP-запроса: GET
  • Описание: Возвращает признак наличия администраторских прав у указанного пользователя.
Параметры
Наименование Обязателен? Тип данных Описание Пример
Пользователь Да СправочникСсылка.яъПользователи Ссылка на пользователя, для которого выполняется проверка наличия прав администратора
{
    "Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=9b7996e6d857ebf811e3a8f3c11af005"
}
Пример вызова
/ЕстьПраваАдминистратора?Пользователь={"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=9b7996e6d857ebf811e3a8f3c11af005"}
Пример ответа
{
    "Success": true,
    "Result": true
}

GetConstant

  • Тип HTTP-запроса: GET
  • Описание: Возвращает значение константы, свойства или настройки.

Параметры:

  • ID/Идентификатор - название требуемой константы или настройки / код требуемого свойства.
Пример вызова
/hs/KintAPI.hs/GetConstant?ID=ПроцентПредоплатыБрони
Пример ответа
{
"Success": true,
"Result": 50,
"Messages": []
}

PostElement

Создание элемента справочника переданного вида. Параметры:

  • Вид: имя справочника в дереве метаданных или имя предопределенного элемента справочника яъКатегории.

Необязательные параметры:

  • ПоляПоиска: структура имен реквизитов и их значений, по которым будет выполняться поиск существующих элементов.
Пример запроса
/hs/KintAPI.hs/PostData?Method=PostElement&Вид=яъРейсы
Тело запроса (создание нового элемента)
{
"Наименование": "Новый рейс",
"ПунктОтправления": {"Идентификатор": "e1cib/data/Справочник.яъПунктыНазначения?ref=98335404a66e4a8111e976225ef1ac20"}
"ПунктПрибытия": {"Идентификатор": "e1cib/data/Справочник.яъПунктыНазначения?ref=98435404a66e4a8111ea6a959c446ea8"}
"Работа":
[
{
"ВидРабот": {"Идентификатор": "e1cib/data/Справочник.Номенклатура?ref=977bf46d0477991a11ee8d010588b413"},
"Количество": 10,
"ЕдиницаИзмерения": {"Идентификатор": "e1cib/data/Справочник.КлассификаторЕдиницИзмерения?ref=9b8e002590d756f511e7eb0759c329d2"}
}
]
}
Пример ответа
{
"Success": true,
"Result": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Новый рейс",
"Код": "000000004",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.яъРейсы?ref=977bf46d0477991a11ee929ce65408df"
}

Тело запроса (изменение существующего элемента)
{
"Наименование": "Измененный рейс",
"ПоляПоиска":
{
"Код": "000000004"
}
}
Пример ответа
{
"Success": true,
"Result": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Измененный рейс",
"Код": "000000004",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.яъРейсы?ref=977bf46d0477991a11ee929ce65408df"
}

ПолучитьИзмененияПоУзлу

Получение данных объектов, зарегистрированных в узле плана обмена.

Параметры:

  • Объекты: структура с параметрами для получения объектов или идентификаторы через «,».
    • ИдОбъекта: строка формата <Тип объекта>.<Вид объекта> - идентификатор объекта в конфигурации, перечень элементов которых нужно получить, например: «Справочник.Контрагенты», «Документ.ЗаявкаПокупателя», «ПланСчетов.МедицинскиеПоказатели». Для справочников доступно игнорирование указания типа.
    • Отбор: структура с отбором реквизитов для определенного объекта.
    • стрРеквизиты: реквизиты через «,» для получения.
  • Узел: узел плана обмена, по которому необходимо получить зарегистрированные объекты.

Необязательные параметры:

  • Отбор: структура с общим отбором реквизитов для всех получаемых объектов.
  • ОтменитьРегистрацию: отменять ли регистрацию объектов в узле после получения. По умолчанию - Истина.
  • КоличествоЭлементов: количество объектов в результате. Может быть задан для каждого объекта, так и для отдельного.
  • НомерСтраницы: Номер результата пагинации. Может быть задан для каждого объекта, так и для отдельного.
Пример запроса
/hs/KintAPI.hs/GetData?Method=ПолучитьИзмененияПоУзлу&Объекты=[{"ИдОбъекта":"яъФизическиеЛица","стрРеквизиты":"Наименование,Код"},{"ИдОбъекта":"Контрагенты","Отбор":{"Наименование":"Юридические лица"}}]&Узел={"Идентификатор":"e1cib/data/ПланОбмена.ОбменКУСБухгалтерия20?ref=9a4a60a44c379a5b11e91efe3f9ca517"}&Отбор={"ЭтоГруппа":true}&ОтменитьРегистрацию=Ложь
Пример ответа
[
{
"Справочник_яъФизическиеЛица": [
{
"Name": "Старше 70",
"Code": "t010003619"
}
]
},
{
"Справочник_Контрагенты": [
{
"Ссылка": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Юридические лица",
"Код": "Т000936  ",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Контрагенты?ref=951ba85e4511756911eec66dccd475d9"
}
}
]
}
]
Пример запроса
/hs/KintAPI.hs/PostData?Method=ПолучитьИзмененияПоУзлуОбъекты=Документ.ЗаявкаГостя,Документ.Путевка&Узел={"Идентификатор":"e1cib/data/ПланОбмена.ОбменКУСБухгалтерия20?ref=9a4a60a44c379a5b11e91efe3f9ca517"}&Отбор={"Контрагент_ПометкаУдаления":true}
[
{
"Документ_ЗаявкаГостя": [
{
"Ссылка": {
"Дата": "2023-11-27T16:58:25",
"Номер": "23/000000000039",
"Идентификатор": "e1cib/data/Документ.ЗаявкаГостя?ref=bca6d85ed320709611ee8d24a1e9d7c7"
}
}
],
},
{
"Документ_Путевка": [
{
"Ссылка": {
"Дата": "2020-02-26T17:20:59",
"Номер": "З-19/00046     ",
"Идентификатор": "e1cib/data/Документ.Путевка?ref=9a58f2e8cf1cc29211ea589ae325f1b1"
}
},
{
"Ссылка": {
"Дата": "2021-09-02T15:33:44",
"Номер": "21/00043       ",
"Идентификатор": "e1cib/data/Документ.Путевка?ref=9a6b60a44c379a5b11ec0be19fda8385"
}
},
{
"Ссылка": {
"Дата": "2017-03-20T12:15:07",
"Номер": "demАЛ-0654624  ",
"Идентификатор": "e1cib/data/Документ.Путевка?ref=845c60a44c379a5b11e70d4ddd07d0a4"
}
},
{
"Ссылка": {
"Дата": "2017-03-20T12:43:26",
"Номер": "demАЛ-0654625  ",
"Идентификатор": "e1cib/data/Документ.Путевка?ref=845c60a44c379a5b11e70d519dffcf81"
}
},
{
"Ссылка": {
"Дата": "2016-11-29T14:52:39",
"Номер": "demАЛ-0654581  ",
"Идентификатор": "e1cib/data/Документ.Путевка?ref=980360a44c379a5b11e6b62b1b6435e6"
}
}
]
}
]
Пример запроса с пагинацией
/hs/KintAPI.hs/GetData?Method=ПолучитьИзмененияПоУзлу&Узел={"Идентификатор": "e1cib/data/ПланОбмена.ОбменКУСБухгалтерия20?ref=bc74d85ed320709611ecbf16523724ef"}&Объекты=[{"ИдОбъекта": "Номенклатура", "стрРеквизиты": "Наименование"}, {"ИдОбъекта": "Контрагенты", "стрРеквизиты": "Наименование"}, {"ИдОбъекта": "яъФизическиеЛица", "стрРеквизиты": "Наименование", "КоличествоЭлементов": 20, "НомерСтраницы": 5}]&ОтменитьРегистрацию=Ложь&КоличествоЭлементов=10&НомерСтраницы=4

КоличествоЭлементов

  • Тип HTTP-запроса: GET
  • Описание: Получение количества объектов
Параметры
Наименование Обязателен? Тип данных Описание Пример
ВидыОбъектов / ВидОбъекта Да Строка, Массив Тип объекта (По умолчанию справочник), вид объекта Организации,Документ.Путевка
Отбор / Filter Нет Структура Структура, указывающая, по каким реквизитам и их значениям необходимо делать отбор {"ИНН": "1835012280"}
Узел Нет Ссылка на узел плана обмена В результате окажется количество изменений по узлу {"Идентификатор": "e1cib/data/ПланОбмена.ОбменКУСБухгалтерия20?ref=9a4a60a44c379a5b11e91efe3f9ca517"}
КоличествоНаСтранице / CountOnPage Нет Число Количество элементов на странице, с указанным параметром будет выводится количество страниц 100
  • Пример вызова 1:
    /GetData?Method=КоличествоЭлементов&КоличествоНаСтранице=100&ВидОбъекта=яъФизическиеЛица

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

    [
        {
            "ВидОбъекта": "Справочник.яъФизическиеЛица",
            "КоличествоОбъектов": 6733,
            "КоличествоСтраниц": 68
        }
    ]
  • Пример вызова 2 (Получение количества для нескольких объектов):
    /GetData?Method=КоличествоЭлементов&ВидыОбъектов=яъФизическиеЛица,Документ.КартаГостя,РегистрСведений.КурсыВалют

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

    [
        {
            "ВидОбъекта": "Справочник.яъФизическиеЛица",
            "КоличествоОбъектов": 6764
        },
        {
            "ВидОбъекта": "Документ.КартаГостя",
            "КоличествоОбъектов": 3000
        },
        {
            "ВидОбъекта": "РегистрСведений.КурсыВалют",
            "КоличествоОбъектов": 3
        }
    ]
  • Пример вызова 3 (Получение количества с общим отбором):
    /GetData?Method=КоличествоЭлементов&ВидыОбъектов=яъФизическиеЛица,Контрагенты,Сотрудники&Отбор={"Код": "000000001"}

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

    [
        {
            "ВидОбъекта": "Справочник.яъФизическиеЛица",
            "КоличествоОбъектов": 1
        },
        {
            "ВидОбъекта": "Справочник.Контрагенты",
            "КоличествоОбъектов": 1
        },
        {
            "ВидОбъекта": "Справочник.Сотрудники",
            "КоличествоОбъектов": 0
        }
    ]
  • Пример вызова 4 (Получение количества с общим отбором, дополнительным отбором по физ. лицам, отключенным отбором по коду для сотрудников):
    /GetData?Method=КоличествоЭлементов&ВидыОбъектов=[{ "ВидОбъекта":"яъФизическиеЛица", "Отбор": {"Наименование": "Макадзару"} },{ "ВидОбъекта":"Контрагенты" },{ "ВидОбъекта":"Сотрудники", "Отбор": {"Код": ""} }]&Отбор={"Код": "000000001"}

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

    [
        {
            "ВидОбъекта": "Справочник.яъФизическиеЛица",
            "КоличествоОбъектов": 0
        },
        {
            "ВидОбъекта": "Справочник.Контрагенты",
            "КоличествоОбъектов": 1
        },
        {
            "ВидОбъекта": "Справочник.Сотрудники",
            "КоличествоОбъектов": 124
        }
    ]
  • Пример вызова 5 (Получение количества изменений по общему узлу и получение количества физ. лиц по другому узлу):
    /GetData?Method=КоличествоЭлементов&ВидыОбъектов=[{ "ВидОбъекта":"яъФизическиеЛица" },{ "ВидОбъекта":"Контрагенты" },{ "ВидОбъекта":"Сотрудники"},{ "ВидОбъекта": "яъФизическиеЛица", "Узел": {"Идентификатор": "e1cib/data/ПланОбмена.ОбменКУСБухгалтерия20?ref=bc74d85ed320709611ecbf16523724ef"} }]&Узел={"Идентификатор": "e1cib/data/ПланОбмена.ОбменКУСБухгалтерия20?ref=9a4a60a44c379a5b11e91efe3f9ca517"}

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

    [
        {
            "ВидОбъекта": "Справочник.яъФизическиеЛица",
            "КоличествоОбъектов": 6733
        },
        {
            "ВидОбъекта": "Справочник.Контрагенты",
            "КоличествоОбъектов": 3050
        },
        {
            "ВидОбъекта": "Справочник.Сотрудники",
            "КоличествоОбъектов": 124
        },
        {
            "ВидОбъекта": "Справочник.яъФизическиеЛица",
            "КоличествоОбъектов": 622
        }
    ]

ЗаписатьПриложения

  • Тип HTTP-запроса: GET/POST
  • Описание: Запись приложений (например, картинок) к объекту. Можно отправлять как массив, так и структуру. Возвращает список индексов созданных приложений.
Параметры
Наименование Обязателен? Тип данных Описание Пример
Владелец Да Ссылка на объект Владелец приложения {"id": "e1cib/data/Справочник.яъКультуры?ref=96d5708bcda2156111eef01513b24eef"}
Индекс Нет Число С указанным параметром перезаписывает старое приложение 1
Файл Да Строка Данные файла в Base64-строке "/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBxMTEhUTExMV..."
Представление Да Строка Имя файла с расширением Арбуз.png
яъКомментарий Нет Строка Комментарий приложения Создан из приложения «Кинт: Мобильный ТСД»
  • Пример вызова
    /GetData?Method=ЗаписатьПриложения&Владелец={"id": "e1cib/data/Справочник.яъКультуры?ref=96d5708bcda2156111eef01513b24eef"}&Файл="/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBxMTEhUTExMV..."&Представление=Арбуз.png

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

    [
        {
            "Индекс": 11
        }
    ]

УдалитьПриложение

  • Тип HTTP-запроса: GET
  • Описание: Удаление приложения
Параметры
Наименование Обязателен? Тип данных Описание Пример
Владелец Да Ссылка на объект Владелец приложения {"id": "e1cib/data/Справочник.яъКультуры?ref=96d5708bcda2156111eef01513b24eef"}
Индекс Да Число Номер удаляемого приложения 11
  • Пример вызова
    /GetData?Method=УдалитьПриложение&Владелец={"id": "e1cib/data/Справочник.яъКультуры?ref=96d5708bcda2156111eef01513b24eef"}&Индекс=11

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

    true

СписокПриложений

  • Тип HTTP-запроса: GET
  • Описание: Получение списка приложений объекта
Параметры
Наименование Обязателен? Тип данных Описание Пример
Владелец Да Ссылка на объект Владелец приложений, которые хотим получить {"id": "e1cib/data/Справочник.яъФизическиеЛица?ref=96d5708bcda2156111eef01513b24eef"}
СФайлами Нет Булево Нужно ли получить файл в Base64-строке Истина
Колонки Нет Строка Список колонок, который необходимо получить в результате Представление,Индекс,яъКомментарий,ИндексТипаПриложения,Файл
  • Описание колонок в результате
    • Представление - представление приложения
    • Индекс - индекс приложения в пределах владельца
    • Автор - пользователь, добавивший приложение
    • Дата - дата добавления приложения
    • фВнешнее - приложение является ссылкой на файл
    • ВидПриложения - не используется
    • ПутьКДанным - полное имя файла, где хранится приложение
    • СостояниеПриложения - 1 (захвачено для редактирования), 0 (никем не редактируется)
    • яъКомментарий - комментарий приложения
    • ИндексТипаПриложения - 1 (картинка), 2 (каталог), 3 (URL-ссылка), 0 (всё остальное)?
    • Файл - файл в Base64-строке
    • Расширение - расширение файла
  • Пример вызова
    /GetData?Method=СписокПриложений&Владелец={"id": "e1cib/data/Справочник.яъКультуры?ref=96d5708bcda2156111eef01513b24eef"}&Колонки=Представление,Индекс,Дата,яъКомментарий,Файл&СФайлами=Истина

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

    [
        {
            "Представление": "images.jpeg",
            "Индекс": 1,
            "Дата": "2024-09-17T18:33:57",
            "яъКомментарий": "",
            "Файл": "/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBxMTEhUTExMV..."
        }
    ]

СоздатьЗадачу (PostTask)

  • Тип HTTP-запроса: POST
  • Описание: Создание документа «Задача».


ПолучитьСписокЗадач (GetTaskList)

  • Тип HTTP-запроса: GET
  • Описание: Список документов с отбором.


ПолучитьСодержаниеЗадачи (GetTaskContent)

  • Тип HTTP-запроса: GET
  • Описание: Получает все комментарии по документу в формате HTML.


ПервыйКомментарий (GetFirstMessage)

  • Тип HTTP-запроса: GET
  • Описание: Получает первый комментарий по документу. Первый комментарий считается "Содержанием" документа.


ПоследнийКомментарий (GetLastMessage)

  • Тип HTTP-запроса: GET
  • Описание: Получает последний комментарий по документу.


ИзменитьЭтапПроцесса (ChangeProcessStage)

  • Тип HTTP-запроса: GET
  • Описание: Изменение этапа процесса документа.


ДобавитьКомментарий (PostMessage)

  • Тип HTTP-запроса: POST
  • Описание: Добавление комментария к документу.

Кинт: Управление санаторием

Методы

Общие

GetNews

Содержимое ленты новостей.

Необязательные параметры:

  • Параметры: структура параметров, которые используются в шаблонах страницы.
    • Развернуть: если значение «Истина», то новости будут развернуты при загрузке страницы.
    • ОграничитьШирину: если значение «Истина», то новости будут отображаться посередине экрана, образуя «Ленту» новостей.
  • ВКонтейнер: если значение «Истина», то к макетам будет подключена стандартная библиотека.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetNews&raw&Параметры={"Развернуть":true,"ОграничитьШирину":true}
Пример ответа
<script>
function showMoreInfo(el) {
let elDescription = el.children[1];
elDescription.classList.toggle("event-header-description");

let elInfo = el.parentNode.children[1];
elInfo.classList.toggle("hide");		
}
function expandAllNews() {
document.querySelectorAll('.event-container').forEach(function(event){
showMoreInfo(event);
});	
}
</script>

<style>

.news-container
{
margin: 0 auto;
width: 40%;
}

.event-image
{
border-radius: 10px; 
max-width: 100%;
margin: 15px 0px;
}

.no-events
{
text-align: center;
color: #9b9b9b; 	
}

body
{
background-color: #E0E0E0; 
font-family: verdana;
}

.hide
{
display: none;
}

.event-container
{
background-color: white;
border-radius: 15px;
padding: 10px;
box-shadow: -1px 1px 7px -4px #000000;
cursor: pointer;	
} 

.event-shell
{
background-color: #F5F5F5;
box-shadow: -1px 1px 7px -4px #000000;
border-radius: 15px;
width: 100%;
margin-bottom: 15px;
line-height: 1.5;
color: #3F3F3F;		
}

.event-title
{
font-weight: bold;
font-size: 18px;
} 

.event-container .event-title
{
width: 100%;
word-break: break-all;
}

.event-subtitle
{
font-weight: bold;
font-size: 14px;		
}

.event-header
{
display: flex;
}

.event-time
{
border-radius: 6px;
padding: 3px; 	
font-size: 14px;
text-align: center;	
background-color: #33a7d4;
color: white;
font-weight: bold;
white-space: nowrap;
}

.event-description
{	
font-size: 14px;	
} 

.event-header-description
{ 
height: 3em;
overflow: hidden; 
background: linear-gradient(180deg, #3F3F3F 50%, gray 90%, white 97%);
-webkit-background-clip: text;
-webkit-text-fill-color: transparent;	
} 

.event-more-info
{
padding: 10px;
} 

p
{
margin-bottom: 0px;
margin-top: 5px;
} 

.marks-container
{
white-space: nowrap;
color: white;
font-weight: bold;	
} 

</style> 









<script>
document.addEventListener("DOMContentLoaded", function() {
expandAllNews();
});
</script>



<div class = 'news-container'>

<div>    	
<div>	    	
<div class = "event-shell">
<div class = "event-container" onclick = "showMoreInfo(this)">
<div class = "event-header"> 		 
<span class = "event-title">День "Пролетника"</span> 
<span class = "marks-container">
<span class = "event-time">12 сент.</span>
</span>			
</div>

<p class = "event-description event-header-description">
Сегодня птицы массово улетают на юг! Становится прохладнее, дожди начинают идти чаще. <br>
Самое время собирать травы, которые в столь знаменательный день обладают целебными свойствами!
</p>
</div> 

<div class = "event-more-info hide">


<img src = "https://krasivosti.pro/uploads/posts/2021-07/1627080338_22-krasivosti-pro-p-karavan-ptits-ptitsi-krasivo-foto-25.jpg" class = "event-image">


</div>
</div> 

</div>			
</div>

<div>    	
<div>	    	
<div class = "event-shell">
<div class = "event-container" onclick = "showMoreInfo(this)">
<div class = "event-header"> 		 
<span class = "event-title">День рождения компании "Кинт"!</span> 
<span class = "marks-container">
<span class = "event-time">10 окт.</span>
</span>			
</div>

<p class = "event-description event-header-description">
Ежегодное собрание сотрудников предприятия состоится в октябре!
Приносите себя и мягкие стулья! <br>
Непьющих просьба не приходить - презентации смотреть только под коньяк!


</p>
</div> 

<div class = "event-more-info hide">


<img src = "https://algo-s.ru/upload/iblock/345/f02b34eee0160c1cec0a0819b5.png" class = "event-image">



<div class = "event-title"> 
Выступления руководителей отделов
</div>



<div class = "event-description"> 
Сотрудники от каждого отдела расскажут о поставленных и достигнутых целях. 
</div>



<div class = "event-subtitle"> 
Будут ли мягкие стулья?
</div>



<div class = "event-description"> 
А задачу написали?
</div>


</div>
</div> 

</div>			
</div>

</div>

ИзменитьСтатусУчастникаМероприятия

Изменение статуса участника на мероприятии. Если участник не числился, то он будет добавлен.

Параметры:

  • Участник: участник (карта гостя или физлицо), у которого необходимо изменить статус.
  • Мероприятие: мероприятие, на котором необходимо изменить статус участника.

Необязательные параметры:

  • Статус: требуемый статус участника (ПотенциальныйУчастник, БудетУчаствовать, ПринялУчастие, Отказ). Если не передан, то будет установлен «Принял участие».
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ИзменитьСтатусУчастникаМероприятия&Участник={"Идентификатор": "e1cib/data/Справочник.яъФизическиеЛица?ref=8e086451060d98bd11e5c8f3aff6f11f"}&Мероприятие={"Идентификатор": "1cib/data/Документ.яъМероприятие?ref=9511a85e4511756911ee74bb0ffc8d41"}&Статус=Отказ
Пример ответа
{
"Success": true,
"Result": {
"Результат": true,
"Описание": "Статус участия изменен на «Отказ»"
},
"Messages": []
}

PaymentStatusByDocument

Состояние оплаты по документа.

Параметры:

  • Document: документ, по которому нужно получить состояние оплаты.

Необязательные параметры:

  • Детализация: в результат будет помещена таблица с расшифровкой состояния оплаты по каждому счету.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=PaymentStatusByDocument&Document={"Идентификатор": "e1cib/data Документ.НазначениеУслуг?ref=bca2d85ed320709611ed8129e69655fb"}
Пример ответа
{
"Success": true,
"Result": {
"СуммаДокумента": 0,
"Выставлено": 1495,
"Оплачено": 1495
},
"Messages": []
}

КонтактыОрганизации

Контактные данные рабочей организации.

Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=КонтактыОрганизации
Пример ответа
{
[
{
"Владелец": "Санаторий \"Родные просторы\"",
"Свойство": "Портье",
"ТипЗначения": "Контактные данные",
"КодСвойства": "1",
"Период": "2023-03-03T00:00:00",
"_Индекс": 0,
"ЗначениеСвойства": "+7(3412)50-11-99",
"Редактор": "Стеньшина Любовь Александровна (суперюзер)",
"Код": "1"
},
{
"Владелец": "Санаторий \"Родные просторы\"",
"Свойство": "Ресепшен",
"ТипЗначения": "Контактные данные",
"КодСвойства": "23",
"Период": "1980-01-01T00:00:00",
"_Индекс": 0,
"ЗначениеСвойства": "+7(3412)64-68-58",
"Редактор": "Абдулов Юрий Владимирович (директор)",
"Код": "23"
},
{
"Владелец": "Санаторий \"Родные просторы\"",
"Свойство": "Приемная",
"ТипЗначения": "Контактные данные",
"КодСвойства": "тел01",
"Период": "2022-10-25T00:00:00",
"_Индекс": 0,
"ЗначениеСвойства": "+7(3412)69-77-72",
"Редактор": "Абдулов Юрий Владимирович (директор)",
"Код": "тел01"
}
]
}

ПользовательПоНаименованию

Данные пользователя по наименованию.

Параметры:

  • Наименование: наименование пользователя.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ПользовательПоНаименованию&Наименование=Администратор
Пример ответа
{
"Ссылка": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Администратор",
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=94fca85e4511756911edad038ee22d63"
},
"ПользовательИБ": "Администратор"
}

ОфициальныеОрганы

Список официальных органов.

Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ОфициальныеОрганы
Пример ответа
[
{
"Код": "200-006",
"Наименование": "ОТДЕЛЕНИЕ УФМС РОССИИ ПО ЧЕЧЕНСКОЙ РЕСПУБЛИКЕ В СТАРОПРОМЫСЛОВСКОМ Р-НЕ Г. ГРОЗНОГО",
"ДатаОкончания": "0001-01-01T00:00:00",
"Идентификатор": "10000",
"КатегорияВладельца":
{
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "ОрганВыдачиДокументов",
"Наименование": "Орган выдачи документов",
"Идентификатор": "e1cib/data/Справочник.яъКатегории?ref=9a4e60a44c379a5b11e9c40aadd85b17"
}
},
{
"Код": "240-011",
"Наименование": "ТП УФМС РОССИИ ПО КРАСНОЯРСКОМУ КРАЮ В КАНСКОМ Р-НЕ",
"ДатаОкончания": "0001-01-01T00:00:00",
"Идентификатор": "10017",
"КатегорияВладельца":
{
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "ОрганВыдачиДокументов",
"Наименование": "Орган выдачи документов",
"Идентификатор": "e1cib/data/Справочник.яъКатегории?ref=9a4e60a44c379a5b11e9c40aadd85b17"
}
}
]

РабочаяОрганизация

Рабочая организация по настройке.

Параметры:

  • стрРеквизиты (не поддерживается): список реквизитов для получения.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=РабочаяОрганизация&стрРеквизиты=Код,Наименование
Пример ответа
{
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Санаторий \"Родные просторы\"",
"Код": "9999999/2",
"Идентификатор": "e1cib/data/Справочник.Организации?ref=9bc8e4800e39484c4b1e680675db5963"
}

GetHtmlForms

Макеты HTML виджетов.

Параметры:

  • Категория: ссылка на категорию (владельца) или ее полный идентификатор.

Необязательные параметры:

  • Вычислить: если значение «Истина», то макеты будут вычислены на стороне конфигурации.
  • ВКонтейнер: если значение «Истина», то к макетам будет подключена стандартная библиотека.
  • Параметры: структура с параметрами, которые используются в макетах.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetHtmlForms&Категория=Справочник.яъКатегории.ВиджетНовости&Вычислить=Истина&ВКонтейнер=Ложь
Пример ответа
{
"Success": true,
"Result": [
{
"Ссылка": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Распродажа носков",
"Код": 0,
"Идентификатор": "e1cib/data/Справочник.яъПечатныеФормы?ref=9500a85e4511756911edd2da71e3489a"
},
"Code": "РаспродажаНосков",
"Шаблон": "<table> \n\n\u0009<tr>\n\u0009\u0009<th>Материал</th>\n\u0009\u0009<th>Цена</th>\n\u0009</tr> \n\u0009\n\u0009<tr>\n\u0009\u0009<td>Мохровые</td>\n\u0009\u0009<td>199</td>\n\u0009</tr>\n\u0009\n\u0009<tr>\n\u0009\u0009<td>Бархатные</td>\n\u0009\u0009<td>350</td>\n\u0009</tr>\n\u0009\n\u0009<tr>\n\u0009\u0009<td>Дырявые</td>\n\u0009\u0009<td>999999</td>\n\u0009</tr>\n\n</table>\n"
}
],
"Messages": []
}

Модуль «Гостиница»

GetAvailableDates

Доступные интервалы заезда за период.

Параметры:

  • ArrivalFrom/ЗаездС: начало периода заезда.
  • ArrivalTo/ЗаездПо: конец периода заезда.
  • Days/КоличествоДней: желаемое количество дней проживания.

Необязательные параметры:

  • RoomCategory/КатегорияНомера: желаемая категория номера.
  • Block/Корпус: желаемый корпус.
  • QuotaID/Квота: требуемая квота (учитываются только квоты по номерам).
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetAvailableDates&ArrivalFrom=30.08.2023&ArrivalTo=05.09.2023&Days=4&RoomCategory={"Идентификатор":%20"e1cib/data/Справочник.НоменклатураПомещений?ref=ac2360a44c379a5b11e565e573e3b690"}&Block={"Идентификатор":%20"e1cib/data/Справочник.Здания?ref=bd4860a44c379a5b11e3a8f481c4453e"}&QuotaID={"Идентификатор":%20"e1cib/data/Справочник.Квоты?ref=9a6860a44c379a5b11eb9d1bc1a84df1"}
Пример ответа
{
"Success": true,
"Result": [
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "102",
"Код": "1102",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
},
"ДатаЗаезда": "2023-08-30T00:00:00",
"ДатаВыезда": "2023-09-03T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "102",
"Код": "1102",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
},
"ДатаЗаезда": "2023-08-31T00:00:00",
"ДатаВыезда": "2023-09-04T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "102",
"Код": "1102",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
},
"ДатаЗаезда": "2023-09-01T00:00:00",
"ДатаВыезда": "2023-09-05T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "102",
"Код": "1102",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
},
"ДатаЗаезда": "2023-09-02T00:00:00",
"ДатаВыезда": "2023-09-06T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "102",
"Код": "1102",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
},
"ДатаЗаезда": "2023-09-03T00:00:00",
"ДатаВыезда": "2023-09-07T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "102",
"Код": "1102",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
},
"ДатаЗаезда": "2023-09-04T00:00:00",
"ДатаВыезда": "2023-09-08T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "102",
"Код": "1102",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c8"
},
"ДатаЗаезда": "2023-09-05T00:00:00",
"ДатаВыезда": "2023-09-09T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "103",
"Код": "1103",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
},
"ДатаЗаезда": "2023-08-30T00:00:00",
"ДатаВыезда": "2023-09-03T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "103",
"Код": "1103",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
},
"ДатаЗаезда": "2023-08-31T00:00:00",
"ДатаВыезда": "2023-09-04T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "103",
"Код": "1103",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
},
"ДатаЗаезда": "2023-09-01T00:00:00",
"ДатаВыезда": "2023-09-05T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "103",
"Код": "1103",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
},
"ДатаЗаезда": "2023-09-02T00:00:00",
"ДатаВыезда": "2023-09-06T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "103",
"Код": "1103",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
},
"ДатаЗаезда": "2023-09-03T00:00:00",
"ДатаВыезда": "2023-09-07T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "103",
"Код": "1103",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
},
"ДатаЗаезда": "2023-09-04T00:00:00",
"ДатаВыезда": "2023-09-08T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "103",
"Код": "1103",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c9"
},
"ДатаЗаезда": "2023-09-05T00:00:00",
"ДатаВыезда": "2023-09-09T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "101",
"Код": "1101",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
},
"ДатаЗаезда": "2023-08-30T00:00:00",
"ДатаВыезда": "2023-09-03T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "101",
"Код": "1101",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
},
"ДатаЗаезда": "2023-08-31T00:00:00",
"ДатаВыезда": "2023-09-04T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "101",
"Код": "1101",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
},
"ДатаЗаезда": "2023-09-01T00:00:00",
"ДатаВыезда": "2023-09-05T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "101",
"Код": "1101",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
},
"ДатаЗаезда": "2023-09-02T00:00:00",
"ДатаВыезда": "2023-09-06T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "101",
"Код": "1101",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
},
"ДатаЗаезда": "2023-09-03T00:00:00",
"ДатаВыезда": "2023-09-07T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "101",
"Код": "1101",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
},
"ДатаЗаезда": "2023-09-04T00:00:00",
"ДатаВыезда": "2023-09-08T00:00:00",
"Свободно": 2
},
{
"Room": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "101",
"Код": "1101",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0c7"
},
"ДатаЗаезда": "2023-09-05T00:00:00",
"ДатаВыезда": "2023-09-09T00:00:00",
"Свободно": 2
}
],
"Messages": []
}

GetPrice

Стоимость проживания за период по различным параметрам.

Необязательные параметры:

  • DateFrom/НачалоПериода/ДатаЗаезда: начало периода проживания. Значение по умолчанию - начало текущего дня.
  • DateTo/КонецПериода/ДатаВыезда: конец периода проживания. Значение по умолчанию - конец текущего дня.
  • ВариантРасчетаЦен: вариант расчета цены. Значение по умолчанию будет получено из настройки.
  • Контекст: структура с различными дополнительными параметрами (Организация, Прайс, Время суток заезда, Время суток выезда, Заезд вечером, Выезд вечером).
  • ВидЦен: Идентификатор или ссылка на вид цены. Значение по умолчанию - цена брони.
  • Details/Расшифровка: развернуть цену по дням.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetPrice&Контекст={"DateFrom": "15.02.2023", "DateTo":"18.02.2023"}
Пример ответа
{
"Success": true,
"Result": [
{
"НомерСтроки": 0,
"Date": "2023-02-15T00:00:00",
"Стоимость": 13000,
"СтоимостьЛечения": 0,
"СтоимостьПитания": 0,
"СтоимостьПроживания": 13000,
"фРучнаяСтоимость": false,
"Скидка": 0,
"СтоимостьБезСкидки": 13000,
"Price": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "ОсновнойПрайсПродаж",
"Наименование": "Основной прайс продаж",
"Код": "000000001",
"Идентификатор": "e1cib/data/Справочник.Прайсы?ref=9b7996e6d857ebf811e3a8f3d7479350"
},
"КодСтроки": 0,
"РучнаяСкидка": 0,
"Ответственный": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=00000000000000000000000000000000"
}
},
{
"НомерСтроки": 0,
"Date": "2023-02-16T00:00:00",
"Стоимость": 13000,
"СтоимостьЛечения": 0,
"СтоимостьПитания": 0,
"СтоимостьПроживания": 13000,
"фРучнаяСтоимость": false,
"Скидка": 0,
"СтоимостьБезСкидки": 13000,
"Price": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "ОсновнойПрайсПродаж",
"Наименование": "Основной прайс продаж",
"Код": "000000001",
"Идентификатор": "e1cib/data/Справочник.Прайсы?ref=9b7996e6d857ebf811e3a8f3d7479350"
},
"КодСтроки": 0,
"РучнаяСкидка": 0,
"Ответственный": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=00000000000000000000000000000000"
}
},
{
"НомерСтроки": 0,
"Date": "2023-02-17T00:00:00",
"Стоимость": 13000,
"СтоимостьЛечения": 0,
"СтоимостьПитания": 0,
"СтоимостьПроживания": 13000,
"фРучнаяСтоимость": false,
"Скидка": 0,
"СтоимостьБезСкидки": 13000,
"Price": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "ОсновнойПрайсПродаж",
"Наименование": "Основной прайс продаж",
"Код": "000000001",
"Идентификатор": "e1cib/data/Справочник.Прайсы?ref=9b7996e6d857ebf811e3a8f3d7479350"
},
"КодСтроки": 0,
"РучнаяСкидка": 0,
"Ответственный": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=00000000000000000000000000000000"
}
},
{
"НомерСтроки": 0,
"Date": "2023-02-18T00:00:00",
"Стоимость": 6500,
"СтоимостьЛечения": 0,
"СтоимостьПитания": 0,
"СтоимостьПроживания": 6500,
"фРучнаяСтоимость": false,
"Скидка": 0,
"СтоимостьБезСкидки": 6500,
"Price": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "ОсновнойПрайсПродаж",
"Наименование": "Основной прайс продаж",
"Код": "000000001",
"Идентификатор": "e1cib/data/Справочник.Прайсы?ref=9b7996e6d857ebf811e3a8f3d7479350"
},
"КодСтроки": 0,
"РучнаяСкидка": 0,
"Ответственный": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=00000000000000000000000000000000"
}
}
],
"Messages": []
}

КартыГостя

Список карт гостей физического лица.

Параметры:

  • ФизЛицо: физическое лицо, по которому необходимо получить карты гостя.
  • стрРеквизиты (не поддерживается): список реквизитов для получения.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=КартыГостя&стрРеквизиты="Дата"&ФизЛицо={"Идентификатор":"e1cib/data/Справочник.яъФизическиеЛица?ref=b20b6451060d98bd11e59cb64e7de21e"}
Пример ответа
[
{
"Дата": "2023-03-14T10:44:55",
"Номер": "23/00083       ",
"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fea85e4511756911edc233ba474f2a"
},
{
"Дата": "2021-09-20T14:39:07",
"Номер": "21/00058       ",
"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=9a6d60a44c379a5b11ec19fefb04ce3a"
}
]

ДанныеОбОсновнойКартеЛояльности

Данные об основной карте лояльности гостя.

Параметры:

  • КартаГостя: карта гостя, по которой необходимо получить карту лояльности.

Необязательные параметры:

  • НаДату: дата актуальности бонусов. Если не передана, то будет получено общее количество бонусов на карте.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ДанныеОбОсновнойКартеЛояльности&КартаГостя={"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fda85e4511756911edb98261ada96f"}&НаДату=01.04.2023
Пример ответа
{
"Success": true,
"Result": {
"Ссылка": {
"Дата": "2023-03-06T09:51:55",
"Номер": "22/00000003              ",
"Идентификатор": "e1cib/data/Документ.яъКартаПокупателя?ref=94fda85e4511756911edb9bb423b5329"
},
"ПометкаУдаления": false,
"Number": "22/00000003              ",
"Date": "2023-03-06T09:51:55",
"Проведен": true,
"Client": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Романов Игорь Егорович",
"Код": "dem000026",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "ФизическиеЛица",
"Наименование": "Физические лица",
"Код": "000000001",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Контрагенты?ref=9b7996e6d857ebf811e3a8f3debae377"
},
"Идентификатор": "e1cib/data/Справочник.Контрагенты?ref=980360a44c379a5b11e6913a7733af63"
},
"ВидСкидки": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Код": null,
"Идентификатор": "e1cib/data/ПланСчетов.яъЦены?ref=00000000000000000000000000000000"
},
"СрокОкончания": "0001-01-01T00:00:00",
"Номинал": 0,
"БонуснаяПрограмма": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Основная",
"Код": "000000001",
"Идентификатор": "e1cib/data/Справочник.яъБонусныеПрограммы?ref=94fda85e4511756911edb9bb423b5327"
},
"Телефон": "",
"яъАвтор": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Стеньшина Любовь Александровна (суперюзер)",
"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=b20b6451060d98bd11e5a7eb037adb81"
},
"DocumentType": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "_ДисконтнаяКарта",
"Наименование": "Карта лояльности",
"Код": "00081",
"Идентификатор": "e1cib/data/Справочник.яъВидыДокументов?ref=9a4a60a44c379a5b11e935b5799a1a4b"
},
"Comment": "",
"яъОрганизация": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Санаторий \"Родные просторы\"",
"Код": "9999999/2",
"Идентификатор": "e1cib/data/Справочник.Организации?ref=9bc8e4800e39484c4b1e680675db5963"
},
"МоментВремени": "06.03.2023 9:51:55; Карта лояльности № 22/00000003 от 06.03.2023",
"Основная": true,
"Статус": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "Активна",
"Наименование": "Активирована",
"Идентификатор": "e1cib/data/Справочник.яъКатегории?ref=94fca85e4511756911edad18caf195a8"
},
"Актуальна": true,
"БонусовНаКарте": 0,
"ШтрихКод": "iVBORw0KGgoAAAANSUhEUgAAALQAAAC0AQAAAAAVtjufAAABgklEQVR4Ae2V0W0D\r\nMQxDtYH231IbuHxU7tIW/SuTrzjG9fxSQLFJ0XX+HPPhb+NV1aP3nulTzTLKW7Om\r\ntSp/zYzy6tbf6ecyzmtGs/c3vIAfZmnWC7imdqZXlecfTpYj9Lfxww8JvkPWAs5v\r\nP/+fqw5TwmAtyTNZjuTaCbalLzSy3D0x+hw7S/J0mI/IKdXUsp7nFuLaFyXLr5pX\r\nA+a4JMe9tfL0XTfE2Q6hRzqdfSY5ntVabnLytRUKcsyqTVl8a/PwVYzXhof1qVU+\r\nybct2BG+pek6yulon5pKSpz9KsjHBEORSpisoxzjPhbe0eXbGEdynviLH3H5Lcbp\r\niU0mGyzMMRNpvbnNxrLclVg4txWAc59bhOusatMCUs/7OsZrbwSdnC08aX6ce2pp\r\nxXbd936KM2g4Gpr8vu7NFPd1wG6oicMedVPcQuirs5cyjyxHdYpSUCHbl+5J7rRw\r\naytDTp7jLOeSzy7LHdl4SpV9bWa5dedWQ291+H3vhPhf48PfxL8AV0I85xcDVSAA\r\nAAAASUVORK5CYII="
},
"Messages": []
}

GetRoomQuota

Получение данных о квоте номеров за период, обязательно передавать период, за который требуется получить данные: параметры запроса DateFrom и DateTo.

Необязательные параметры

  • RoomCategory: если требуется получить данные по определенной категории(ям) номеров, пример &RoomCategory={"ID":"e1cib/data/Справочник.НоменклатураПомещений?ref=88575404a66e4a8911e340740eaeea25"};
  • Seats: будет учитываться количество свободных мест при определении доступной квоты, пример вызова: &Seats=true
  • TypeOfQuota: вид документа онлайн-квоты, по которым требуется получить квоту. Доступные значения: Travelline, Wubook, KintAPI, пример вызова: &TypeOfQuota=KintAPI
  • OrganizationOfStay: если требуется получить квоту, привязанную к определенной организации (актуально для баз в которых ведется учет по нескольким организациям), пример вызова: &OrganizationOfStay={"ID":"e1cib/data/Справочник.Организации?ref=8e8150e54935bd5411e25bc6880bb616"}
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetRoomQuota&DateFrom=2018-08-01T00:00:00&DateTo=2018-08-31T00:00:00
Пример ответа
{
"Success": true,
"Result": [
{
"RoomCategory": {
"Name": "Люкс 2к",
"ID": "e1cib/data/Справочник.НоменклатураПомещений?ref=88575404a66e4a8911e340740eaeea25"
},
"DateFrom": "2018-08-06T00:00:00",
"Qty": 2,
"DateTo": "2018-08-31T23:59:59"
"QuotaID": {
"Date": "2018-10-08T12:14:10",
"Number": "demA00025",
"ID": "e1cib/data/Документ.УстановкаКвоты?ref=9a4660a44c379a5b11e8cad221b146ad",
"GUID": "21b146ad-cad2-11e8-9a46-60a44c379a5b"
}
}
]
}

GetAvailableRooms

Получение данных о доступных (свободных) номерах за период, обязательно передавать период, за который требуется получить данные. Возвращает массив структур с описанием номеров гостиницы. Все доступные поля отображены в разделе "Пример ответа". Обязательные параметры запроса DateFrom - начало периода проживания DateTo - конец периода проживания

Необязательные параметры

  • Qty - количество мест в одном номере. Будут подобраны все номера где есть требуемое количество свободных мест. Если не передан - будут подобраны все доступные номера.
  • Vacant: если передано значение true - будут подобраны только полностью свободные номера;
  • RoomCategory: если требуется получить данные по определенной категории(ям) номеров;
  • Room: проверка доступности определенного номера гостиницы;
  • OrganizationOfStay: если требуется получить номера, привязанные к определенной организации (актуально для баз в которых ведется учет по нескольким организациям)
  • QuotaID: поиск номеров, привязанных к определенной квоте; Например &QuotaID={"ID":"e1cib/data/Справочник.Квоты?ref=813800155d1e281211ec0952ca92c338"}
  • ДополнительныеСвойства: вывод дополнительных свойств номера гостиницы;

Время заезда и выезда берется из настроек гостиницы.

Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetAvailableRooms&DateFrom=2019-09-24T00:00:00&DateTo=2019-09-29T00:00:00&Vacant=true&Qty=2
Пример ответа
{
"Success": true,
"Result": [
{
"ДатаЗаезда": "2019-09-24T00:00:00",
"ДатаВыезда": "2019-09-29T23:59:59",
"Room": {
"Наименование": "Номер 201",
"Код": "ТТ00000012",
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=b8f7001bfc34542111df326af0fbf7c5",
"ПометкаУдаления": false,
"ЭтоГруппа": false,
"Родитель": {
"Наименование": "Номера лаптя",
"Код": "666",
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=bb9c5404a66e4a8911e7f79b39f2da3e",
"ПометкаУдаления": false,
"ЭтоГруппа": true
}
},
"Block": {
"Наименование": "Корпус 2",
"Код": "000000005",
"Идентификатор": "e1cib/data/Справочник.Здания?ref=b72f90e6baabdd1411e291efe183744d",
"ПометкаУдаления": false
},
"RoomCategory": {
"Наименование": "Люкс 2к",
"Код": "Lux",
"Идентификатор": "e1cib/data/Справочник.НоменклатураПомещений?ref=88575404a66e4a8911e340740eaeea25",
"ПометкаУдаления": false
},
"МестВНомере": 2,
"Category": {
"Наименование": "Гостиничный номер",
"Код": "",
"Идентификатор": "e1cib/data/Справочник.яъКатегории?ref=81bba100d9d99e6248a9bf544ade9963",
"ПометкаУдаления": false
},
"НачалоПериодаКвоты": null,
"КонецПериодаКвоты": null,
"ТребуетсяУборка": true,
"С": 1,
"Свободно": 1,
"До": 12.5,
"Стоимость": 0,
"ПериодПребывания": "с 24 по 29.09.2019 (5.5 суток)",
"ОтВыезда": 6,
"ДоЗаезда": 15,
"ДатаРаботы": "2018-12-19T00:00:00",
"Работа": {
"Наименование": "Смена белья",
"Код": "ТТ0000010",
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=9cf55404a66e4a8911e4285c09474fc0",
"ПометкаУдаления": false,
"ЭтоГруппа": false
},
"РаботыВНомере": "19.12.2018, Смена белья"
}
]
}
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=GetAvailableRooms&DateFrom=2024-08-23T00:00:00&DateTo=2024-08-29T00:00:00&Vacant=true&КоличествоЭлементов=12&НомерСтраницы=3

GetAvailableCategories

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


RoomOccupancy

  • Тип HTTP-запроса: GET
  • Описание: Получение таблицы с интервалами занятости мест в номерах гостиницы в указанном периоде.
Параметры
Наименование Обязателен? Тип данных Описание Пример
ДатаНачала (DateFrom) Да Дата Дата передается в формате dd.mm.yyyy, либо в формате ISO 01.01.2024
ДатаОкончания (DateTo) Да Дата Дата передается в формате dd.mm.yyyy, либо в формате ISO 31.01.2024
КатегорияНомера (RoomCategory) Нет Ссылка на категорию номера Фильтрация результата по полю "Категория номера". {"ID": "e1cib/data/Справочник.НоменклатураПомещений?ref=a33f60a44c379a5b11e586d4889feee7"}

PostBooking

Отправка данных для создания новой заявки, в случае успеха метод возвращает номер, дату и идентификатор созданного документа.

Данные для создания заявки передаются в теле запроса в формате json.

Если запрос содержит параметр Test, в качестве результата метода вернется тело POST-запроса и текст в формате JSON, полученный после преобразования данных для создания заявки. Можно использовать для отладки.

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

Запрос может содержать массив с данными для одновременной передачи нескольких заявок. В этом случае ответом сервиса является массив с результатом обработки каждой заявки, количество элементов в ответе равно количеству во входящем массиве.

Параметры пребывания могут быть переданы как в шапке, так и в строке массива гостей. Если параметр передан и в строке и в шапке - приоритетным считаем параметр строки. Если передан параметр Room - заявка забронирует места в переданном номере гостиницы.

Данные для создания гостей могут быть переданы двумя способами:

  • отдельным элементом строки массива гостей с именем "ФизЛицо", "Гость" или "Guest";
  • параметры для создания гостя находятся непосредственно в строке массива гостей.

Ключи структуры JSON можно передавать как кириллицей, так и латиницей. Рекомендуется использовать кириллицу.

Если в контексте создания заявки передан идентификатор заявки (навигационная ссылка или уникальный идентификатор (ID), дата и номер входящего документа (InboundDate, InboundNumber), будет выполнен поиск заявки и обновление реквизитов. Новая заявка создается в том случае, если по идентификатору ничего не найдено.

Структура поля «Guest» может содержать ключ ВидУдостоверения, в этом случае будут заполнены данные об удостоверении личности гостя. В значении этого поля должно быть значение «Паспорт» или произвольное наименование удостоверения, которое есть в базе данных (справочник Справочник «Виды удостоверений»).

Также структура поля «Guest» может содержать ключ Телефон, который необходимо вводить в соответствии с маской страны физлица или контрагента. Телефон используется как ключ уникальности для физлиц (Параметр «ЭтоФизЛицо» = Истина или явно передана категория «Физическое лицо»).

Поля для заполнения данных удостоверения личности: ДокументСерия, ДокументНомер, ДокументДатаВыдачи, ДокументКемВыдан, ДокументКодПодразделения, ДатаРегистрацииПоМестуЖительства.

Передача поля Адрес регистрации: поиск адреса выполняется по ключевому полю ИдентификаторФИАС или FIAS_ID. Если идентификатор не передан, выполняется поиск по наименованию. В запросе это одно из полей: Raw, Наименование, Name.

Так же, может быть передан АдресФактический. Если его нет, но есть АдресРегистрации, то в фактический будет записан адрес регистрации.

Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/PostData?Method=PostBooking
Тело запроса (параметры в шапке)
{
"Client": {
"Name": "Иванов Иван Иванович",
"BirthDate": "1980-11-11T00:00:00",
"Sex": "М",
"RegAddress": {},
"FactAddress": {}
},
"Guests": [
{
"Name": "Иванов Сергей Иванович",
"BirthDate": "1995-01-11T00:00:00",
"Sex": "Мужской",
"Relation": {
"Name": "Сын",
"ID": "e1cib/data/Справочник.яъСтепениРодстваФЛ?ref=95965404a66e4a8911e3c1440ad6102b"
}
}
],
"OrganizationOfStay": {
"ID": "e1cib/data/Справочник.Организации?ref=8e8150e54935bd5411e25bc6880bb616"
},
"DateFrom": "2018-10-01T00:00:00",
"Days": 10,
"RoomCategory": {
"ID": "e1cib/data/Справочник.НоменклатураПомещений?ref=88575404a66e4a8911e340740eaeea25"
},
"File": "iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAQAAADZc7J/AAAABGdBTUEAALGPC/xh..."
}
Тело запроса (параметры в строке)
{
"Client": {
"Name": "Иванов Иван Иванович",
"Телефон": "+7(999)999-99-99",
"ЭтоФизЛицо": true,	
"BirthDate": "1980-11-11T00:00:00",
"Sex": "М",
"RegAddress": {},
"FactAddress": {}
},
"Guests": [
{
"Guest": {
"Name": "Иванов Сергей Иванович",
"Телефон": "+7(999)999-99-99",
"BirthDate": "1995-01-11T00:00:00",
"Sex": "Мужской"
},
"DateFrom": "2023-10-01T00:00:00",
"Days": "10",
"RoomCategory": {
"ID": "e1cib/data/Справочник.НоменклатураПомещений?ref=9a4a60a44c379a5b11e91e3b538636ab"
}
}
],
"OrganizationOfStay": {
"ID": "e1cib/data/Справочник.Организации?ref=9bc8e4800e39484c4b1e680675db5963"
}
}
Пример ответа
{
"Success": true,
"Result": {
"Date": "2018-08-21T11:07:37",
"Number": "ТТ0000000173",
"ID": "e1cib/data/Документ.ЗаявкаПокупателя?ref=b4535404a66e4a8911e8a510e223144c"
}
}

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

Пример заполнения полей справки
"MedicalCertificate": [
    {
        "InboundDate":"2018-02-04T00:00:00",
        "InboundNumber":"RR-123123",
        "MKB10":"W26.6",
        "MedicalInstitution":"СПб ГБУЗ Городская Мариинская больница",
        "File":"DFHHFGFM<JGKFYJBDVBDGdBTUEAALGPC/xh..."
    },
    {
        "InboundDate":"2018-09-01T00:00:00",
        "InboundNumber":"RR-123124",
        "MKB10":"W25.6",
        "MedicalInstitution":"СПб ГБУЗ Городская Мариинская больница",
        "File":"DFHHFGFM<JGKFYJBDVBDGdBTUEAALGPC/xh..."
    }
]
Дополнительные свойства

Есть возможность установки дополнительных свойств при создании объектов. Для этого в контексте объекта должно быть установлено поле AdditionalProperties. Значение массива - структура описания свойства: поле Property содержит ссылку на свойство (поля ID или GUID) или строковый код свойства, поле Value - его значение.

Пример заполнения поля:

[
{
"Property": "Цвет",
"Value": "Красный"
},
{
"Property": {
"GUID": "e2634e5a-13e4-22g7-bded-1206a89t4e19"
},
"Value": {
"GUID": "a56e244a-19e5-11e3-bded-5404a66e4a89"
}
}
]

Для передачи контактных данных в поле Property можно передать идентификатор вида контактной информации: ЭлектроннаяПочта или Телефон.

[
{
"Property": "ЭлектроннаяПочта",
"Value": "example@example.com"
},
{
"Property": "Телефон",
"Value": "1-234-567-890"
}
]
Пример кода на PHP

Приведённый ниже код демонстрирует, как можно обращаться к этому методу API на языке программирования PHP, который широко используется в разработке веб-сайтов. Он отправляет заявку на бронирование для двух гостей, и указывает одного из них в качестве плательщика (контрагента).

<?php 

/**
 * Минимальный пример создания заявок в программе «Кинт: Управление санаторием»
 * с помощью HTTP API.
 * 
 * Пример разрабатывался и тестировался на PHP 5.4, требует расширение cURL и
 * JSON.
 */

$configuration = [];
$configuration['url'] = 'http://127.0.0.1/kus'; // Адрес публикации КУС.
$configuration['username'] = 'API'; // Имя пользователя.
$configuration['password'] = ''; // Пароль (если установлен).
$configuration['timeout'] = 30; // Время, через которое запрос будет сброшен. В секундах.

$configuration['service_name'] = 'KintAPI.hs';
$configuration['full_url'] = sprintf('%s/hs/%s', $configuration['url'], $configuration['service_name']);

// Объекты для API (если они уже есть в удалённой базе) сериализуются в
// примитивном виде - в виде структуры с одним полем: "Идентификатор".
$quota = ['Идентификатор' => 'e1cib/data/Справочник.Квоты?ref=b4b85404a66e4a8911eb906c7437a068'];
// Если достоверно известно, что используемый объект - предопределенный, то
// можно записать просто путь к нему без массива. У квот нет предопределенных
// объектов, но предположим, что такой есть, и он называется "Общий". Тогда
// запись будет выглядеть так:
// $quota = 'Справочник.Квоты.Общий';

// Заполним массив гостей произвольными данными.
$currentTime = time(); // Сохраним текущее время для дальнейших манипуляций
$guests = [
    [
        // Заезд оформляем через неделю в 8 утра
        'ДатаЗаезда' => date('c', $currentTime + (86400 * 7)),
        'ВремяСутокЗаезда' => 'Справочник.ВидыВременныхИнтервалов.ДоЗавтрака',

        // А выезд - через две и вечером
        'ДатаВыезда' => date('c', $currentTime + (86400 * 21)),
        'ВремяСутокВыезда' => 'Справочник.ВидыВременныхИнтервалов.ПослеУжина',

        // Если требуется ручной выбор номера - указываем сам номер
        'НомерГостиницы' => ['Идентификатор' => 'e1cib/data/Справочник.Помещения?ref=b8fd001bfc34542111df38c571c15995'],

        // Стоимость. Заполняется, если требуется.
        // 'Стоимость' => 2800,           // Общая стоимость
        // 'СтоимостьЛечения' => 500,     // Стоимость лечения
        // 'СтоимостьПитания' => 1000,    // Стоимость питания
        // 'СтоимостьПроживания' => 1300, // Стоимость проживания

        // ФизЛицо - отдельная структура с информацией о нашем госте, который заезжает.
        'ФизЛицо' => [
            'ДатаРождения' => '1965-07-31T00:00:00', // Мы родились 31-го июля 1965 года
            'Наименование' => 'Роулинг Джоан Кэтлин',
            'Пол' => 'Ж',

            'ДополнительныеСвойства' => [
                [
                    'Свойство' => 'ЭлектроннаяПочта',
                    'Значение' => 'example@mail.ru'
                ],

                [
                    'Свойство' => 'Телефон',
                    'Значение' => '+79121112233'
                ]
            ],

            // Можно передать паспортные данные или любой иной документ.
            'ВидУдостоверения' => 'Паспорт',
            'ДокументСерия' => '9400',
            'ДокументНомер' => '999999',
            'ДокументДатаВыдачи' => '2000-01-01T00:00:00',
            'ДокументКемВыдан' => 'ОТДЕЛ МИГРАЦИОННОГО УЧЕТА И ОФОРМЛЕНИЯ ВИЗ УФМС РОССИИ ПО Г. МОСКВЕ',
            'ДокументКодПодразделения' => '770-001',

            'ИНН' => '1234567890123',

            'АдресРегистрации' => ['ИдентификаторФИАС' => 'afeea607-0207-467f-8c59-562fc634f924'],
            'АдресФактический' => ['ИдентификаторФИАС' => 'deb1d05a-71ce-40d1-b726-6ba85d70d58f'],
            // 'Гражданство' => ['Код' => 'RUS'],
            // 'яъКомментарий' => 'Описание для вставки в Физлицо',
        ],

        'Справка' => [
            [
                'ДатаВходящегоДокумента' => '2000-01-01T00:00:00',
                'НомерВходящегоДокумента' => '000001',
                'ДиагнозНаправившегоУчреждения' => 'W26.6',
                'ЛечебноеУчреждение' => 'СПб ГБУЗ Городская Мариинская больница',

                // Содержимое файла передаётся в BASE64 формате.
                // base64_encode(file_get_contents('/var/www/.../file.png'))
                'Файл' => ''
            ],

            // Можно передать несколько справок, начиная с релиза 21.07 (21-1822).
            // Для этого просто продублируйте структуру выше столько раз, сколько Вам нужно.
        ],

        // Ещё можно прикладывать дополнительно файл к заявке в контексте строки гостя.
        // Содержимое файла передаётся в BASE64 формате.
        // base64_encode(file_get_contents('/var/www/.../file.png'))
        // 'Файл' => ''
    ],

    [
        'ДатаЗаезда' => date('c', $currentTime + (86400 * 7)),
        'ВремяСутокЗаезда' => 'Справочник.ВидыВременныхИнтервалов.ДоЗавтрака',
        'ДатаВыезда' => date('c', $currentTime + (86400 * 21)),
        'ВремяСутокВыезда' => 'Справочник.ВидыВременныхИнтервалов.ПослеУжина',

        // А этот гость с номером не определился. Зато он определился с категорией.
        'КатегорияНомера' => ['Идентификатор' => 'e1cib/data/Справочник.НоменклатураПомещений?ref=88575404a66e4a8911e340740eaeea25'],

        'ФизЛицо' => [
            'ДатаРождения' => '1928-12-06T00:00:00',
            'Наименование' => 'Рубеус Хагрид',
            'Пол' => 'М'
        ]
    ]
];

// Подготавливаем тело запроса.
$getBody = [
    // Если требуется сразу "Забронировать" заявку.
    'MakeReservation' => ''
];
$postBody = [
    'Гости' => $guests,

    // Считаем, что наш контрагент - это самый первый гость.  Для корректной
    // обработки со стороны КУС, добавим ему атрибут "фЭтоФизЛицо".
    'Контрагент' => array_merge($guests[0]['ФизЛицо'], [
        'ЭтоФизЛицо' => true
    ]),

    'Квота' => $quota,
    'яъКомментарий' => "Это комментарий к заявке.\nВ нём можно использовать переносы строк, если нужно."
];

// Отправляем запрос.
$request = curl_init($configuration['full_url'] . '/PostBooking?' . http_build_query($getBody));
curl_setopt($request, CURLOPT_RETURNTRANSFER, true);
curl_setopt($request, CURLOPT_TIMEOUT, $configuration['timeout'] * 1000);
curl_setopt($request, CURLOPT_USERPWD, sprintf('%s:%s', $configuration['username'], $configuration['password']));
curl_setopt($request, CURLOPT_POSTFIELDS, json_encode($postBody));
curl_setopt($request, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$responseBody = @json_decode(curl_exec($request), true);
if (!$responseBody)
{
    echo('Произошла критическая ошибка при разборе ответа сервера' . PHP_EOL);
    exit();
}

$exitCode = 0;
$text = '';
if ($responseBody['Success'])
{
    $text = sprintf('Заявка успешно создана под номером %s', trim($responseBody['Result']['Ссылка']['Номер']));
}
else
{
    $text = sprintf('Заявку создать не удалось, ошибка %d: %s', $responseBody['Result']['КодОшибки'], $responseBody['Result']['Error']);
    $exitCode = $responseBody['Result']['КодОшибки'];
}

echo($text . PHP_EOL);
exit($exitCode);

GetBookingInvoice

  • Тип HTTP-запроса: GET
  • Описание: Метод создает (переформировывает) документ «Счет на оплату» по документу бронирования и возвращает печатную форму «Счета на оплату» в виде двоичных данных.
Параметры
Наименование Обязателен? Тип данных Описание Пример
Booking Да Документ.ЗаявкаПокупателя, Документ.Путевка Ссылка на документ «Заявка покупателя» или «Путевка». {"ID": "e1cib/data/Документ.ЗаявкаПокупателя?ref=bca9d85ed320709611ef70efeed77b90"}
PrintForm Да Справочник.яъПечатныеФормы Ссылка на печатную форму документа «Счет на оплату» {"ID": "e1cib/data/Справочник.яъПечатныеФормы?ref=9b7996e6d857ebf811e3a8f3debae343"}

ОтметитьВыполнениеПотребностей

Создание документа «Отметка услуг»

Параметры:

  • Пользователь: исполнитель потребностей.

Тело запроса:

  • Наряд: контекст заполнения документа.
  • Потребности: контекст строк с услугами для отметки выполнения.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ОтметитьВыполнениеПотребностей&Пользователь={"Идентификатор": "e1cib/data/Справочник.Сотрудники?ref=b20b6451060d98bd11e5a7ef357c1a80"}

Тело запроса:

{
"Наряд": {
"ДатаНачала": "2023-03-10T00:00:00",
"ДатаОкончания": "2023-03-12T00:00:00"
},
"Потребности": [
{
"Услуга": {"Идентификатор": "e1c://filev/C/Users/na/Documents/InfoBase#e1cib/data/Справочник.Услуги?ref=b33060a44c379a5b11e7af51a0e04cd2"},
"Дата": "2023-03-10T00:00:00",
"Кабинет": {"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c115"},
"ДокументНазначения": {"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fea85e4511756911edbf1fdca75068"}
}
]
}
Пример ответа
{
"Success": true,
"Result": true,
"Messages": []
}

PostGuestCard

Создание и регистрация документа «Карта гостя».

Тело запроса (обязательные параметры):

  • ФизЛицо: физическое лицо гостя. Можно передать в виде структуры с данными для заполнения или с идентификатором. В структуре с данными также можно передать параметры: «Адрес», «Электронная почта», «Телефон» (может использоваться как ключ уникальности. Необходимо передавать с учетом маски адреса физлица), «Удостоверения» (Массив или структура с данными удостоверений. Значение свойства «ВидДокумента» по умолчанию - Паспорт. Если передан массив, то последнее удостоверение будет установлено в качестве основного удостоверения физлица).

Тело запроса (необязательные параметры):

  • ВремяСутокЗаезда: время заезда гостя. Значение по умолчанию берется из настройки «Действующее время суток заезда».
  • ВремяСутокВыезда: время выезда гостя. Значение по умолчанию берется из настройки «Действующее время суток Выезда».
  • ДатаЗаезда: дата заезда гостя. Значение по умолчанию - текущая дата.
  • КоличествоДней: количество дней проживания гостя. Значение по умолчанию берется из настройки «Количество дней по умолчанию».
  • ВариантПроживания: вариант проживания гостя. Можно передать в виде строки или структуры с идентификатором. Значение по умолчанию - «Основное место».
  • ВариантЛечения: вариант лечения гостя. Можно передать в виде строки или структуры с идентификатором. Значение по умолчанию - «Общий курс процедур».
  • ВариантПитания: вариант питания гостя. Можно передать в виде строки или структуры с идентификатором. Значение по умолчанию - «Общий стол».
  • НомерГостиницы/Room: номер гостиницы, где будет проживать гость. Если не указан, то вариант проживания будет установлен «Без проживания».
  • Прайс/Price: прайс. Значение по умолчанию берется из настройки «Прайс продаж».
  • Контрагент/Client: контрагент гостя. Можно передать в виде структуры с данными для заполнения или с идентификатором. В структуре с данными также можно передать параметр «Адрес» (Значение по умолчанию - адрес физического лица), «Электронная почта», «Телефон» (может использоваться как ключ уникальности. Необходимо передавать с учетом маски адреса контрагента). Если контрагент не передан, то он будет создан по физическому лицу.

Дополнительные сведения:

  • В качестве договора карты гостя будет выступать основной договор контрагента. Если договора нет, то он будет создан и назначен основным.
  • Между физическим лицом и контрагентом всегда будет установлена связь, вне зависимости от того, в каком виде они были переданы.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=PostGuestCard

Тело запроса:

{
	"ФизЛицо": {
		"Наименование": "Бусина Мария Александровна",
		"Пол": "Перечисление.яъПол.Женский",
		"ДатаРождения": "2007-03-02T00:00:00",
		"Адрес": "Россия, г.Ижевск пр. Никитин 38б",
		"Телефон": "+7(999)999-99-99",
		"ЭлектроннаяПочта": "busina.maria2007@gmail.com",
		"Удостоверения": [
			{
				"ВидДокумента": "Паспорт",
				"ДокументСерия": "9412",
				"ДокументНомер": "980-154",
				"ДокументДатаВыдачи": "2012-03-22T00:00:00"
			},
			{
				"ВидДокумента": "ПолисДМС",
				"ДокументНомер": "5467 8490 9843 3609"
			}
		]
	},
	"Контрагент": {
		"Наименование": "Набережный санаторий",
		"ЭлектроннаяПочта": "mailof.contragent@gmail.com",
		"Телефон": "+7(999)999-99-99"
	},
	"ДатаЗаезда": "2023-09-20T00:00:00",
  "КоличествоДней": 14,
  "КатегорияНомера": "",
  "НомерГостиницы": {"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0ee"},
  "КатегорияПутёвки": "",
  "ВариантЛечения": {"Идентификатор": "e1cib/data/Справочник.НаборыУслуг?ref=b20b6451060d98bd11e5bb4fe5828252"},
  "ВариантПроживания": "ОсновноеМесто"
  "ВозрастГостя": 16 
}
Пример ответа
{
"Success": true,
"Result": {
"Дата": "2023-09-04T14:11:01",
"Номер": "2323/000021    ",
"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=950fa85e4511756911ee4b0b0bf3acd2"
},
"Messages": []
}

ChangeGuestParameters

Выполнения операций с картой гостя. Изменение параметров пребывания.

Параметры:

  • КартаГостя: карта гостя для выполнения операции.
  • Операция: название или структура с идентификатором операции.

Доступные операции:

Выбытие
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ChangeGuestParameters&Операция=Выбытие&КартаГостя={"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fea85e4511756911edbf1bf86f3635"}
Пример ответа
{
"Success": true,
"Result": true,
"Messages": []
}
Сокращение пребывания

Тело запроса (необязательные параметры):

  • ДатаОперации: дата сокращения пребывания. Значение по умолчанию - текущая дата (или дата заезда, если операция выполняется будущим числом).
  • ВремяОперации: время сокращения пребывания. Значение по умолчанию - время выезда гостя.
  • СВыбытием: выполнить ли выбытие после сокращения пребывания.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ChangeGuestParameters&Операция=СокращениеПребывания&КартаГостя={"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fea85e4511756911edbf1bf86f3635"}

Тело запроса:

{
"ДатаОперации": "2023-03-11T00:00:00",
"ВремяОперации": "0001-01-01T19:00:00",
"СВыбытием": "Истина"
}
Пример ответа
{
"Success": true,
"Result": {
"Дата": "2023-03-13T16:49:00",
"Номер": "23/000000000168",
"Идентификатор": "e1cib/data/Документ.ЗаявкаГостя?ref=94fea85e4511756911edc19c5d279cbe"
},
"Messages": []
}
Переселение / продление

Тело запроса (необходимо указать один или оба параметра):

  • НомерГостиницы: новый номер гостиницы гостя.
  • КоличествоДней: количество дней для продления проживания.

Тело запроса (необязательные параметры):

  • НовоеВремяВыезда: новое время выезда гостя. Значение по умолчанию - время выезда гостя.
  • ДатаОперации: дата переселения гостя.
  • ВремяОперации: время переселения гостя.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ChangeGuestParameters&Операция=ПереселениеПродление&КартаГостя={"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fea85e4511756911edbf1bf86f3635"}

Тело запроса:

{
"КоличествоДней": 4,
"ДатаОперации": "2023-03-11T00:00:00",
"НовоеВремяВыезда": "0001-01-01T12:00:00",
"Причина": "Смерть родственника",
"НомерГостиницы": {"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c12a"}
}
Пример ответа
{
"Success": true,
"Result": {
"Дата": "2023-03-13T16:59:57",
"Номер": "23/000000000169",
"Идентификатор": "e1cib/data/Документ.ЗаявкаГостя?ref=94fea85e4511756911edc19c5d279cc1"
},
"Messages": []
}
Перерыв пребывания

Тело запроса (необязательные параметры):

  • ДатаОперации: дата начала перерыва пребывания. Значение по умолчанию - дата заезда гостя.
  • ВремяОперации: время начала перерыва пребывания. Значение по умолчанию - время выезда гостя.
  • ДатаОкончанияОперации: дата окончания перерыва пребывания.
  • ВремяОкончанияОперации: время окончания перерыва пребывания.
  • СохранитьНомер: сохранить номер за гостем. Значение по умолчанию - ложь. Принимает ложь, если указана дата окончания операции.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ChangeGuestParameters&Операция=ПерерывПребывания&КартаГостя={"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fea85e4511756911edbf1bf86f3635"}

Тело запроса:

{
"ДатаОперации": "2023-03-11T00:00:00",
"ВремяОперации": "0001-01-01T12:00:00",
"СохранитьНомер": "Истина"
}
Пример ответа
{
"Success": true,
"Result": {
"Дата": "2023-03-13T17:17:17",
"Номер": "23/000000000172",
"Идентификатор": "e1cib/data/Документ.ЗаявкаГостя?ref=94fea85e4511756911edc1a0aa787ea8"
},
"Messages": []
}
Возобновление пребывания

Тело запроса (необязательные параметры):

  • ДатаОперации: дата возобновления пребывания. Значение по умолчанию - дата перерыва.
  • ВремяОперации: время возобновления пребывания. Значение по умолчанию - время перерыва.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ChangeGuestParameters&Операция=ВозобновлениеПребывания&КартаГостя={"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fea85e4511756911edbf1bf86f3635"}

Тело запроса:

{
"ДатаОперации": "2023-03-11T00:00:00",
"ВремяОперации": "0001-01-01T12:00:00",
}
Пример ответа
{
"Success": true,
"Result": {
"Дата": "2023-03-13T17:23:06",
"Номер": "23/000000000173",
"Идентификатор": "e1cib/data/Документ.ЗаявкаГостя?ref=94fea85e4511756911edc1a0aa787ea9"
},
"Messages": []
}
Изменение пребывания

Тело запроса (обязательные параметры):

  • ВидДокумента: название или структура с идентификатором вида документа изменения пребывания.
  • ВариантПроживания/ВариантЛечения/ВариантПитания: название или структура с идентификатором параметра пребывания. Для каждого вида документа требуется установить свой параметр. Например, для вида «Заявка на изменение питания» необходимо установить параметр «ВариантПитания».

Тело запроса (необязательные параметры):

  • ДатаОперации: дата изменения параметров пребывания.
  • ВремяОперации: время изменения параметров пребывания.
  • НомерГостиницы: новый номер гостиницы гостя. Требуется только для вида «Заявка на изменение проживания». Параметр обязателен, если до операции вариант проживания гостя был «Без проживания».
  • ПомещениеПитания: новое помещение питания гостя. Требуется только для вида «Заявка на изменение питания».
  • ОборудованиеПитания: новое оборудование питания гостя. Требуется только для вида «Заявка на изменение питания».
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ChangeGuestParameters&Операция=ИзменениеПребывания&КартаГостя={"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fea85e4511756911edbf1bf86f3635"}

Тело запроса:

{
"ВидДокумента": "ЗаявкаНаИзменениеПитания",
"ВариантПитания": "ОбщийСтол",
"ПомещениеПитания": {"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0f0"},
"ОборудованиеПитания": {"Идентификатор": "e1cib/data/Справочник.Номенклатура?ref=b87a60a44c379a5b11e84226f79ecc90"},
"ДатаОперации": "2023-03-18T00:00:00"
}
Пример ответа
{
"Success": true,
"Result": {
"Дата": "2023-03-14T09:15:10",
"Номер": "23/000000000175",
"Идентификатор": "e1cib/data/Документ.ЗаявкаГостя?ref=94fea85e4511756911edc226c904325b"
},
"Messages": []
}

GetBookingList

Список заявок заявителя.

Так же может возвращать все заявки по периоду, начиная с 21.07.01. Для этого передаётся параметры "НачалоПериода", "КонецПериода". Можно как один, так и оба сразу.

Пример вызова
/GetData?Method=GetBookingList&Client={"ID":"e1cib/data/Справочник.Контрагенты?ref=aab56c626dc53d6911e8a44b45d09480"}
Пример ответа
Аналогично методу GetBookingStatus.

CancelBooking

Запрос на отмену заявки. В теле запроса передается массив идентификаторов заявок и причины отмены. Можно передать общую для всех заявок причину отмены в параметрах запроса, но причина в теле запроса приоритетней причины в параметрах. Метод возвращает массив заявок и результатов отмены.

В зависимости от текущего состояния заявки выполняются следующие действия:

  • Принята (документ не проведен): устанавливается пометка на удаление документа, в реквизит "Комментарий" документа записывается причина отмены.
  • В работе (документ проведен): создается общий отказ по всем строкам заявки с указанием причины.
  • Завершена (создан документ "Путевка"): для каждой путевки, созданной на основании заявки выполняется операция "Снятие брони" с указанием причины.

Если переданная заявка уже отменена, вернется ошибка обработки с соответствующим кодом и описанием.

Пример вызова
/PostData?Method=CancelBooking&DenyReason={"GUID": "21b146ad-cad2-11e8-9a46-60a44c379a5b"}
Тело запроса
[
{
"Booking": {
"GUID": "78fd6678-86d4-11e5-a33f-60a44c379a5b"
},
"DenyReason": {
"GUID": "49fde0fc-bb04-11e8-b458-5404a66e4a89"
}
},
{
"Booking": {
"GUID": "49fde0fc-bb04-11e8-b458-5404a66e4a89"
}
}
]
Пример ответа
{
"Success": true,
"Result": [
{
"Booking": {
"Date": "2018-08-08T12:21:19",
"Number": "ТТ0000000165",
"ID": "e1cib/data/Документ.ЗаявкаПокупателя?ref=b4535404a66e4a8911e89ae406700121"
},
"Результат": "Заявка подтверждена, автоматическая отмена невозможна!"
}
]
}

GetBookingStatus

Возвращает статус заявки, в параметрах можно передать массив идентификаторов заявок. Запрос содержит один обязательный параметр Booking.

Дополнительные параметры:

  • AdditionalProperties: в результат будут добавлены значения дополнительных свойств заявки, заданных для нее в базе. Список свойств передается через запятую без пробелов. В 1С это поле КОД доп. свойства.
  • PrintForm: вывод файла печатной формы в формате PDF. Необходимо передавать ИД печатной формы в базе КУС: PrintForm={"GUID":"c357203b-c09c-11e8-b45b-5404a66e4a89"}

Возможные статусы заявок:

  • Принята: Документ не проведен. Её движения не активны.
  • Отменена: Документ не проведен и помечен на удаление.
  • В работе: Документ проведен и есть не закрытые строки.
  • Отказано: Все строки документа закрыты отказам по заявке.
  • Завершена: Все строки документа закрыты и есть хотя бы одна созданная по ним путевка.
Пример вызова
/GetData?Method=GetBookingStatus&Booking=[{"ID": "e1cib/data/Документ.ЗаявкаПокупателя?ref=b4535404a66e4a8911e89ae406700121"}, {"GUID": "78fd6678-86d4-11e5-a33f-60a44c379a5b"}]
Пример ответа
{
"Success": true,
"Result": [
{
"Date": "2018-08-08T12:21:19",
"Number": "ТТ0000000165",
"Sanatorium": {
"Name": "ОАО санаторий \"Родные просторы\"",
"ID": "e1cib/data/Справочник.Организации?ref=8e8150e54935bd5411e25bc6880bb616"
},
"Status": "Завершена",
"Booked": 4,
"Denied": 0,
"ToProcess": 0,
"ID": "e1cib/data/Документ.ЗаявкаПокупателя?ref=b4535404a66e4a8911e89ae406700121"
},
{
"Date": "2018-08-13T20:15:22",
"Number": "ТТ0000000170",
"Sanatorium": {
"Name": "ОАО санаторий \"Родные просторы\"",
"ID": "e1cib/data/Справочник.Организации?ref=8e8150e54935bd5411e25bc6880bb616"
},
"Status": "В работе",
"Booked": 0,
"Denied": 0,
"ToProcess": 1,
"ID": "e1cib/data/Документ.ЗаявкаПокупателя?ref=b4535404a66e4a8911e89f1413f618ad"
}
]
}

CheckGuest

Выполняет поиск карты гостя по переданным реквизитам и проверяет ее актуальность.

Пример структуры параметров
{
   "ДатаЗаезда":"2020-07-15T00:00:00",
   "Физлицо_ДатаРождения":"1949-01-23T00:00:00",
   "НаДату":"2020-07-28T00:00:00"
}

Параметры отбора карты гостя передаются в структуре с имененем "Отбор" или "Filter". Вложенные реквизиты должны быть переданы с разделителем "_", например: дата рождения физлица: "Физлицо_ДатаРождения". Служебные параметры отбора:

  • НаДату: на какую дату проверять регистрацию гостя. Если не передан, то проверяется на текущую дату.
  • УчитыватьВремя (булево): учитывать время суток заезда и выезда гостя. По умолчанию время не учитывается.

Параметр ВернутьКартуГостя (булево) позволяет вернуть в ответе идентификатор карты гостя, если она найдена и актуальна. По умолчанию возвращается только признак актуальности. Реквизиты карты гостя могут быть получены с помощью предопределенного параметра Fields. Признак успешного поиска карты гостя возвращается в поле КартаГостяНайдена.

Пример вызова
/GetData?Method=CheckGuest&Отбор={"ДатаЗаезда":"2020-07-15T00:00:00","Физлицо_ДатаРождения":"1949-01-23T00:00:00","НаДату":"2020-07-16T00:00:00"}&ВернутьКартуГостя=true&Fields=ДатаЗаезда,ДатаВыезда
Пример ответа
{
"Success": true,
"Result": {
"Date": "2020-07-14T17:13:24",
"Number": "t0123/00048",
"ID": "e1cib/data/Документ.КартаГостя?ref=977af46d0477991a11ee3cfe22c317ca"
"ДатаЗаезда": "2020-07-15T00:00:00",
"ДатаВыезда": "2020-07-25T00:00:00",
"КартаГостяНайдена": true
}
}
Пример ответа с параметром &ВернутьКартуГостя=false
{
"Success": true,
"Result": true
}

GetGuestData

Возвращает информацию о физлице на основании ссылки на физлицо. Параметры:

  • ФизЛицо: структура с ссылкой на физическое лицо, данные о котором необходимо извлечь.
Пример вызова
/GetGuestData?Физлицо={"Идентификатор": "e1cib/data/Справочник.яъФизическиеЛица?ref=bc98d85ed320709611ed0990f9042959"}
Пример ответа
{
	"Success": true,
	"Result": {
		"LastNameRu": "Евгений",
		"FirstNameRu": "Никандрович",
		"MiddleName": "",
		"Gender": "Перечисление.яъПол.Мужской",
		"Возраст": 47,
		"ВозрастнаяГруппа": {
			"Наименование": "Взрослые (с 15 лет и старше)",
			"ПометкаУдаления": false,
			"Предопределенный": false,
			"ИмяПредопределенныхДанных": "",
			"Идентификатор": "e1cib/data/Справочник.яъКатегории?ref=bd4860a44c379a5b11e3ab40edb150de"
		},
		"Birthday": "1974-08-10T00:00:00",
		"ИНН": "",
		"BirthplaceRu": {
			"Наименование": null,
			"ПометкаУдаления": null,
			"Предопределенный": null,
			"ИмяПредопределенныхДанных": null,
			"Код": null,
			"Идентификатор": "e1cib/data/Справочник.яъАдреса?ref=00000000000000000000000000000000"
		},
		"Category": {
			"Наименование": null,
			"ПометкаУдаления": null,
			"Предопределенный": null,
			"ИмяПредопределенныхДанных": null,
			"Код": null,
			"Идентификатор": "e1cib/data/Справочник.яъКатегорииФизлиц?ref=00000000000000000000000000000000"
		},
		"КатегорияФизлица": {
			"Наименование": null,
			"ПометкаУдаления": null,
			"Предопределенный": null,
			"ИмяПредопределенныхДанных": null,
			"Код": null,
			"Идентификатор": "e1cib/data/Справочник.яъКатегорииФизлиц?ref=00000000000000000000000000000000"
		},
		"ВидДокумента": {
			"Наименование": "Паспорт гражданина Российской Федерации",
			"ПометкаУдаления": false,
			"Предопределенный": true,
			"ИмяПредопределенныхДанных": "Паспорт",
			"Код": 21,
			"Идентификатор": "e1cib/data/Справочник.ДокументыУдостоверяющиеЛичность?ref=846e60a44c379a5b11e55885c749b7e0"
		},
		"ДокументСерия": "1487",
		"ДокументНомер": "32157",
		"DateOfIssue": "0001-01-01T00:00:00",
		"IssuedBy": "ТЕРРИТОРИАЛЬНЫЙ ПУНКТ УФМС РОССИИ ПО Г. МОСКВЕ В С. КРАСНОЕ",
		"DepartmentCode": "770-147",
		"ДатаРегистрацииПоМестуЖительства": "0001-01-01T00:00:00",
		"ОкончаниеРегистрации": "0001-01-01T00:00:00",
		"ДействителенДо": "0001-01-01T00:00:00",
		"ЭлектроннаяПочта": null,
		"FactAddress": {
			"Наименование": "Российская Федерация, Вологодская обл, г Вологда, Ленина ул, дом № 12, кв. 232",
			"ПометкаУдаления": false,
			"Предопределенный": false,
			"ИмяПредопределенныхДанных": "",
			"Код": "dem0000261",
			"Идентификатор": "e1cib/data/Справочник.яъАдреса?ref=bc98d85ed320709611ed09925386b91b"
		},
		"Телефон": null,
		"RegAddress": {
			"Наименование": "Российская Федерация, Вологодская обл, г Вологда, Ленина ул, дом № 12, кв. 232",
			"ПометкаУдаления": false,
			"Предопределенный": false,
			"ИмяПредопределенныхДанных": "",
			"Код": "dem0000261",
			"Идентификатор": "e1cib/data/Справочник.яъАдреса?ref=bc98d85ed320709611ed09925386b91b"
		}
	}
}

Модуль «Медицина»

НазначенныеИсследования

Назначенные пациенту исследования.

Параметры:

  • КартаГостя: карта гостя пациента, по которой нужно получить назначенные исследования.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=НазначенныеИсследования&КартаГостя={"Идентификатор" : "e1cib/data/Документ.КартаГостя?ref=94fda85e4511756911edb98261ada96f"}
Пример ответа
[
{
"Результат": null,
"ДатаСеанса": "2023-03-03T00:00:00",
"Услуга": "Исследование времени кровотечения",
"КатегорияУслуги": "Исследование",
"Кабинет": "210 - Лаборатория",
"ДокументНазначения": "Назначение услуг № demA00698 от 03.03.2023",
"Врач": "Новикова Анна Степановна",
"Персонал": "",
"КартаГостя": "Романов Игорь Егорович (№ 23/00011 от 03.03.2023)",
"ДатаЗаезда": "2023-03-03T00:00:00",
"ДатаВыезда": "2023-03-16T00:00:00",
"Пациент": "Романов Игорь Егорович",
"Комментарий": "",
"ПараметрыНазначения": "",
"Платная": false,
"ЦенаПроцедуры": 45,
"Срочная": false,
"ВремяС": "0001-01-01T08:10:00",
"КодСтроки": 1,
"ВремяДо": "0001-01-01T08:30:00",
"ФизлицоВремяС": "0001-01-01T08:10:00",
"ФизлицоВремяДо": "0001-01-01T08:25:00",
"Оборудование": "Лаборатория",
"Пройдено": 0,
"Неявка": 0,
"Выполнено": false,
"Осталось": 1,
"ПроцентОплаты": 0,
"БлижайшийСеанс": "2023-03-03T00:00:00",
"БлижайшееВремя": "0001-01-01T08:10:00",
"стрРезультат": ""
}
]

СвойстваПациента

Список свойств и их значений пациента.

Параметры:

  • КартаГостя: карта гостя пациента, по которой нужно получить свойства.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=СвойстваПациента&КартаГостя={"Идентификатор" : "e1cib/data/Документ.КартаГостя?ref=94fda85e4511756911edb98261ada96f"}
Пример ответа
{
"ЛечащийВрач": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Новикова Анна Степановна",
"Код": "t010000029",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Врачи-терапевты",
"Код": "t010000038",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Сотрудники?ref=b20b6451060d98bd11e5a941c4baa271"
},
"Идентификатор": "e1cib/data/Справочник.Сотрудники?ref=b20b6451060d98bd11e5a7ef5bec932e"
},
"МедицинскаяСправка": {
"Дата": "0001-01-01T00:00:00",
"Номер": "",
"Идентификатор": "e1cib/data/Документ.Справка?ref=00000000000000000000000000000000"
},
"Отделение": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Код": null,
"Идентификатор": "e1cib/data/Справочник.ПодразделенияОрганизаций?ref=00000000000000000000000000000000"
},
"КомментарийПациента": "",
"ДиагнозМКБ10": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Код": null,
"ЭтоГруппа": null,
"Идентификатор": "e1cib/data/Справочник.МКБ10?ref=00000000000000000000000000000000"
},
"ЛечебноеУчреждение": null,
"ДатаЛистаНетрудоспособности": null,
"НомерЛистаНетрудоспособности": null,
"НомерПолиса": null,
"НомерСтрахователя": null,
"СтраховаяКомпания": null,
"ФилиалФСС": null,
"ФизЛицо": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Романов Игорь Егорович",
"Код": "dem0000014",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.яъФизическиеЛица?ref=980360a44c379a5b11e6913943daceb3"
},
"НомерГостиницы": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "118",
"Код": "0000002118",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c101"
},
"ДатаЗаезда": "2023-03-03T00:00:00",
"ВремяЗаезда": "0001-01-01T12:00:00",
"ДатаВыезда": "2023-03-16T00:00:00",
"ВремяВыезда": "0001-01-01T08:00:00",
"ВариантПроживания": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "ОсновноеМесто",
"Наименование": "Основное место",
"Код": "00000000003",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "ВариантыПроживания",
"Наименование": "Варианты проживания",
"Код": "00000010006",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Номенклатура?ref=9b7996e6d857ebf811e3a8f3d7479344"
},
"Идентификатор": "e1cib/data/Справочник.Номенклатура?ref=9b7996e6d857ebf811e3a8f3d7479348"
},
"ВариантЛечения": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "ОбщийКурсПроцедур",
"Наименование": "С лечением",
"Код": "00002",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "УслугиЛечения",
"Наименование": "Наборы услуг лечения",
"Код": "00001",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.НаборыУслуг?ref=9b7996e6d857ebf811e3a8f3d747934a"
},
"Идентификатор": "e1cib/data/Справочник.НаборыУслуг?ref=9b7996e6d857ebf811e3a8f3d747934b"
},
"ВариантПитания": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "ОбщийСтол",
"Наименование": "Шведский стол",
"Код": "00002",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "УслугиПитания",
"Наименование": "Наборы услуг питания",
"Код": "00002",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.НаборыУслуг?ref=9b7996e6d857ebf811e3a8f3d747934f"
},
"Идентификатор": "e1cib/data/Справочник.НаборыУслуг?ref=9b7996e6d857ebf811e3a8f3d747934e"
},
"Пол": "Перечисление.яъПол.Мужской",
"Диета": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "ОсновнойВариантСтандартнойДиеты",
"Наименование": "ОВД - основной вариант стандартной диеты",
"Код": "ОВД      ",
"Идентификатор": "e1cib/data/Справочник.дтДиеты?ref=9b7996e6d857ebf811e3a8f3debae350"
},
"МестоПроживания": "118"
}

НазначенияМедикаментов

Список медикаментов по карте гостя.

Параметры:

  • КартаГостя: карта гостя, по которой необходимо получить список медикаментов.
  • стрРеквизиты (не поддерживается): список необходимых реквизитов. Доступные реквизиты: КартаГостя, Дата, Медикамент, Количество.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=НазначенияМедикаментов&КартаГостя={"Идентификатор" : "e1cib/data/Документ.КартаГостя?ref=94fda85e4511756911edb98261ada96f"}&стрРеквизиты=""
Пример ответа
[
    {
        "Количество": 10,
        "Дата": "2023-03-09T00:00:00",
        "КартаГостя": {
            "Дата": "2023-03-03T09:15:21",
            "Номер": "23/00011       ",
            "Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fda85e4511756911edb98261ada96f"
        },
        "Медикамент": {
            "ПометкаУдаления": false,
            "Предопределенный": false,
            "ИмяПредопределенныхДанных": "",
            "Наименование": "Аспирин",
            "Код": "dem00000008",
            "ЭтоГруппа": false,
            "Родитель": {
                "ПометкаУдаления": false,
                "Предопределенный": true,
                "ИмяПредопределенныхДанных": "Медикаменты",
                "Наименование": "Медикаменты (лекарственные препараты)",
                "Код": "00000010005",
                "ЭтоГруппа": true,
                "Идентификатор": "e1cib/data/Справочник.Номенклатура?ref=9b7996e6d857ebf811e3a8f3d7479342"
            },
            "Идентификатор": "e1cib/data/Справочник.Номенклатура?ref=ad1660a44c379a5b11e6ec5de753c7c0"
        }
    },
    {
        "Количество": 10,
        "Дата": "2023-03-13T00:00:00",
        "КартаГостя": {
            "Дата": "2023-03-03T09:15:21",
            "Номер": "23/00011       ",
            "Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fda85e4511756911edb98261ada96f"
        },
        "Медикамент": {
            "ПометкаУдаления": false,
            "Предопределенный": false,
            "ИмяПредопределенныхДанных": "",
            "Наименование": "Аспирин",
            "Код": "dem00000008",
            "ЭтоГруппа": false,
            "Родитель": {
                "ПометкаУдаления": false,
                "Предопределенный": true,
                "ИмяПредопределенныхДанных": "Медикаменты",
                "Наименование": "Медикаменты (лекарственные препараты)",
                "Код": "00000010005",
                "ЭтоГруппа": true,
                "Идентификатор": "e1cib/data/Справочник.Номенклатура?ref=9b7996e6d857ebf811e3a8f3d7479342"
            },
            "Идентификатор": "e1cib/data/Справочник.Номенклатура?ref=ad1660a44c379a5b11e6ec5de753c7c0"
        }
    }
]

ПроцедурныеКабинеты

Помещения категорий «Процедурный кабинет» и «Лаборатория».

Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ПроцедурныеКабинеты
Пример ответа
[
    {
        "Кабинет": {
            "ПометкаУдаления": false,
            "Предопределенный": false,
            "ИмяПредопределенныхДанных": "",
            "Наименование": "Кабинет (Вибромассаж стоп)",
            "Код": "Тер0000011",
            "ЭтоГруппа": false,
            "Идентификатор": "e1cib/data/Справочник.Помещения?ref=9a4e60a44c379a5b11e9bf533d8c9c71"
        }
    },
    {
        "Кабинет": {
            "ПометкаУдаления": false,
            "Предопределенный": false,
            "ИмяПредопределенныхДанных": "",
            "Наименование": "Кабинет (Гидроаэроионизация)",
            "Код": "Тер0000013",
            "ЭтоГруппа": false,
            "Идентификатор": "e1cib/data/Справочник.Помещения?ref=9a4e60a44c379a5b11e9bf533d8c9c7c"
        }
    },
    {
        "Кабинет": {
            "ПометкаУдаления": false,
            "Предопределенный": false,
            "ИмяПредопределенныхДанных": "",
            "Наименование": "Кабинет (Гидромассаж)",
            "Код": "Тер0000014",
            "ЭтоГруппа": false,
            "Идентификатор": "e1cib/data/Справочник.Помещения?ref=9a4e60a44c379a5b11e9bf533d8c9c81"
        }
    }
]

НазначенияИРезультаты

Назначения и результаты пациентов.

Тело запроса (обязательные параметры):

  • Параметры: параметры отбора назначений. Можно передать пустую структуру для получения всех назначений. Доступны параметры:
    • КартаГостя: карта гостя пациента.
    • ФизЛицо: физическое лицо пациента.
    • ДокументНазначения: документ назначения.
    • фОплата: получить таблицу с оплатой счетов.
    • Кабинет: кабинеты, по которым необходимо получить назначения.
    • НачалоПериода: начало периода сеансов.
    • КонецПериода: конец периода сеансов.
    • КатегорияУслуги: получить только услуги переданной категории.
    • НаДату: дата документов назначения сеансов.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=НазначенияИРезультаты

Тело запроса:

{
"Параметры": {
"КартаГостя": {"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fda85e4511756911edb98261ada96f"},
"фОплата": false,
"Кабинет": [
{"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e58c6735a8e750"}
],
"КатегорияУслуги": {"Идентификатор": "e1cib/data/Справочник.яъКатегории?ref=9777f46d0477991a11ede40656633b10"}
"НаДату": "2023-03-16T00:00:00",
"НачалоПериода": "2023-03-03T00:00:00",
"КонецПериода": "2023-03-14T00:00:00"
}	
}
Пример ответа
[
{
"ДатаСеанса": "2023-03-03T00:00:00",
"ВремяС": "0001-01-01T08:10:00",
"ВремяДо": "0001-01-01T08:30:00",
"Платная": false,
"ПроцентОплаты": 0,
"Пройдено": 0,
"Осталось": 1,
"Назначено": null,
"БлижайшийСеанс": "2023-03-03T00:00:00",
"Комментарий": "",
"КодСтроки": 1,
"ПредставлениеПараметровНазначения": "",
"КартаГостя": {
"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fda85e4511756911edb98261ada96f",
"Наименование": null,
"Код": null,
"Дата": "2023-03-03T09:15:21",
"Номер": "23/00011       "
},
"Пациент": {
"Идентификатор": "e1cib/data/Справочник.яъФизическиеЛица?ref=980360a44c379a5b11e6913943daceb3",
"Наименование": "Романов Игорь Егорович",
"Код": "dem0000014",
"Дата": null,
"Номер": null
},
"Услуга": {
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=b20b6451060d98bd11e5bc5b3068e44c",
"Наименование": "Исследование времени кровотечения",
"Код": "t01000111",
"Дата": null,
"Номер": null,
"Памятка": ""
},
"ПараметрыНазначения": {
"Идентификатор": "e1cib/data/Документ.яъЗначенияСвойств?ref=00000000000000000000000000000000",
"Наименование": null,
"Код": null,
"Дата": "0001-01-01T00:00:00",
"Номер": ""
},
"Кабинет": {
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e58c6735a8e750",
"Наименование": "210 - Лаборатория",
"Код": "210",
"Дата": null,
"Номер": null
},
"Оборудование": {
"Идентификатор": "e1cib/data/Справочник.Номенклатура?ref=b20b6451060d98bd11e5babd8df939f8",
"Наименование": "Лаборатория",
"Код": "00000000011",
"Дата": null,
"Номер": null
},
"ДокументНазначения": {
"Идентификатор": "e1cib/data/Документ.НазначениеУслуг?ref=94fda85e4511756911edb9bb423b531f",
"Наименование": null,
"Код": null,
"Дата": "2023-03-03T16:42:13",
"Номер": "demA00698      "
}
}
]

ПоказателиПациента

Значения показателей пациента по физическому лицу.

Параметры:

  • ФизЛицо: физическое лицо, по которому необходимо получить показатели.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ПоказателиПациента&ФизЛицо={"Идентификатор":"e1cib/data/Справочник.яъФизическиеЛица?ref=b20b6451060d98bd11e59cb642414f2b"}
Пример ответа
[
{
"Показатель": "Группа не указана",
"Значение": null,
"ГруппаПоказателей": null
},
{
"Показатель": "Объём мочи, суточный",
"Значение": "10",
"ГруппаПоказателей": ""
},
{
"Показатель": "Диета",
"Значение": "ОВД - основной вариант стандартной диеты",
"ГруппаПоказателей": ""
},

{
"Показатель": "Хирургические вмешательства",
"Значение": "полипэктомия",
"ГруппаПоказателей": "Анамнез"
},
{
"Показатель": "Онкологический анамнез",
"Значение": "c-r легкого",
"ГруппаПоказателей": "Анамнез"
},
{
"Показатель": "Сахарный диабет",
"Значение": "нет",
"ГруппаПоказателей": "Анамнез"
},
{
"Показатель": "Инфекционные заболевания",
"Значение": "туберкулез",
"ГруппаПоказателей": "Анамнез"
},
{
"Показатель": "Анамнез",
"Значение": "полиартроз",
"ГруппаПоказателей": "Анамнез"
},
{
"Показатель": "Анамнез",
"Значение": null,
"ГруппаПоказателей": null
}
]

ОказанныеУслуги

Оказанные услуги исполнителя.

Параметры:

  • НачалоПериода: начало периода оказанных услуг.
  • КонецПериода: конец периода оказанных услуг.
  • Исполнитель: исполнитель услуг.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ОказанныеУслуги&Параметры={"НачалоПериода":"2022-01-14T00:00:00","КонецПериода":"2023-01-18T00:00:00","Исполнитель":{"Идентификатор":"e1cib/data/Справочник.Сотрудники?ref=b20b6451060d98bd11e5a7ef357c1a80"}}
Пример ответа
{
[
{
"Услуга": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Массаж ручной",
"Код": "t01000063",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "Процедуры",
"Наименование": "Процедуры",
"Код": "000000002",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab41cc1f4635"
},
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=a33f60a44c379a5b11e58a0535bff3f1"
},
"ПроцЕд": 18,
"Стоимость": 2098,
"Выполнено": 3,
"Платная": true
},
{
"Услуга": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Ароматерапия",
"Код": "t01000067",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "Процедуры",
"Наименование": "Процедуры",
"Код": "000000002",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab41cc1f4635"
},
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=a33f60a44c379a5b11e58a0551163e70"
},
"ПроцЕд": 50,
"Стоимость": 10165,
"Выполнено": 4,
"Платная": true
},
{
"Услуга": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Ароматерапия",
"Код": "t01000067",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "Процедуры",
"Наименование": "Процедуры",
"Код": "000000002",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab41cc1f4635"
},
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=a33f60a44c379a5b11e58a0551163e70"
},
"ПроцЕд": 5,
"Стоимость": 55,
"Выполнено": 1,
"Платная": false
}
]

ИзменитьСостояниеСеанса

Создание документа «Отметка услуг».

Тело запроса (обязательные параметры):

  • фОтмена: если истина, то вид документа будет «Неявка на услуги», иначе «Отметка услуг».
  • Дата: дата оказания услуги.
  • Услуга: услуга для оказания.
  • Пациент: физическое лицо или карта гостя пациента.
  • Кабинет: кабинет оказания услуги.
  • ДокументНазначения: документ назначения услуги, по которому необходимо выполнить отметку.
  • КодСтроки: код строки услуги из документа назначения.

Тело запроса (необязательные параметры):

  • Исполнитель: исполнитель услуг. Значение по умолчанию - текущий пользователь.
  • QRКод: признак отметки услуги по QR-коду.
  • фПлатная: признак платности услуги.
  • фСрочная: признак срочной услуги.
  • ПараметрыНазначения: параметры назначения услуги.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ИзменитьСостояниеСеанса

Тело запроса:

{
"фОтмена": false,
"Дата": "2023-03-18T00:00:00",
"Услуга": {"Идентификатор": "e1cib/data/Справочник.Услуги?ref=a33f60a44c379a5b11e58a0551163e70"},
"Пациент": {"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fea85e4511756911edc22a22d2dea3"},
"Исполнитель": {"Идентификатор": "e1cib/data/Справочник.Сотрудники?ref=b20b6451060d98bd11e5a7ef357c1a80"},
"ДокументНазначения": {"Идентификатор": "e1cib/data/Документ.НазначениеУслуг?ref=94fea85e4511756911edc25f873125fc"},
"Кабинет": {"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e58c6771c76040"},
"КодСтроки": 4,
"QRКод": true,
"фСрочная": true
}
Пример ответа
{
"Success": true,
"Result": true,
"Messages": []
}

Подсистема «Предприятие»

GetPaymentQRCode

Формирует и возвращает QR-код для оплаты счета. Может вернуть как структуру из разных видов QR-кодов, так и просто ссылку на него.

Параметры:

  • ТипКода: тип необходимого QR-кода. Поддерживаются "СБП" и "Обычный".
  • СчетНаОплату: структура, описывающая счёт на оплату, или содержащая ссылку на уже существующий.
Пример вызова
/GetPaymentQRCode?ТипКода=["СБП", "Обычный"]&СчетНаОплату={"Идентификатор": "e1cib/data/Документ.СчетНаОплатуПокупателю?ref=b4bd5404a66e4a8911ebc434d07efc77"}
Пример ответа
{
    "Success": true,
    "Result": {
        "СБП": "https://test.ecom.raiffeisen.ru/api/sbp/v1/qr/AD241848FF8A4D0E9700D707C7688152/image",
        "Обычный": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAKoAAACqAQAAAAAVDekvAAAEEUlEQVR4AdWVsYo0OQyEBUoFehWBUoNe3aDU4FcRODX4anr+5GDcl/7nHdidr9m2LZWq6Pxa/X+Aic9pS8+stXaYzaK441ihTdssG5nM6X5esPloNcMFT+l0U+dXbNTGmDhqP3vHf+Ha85DPPg2PtL/iWNqzQmt8fk33dV4wsf97Gb3gczKUwgSbr9WWxJ96/8RkatlQXq6OY5qM8YIl+LSeduKI7pzHWtyxU7fueAtlWmbpjHPHPXw3PjbDJq+9stoLJqw9nVorzY4H8ynsBbum4+fEPttyoHHtBZvT2nsb0zgDYhPJc8c020dgaLHNNWYWZHrHm6PlWV1i01lppiPu2AbKSek6SQulOH2+4ODsutuw2hvtNYl6wbMZY4xK+qObqnwKe8GNLU21f6dwRCm94ICG5wrhOUdlUGrEC+aOwrbEsB5p3M56trzgpcOWq+1TvFpGbH7BQZTUiVS5E49RpC8YYjOCeezwrMI74g0PNzuY6KrJn7lmf8MSaLGEjGNcyhhtiTsO0miFA24vFlyP7Hvun9gw2bMHT4zgthBII+74M0cxx1w0h+rc1urp/G+89YQr5JMinrbm1wou+NCqOPsc2Qnhb1n2gufABbbKoeHNVW09grjgglNHX7h45yIW4cc4Lhizhz/IGkRPEeZ7v+BmuqCxJZSxDHpmesFzts895m6QPiImxrewvzH6ajJHdniMsO8ezwEv2Df+beSaxCpt79nOC962MHMbhgS3YVhZ0QvOjcNNQklhNpvxfL5gR0wMiKEMN4KjaT5tuOBonZrCAY5taSTQ3AueVo/BoMLBC/b4Da8LhmXAW/pe4zhySVW/efkbb8J8ChRkE+EVa5GcO068hSEEbPzJl2VhL7g8DpO7DojeW32+37FDYs3R11a5/GwYYNzxZ1pxQEV2wJSSmd4wq8/WRIWr+U5p7WnaBcOGCqVfPSPFKukr+wsuRe2PpPKY2L0Jr7hjdqsxp7jy3Ar/mk9hLziRACrl7eCDMD9TXzAlahQdgqgc7hY46R1jD28f47XNhiGEil7wrmD3pEVZmL5CsV6wI0CrNjyxMscqVPncMcIoNxxJjPBloFb9BUdgO5PToKKdKWM9W16w5Gf4h69eiH8ocz5iu+AlsdgR6BunRNJBdW+4wz8P3EbHR/6ntf6Co43h3FxGnzInZvaR5gVDMxlHEDAj9t6Yl3rBeItMSpeDKEKmbn0OeMHdcFnFRGsYcz/IyBd8jlb2UFjpqnSa8Qjigom9kzjDelFV3s0fK7jgQIeJA5cpGEfXFl8L+40NdZIks8MwJUG+PLK/4ijIQXazI6hEfCP6imlkIuu6oP6BTJUXHEsw2+aolC5Fs9cT6BdMjPGevKC32Rsu9RXbBf9afz/+BxyWHQ86YHDJAAAAAElFTkSuQmCC"
    }
}

GetAcceptances

Доступен с версии 21.07.01

Возвращает перечень созданных приёмов платежей по контрагенту, договору и/или счету (в зависимости от переданных параметров).

Пример вызова
/GetData?Method=GetAcceptances&Контрагент={"ID":%20"e1cib/data/Справочник.Контрагенты?ref=9a6c5404a66e4a8911e5bb8e2aa076f5"}&Счет={"Идентификатор":%20"e1cib/data/Документ.СчетНаОплатуПокупателю?ref=b4bd5404a66e4a8911ebc434d07efc5d"}&Реквизиты=СуммаДокументаБезСкидки
Пример ответа
{
    "Success": true,
    "Result": [
        {
            "Дата": "2019-09-30T15:26:39",
            "Номер": "ЧО0000000000038",
            "Идентификатор": "e1cib/data/Документ.ПриемПлатежей?ref=b48b5404a66e4a8911e9e36cba1ce639",
            "СуммаДокументаБезСкидки": 1000
        },
        {
            "Дата": "2021-06-03T10:54:18",
            "Номер": "ЧО000000149    ",
            "Идентификатор": "e1cib/data/Документ.ПриемПлатежей?ref=b4bd5404a66e4a8911ebc434d07efc5b",
            "СуммаДокументаБезСкидки": 21109
        },
        {
            "Дата": "2021-06-03T11:16:05",
            "Номер": "ЧО000000150    ",
            "Идентификатор": "e1cib/data/Документ.ПриемПлатежей?ref=b4bd5404a66e4a8911ebc434d07efc61",
            "СуммаДокументаБезСкидки": 3885
        }
    ]
}

AcceptPayment

Доступен с версии 21.10.01

Параметры запроса:

  • Основание: документ «Заявка», по которому необходимо выставить счет.
  • Контрагент: контрагент, которому необходимо выставить счет.
  • Договор: договор, контрагента, по которому необходимо выставить счет.
  • ЗаполнитьПоДокументу: признак заполнения счета по документу. Если параметр не передан или передан в значении «Ложь», то документ будет заполнен по невыставленным услугам.
  • мсУслуги: таблица с услугами. Основными параметрами являются: номенклатура, количество, цена, сумма. Возможна передача пустой цены, в таком случае цена будет получена по настройке ценообразования. Если параметр передан, то параметр «ЗаполнитьПоДокументу» игнорируется.
  • ПроцентПредоплаты: процент предоплаты, на который выставляется счет. Если параметр передан, то счет будет выставлен на соответствующий процент количества услуг.
  • ОтправитьНаEmail: печатная форма, которую необходимо отправить контрагенту на Email, установленный в его контактных данных. Если параметр передан с пустым значением, то будет отправлена стандартная печатная форма счета на оплату.
  • СбербанкИдентификатор: идентификатор платежа в сбербанке. Начиная с релиза 24.01 не используется.
  • ЭквайрингИДСчета: идентификатор платежа У Оператора Эквайринга. Используется начиная с релиза 24.01.
  • Контекст: структура со значением остальных реквизитов счета.
Пример вызова
/AcceptPayment
Счет на предоплату 50% стоимости, заполнение по документу
{
"Контрагент": {"ID": "e1cib/data/Справочник.Контрагенты?ref=9510a85e4511756911ee52ea8a5111a5"},
"Договор": {"ID": "e1cib/data/Справочник.ДоговорыКонтрагентов?ref=9510a85e4511756911ee52ea8a5111a6"},
"Основание": {"ID": "e1cib/data/Документ.ЗаявкаПокупателя?ref=9511a85e4511756911ee698a1ac22021"},
"ЗаполнитьПоДокументу": true,
"ПроцентПредоплаты": 50,
"ОтправитьНаEmail": null,
"Контекст": {"СрокОплаты": "2023-10-13T15:10:45"}
}
Пример ответа
{
"Success": true,
"Result": {
"Дата": "2023-10-13T15:10:45",
"Номер": "23/00094       ",
"Идентификатор": "e1cib/data/Документ.СчетНаОплатуПокупателю?ref=9511a85e4511756911ee69b9254871ae"
},
"Messages": [
{
"text": "15:10:51: сообщение отправлено на test.test@gmail.com"
}
]
}
Счет на оплату на 10 единиц номенклатуры.
{
"Контрагент": {"ID": "e1cib/data/Справочник.Контрагенты?ref=9510a85e4511756911ee52ea8a5111a5"},
"Договор": {"ID": "e1cib/data/Справочник.ДоговорыКонтрагентов?ref=9510a85e4511756911ee52ea8a5111a6"},
"Основание": {"ID": "e1cib/data/Документ.ЗаявкаПокупателя?ref=9511a85e4511756911ee698a1ac22021"},
"мсУслуги": [
{
"Номенклатура": {"ID": "e1cib/data/Справочник.Номенклатура?ref=9a4e60a44c379a5b11e9b3808b34f6b5"},
"Количество": 10
}
]
}
Пример ответа
{
"Success": true,
"Result": {
"Дата": "2023-10-13T15:45:47",
"Номер": "23/00095       ",
"Идентификатор": "e1cib/data/Документ.СчетНаОплатуПокупателю?ref=9511a85e4511756911ee69be0a6345ae"
},
"Messages": []
}

RegisterPayment

Доступен с версии 21.07.01

Создаёт приём платежей. Должен быть строго POST-запросом. В теле должны содержаться данные для добавления в документ. Основными считаются ссылка на счёт-основание, вид документа и сумма. Все остальные должны передаваться внутри объекта "Контекст".

Пример запроса
{
    "Счет": {"Идентификатор": "e1cib/data/Документ.СчетНаОплатуПокупателю?ref=b4bd5404a66e4a8911ebc42b9401edbb"},
    "ВидДокумента": "ПриемПлатежей",
    "Сумма": 100,
    "Контекст": {
        "ЧекПробитВоВнешнейПрограмме": true,
        "НомерВходящегоДокумента": "000002",
        "ДатаВходящегоДокумента": "2021-07-13T13:33:59"
    }
}
Пример ответа
{
    "Success": true,
    "Result": {
        "Дата": "2021-07-14T10:07:23",
        "Номер": "ЧО000000162    ",
        "Идентификатор": "e1cib/data/Документ.ПриемПлатежей?ref=967f708bcda2156111ebe469c0d8a16b"
    }
}

GetInvoices

Доступен с версии 21.07.01

Возвращает перечень счетов по контрагенту, договору или основанию (в зависимости от переданных параметров).

Пример вызова
/GetData?Method=GetInvoices&Контрагент={"ID":%20"e1cib/data/Справочник.Контрагенты?ref=9a6c5404a66e4a8911e5bb8e2aa076f5"}&Договор={"ID":%20"e1cib/data/Справочник.ДоговорыКонтрагентов?ref=bfdd7085c2c0660b11ebd27de6bcea8a"}&Основание={"ID":"e1cib/data/Документ.ЗаявкаПокупателя?ref=97495404a66e4a8111ec2a58b844326f"}&Fields=СуммаДокумента
Пример ответа
{
    "Success": true,
    "Result": [
        {
            "Дата": "2021-06-03T10:54:11",
            "Номер": "ЧОКУС-000000120",
            "Идентификатор": "e1cib/data/Документ.СчетНаОплатуПокупателю?ref=b4bd5404a66e4a8911ebc434d07efc5a",
            "СуммаДокумента": 25000   
        },
        {
            "Дата": "2021-06-03T10:54:43",
            "Номер": "ЧОКУС-000000121",
            "Идентификатор": "e1cib/data/Документ.СчетНаОплатуПокупателю?ref=b4bd5404a66e4a8911ebc434d07efc5d",
            "СуммаДокумента": 10000
        }
    ]
}

RoomCleaningStatus

Состояние уборки помещений.

Необязательные параметры:

  • Исполнитель: исполнитель потребностей. Если не указан, то состояние будет получено по текущему пользователю.
  • НаДату: дата уборки. Если не указана, то состояние будет получено на текущую дату.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=RoomCleaningStatus&НаДату=06.03.2023&Исполнитель={"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=94fda85e4511756911edb9bb423b532c"}
Пример ответа
{
"Success": true,
"Result": [
{
"Помещение": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "102",
"Код": "2102",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0f1"
},
"БлижайшийЗаезд": null,
"БлижайшийВыезд": null,
"ТребуетсяУборка": true,
"КоличествоПотребностей": 1,
"УборкаЗаездВыезд": false
}
],
"Messages": []
}

ListRooms

Перечень помещений и категорий.

Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ListRooms
Пример ответа
{
"Success": true,
"Result": {
"мзЗдания": [
{
"Ссылка": {
"ПометкаУдаления": true,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Лечебный корпус",
"Код": "dem000003",
"Идентификатор": "e1cib/data/Справочник.Здания?ref=8d2260a44c379a5b11e7a4e84ad54bf3"
},
"яъОрганизация": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Санаторий \"Родные просторы\"",
"Код": "9999999/2",
"Идентификатор": "e1cib/data/Справочник.Организации?ref=9bc8e4800e39484c4b1e680675db5963"
}
}
],
"мзКатегорииПомещений": [
{
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "НомерГостиницы",
"Наименование": "Гостиничный номер",
"Идентификатор": "e1cib/data/Справочник.яъКатегории?ref=9b7996e6d857ebf811e3a8f3c11af030"
}
]
},
"Messages": []
}

ПереченьПотребностей

Список потребностей и их исполнителей.

Необязательные параметры:

  • НаДату: дата потребности. Если не указана, то список потребностей будет получен на текущую дату.
  • Исполнитель: пользователь исполнителя потребности.
  • Помещение: помещение исполнения потребности.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ПереченьПотребностей&НаДату=06.03.2023&Исполнитель={"Идентификатор": "e1cib/data/Справочник.яъПользователи?ref=94fda85e4511756911edb9bb423b532c"}
Пример ответа
{
"Success": true,
"Result": [
{
"РаботаУслуга": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Генеральная уборка (Стандарт)",
"Код": "dem000009",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Услуги клининга",
"Код": "dem000005",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=9cb960a44c379a5b11e739694d098bb1"
},
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=9cb960a44c379a5b11e73fb6d9cf78e0"
},
"Помещение": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "102",
"Код": "2102",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0f1"
},
"Исполнитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Нина Егоровна",
"Код": "t010000053",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Горничные",
"Код": "dem0000005",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Сотрудники?ref=9cb960a44c379a5b11e73fb950120f70"
},
"Идентификатор": "e1cib/data/Справочник.Сотрудники?ref=9a0660a44c379a5b11e7e0930feffd50"
},
"Date": "2023-03-06T00:00:00",
"ВремяС": "0001-01-01T00:00:00",
"ВремяДо": "0001-01-01T00:00:00",
"Основание": {
"Дата": "2023-03-06T09:58:22",
"Номер": "dem000042      ",
"Идентификатор": "e1cib/data/Документ.НарядНаРаботы?ref=94fda85e4511756911edb9bb423b532b"
},
"Ссылка": {
"Дата": "2023-03-06T09:58:22",
"Номер": "dem000042      ",
"Идентификатор": "e1cib/data/Документ.НарядНаРаботы?ref=94fda85e4511756911edb9bb423b532b"
},
"КодСтроки": 1,
"Выполнено": false
}
],
"Messages": []
}

ЗаписатьУдостоверениеФизлица

Создание основного удостоверения физического лица.

Параметры:

  • ФизЛицо: владелец удостоверения.

Тело запроса (обязательные параметры):

  • ВидДокумента: вид документа удостоверения.

Тело запроса (необязательные параметры):

  • ДокументСерия: серия документа.
  • ДокументНомер: номер документа.
  • ДокументДатаВыдачи: дата выдачи документа.
  • ДокументКемВыдан: кем выдан документ.
  • ДокументКодПодразделения: код подразделения документа.
  • ДатаРегистрацииПоМестуЖительства: дата регистрации по месту жительства.
  • ДействителенДо: дата окончания действия документа.
  • ТипВизы: код типа визы МВД.
  • КратностьВизы: код кратности визы МВД.
  • ЦельВъезда: код цели въезда по визе МВД.
  • КодПунктаПересечения: код пункта пересечения границы.
  • ПунктПересеченияГраницы: пункт пересечения границы.
  • ФилиалФСС: номер филиала ФСС.
  • НомерСтрахователя: регистрационный номер страхователя.
  • ОкончаниеРегистрации: дата окончания регистрации.
  • ТипПолисаОМС: тип полиса ОМС.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ЗаписатьУдостоверениеФизлица&ФизЛицо={"Идентификатор":"e1cib/data/Справочник.яъФизическиеЛица?ref=b20b6451060d98bd11e59cb642414f2b"}
Тело запроса
{
"ВидДокумента": {"Идентификатор": "e1cib/data/Справочник.ДокументыУдостоверяющиеЛичность?ref=846e60a44c379a5b11e55885c749b7e0"},
"ДокументСерия": 9518,
"ДокументНомер": 648334,
"ДокументДатаВыдачи": "2014-05-18T00:00:00",
"ДокументКемВыдан": "КИНТ",
"ДокументКодПодразделения": 162566
}
Пример ответа
{
"Success": true,
"Result": null,
"Messages": []
}

РасходныеПоПомещению

Список расходных материалов по помещениям.

Необязательные параметры:

  • ДокументНазначения: документ назначения, по которому необходимо получить расходные материалы.
  • Услуга: услуга(работа), по которой были добавлены расходные материалы.
  • ПараметрыНазначения: параметры назначения услуги, по которой были добавлены расходные материалы.
  • ОбъектРабот: помещение, по которому необходимо получить расходные материалы.
  • фПлатная: отбор только по платным/бесплатным услугам.
  • ДатаТребования/ДатаСеанса: дата требования.
  • КодСтроки: код строки требования.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=РасходныеПоПомещению&ДатаТребования=06.03.2023&ДокументНазначения={"Идентификатор": "e1cib/data/Документ.НарядНаРаботы?ref=94fda85e4511756911edb9bb423b532b"}
Пример ответа
{
"Success": true,
"Result": [
{
"Документ": {
"Дата": "2023-03-06T09:58:22",
"Номер": "dem000042      ",
"Идентификатор": "e1cib/data/Документ.НарядНаРаботы?ref=94fda85e4511756911edb9bb423b532b"
},
"Организация": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Санаторий \"Родные просторы\"",
"Код": "9999999/2",
"Идентификатор": "e1cib/data/Справочник.Организации?ref=9bc8e4800e39484c4b1e680675db5963"
},
"ОсновнойСклад": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Код": null,
"ЭтоГруппа": null,
"Идентификатор": "e1cib/data/Справочник.Склады?ref=00000000000000000000000000000000"
},
"СкладПроизводства": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Код": null,
"ЭтоГруппа": null,
"Идентификатор": "e1cib/data/Справочник.Склады?ref=00000000000000000000000000000000"
},
"НаборУслуг": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Код": null,
"ЭтоГруппа": null,
"Идентификатор": "e1cib/data/Справочник.НаборыУслуг?ref=00000000000000000000000000000000"
},
"Номенклатура": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Шампунь одноразовый",
"Код": "00000000001",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "лимитка и профхимия",
"Код": "dem00000014",
"ЭтоГруппа": true,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Расходные материалы",
"Код": "dem00000001",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Номенклатура?ref=997960a44c379a5b11e62e032ea50ab3"
},
"Идентификатор": "e1cib/data/Справочник.Номенклатура?ref=9a6f60a44c379a5b11ec593317b72b6c"
},
"Идентификатор": "e1cib/data/Справочник.Номенклатура?ref=9a5560a44c379a5b11ea2572d42b3184"
},
"ОбъектРабот": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "102",
"Код": "2102",
"ЭтоГруппа": false,
"Идентификатор": "e1cib/data/Справочник.Помещения?ref=a33f60a44c379a5b11e586d5cb31c0f1"
},
"ДатаТребования": "2023-03-06T00:00:00",
"Qty": 1,
"ДокументНазначения": {
"Дата": "2023-03-06T09:58:22",
"Номер": "dem000042      ",
"Идентификатор": "e1cib/data/Документ.НарядНаРаботы?ref=94fda85e4511756911edb9bb423b532b"
},
"Услуга": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Генеральная уборка (Стандарт)",
"Код": "dem000009",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Услуги клининга",
"Код": "dem000005",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=9cb960a44c379a5b11e739694d098bb1"
},
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=9cb960a44c379a5b11e73fb6d9cf78e0"
},
"ПараметрыНазначения": {
"Дата": "0001-01-01T00:00:00",
"Номер": "",
"Идентификатор": "e1cib/data/Документ.яъЗначенияСвойств?ref=00000000000000000000000000000000"
},
"ОбластьПрименения": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Код": null,
"ЭтоГруппа": null,
"Идентификатор": "e1cib/data/Справочник.ОбластиПрименения?ref=00000000000000000000000000000000"
},
"фПлатная": false,
"Исполнитель": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Код": null,
"ЭтоГруппа": null,
"Идентификатор": "e1cib/data/Справочник.Сотрудники?ref=00000000000000000000000000000000"
},
"КодСтроки": 1
}
],
"Messages": []
}

Модуль «Питание»

PostMenu

Записывает выбор гостя по меню-раскладке на выбранный день.

Тело запроса:

  • Описание шахматки-меню для гостя.
Пример вызова

Тело запроса:

{
    "ИдентификаторКонтекста": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "СодержимоеЗаказа": [
        {
            "Потребность": {"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"},
            "Количество": 1
        }
    ]
}

ЗаказГостяНаДату

Список блюд по рационам из заказа гостя.

Параметры:

  • Параметры: Структура, содержащая параметры:
    • НаДату: дата заказа.
    • КартаГостя: карта гостя, по которой необходимо получить заказ.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ЗаказГостяНаДату&Параметры={"КартаГостя": {"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fda85e4511756911edb98261ada96f"}, "НаДату": "2023-03-04T00:00:00"}
Пример ответа
[
{
"Рацион": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Завтрак",
"Код": "000000006",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "УслугиПитания",
"Наименование": "Услуги питания",
"Код": "000000003",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab41cc1f4634"
},
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab44727047d0"
},
"Блюдо": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Айран (молочный напиток — кабардино-балкарское национальное блюдо) №731",
"Код": "00000000310",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Молочные и сливочные прохладительные напитки",
"Код": "00000000309",
"ЭтоГруппа": true,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Напитки",
"Код": "00000000007",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=ac2360a44c379a5b11e566724d4c46e0"
},
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec37ca294268"
},
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec37ca294269"
},
"ВидБлюда": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Код": null,
"Идентификатор": "e1cib/data/Справочник.дтВидыБлюд?ref=00000000000000000000000000000000"
},
"Количество": 1
},
{
"Рацион": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Обед",
"Код": "000000007",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "УслугиПитания",
"Наименование": "Услуги питания",
"Код": "000000003",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab41cc1f4634"
},
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab44727047d1"
},
"Блюдо": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Баранина отварная с овощами №396",
"Код": "00000000703",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Отварное мясо, субпродукты",
"Код": "00000000697",
"ЭтоГруппа": true,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Блюда из мяса и мясных продуктов",
"Код": "00000000010",
"ЭтоГруппа": true,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "БЛЮДА",
"Код": "9          ",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=9a4a60a44c379a5b11e936657263abfc"
},
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec34aacac6a2"
},
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec37d61e6be7"
},
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec37d61e6bed"
},
"ВидБлюда": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Код": null,
"Идентификатор": "e1cib/data/Справочник.дтВидыБлюд?ref=00000000000000000000000000000000"
},
"Количество": 1
}
]

БлюдаДляЗаказа

Доступные для заказа блюда.

Параметры:

  • Параметры: Структура, содержащая параметры:
    • НаДату: дата заказного меню.
    • ВариантПитания: вариант питания, по которому необходимо получить заказное меню.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=БлюдаДляЗаказа&Параметры={"НаДату": "04.03.2023", "ВариантПитания": {"Идентификатор": "e1cib/data/Справочник.НаборыУслуг?ref=9b7996e6d857ebf811e3a8f3d747934e"}}
Пример ответа
[
{
"Рацион": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Завтрак",
"Код": "000000006",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "УслугиПитания",
"Наименование": "Услуги питания",
"Код": "000000003",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab41cc1f4634"
},
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab44727047d0"
},
"ВидБлюда": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Код": null,
"Идентификатор": "e1cib/data/Справочник.дтВидыБлюд?ref=00000000000000000000000000000000"
},
"Блюдо": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Айран (молочный напиток — кабардино-балкарское национальное блюдо) №731",
"Код": "00000000310",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Молочные и сливочные прохладительные напитки",
"Код": "00000000309",
"ЭтоГруппа": true,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Напитки",
"Код": "00000000007",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=ac2360a44c379a5b11e566724d4c46e0"
},
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec37ca294268"
},
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec37ca294269"
},
"Количество": 1,
"МаксКоличество": null
},
{
"Рацион": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Завтрак",
"Код": "000000006",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "УслугиПитания",
"Наименование": "Услуги питания",
"Код": "000000003",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab41cc1f4634"
},
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab44727047d0"
},
"ВидБлюда": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Код": null,
"Идентификатор": "e1cib/data/Справочник.дтВидыБлюд?ref=00000000000000000000000000000000"
},
"Блюдо": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Апельсины с сахаром №630",
"Код": "00000000487",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Плоды и ягоды свежие и быстрозамороженные",
"Код": "00000000480",
"ЭтоГруппа": true,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Сладкие блюда",
"Код": "00000000341",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec37ca294288"
},
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec37d023d712"
},
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec37d023d719"
},
"Количество": 1,
"МаксКоличество": null
},
{
"Рацион": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Обед",
"Код": "000000007",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "УслугиПитания",
"Наименование": "Услуги питания",
"Код": "000000003",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab41cc1f4634"
},
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab44727047d1"
},
"ВидБлюда": {
"ПометкаУдаления": null,
"Предопределенный": null,
"ИмяПредопределенныхДанных": null,
"Наименование": null,
"Код": null,
"Идентификатор": "e1cib/data/Справочник.дтВидыБлюд?ref=00000000000000000000000000000000"
},
"Блюдо": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Баранина отварная с овощами №396",
"Код": "00000000703",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Отварное мясо, субпродукты",
"Код": "00000000697",
"ЭтоГруппа": true,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Блюда из мяса и мясных продуктов",
"Код": "00000000010",
"ЭтоГруппа": true,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "БЛЮДА",
"Код": "9          ",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=9a4a60a44c379a5b11e936657263abfc"
},
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec34aacac6a2"
},
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec37d61e6be7"
},
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec37d61e6bed"
},
"Количество": 1,
"МаксКоличество": null
},
{
"Рацион": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Ужин",
"Код": "000000008",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": true,
"ИмяПредопределенныхДанных": "УслугиПитания",
"Наименование": "Услуги питания",
"Код": "000000003",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab41cc1f4634"
},
"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab44727047d2"
},
"ВидБлюда": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Гарнир",
"Код": 5,
"Идентификатор": "e1cib/data/Справочник.дтВидыБлюд?ref=bf4e60a44c379a5b11e61cf626926640"
},
"Блюдо": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Баклажаны жареные №548",
"Код": "00000000671",
"ЭтоГруппа": false,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Гарниры из картофеля и овощей",
"Код": "00000000619",
"ЭтоГруппа": true,
"Родитель": {
"ПометкаУдаления": false,
"Предопределенный": false,
"ИмяПредопределенныхДанных": "",
"Наименование": "Гарниры",
"Код": "00000000601",
"ЭтоГруппа": true,
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec37d023d78b"
},
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec37d023d79d"
},
"Идентификатор": "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec37d61e6bcd"
},
"Количество": 1,
"МаксКоличество": null
}
]

тзУФО_Меню

Документ «Меню-раскладка» на дату.

Параметры:

  • Параметры: структура, содержащая:
    • Дата: дата меню.
    • ВариантПитания: вариант питания, для которого было составлено меню.
    • Диета: диета, для которой было составлено меню.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=тзУФО_Меню&Параметры={"Дата":"2023-03-17T00:00:00","Диета":"","ВариантПитания":{"Идентификатор":"e1cib/data/Справочник.НаборыУслуг?ref=9b7996e6d857ebf811e3a8f3d747934e"}}
Пример ответа
[
{
"Калорийность": 162.34,
"БелкиОбщ": 8.12,
"ЖирыОбщ": 0.68,
"УглевОбщ": 30.44,
"БелкиЖивотн": 0,
"ЖирыРаст": 0,
"ВитаминА": 0,
"ВитаминВ1": 0.27,
"ВитаминВ2": 0.34,
"ВитаминРР": 4.06,
"ВитаминС": 33.82,
"Железо": 2.71,
"Калий": 1609.83,
"Кальций": 101.46,
"Магний": 60.88,
"Натрий": 40.58,
"Фосфор": 229.98,
"МенюРаскладка": "Меню-раскладка 000000000000003 от 16.03.2023 (Основное требование)",
"Продукт": "Баклажаны (свежие)",
"Блюдо": "Баклажаны тушеные с помидорами в соусе \"Восточный\" №106",
"ВидБлюда": "Гарнир",
"ВыходФакт": 1000,
"ВыходБлюда": 1000,
"КоличествоПродуктаОборот": 2136,
"Рацион": "Завтрак",
"ПорядокРациона": "000000006",
"Брутто": 2136,
"Нетто": 2029.2,
"КоличествоПорций": 3,
"Коэффициент": "",
"ПлановоеМеню": "",
"ЕдиницаИзмеренияВБлюде": "г",
"фОбработана": true
},
{
"Калорийность": 674.25,
"БелкиОбщ": 0,
"ЖирыОбщ": 74.93,
"УглевОбщ": 0,
"БелкиЖивотн": 0,
"ЖирыРаст": 0,
"ВитаминА": 0,
"ВитаминВ1": 0,
"ВитаминВ2": 0,
"ВитаминРР": 0,
"ВитаминС": 0,
"Железо": 0,
"Калий": 0,
"Кальций": 0,
"Магний": 0,
"Натрий": 0,
"Фосфор": 1.5,
"МенюРаскладка": "Меню-раскладка 000000000000003 от 16.03.2023 (Основное требование)",
"Продукт": "Масло растительное",
"Блюдо": "Баклажаны тушеные с помидорами в соусе \"Восточный\" №106",
"ВидБлюда": "Гарнир",
"ВыходФакт": 1000,
"ВыходБлюда": 1000,
"КоличествоПродуктаОборот": 225,
"Рацион": "Завтрак",
"ПорядокРациона": "000000006",
"Брутто": 225,
"Нетто": 225,
"КоличествоПорций": 3,
"Коэффициент": "",
"ПлановоеМеню": "",
"ЕдиницаИзмеренияВБлюде": "г",
"фОбработана": true
},
{
"Калорийность": 134.4,
"БелкиОбщ": 6.16,
"ЖирыОбщ": 1.12,
"УглевОбщ": 21.28,
"БелкиЖивотн": 0,
"ЖирыРаст": 0,
"ВитаминА": 0,
"ВитаминВ1": 0.34,
"ВитаминВ2": 0.22,
"ВитаминРР": 2.97,
"ВитаминС": 140,
"Железо": 5.04,
"Калий": 1624,
"Кальций": 78.4,
"Магний": 112,
"Натрий": 16.8,
"Фосфор": 145.6,
"МенюРаскладка": "Меню-раскладка 000000000000003 от 16.03.2023 (Основное требование)",
"Продукт": "Помидоры свежие",
"Блюдо": "Баклажаны тушеные с помидорами в соусе \"Восточный\" №106",
"ВидБлюда": "Гарнир",
"ВыходФакт": 1000,
"ВыходБлюда": 1000,
"КоличествоПродуктаОборот": 1680,
"Рацион": "Завтрак",
"ПорядокРациона": "000000006",
"Брутто": 1680,
"Нетто": 1680,
"КоличествоПорций": 3,
"Коэффициент": "",
"ПлановоеМеню": "",
"ЕдиницаИзмеренияВБлюде": "г",
"фОбработана": true
},
{
"Калорийность": 0,
"БелкиОбщ": 0,
"ЖирыОбщ": 0,
"УглевОбщ": 0,
"БелкиЖивотн": 0,
"ЖирыРаст": 0,
"ВитаминА": 0,
"ВитаминВ1": 0,
"ВитаминВ2": 0,
"ВитаминРР": 0,
"ВитаминС": 0,
"Железо": 0,
"Калий": 0,
"Кальций": 0,
"Магний": 0,
"Натрий": 0,
"Фосфор": 0,
"МенюРаскладка": "Меню-раскладка 000000000000003 от 16.03.2023 (Основное требование)",
"Продукт": "Соус “Восточный”",
"Блюдо": "Баклажаны тушеные с помидорами в соусе \"Восточный\" №106",
"ВидБлюда": "Гарнир",
"ВыходФакт": 1000,
"ВыходБлюда": 1000,
"КоличествоПродуктаОборот": 600,
"Рацион": "Завтрак",
"ПорядокРациона": "000000006",
"Брутто": 600,
"Нетто": 600,
"КоличествоПорций": 3,
"Коэффициент": "",
"ПлановоеМеню": "",
"ЕдиницаИзмеренияВБлюде": "г",
"фОбработана": true
},
{
"Калорийность": 0,
"БелкиОбщ": 0.85,
"ЖирыОбщ": 0.07,
"УглевОбщ": 0,
"БелкиЖивотн": 0,
"ЖирыРаст": 0,
"ВитаминА": 0,
"ВитаминВ1": 0.01,
"ВитаминВ2": 0.01,
"ВитаминРР": 0.16,
"ВитаминС": 1.3,
"Железо": 0.2,
"Калий": 33.8,
"Кальций": 23.4,
"Магний": 3.9,
"Натрий": 2.21,
"Фосфор": 13,
"МенюРаскладка": "Меню-раскладка 000000000000003 от 16.03.2023 (Основное требование)",
"Продукт": "Чеснок",
"Блюдо": "Баклажаны тушеные с помидорами в соусе \"Восточный\" №106",
"ВидБлюда": "Гарнир",
"ВыходФакт": 1000,
"ВыходБлюда": 1000,
"КоличествоПродуктаОборот": 39,
"Рацион": "Завтрак",
"ПорядокРациона": "000000006",
"Брутто": 39,
"Нетто": 39,
"КоличествоПорций": 3,
"Коэффициент": "",
"ПлановоеМеню": "",
"ЕдиницаИзмеренияВБлюде": "г",
"фОбработана": true
},
{
"Калорийность": 166.5,
"БелкиОбщ": 12.58,
"ЖирыОбщ": 12.88,
"УглевОбщ": 0,
"БелкиЖивотн": 0,
"ЖирыРаст": 0,
"ВитаминА": 0,
"ВитаминВ1": 0.04,
"ВитаминВ2": 0.15,
"ВитаминРР": 3.48,
"ВитаминС": 0,
"Железо": 2,
"Калий": 240.5,
"Кальций": 6.66,
"Магний": 16.28,
"Натрий": 48.1,
"Фосфор": 139.12,
"МенюРаскладка": "Меню-раскладка 000000000000003 от 16.03.2023 (Основное требование)",
"Продукт": "Говядина (вырезка)",
"Блюдо": "Биточки говяжьи паровые №475",
"ВидБлюда": "Первые блюда",
"ВыходФакт": 100,
"ВыходБлюда": 100,
"КоличествоПродуктаОборот": 303,
"Рацион": "Обед",
"ПорядокРациона": "000000007",
"Брутто": 303,
"Нетто": 222,
"КоличествоПорций": 3,
"Коэффициент": "",
"ПлановоеМеню": "",
"ЕдиницаИзмеренияВБлюде": "г",
"фОбработана": true
},
{
"Калорийность": 26.44,
"БелкиОбщ": 0.03,
"ЖирыОбщ": 2.9,
"УглевОбщ": 0.05,
"БелкиЖивотн": 0,
"ЖирыРаст": 0,
"ВитаминА": 0.02,
"ВитаминВ1": 0,
"ВитаминВ2": 0,
"ВитаминРР": 0,
"ВитаминС": 0,
"Железо": 0.01,
"Калий": 1.2,
"Кальций": 0.96,
"Магний": 0,
"Натрий": 0.6,
"Фосфор": 1.2,
"МенюРаскладка": "Меню-раскладка 000000000000003 от 16.03.2023 (Основное требование)",
"Продукт": "Масло сливочное",
"Блюдо": "Биточки говяжьи паровые №475",
"ВидБлюда": "Первые блюда",
"ВыходФакт": 100,
"ВыходБлюда": 100,
"КоличествоПродуктаОборот": 12,
"Рацион": "Обед",
"ПорядокРациона": "000000007",
"Брутто": 12,
"Нетто": 12,
"КоличествоПорций": 3,
"Коэффициент": "",
"ПлановоеМеню": "",
"ЕдиницаИзмеренияВБлюде": "г",
"фОбработана": true
},
{
"Калорийность": 13.86,
"БелкиОбщ": 0.66,
"ЖирыОбщ": 0.77,
"УглевОбщ": 1.03,
"БелкиЖивотн": 0,
"ЖирыРаст": 0,
"ВитаминА": 0,
"ВитаминВ1": 0,
"ВитаминВ2": 0.03,
"ВитаминРР": 0.02,
"ВитаминС": 0.13,
"Железо": 0.02,
"Калий": 32.12,
"Кальций": 26.62,
"Магний": 3.08,
"Натрий": 11,
"Фосфор": 20.02,
"МенюРаскладка": "Меню-раскладка 000000000000003 от 16.03.2023 (Основное требование)",
"Продукт": "Молоко",
"Блюдо": "Биточки говяжьи паровые №475",
"ВидБлюда": "Первые блюда",
"ВыходФакт": 100,
"ВыходБлюда": 100,
"КоличествоПродуктаОборот": 66,
"Рацион": "Обед",
"ПорядокРациона": "000000007",
"Брутто": 66,
"Нетто": 66,
"КоличествоПорций": 3,
"Коэффициент": "",
"ПлановоеМеню": "",
"ЕдиницаИзмеренияВБлюде": "г",
"фОбработана": true
},
{
"Калорийность": 42.3,
"БелкиОбщ": 1.42,
"ЖирыОбщ": 0.18,
"УглевОбщ": 8.69,
"БелкиЖивотн": 0,
"ЖирыРаст": 0,
"ВитаминА": 0,
"ВитаминВ1": 0.03,
"ВитаминВ2": 0.01,
"ВитаминРР": 0.29,
"ВитаминС": 0,
"Железо": 0.36,
"Калий": 23.94,
"Кальций": 4.14,
"Магний": 5.94,
"Натрий": 68.04,
"Фосфор": 15.66,
"МенюРаскладка": "Меню-раскладка 000000000000003 от 16.03.2023 (Основное требование)",
"Продукт": "Хлеб пшеничный",
"Блюдо": "Биточки говяжьи паровые №475",
"ВидБлюда": "Первые блюда",
"ВыходФакт": 100,
"ВыходБлюда": 100,
"КоличествоПродуктаОборот": 54,
"Рацион": "Обед",
"ПорядокРациона": "000000007",
"Брутто": 54,
"Нетто": 54,
"КоличествоПорций": 3,
"Коэффициент": "",
"ПлановоеМеню": "",
"ЕдиницаИзмеренияВБлюде": "г",
"фОбработана": true
},
{
"Калорийность": 307.57,
"БелкиОбщ": 15.38,
"ЖирыОбщ": 1.28,
"УглевОбщ": 57.67,
"БелкиЖивотн": 0,
"ЖирыРаст": 0,
"ВитаминА": 0,
"ВитаминВ1": 0.51,
"ВитаминВ2": 0.64,
"ВитаминРР": 7.69,
"ВитаминС": 64.08,
"Железо": 5.13,
"Калий": 3050.09,
"Кальций": 192.23,
"Магний": 115.34,
"Натрий": 76.89,
"Фосфор": 435.73,
"МенюРаскладка": "Меню-раскладка 000000000000003 от 16.03.2023 (Основное требование)",
"Продукт": "Баклажаны (свежие)",
"Блюдо": "Баклажаны жареные №548",
"ВидБлюда": "Гарнир",
"ВыходФакт": 1000,
"ВыходБлюда": 1000,
"КоличествоПродуктаОборот": 4047,
"Рацион": "Ужин",
"ПорядокРациона": "000000008",
"Брутто": 4047,
"Нетто": 3844.65,
"КоличествоПорций": 3,
"Коэффициент": "",
"ПлановоеМеню": "",
"ЕдиницаИзмеренияВБлюде": "г",
"фОбработана": true
},
{
"Калорийность": 539.4,
"БелкиОбщ": 0,
"ЖирыОбщ": 59.94,
"УглевОбщ": 0,
"БелкиЖивотн": 0,
"ЖирыРаст": 0,
"ВитаминА": 0,
"ВитаминВ1": 0,
"ВитаминВ2": 0,
"ВитаминРР": 0,
"ВитаминС": 0,
"Железо": 0,
"Калий": 0,
"Кальций": 0,
"Магний": 0,
"Натрий": 0,
"Фосфор": 1.2,
"МенюРаскладка": "Меню-раскладка 000000000000003 от 16.03.2023 (Основное требование)",
"Продукт": "Масло растительное",
"Блюдо": "Баклажаны жареные №548",
"ВидБлюда": "Гарнир",
"ВыходФакт": 1000,
"ВыходБлюда": 1000,
"КоличествоПродуктаОборот": 180,
"Рацион": "Ужин",
"ПорядокРациона": "000000008",
"Брутто": 180,
"Нетто": 180,
"КоличествоПорций": 3,
"Коэффициент": "",
"ПлановоеМеню": "",
"ЕдиницаИзмеренияВБлюде": "г",
"фОбработана": true
},
{
"Калорийность": 165,
"БелкиОбщ": 5.3,
"ЖирыОбщ": 0.65,
"УглевОбщ": 34.5,
"БелкиЖивотн": 0,
"ЖирыРаст": 0,
"ВитаминА": 0,
"ВитаминВ1": 0.13,
"ВитаминВ2": 0.04,
"ВитаминРР": 1.1,
"ВитаминС": 0,
"Железо": 1.05,
"Калий": 89,
"Кальций": 12,
"Магний": 22,
"Натрий": 2,
"Фосфор": 57.5,
"МенюРаскладка": "Меню-раскладка 000000000000003 от 16.03.2023 (Основное требование)",
"Продукт": "Мука пшеничная",
"Блюдо": "Баклажаны жареные №548",
"ВидБлюда": "Гарнир",
"ВыходФакт": 1000,
"ВыходБлюда": 1000,
"КоличествоПродуктаОборот": 150,
"Рацион": "Ужин",
"ПорядокРациона": "000000008",
"Брутто": 150,
"Нетто": 150,
"КоличествоПорций": 3,
"Коэффициент": "",
"ПлановоеМеню": "",
"ЕдиницаИзмеренияВБлюде": "г",
"фОбработана": true
}
]

ЗаказатьБлюда

Создание документа «Задача» в процессе «Заказ питания».

Тело запроса (обязательные параметры):

  • Заявитель: карта гостя заказчик блюд.
  • НаДату: срок исполнения заказа.
  • мсБлюда: массив структур с блюдами для заказа, содержащих:
    • Услуга: услуга (рацион).
    • Потребность: блюдо для заказа.
    • Количество: количество блюда для заказа.
Пример вызова
http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ЗаказатьБлюда

Тело запроса:

{
"Заявитель": {"Идентификатор": "e1cib/data/Документ.КартаГостя?ref=94fea85e4511756911edc2fdd62e6acd"},
"НаДату": "2023-03-22T00:00:00",
"мсБлюда": [
{
"Услуга": {"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab44727047d0"},
"Потребность": {"Идентификатор" : "e1cib/data/Справочник.Номенклатура?ref=91b56451060d98bd11e5ec381c250734"},
"Количество": 1 
},
{
"Услуга": {"Идентификатор": "e1cib/data/Справочник.Услуги?ref=bd4860a44c379a5b11e3ab44727047d2"},
"Потребность": {"Идентификатор" : "e1cib/data/Справочник.дтБлюда?ref=91b56451060d98bd11e5ec37ee03fce4"},
"Количество": 2
}
]
}
Пример ответа
{
"Success": true,
"Result": true,
"Messages": []
}

Соответствие имен реквизитов

Внутренний Внешний
Наименование Name
Код Code
Идентификатор ID
Контрагент Client
ОписаниеОшибки Error
НомерГостиницы Room
КатегорияНомера RoomCategory
Дата Date
Номер Number
НачалоПериода DateFrom
КонецПериода DateTo
Количество Qty
ОрганизацияПребывания Sanatorium
Состояние Status
ПредварительноЗабронировано Booked
Подтверждено Processed
Отказано Denied
ОсталосьОбработать ToProcess
ПричинаОтказа DenyReason
Заявка Booking
Файл File
КоличествоДней Days
ОрганизацияПребывания OrganizationOfStay
Семья Family
Гости Guests
Пол Sex
СтепеньРодства Relation
АдресРегистрации RegAddress
ДатаРождения BirthDate
НомерСНИЛС SNILS
Категория Category
МестоРождения Birthplace
Гражданство Citizenship
стрМестоРаботы PlaceOfWork
стрДолжность Position
ИдентификаторФИАС FIAS_ID
Дом House
Корпус Block
Квартира Flat
ПочтовыйИндекс ZipCode
стрДопСвойства AdditionalProperties
ПечатнаяФорма PrintForm
Квота QuotaID
Продавец Agent
Прайс Price
КатегорияПутевки VoucherCategory
Справка MedicalCertificate
ЛечебноеУчреждение MedicalInstitution
ДиагнозНаправившегоУчреждения MKB10
ДатаВходящегоДокумента InboundDate
НомерВходящегоДокумента InboundNumber

Коды ошибок

Код ошибки (ErrorCode) Описание
1020 Ошибка создания документа «Заявка» методом PostBooking
1021 Ошибка обработки файлов, приложенных к заявке или справке.
1025 Не найдена заявка по ссылке при запросе статуса методом GetBookingStatus.
1030 Не найдена заявка по ссылке при отказе методом CancelBooking.
1031 Ошибка установки пометки заявки на удаление методом CancelBooking.
1032 Ошибка выполнения отказа по заявке методом CancelBooking.
1033 Ошибка снятия брони по подтвержденной заявке методом CancelBooking.

Учет. Анализ. Управление

Методы

PostDocument

Создание документов переданного вида. Обязательный параметр: Вид - имя документа в дереве метаданных или имя предопределенного элемента справочника яъВидыДокументов (для документов, которые делятся на несколько видов, например документ яъЗаказ).

Поддерживаются следующие виды:

  • яъЗаказПокупателя
  • яъЗаказПоставщику
  • яъЗаказНаПроизводство
  • ОплатаПлатежнойКартой
  • ПриходныйКассовыйОрдер
  • ПоступлениеНаРасчетныйСчет
  • _ПеремещениеРастений
  • ПеремещениеРезервов
  • ИзменениеХарактеристик

Реквизиты документа передаются в теле запроса, для успешного создания и проведения документа должны быть заполнены все реквизиты с типом проверки заполнения Выдавать ошибку. Номер и дата документа заполняются автоматически, если не переданы в запросе. Если в запросе передается номер документа, он должен быть уникальным в пределах информационной базы. Ссылочные реквизиты передаются JSON-структурой с одним из ключевых полей: ID или GUID, значения реквизитов (элементы справочников) должны быть предварительно созданы в информационной базе вручную или методом PostElement.

Пример создания заказа покупателя
/PostData?Method=PostDocument&Вид=яъЗаказПокупателя

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

Если передан параметр СкладРезервирования, товары заказа будут автоматически зарезервированы на переданном складе. Параметр может быть передан в реквизитах шапки или в табличной части:

  • Если склад указан в табличной части - используется склад из табличной части
  • Если склад не указан в табличной части - используется склад шапки
  • Если склад не указан ни в шапке ни в табличной части - товар не резервируется
Тело запроса
{
"Организация": {
"GUID": "8a276db6-ce58-11e5-982d-14dae9b19a48"
},
"идИнтернетЗаказа": "0001",
"Дата": "2020-01-01T00:00:00",
"ОплатаПлатежнойКартой": {
"СуммаДокумента": 500,
"ВидОплаты": {
"ID": "e1cib/data/Справочник.ВидыОплатОрганизаций?ref=98165404a66e4a8111e879fee15001c2"
}
},
"СкладРезервирования": {
"ID": "e1cib/data/Справочник.Склады?ref=8b25a0661889f40541be854e00d95269"
},
"Контрагент": {
"GUID": "3cc7dcfa-930d-11df-b942-001bfc345421"
},
"Товары": [
{
"Номенклатура": {
"GUID": "2b82b757-366b-11e9-982b-5404a66e4a81"
},
"Количество": 10,
"Цена": 150,
}
],
"ДополнительныеСвойства": [
{
"Свойство": "СуммаДоставки",
"Значение": 100
}
]
}
Пример ответа
{
"Success": true,
"Result": {
"Дата": "2020-01-01T00:00:00",
"Номер": "0000--000000045",
"Идентификатор": "e1cib/data/Документ.яъЗаказ?ref=98485404a66e4a8111eaa099a5a5b36d"
}
}

Изменение документов

Для вида документа «яъЗаказПокупателя» поддерживается изменение реквизитов. Для этого в тело запроса необходимо передать параметр Идентификатор (идентификатор заказа возвращается при успешном выполнении метода PostDocument). Реквизиты для изменения рекомендуется передавать в параметре «стРеквизиты», а не в теле запроса, так как реквизиты из тела запроса не всегда изменяются при вызове обработки заполнения документа. Если в запросе передана таблица товаров, позиции будут добавлены к существующим, если позиция уже есть в заказе, будет увеличено количество в строке. Если в запросе передан параметр Режим со значением УдалениеТоваров, количество товара будет уменьшено. В случае, если количество стало меньше или равно нулю, строка из заказа будет удалена. Данный функционал доступен начиная с версии 3.24.04.

Пример запроса для изменения реквизитов «Контрагент» и «Договор»
{
  "Идентификатор": "e1cib/data/Документ.яъЗаказ?ref=bca9d85ed320709611ef2232d2aed537",
  "стРеквизиты": {
    "Контрагент": {
      "Идентификатор": "e1cib/data/Справочник.Контрагенты?ref=9a58f2e8cf1cc29211ea4d76137ec466"
    },
    "ДоговорКонтрагента": {
      "Идентификатор": "e1cib/data/Справочник.ДоговорыКонтрагентов?ref=bca6d85ed320709611eeb4f2fc6d1fb8"
    }
  }
}
Пример запроса для уменьшения количества номенклатуры
{
  "Идентификатор": "e1cib/data/Документ.яъЗаказ?ref=9d415404a66e4a8911ef224f2be07e9b",
  "Режим": "УдалениеТоваров",
  "Товары": [
    {
      "Номенклатура": {
        "GUID": "2b82b757-366b-11e9-982b-5404a66e4a81"
      },
      "Количество": "10"
    }
  ]
}

Коды ошибок

Код ошибки (ErrorCode) Описание
3000 В параметрах не передан вид создаваемого документа.
3001 В параметрах передан вид документа, не поддерживаемый методом.
3002 Не удалось записать созданный документ.
3003 Передан вид документа, отсутствующий в конфигурации.
3004 Не удалось зарезервировать товары заказа покупателя.

Историй изменений, ссылки сюда