Получение онлайн-заявок из Google Таблицы (КУС) — различия между версиями

Материал из КинтВики
Перейти к: навигация, поиск
м
(Настройка)
 
(не показаны 33 промежуточные версии 9 участников)
Строка 1: Строка 1:
[[Категория:Продажа и бронирование (КУС)]][[Категория:Обмен данными (КУС)]][[Категория:Обработки (КУС)]]
+
<noinclude>[[Категория:Продажа и бронирование (КУС)|*11]][[Категория:Обмен данными (КУС)|*25]][[Категория:Обработки (КУС)]][[Категория:Загрузка данных (КУС)]]</noinclude>
 +
Существует возможность создать Google-форму для приема Заявок от Гостей или Агентов. Эта форма может собирать ответы в связанную с ней Google Таблицу. И в КУС будут создаваться документы «Заявка» по каждой строчке из таблицы.
 +
Также ее можно использовать для массовой загрузки броней в базу.
 +
{{video|[https://youtu.be/85-OVh-XJo4 Загрузка брони из google-таблицы]}}
 +
= Настройка =
 +
* Пример таблицы: https://docs.google.com/spreadsheets/d/1XUn-Ea7AyEF1c4ZjUdb9g00keHTsgTahWBokIMjYbec/edit#gid=390831340
 +
** ID таблицы в этом примере: 1XUn-Ea7AyEF1c4ZjUdb9g00keHTsgTahWBokIMjYbec
 +
* Уровень доступа к таблице должен быть «Для всех, кто имеет ссылку» — «Редактировать». Так как КУС подключается без авторизации, под анонимным пользователем по ссылке и заполняет колонку ДатаВыгрузки.
 +
* Также можно добавить права на редактирование таблице для почтового адреса '''kus.robot@gmail.com'''.
 +
* Необходимо указать ID таблицы в интерфейсе «Администратор системы» на закладке '''Интернет-сервисы''' в разделе «Онлайн заявки»:
 +
*: [[Файл:Настройка онлайн заявок.png]]
 +
После этого необходимо зайти в "Бронирование" и выбрать пункт "Загрузить онлайн-заявки"
 +
    [[Файл:Загрузить заявки.png]]
  
= Настройка =
 
 
== Правила оформления Google Таблицы ==
 
== Правила оформления Google Таблицы ==
* В первой строке может быть написано что-угодно, это поле для заголовков вопросов.
+
* В первой строке может быть написано что угодно, это поле для заголовков вопросов.
* Во второй строке — технические названия полей. Названия должны быть как в Конфигураторе.
+
* Во второй строке — технические названия полей.
* Во второй строке не должно быть пустых значений. Там должно быть хоть что-то. Если он найдет по названию параметр в заявке — он его заполнит. Если нет — пропустит.
+
** Названия должны быть как в разделе «Доступные параметры» ниже.
* Отправка заявок работает по колонкам:
+
** Не должно быть пустых значений. В ячейке должно быть написано хоть что-то. Если программа найдет параметр по названию в заявке — она его заполнит. Если нет — пропустит.
** ДатаСоздания — это дата и время создания строчки в таблице.
+
** Название поля не должно начинаться с символа, только с буквы.
** ДатаВыгрузки — это дата и время выгрузки строчки в КУС.
+
* Отправка заявок работает по двум колонкам:
* По одной строчке создается 1 заявка.
+
** ДатаСоздания — это дата и время создания строчки в таблице. В данной ячейке необходимо добавить дату.
 +
** ДатаВыгрузки — это дата и время выгрузки строчки в КУС. Данная ячейка добавляется автоматически. '''Колонка является обязательной для работы'''.
 +
* По одной строке из Google Таблицы создается одна заявка.
 +
* Если в колонках нет критичных для бронирования параметров (например КатегорииНомера), то Заявка создастся, но будет в статусе «Черновик» (не проведена).
 +
* Если КУС определит заголовок таблицы (например, КатегорияНомера) — то он заполнит соответствующий реквизит в документе «Заявка». Если не сможет определить, то данные из этой колонки попадут в реквизит «Описание заявки».
  
== Доступные параметры ==
+
=== Доступные параметры ===
 
* ДатаСоздания
 
* ДатаСоздания
 +
* ДатаВыгрузки
 
* Контрагент
 
* Контрагент
 
* ОрганизацияПребывания
 
* ОрганизацияПребывания

Текущая версия на 12:43, 15 марта 2023

Существует возможность создать Google-форму для приема Заявок от Гостей или Агентов. Эта форма может собирать ответы в связанную с ней Google Таблицу. И в КУС будут создаваться документы «Заявка» по каждой строчке из таблицы. Также ее можно использовать для массовой загрузки броней в базу.

YouTube.png

Настройка

  • Пример таблицы: https://docs.google.com/spreadsheets/d/1XUn-Ea7AyEF1c4ZjUdb9g00keHTsgTahWBokIMjYbec/edit#gid=390831340
    • ID таблицы в этом примере: 1XUn-Ea7AyEF1c4ZjUdb9g00keHTsgTahWBokIMjYbec
  • Уровень доступа к таблице должен быть «Для всех, кто имеет ссылку» — «Редактировать». Так как КУС подключается без авторизации, под анонимным пользователем по ссылке и заполняет колонку ДатаВыгрузки.
  • Также можно добавить права на редактирование таблице для почтового адреса kus.robot@gmail.com.
  • Необходимо указать ID таблицы в интерфейсе «Администратор системы» на закладке Интернет-сервисы в разделе «Онлайн заявки»:
    Настройка онлайн заявок.png

После этого необходимо зайти в "Бронирование" и выбрать пункт "Загрузить онлайн-заявки"

   Загрузить заявки.png

Правила оформления Google Таблицы

  • В первой строке может быть написано что угодно, это поле для заголовков вопросов.
  • Во второй строке — технические названия полей.
    • Названия должны быть как в разделе «Доступные параметры» ниже.
    • Не должно быть пустых значений. В ячейке должно быть написано хоть что-то. Если программа найдет параметр по названию в заявке — она его заполнит. Если нет — пропустит.
    • Название поля не должно начинаться с символа, только с буквы.
  • Отправка заявок работает по двум колонкам:
    • ДатаСоздания — это дата и время создания строчки в таблице. В данной ячейке необходимо добавить дату.
    • ДатаВыгрузки — это дата и время выгрузки строчки в КУС. Данная ячейка добавляется автоматически. Колонка является обязательной для работы.
  • По одной строке из Google Таблицы создается одна заявка.
  • Если в колонках нет критичных для бронирования параметров (например КатегорииНомера), то Заявка создастся, но будет в статусе «Черновик» (не проведена).
  • Если КУС определит заголовок таблицы (например, КатегорияНомера) — то он заполнит соответствующий реквизит в документе «Заявка». Если не сможет определить, то данные из этой колонки попадут в реквизит «Описание заявки».

Доступные параметры

  • ДатаСоздания
  • ДатаВыгрузки
  • Контрагент
  • ОрганизацияПребывания
  • яъКомментарий
  • Физлицо
  • ДатаРождения
  • ЭлектроннаяПочта
  • Телефон
  • КатегорияНомера
  • ДатаЗаезда
  • КоличествоДней
  • КатегорияПутевки
  • ВариантПроживания
  • ВариантЛечения
  • ВариантПитания
  • ВидУдостоверения
  • ДокументСерия
  • ДокументНомер
  • ДокументДатаВыдачи
  • ДокументКемВыдан
  • ДокументКодПодразделения
  • ДатаРегистрацииПоМестуЖительства