Настройка интеграции с r_keeper

Для настройки интеграции с r_keeper:

  1. На главной панели перейдите во вкладку Финансовый модуль>Настройки>Настройки импорта.
  2. Выберите вкладку RKeeper. 

    На странице “Импорт RK” интеграции отображаются в виде древовидной структуры: Интеграции→ Рестораны → Тип валюты → Валюты. 

    Для каждой интеграции r_keeper (т.е. для каждой базы RK7) получаем список ресторанов и для каждого ресторана по отдельности выводим типы валют этой базы. По умолчанию настройки типов валют распространяются на все валюты.

  3. Нажмите на интеграцию, откроются окно с полями для редактирования. В этом окне отображается настройка переодических задач:
    • Активируйте слайдер Включить периодический импорт для включения задачи.
    • Укажите время запуска.
    • Нажмите кнопку Сохранить.
    • Логика работы: При создании интеграции автоматически создается задача ежедневной проверки соединения с удаленным источником данных. По умолчанию проверка соединения осуществляется в 12:00 UTC. Также выполняется импорт данных из интеграции в заданное пользователем время ежедневно. Чтобы включить эту функцию пользователь должен указать время исполнения задачи. Импорт происходит со вчера на сегодня или если с даты последних импортированных транзакций до сегодня менее 5 дней, то с этой даты по сегодня (на случай проблем с соединением). Более ранний период при необходимости нужно загрузить вручную.
  4. Нажмите на ресторан. В правой части откроется окно с полями для редактирования:

    • Название ресторана — заполняется при подключении интеграции.
    • Группировать по типу валют — если установлено, то на все валюты одного типа с одинаковой операцией будет сделана одна транзакция, иначе – на каждую валюту будет создана отдельная транзакция. Обычно убирать эту установку нет необходимости.
    • Используется — если активен, то по данному ресторану будут импортироваться данные, если деактивировать — данные импортироваться не будут.
    • Счет по умолчанию — при подключении интеграции по умолчанию Нераспределенная выручка. Обычно менять нет необходимости: таким образом, новые типы валют попадут на этот счёт и будет понятно, что этот новый тип валют надо настроить.
    • Операция по умолчанию — при подключении интеграции по умолчанию Выручка.
    • Метки для транзакций по умолчанию — при подключении интеграции по умолчанию r_keeper и метка ресторана. Редактировать нельзя.
    • Права доступа — необязательное поле, укажите метки, по которым будут даны права на редактирование свойств импорта ресторана.
    • Назначить всем в ресторане — при нажатии назначаются всем типам валют ресторана Счет по умолчанию, Операция по умолчанию и Метки для транзакций по умолчанию. При планировании работы с несколькими ресторанами рекомендуется добавить в метки для транзакций метку ресторана.
    • Кроме счетов — влияет на Назначить всем в ресторане и Счет по умолчанию не устанавливается типам валют ресторана. 

При добавлении в r_keeper новых Типов валют — для них будут применены настройки ресторана по умолчанию.

При добавлении в r_keeper новых Валют — для них будут применены настройки типа валют по умолчанию.

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

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

Для редактирования Типа валют:

  1. Нажмите на Тип валют. В правой части откроется окно с полями для редактирования:

    • Название валюты — заполняется при подключении интеграции.
    • Используется — если активен, то валюты этого типа будут импортироваться, если деактивировать — валюты данного типа импортироваться не будут.
    • Сотрудник обязателен — по умолчанию не активен, при активации, если в данном типе валют будет новая валюта – импорт выдаст ошибку и укажет, для какой валюты необходимо настроить сотрудника. 
    • Счет по умолчанию — предзаполняется при импорте из настроек по умолчанию в окне Ресторан.
    • Операция по умолчанию — предзаполняется при импорте из настроек по умолчанию в окне Ресторан.
    • Метки для транзакций по умолчанию — предзаполняется при импорте из настроек по умолчанию в окне Ресторан.
    • Права доступа — необязательное поле, укажите метки, по которым будут даны права на редактирование свойств данного типа валюты.
    • Добавить правило — открывается окно для добавления нового правила. Заполните поля и нажмите кнопку Добавить.

      • Наименование правила — обязательное поле, по умолчанию предзаполнено Правило 0, можете ввести свое название.
      • Используемое — по умолчанию не активирован, при активации означает, что при импорте данных это правило используется. 

      • Категория заказа r_keeper — необязательное поле, можно выбрать одну, несколько или все. 

      • Тип заказа r_keeper — необязательное поле, можно выбрать один, несколько или все. 

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

        При добавлении правила в окне Ресторан в поле Валюта r_keeper можно выбрать из списка всех валют в этом ресторане, при добавлении в окне Тип валют - из списка валют в данном типе.

      • Счет — обязательное поле, выберите счет из списка.

      • Операция — обязательное поле, выберите операцию из списка.

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

  2. Нажмите кнопку Сохранить.

Настройки типов валют применяются по умолчанию ко всем валютам данного типа. Для некоторых стандартных типов валют имеются предустановленные настройки:

  • Зачет аванса: счет по умолчанию — Предоплаты, операция — Выручка.
  • Кредитные карты: счёт по умолчанию — Карты в пути, операция — Выручка.
  • Наличные: счет по умолчанию — Наличные, операция — Выручка.
  • Неплательщики: счёт по умолчанию — Неплательщики, операция — Неплательщики.
  • Платежные карты: счёт по умолчанию — Карты лояльности, операция — Выручка.

Для более подробного импорта можно использовать правила. В правиле можно выбрать тип заказа или категорию заказа и задать для такого случая индивидуальные настройки. Всё, что попадёт под действие правил – будет обработано по правилам; всё остальное – по стандартным настройкам валюты или типа валюты. Например: есть валюта «Рубли», у неё есть настройки, что на нее назначается операция «Выручка», и настроено правило, что для типа заказа «Доставка» назначается операция «Выручка по доставке». Тогда вся выручка по этой валюте, которая имеет тип заказа «Доставка» будет записана на операцию «Выручка по доставке», а вся остальная выручка с этой валютой – на операцию «Выручка». Приоритет имеют правила валюты, потом правила типа валюты, потом правила ресторана. Рекомендуется выбрать единую стратегию задания правил, чтобы не запутаться в настройках.

Для редактирования Валют:

  1. Нажмите на Валюту. В правой части откроется окно с полями для редактирования:

    • Название валюты — предзаполняется названием валюты, редактировать нельзя.
    • Коэффициент — по умолчанию стоит, сюда можно ввести дробное число. При заполнении поля «Сотрудник» по нему записывается начисление с учетом коэффициента.
    • Сотрудник — выберите сотрудника из списка.
    • Используется — если активен, то валюта будет импортироваться, если деактивировать - импортироваться не будет. 
    • Счет по умолчанию — необязательное поле, можно выбрать счет из списка счетов.
    • Операция по умолчанию — необязательное поле, можно выбрать операцию из списка операций.
    • Метки для транзакций по умолчанию — необязательное поле.
  2. Нажмите кнопку Сохранить.

Если при импорте есть валюта, для которой заполнено поле Сотрудник, то записывается операция удержания (расход) «Премии и удержания» по счёту расчета зарплаты с этим сотрудником с учетом коэффициента.  

Если заданы правила валют, а в настройках валюты указано иное – правила имеют приоритет.