E1cib data задача задачаисполнителя

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

Чтобы произвести начальные настройки уведомлений в системе, администратору необходимо в разделе «Настройка и администрирование» перейти в меню «Настройки программы-Общие настройки программы».

Рис.1 Настройки программыРис.2 Общие настройки программы

Далее нужно проставить признак «Использовать уведомления».

Рис.3 Признак Использовать уведомления

Для непосредственно настройки самих уведомлений нужно перейти по ссылке «Настроить».

Рис.4 Настройка уведомлений по умолчанию

На первой вкладке рабочего места настроек уведомлений по умолчанию настраиваются виды событий, по которым требуется уведомления тем или иным способом. Способов отправки в системе существует три: отправка уведомлений на почту электронным письмом, всплывающим окном и СМС-сообщением.

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

Электронное письмо

Рис.5 Электронное письмо

Из письма сразу можно перейти к предмету уведомления – в данном случае откроется окно задачи в веб-браузере.

СМС-уведомление

Рис.6 СМС-уведомление

Из СМС-уведомления также можно перейти к задаче в мобильном браузере.

Всплывающее окно системы

Рис.7 Всплывающее окно системы

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

Частоту и сроки уведомлений необходимо настраивать на второй вкладке рабочего места.

Рис.8 Частота и сроки уведомлений

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

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

Рис.9 Способы уведомлений для пользователей

На следующей вкладке «Отправка СМС» указываются настройки взаимодействия с СМС-провайдером.

Рис.10 Отправка СМС

На вкладке «Дополнительные настройки» включается функционал «Выполнение задач по почте».

Рис.11 Дополнительные настройки

Тут же указывается адрес публикации СЭД на веб-сервере, устанавливается разрешение пользователям изменять настройки уведомлений индивидуально для себя, а также есть возможность выставленные настройки по умолчанию установить сразу всем пользователям системы, сбросив их индивидуальные изменения уведомлений.

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

Рис.12 Персональные настройки

Выбираем пункт «Уведомления».

Рис.13 Пункт Уведомления

Настройки практически полностью идентичны настройкам по умолчанию, за исключением СМС-уведомлений – ими может управлять только администратор системы.

Рис.14 Заполнение настроек уведомлений

Но как быть, если 1С:Документооборот на веб-сервере не опубликован, и по ссылкам в уведомлениях ничего не открывается?

Да, ссылки формата e1cib/data/Задача.ЗадачаИсполнителя?ref=b7e… по умолчанию в операционной системе не открываются. ОС не может ассоциировать данные виды ссылок с необходимым приложением – платформой 1С.

Давайте исправим эту недоработку. Для этого необходимо произвести небольшие изменения в реестре Windows: готовим файл скрипта – текстовый файл с расширением .reg. Содержание файла должно быть следующим:

Windows Registry Editor Version 5.00 «URL Protocol»=»e1cb» @=»URL:e1cb» @=»C:\\Program Files (x86)\\1cv8\\common\\1cestart.exe,0″ @=»\»C:\\Program Files (x86)\\1cv8\\common\\1cestart.exe\» ENTERPRISE /S\»ServerName:Port\\Database_Name\» /URL \»%1\»»

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

Рис.15 Редактор реестра

Соглашаемся и вносим изменения в реестр Windows.

Рис.16 Сообщение о внесении в реестр изменений

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

Учебный курс: Подготовка на 1С:Специалист по платформе 1С:Предприятие 8.3

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

Существует другой вариант – можно отправить пользователю ссылку на документ, перейдя по которой сразу откроется форма этого документа. Таким образом, не нужно будет тратить время на поиск объекта в базе, что ускорит процесс обработки информации.

В платформе «1С:Предприятие» существует возможность получить ссылку на конкретный объект информационной базы (элемент справочника, документ, запись регистра сведений, отчет, обработку и так далее).

Для этого в окне соответствующего объекта нужно нажать кнопку «Получить ссылку»:

Рисунок 1 – Кнопка «Получить ссылку»

Окно получение ссылки выглядит следующим образом:

Рисунок 2 – Ссылка на элемент справочника «Номенклатура»

Ссылки системы «1С:Предприятие» начинаются с символов «e1c», что позволяет отличить их от других ссылок (например, от ссылок на веб-страницы, начинающихся с http, ссылок на FTP-сервера, начинающихся с ftp).

Ссылки в платформе «1С:Предприятие» бывают разных типов:

  • Ссылка на список, например, e1cib/list/Справочник.Номенклатура
  • Ссылка на объект базы, например, e1cib/data/Справочник.Номенклатура?ref=ba5694de806096e911e720efee9ad069
  • Ссылка на отчет, например, e1cib/app/Отчет.ТоварыНаСкладах
  • Ссылка на обработку, например, e1cib/app/Обработка.КонсольЗапросов
  • Некоторые другие (ссылка на реквизит объекта, ссылка на запись регистра, ссылка на временное хранилище и т.д.).

Полученную ссылку можно скопировать в буфер обмена, отправить другому пользователю по почте. Чтобы открыть объект по ссылке, нужно в области системных команд главного окна (справа) «1С:Предприятие» нажать на кнопку Перейти по ссылке:

Рисунок 3 – Кнопка «Перейти по ссылке»

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

Рисунок 4 – Переход по ссылке

Более подробно работа с навигационными ссылками рассматривается в курсе Профессиональная разработка интерфейсов и форм в 1С:Предприятие 8.3 (см. Занятие 24).

Умение работать со ссылками в системе «1С:Предприятие» проверяется на экзамене. Ниже рассматривается пример подобной задачи:

В документе РасходнаяНакладная присутствует реквизит Комментарий, где пользователь может сохранить произвольные заметки по документу. В комментарии может содержаться навигационная ссылка на документ информационной базы. Например, это может быть ссылка на документ Счет на оплату, по которому была оформлена отгрузка.

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

Рисунок 5 – Использование навигационной ссылки в комментарии

Рассмотрим, как решить поставленную задачу. Предварительно создадим в каркасной конфигурации недостающий документ СчетНаОплату.

К сожалению, у Вас недостаточно прав для дальнейшего просмотра.

Если Вы приобрели курс, но еще не активировали токен — пожалуйста, активируйте доступ по инструкциям, высланным на Ваш email после покупки.

Если Вы не залогинены на сайте — залогиньтесь, вернитесь на эту страницу и обновите ее.

Если Вы залогинены, у Вас активирован токен доступа, но Вы все равно видите эту запись — напишите нам на e-mail поддержки.

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

При вызове любой операции необходимо передать имя метода — это предопределенный параметр http-запроса Method.

Ответ в формате JSON, Content-Type: application/json;charset=utf-8

Ответ содержит два поля: Success — флаг успешности выполнения и Result — результат выполнения, обычно структура.

Вызов GET запроса http://127.0.0.1/имя_публикации/hs/KintAPI.hs/GetData?Method=ИмяМетода Вызов POST запроса http://127.0.0.1/имя_публикации/hs/KintAPI.hs/PostData?Method=ИмяМетода

Для 1С важен регистр букв при написании адреса запроса. Например, обращение по адресу /hs/kintapi.hs/ выдаст ошибку HTTP ERROR 404.

Пример ответа с ошибкой:

{ «Success»: false, «Result»: { «Error»: «Метод конфигурации <ИмяМетода> не найден!» } }

Для поиска любых ссылочных объектов используется одно из ключевых полей: ID или GUID.

  • ID — это навигационная ссылка на объект в базе 1С: Предприятия (e1cib/data/Справочник.НоменклатураПомещений?ref=b4585404a66e4a8911e8bb0449fde0fc),
  • GUID — это уникальный идентификатор ссылки (49fde0fc-bb04-11e8-b458-5404a66e4a89).

При передаче параметров в запросах достаточно указать одно из этих полей:

?RoomCategory=

Если в параметрах переданы оба поля, приоритет за полем ID. Следует учесть, что поиск по ID примерно на 50% быстрее поиска по GUID.

Файлы приложений передаются в формате base64.

Если в параметрах GET запроса передан список доп. свойств, в результат запроса результат будут добавлены значения дополнительных свойств объектов. Список свойств передается через запятую без пробелов. В 1С это поле Код доп. свойства.

?Method=GetCatalog&CatalogName=НоменклатураПомещений&AdditionalProperties=ДопОрганизация,СуммаПредоплаты

Если в результате запроса требуется получить реквизиты ссылочных объектов, можно добавить в параметры запросе перечень требуемых реквизитов через запятую. Функция работает рекурсивно, для всех ссылочных объектов в ответе сервера.

&Fields=ОрганизацияПребывания,Прайс,Контрагент

Авторизация

Для подключения к базе-источнику требуется ввести имя и пароль пользователя базы данных: пользователь должен быть добавлен в список пользователей информационной базы.

Возможно два варианта обращения к базе:

  • Использовать стандартную HTTP авторизацию: developer.mozilla.org/ru/docs/Web/HTTP/Авторизация.
  • Настройка публикации для подключения под определенным пользователем. В этом варианте публикации запрос авторизации базой-источником не выполняется. Описание настройки файла публикации доступно в статье ИТС.

Рекомендуется использовать только для публикации HTTP-сервисов. В противном случае подключиться к базе в режиме «1С: Предприятие» сможет любой пользователь, который знает адрес публикации.

Общие методы

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

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

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

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

  • Fields (стрРеквизиты): список реквизитов через запятую;
  • Filter (Отбор): отбор в виде json с идентификаторами объектов;

Пример вызова /GetData?Method=GetCatalog&CatalogName=Организации&Fields=Ссылка,ИНН,КПП&Filter={«ГоловнаяОрганизация»: {«ID»: «e1cib/data/Справочник.Организации?ref=b72f90e6baabdd1411e271b038722897»}} Пример вызова с отбором /GetData?Method=GetCatalog&CatalogName=Организации&Fields=Ссылка,ИНН,КПП&Filter={«ГоловнаяОрганизация»:%20{«ID»:»e1cib/data/Справочник.Организации?ref=ad5c5404a66e4a8911e37e83f3ef6892″}} Пример ответа { «Success»: true, «Result»: }

GetDBInfo (ДанныеИБ)

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

Пример вызова /GetData?Method=GetDBInfo Пример ответа { «Success»: true, «Result»: { «ВерсияAPI»: «1.1», «НомерРелиза»: «20.06.03» } }

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

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

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

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

Параметры:

  • Объект (GUID, обязательный) — для кого получаем значение параметра
  • ПечатнаяФорма (GUID, не обязательный только в случае получения значения параметра) — может использоваться для расширения списка параметров. Без печатной формы список параметров может быть ограничен.
  • ТипФайла (не обязательный только в случае получения значения параметра) — доступны значения: DOCX, HTML5, MXL, PDF, TXT, XLS
  • ИмяПараметра (Строка, не обязательный) — если передан, то вернется не печатная форма, а значение переданного параметра. По умолчанию доступны параметры на вкладках «Основные» + «Доступные» + «Дополнительные» в форме настройки печатной формы.

Пример вызова /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 } }

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

GetRoomQuota

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

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

  • RoomCategory: если требуется получить данные по определенной категории(ям) номеров;
  • 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»: }

GetAvailableRooms

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

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

  • Qty — количество мест в одном номере. Будут подобраны все номера где есть требуемое количество свободных мест. Если не передан — будут подобраны все доступные номера.
  • Vacant: если передано значение true — будут подобраны только полностью свободные номера;
  • RoomCategory: если требуется получить данные по определенной категории(ям) номеров;
  • Room: проверка доступности определенного номера гостиницы;
  • OrganizationOfStay: если требуется получить номера, привязанные к определенной организации (актуально для баз в которых ведется учет по нескольким организациям)
  • QuotaID: поиск номеров, привязанных к определенной квоте;

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

Пример вызова 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»: }

PostBooking

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

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

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

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

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

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

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

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

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

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

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

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

Пример вызова http://127.0.0.1/имя_публикации/hs/KintAPI.hs/PostData?Method=PostBooking Тело запроса (параметры в шапке) { «Client»: { «Name»: «Иванов Иван Иванович», «BirthDate»: «1980-11-11T00:00:00», «Sex»: «М», «RegAddress»: {} }, «Guests»: , «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»: «Иванов Иван Иванович», «BirthDate»: «1980-11-11T00:00:00», «Sex»: «М», «RegAddress»: {} }, «Guests»: , «OrganizationOfStay»: { «ID»: «e1cib/data/Справочник.Организации?ref=8e8150e54935bd5411e25bc6880bb616» } } Пример ответа { «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…» }

Дополнительные свойства

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

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

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

GetBookingStatus

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

Запрос содержит один обязательный параметр Booking.

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

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

Пример вызова /GetData?Method=GetBookingStatus&Booking= Пример ответа { «Success»: true, «Result»: }

GetBookingList

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

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

CancelBooking

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

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

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

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

Пример вызова /PostData?Method=CancelBooking&DenyReason={«GUID»: «21b146ad-cad2-11e8-9a46-60a44c379a5b»} Тело запроса Пример ответа { «Success»: true, «Result»: }

GetPrice

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

Параметры:

  • ВидЦен/PriceType, не обязательный. Если не задан — будет получена «Цена брони» (Проживание + Лечение + Питание). Для получения цены по варианту пребывания необходимо передать один из идентификаторов: «ЦенаПроживания», «ЦенаЛечения», «ЦенаПитания».
  • Контекст/Context (Структура) — любые параметры которые будут участвовать при расчете цены. Чем полнее контекст, тем точнее будет расчет стоимости.
  • Расшифровка — вернет таблицу расшифровки стоимости с учетом скидок по вариантам пребывания.

Пример вызова /GetData?Method=GetPrice&Контекст={«КатегорияНомера»:%20{«GUID»:%20″0eaeea25-4074-11e3-8857-5404a66e4a89″}} Пример вызова с расшифровкой /GetData?Method=GetPrice&Контекст={«КатегорияНомера»:%20{«GUID»:%20″0eaeea25-4074-11e3-8857-5404a66e4a89″}}&Расшифровка=Истина Пример ответа { «Success»: true, «Result»: 1500 }

CheckGuest

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

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

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

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

Пример вызова /GetData?Method=CheckGuest&Отбор={«ДатаЗаезда»:»2020-07-15T00:00:00″,»Физлицо_ДатаРождения»:»1949-01-23T00:00:00″,»НаДату»:»2020-07-28T00:00:00″} Пример ответа { «Success»: true, «Result»: false }

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

Внутренний Внешний
Наименование 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

Коды ошибок

Если при выполнении метода сервиса возникли ошибки, в ответ сервера, помимо расшифровки ошибки, будет добавлен код ошибки. Пример ответа:

{ «Success»: false, «Result»: { «Error»: «Метод конфигурации <ИмяМетода> не найден!», «ErrorCode»: «1000» } }

Код ошибки (ErrorCode) Описание
1000 Передано некорректное или не существующее имя метода
1001 Переданы некорректные параметры запроса
1002 Передан некорректный текст POST запроса
1010 Внутренняя ошибка конфигурации, при возникновении ошибки напишите об этом на spp@kint.ru
1020 Ошибка создания документа «Заявка» методом PostBooking
1021 Ошибка обработки файлов, приложенных к заявке или справке.
1025 Не найдена заявка по ссылке при запросе статуса методом GetBookingStatus.
1030 Не найдена заявка по ссылке при отказе методом CancelBooking.
1031 Ошибка установки пометки заявки на удаление методом CancelBooking.
1032 Ошибка выполнения отказа по заявке методом CancelBooking.
1033 Ошибка снятия брони по подтвержденной заявке методом CancelBooking.

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

PostDocument

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

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

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

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

Пример создания заказа покупателя /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» }, «Контрагент»: { «Наименование»: «Иванов Иван Иванович», «ИНН»: «»111111111111″», «GUID»: «3cc7dcfa-930d-11df-b942-001bfc345421» }, «Товары»: , «ДополнительныеСвойства»: } Пример ответа { «Success»: true, «Result»: { «Дата»: «2020-01-01T00:00:00», «Номер»: «0000—000000045», «Идентификатор»: «e1cib/data/Документ.яъЗаказ?ref=98485404a66e4a8111eaa099a5a5b36d» } }

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

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *