Разделы и статьи

Интеграция TL: WebPMS и 1С

Набор программных продуктов компании 1С предназначен для автоматизации бухгалтерского и налогового учета, для работы с отчетностью. Это профессиональный инструмент бухгалтера, которым пользуется большое количество наших партнеров, пользователей TL: WebPMS. Чтобы было удобно работать с документами в привычной среде, мы разработали API для интеграции TL: WebPMS и 1С.

 

Как работает API

API помогает TL: WebPMS и 1C обмениваться данными. Вам не придется вручную переносить и создавать документы — достаточно один раз настроить связку через API.

Из TL: WebPMS в 1C передаются:

  • начисления по броням за проживание и платные услуги;

  • начисления от продажи услуг, которые не связаны с проживанием;

  • наличные платежи и платежи банковской картой, оформленные в шахматке.

На основе этих данных в 1С могут создаваться различные документы:

TL: WebPMS

Начисления

Счета, акты выполненных работ (реализация товаров и услуг), счета-фактуры.

Наличные платежи

Приходные кассовые ордеры и расходные кассовые ордеры для возврата денежных средств.

Электронные платежи

Документы «Операции по платежным картам» и «Поступление на расчетный счет».

 

Примеры документов, которые создаются в 1С:

0f00004d4cf45a1c951deaff0aa603e6.png

 

c55c53d2f9eabb7b4c57190faa0b77df.png

 

Поступления на расчетный счет гостиницы выгружаются из 1С в TL: WebPMS в виде платежей по брони. Чтобы документ «Поступление на расчетный счет» выгрузился в TL: WebPMS и привязался к брони, выберите документ-основание в выписке. Документ-основание — это счет на оплату, который ранее был загружен из TL: WebPMS.

Если по какой-то причине платеж не привязался к брони автоматически, то он оказывается в списке «Недоставленные платежи». Смотрите подробности в статье «Как обрабатывать платежи недоставленные из 1С».

 

Как настроить интеграцию

Самостоятельная настройка интеграции через API

Это задача для 1С разработчика. Напишите нам, и мы предоставим всю необходимую информацию об API вашему техническому специалисту.

Модуль интеграции

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

Чтобы узнать об условиях подключения модуля интеграции, пишите по адресу salesplus@travelline.ru.

 

Какие версии 1С поддерживает модуль

Платформа 1С 8.3 (управляемое приложение):

  • Бухгалтерия предприятия, ред. 3.0 (3.0.73 и выше);

  • Бухгалтерия предприятия КОРП, ред. 3.0 (3.0.73 и выше).

Платформа 1С 8.2 и 8.3:

  • Бухгалтерия предприятия 2.0, ред. 2.0.66 (2.0.66.86 и выше);

  • Бухгалтерия предприятия КОРП 2.0, ред. 2.0.66 (2.0.66.86 и выше);

  • Управление производственным предприятием, ред. 1.3 (1.3.127 и выше).

 

Как установить модуль

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

1. Получите модуль интеграции и API Key от сотрудника TravelLine. Пишите по адресу salesplus@travelline.ru.

2. На странице «Администрирование» откройте пункт «Печатные формы, отчеты и обработки»:

d35a28a3b0e49ef1e1e5f9e59ad2c7fd.png

 

3. Откройте «Дополнительные отчеты и обработки»:

39e8729fcd07310cdda0ed14fc79ffbd.png

 

4. Нажмите на кнопку «Добавить из файла...»:

16d414f6a4e915adea735a1a5cdb8b21.png

 

5. Откроется окно «Предупреждение безопасности». Нажмите на кнопку «Продолжить»:

4906c53e72fa65379e58f1a25d7212fa.png

 

6. Откройте файл, который передал вам сотрудник TravelLine:

4efc202f8ff1fe73e12e8f7a5ef75b1b.png

 

7. Настройте размещение:

9b35f5e97af8320ae2db34c9163fb284.png

 

8. Выберите размещение в разделах «Администрирование», «Продажи» и нажмите на кнопку «ОК»:

4810329736f5b830598077a7fb3979a9.png

 

9. Настройте быстрый доступ:

ff3c4678aed6d9a25ee56813b523eb88.png

 

10. Добавьте пользователей, которые будут работать с модулем и нажмите на кнопку «ОК»:

26eabd419b546e4650b44ae1453a3757.png

 

Как запустить модуль

1. На странице «Продажи» откройте сервис «Дополнительные обработки»:

ebc0286f35cfc6d8dd56ac933d53fcd4.png

 

2. В открывшемся окне нажмите «Настроить список»:

cb1e3f23689a7ae0569ff6feabf5ad15.png

 

3. Выберите модуль «Интеграция 1С с TL: WebPMS» и нажмите на кнопку «OK»:

b0b6ef8f54711f0c8860bd6987c68fae.png

 

4. Нажмите на кнопку «Выполнить»:

936b8c912d2d08ac8d7848050cf4871e.png

 

5. Модуль готов к работе:

04cc0149ef11f26108736beb5fc5adb4.png

 

Как настроить модуль

На вкладках «Основные», «Настройки по документам» и «Настройки по оплатам» находятся параметры загрузки данных из TL: WebPMS в 1С.

Вкладка «Основные»

9321c73c818615348a6e2d59ba7adb30.png

 

«Период загрузки» — промежуток времени для загрузки и выгрузки данных. Эта настройка дублируется на каждой вкладке.

«API Key» — ключ для работы модуля через API выдается сотрудником TravelLine. Вставьте ключ и нажмите на кнопку «Проверить API key». Вы увидите сообщение о готовности API к работе.

«Организация для загрузки» — юридическое лицо гостиницы.

«Банковский счет» — основной банковский счет юридического лица, на который приходят все документы.

«Выставлять документы на каждое физлицо» — при отключении опции выбирается одно общее физическое лицо для выставления всех документов физических лиц:

b26d9834f52c72de88f86c78c20e778d.png

 

Документы для юридических лиц выставляются на каждое юридическое лицо отдельно.

«Валюта по умолчанию» — выберите валюту учета.

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

«Группа для новых контрагентов» — вы можете выбрать папки, куда будут добавляться новые юридические и физические лица.

«Группа для новой номенклатуры» — если из TL: WebPMS приходит услуга, которой нет в 1С, то для услуги создается новая номенклатура. В этой настройке выбирается папка для новой номенклатуры.

«Единица для новой номенклатуры» — выберите единицу измерения.

«Поиск номенклатуры в выбранной папке» — при выборе опции модуль будет искать номенклатуру в указанной папке. Если настройка не выбрана, то поиск будет проходить по всей базе.

«Проводить документы» — документы из TL: WebPMS будут проводиться автоматически. Если вы хотите проводить документы вручную, снимите галочку.

 

Вкладка «Настройки по документам»

3ee77301044b873b4e462bfd134a7579.png

 

«Тип выгрузки по дате» — выберите признак, по которому из TL: WebPMS будут выгружаться документы:

  • «по выезду» — выгружается информация о бронях, дата выезда которых попала в запрашиваемый период. Обычно используется для загрузки актов и счетов.

  • «по пребыванию» — выгружается информация о начислениях, которые были сделаны в запрашиваемый период. Обычно используется для загрузки актов.

  • «создание брони» — выгружается информация о бронях, созданных в запрашиваемый период.

«Загружать каждую услугу отдельно» — каждая услуга (проживание, дополнительные услуги, ранний заезд, поздний выезд и трансферы) будет загружена отдельной строкой в акте. Если настройка не выбрана, то в акте будет одна общая услуга.

При выборе этой настройки появляется опция «Группировать услуги в документах» — повторяющиеся услуги будут сгруппированы:

56f0df2654268ece028bd9c642646dac.png

 

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

7e303eb84fbd46c7f8c0f04507939e09.png

 

«Не создавать акт для физ лица» и «Не создавать счет на оплату для физ лица» — поставьте галочки, чтобы не загружать документы для физических лиц.

«Создавать счет на оплату для физ лица от компании-агента» — счет на оплату физическим лицам будет выставляться для услуг, оказанных компанией-агентом.

При выборе этой настройки появятся опция «Выставлять счет на оплату для физ лица на компанию-агента» — в качестве плательщика в счете будет указана компания-агент.

dc8801539c8e6e59e05947794d87fce2.png

 

«Устанавливать номер акта из WebPMS» — номер акта будет копироваться из TL: WebPMS в 1С.

«Устанавливать номер счета на оплату из WebPMS» — номер счета будет копироваться из TL: WebPMS в 1С.

«Выставлять счет текущей датой» — в счете будет выбрана текущая дата на момент передачи информации, а не дата создания брони.

«Загружать только, когда заезд гостя зафиксировать» — из TL: WebPMS будут загружаться только те брони, по которым гость заселился в номер.

«Сумма включает НДС» — НДС будет входить в стоимость услуги.

«Создавать счет-фактуру» — настройка для организаций, которые работают с НДС.

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

«Не выставлять акт с оплатой без чека» — брони, оплаченные без чека, не попадут в 1C.

«Не обновлять проведенные документы» — документы загруженные и проведенные ранее не будут обновляться при загрузке из TL: WebPMS.

Номенклатура для печатной формы счета и акта формируется при помощи шаблонов:

d2476a90c761b8c82b12412690669a4a.png

 

Соберите свои шаблоны при помощи переменных в квадратных кавычках. При печати документов переменные автоматически заменяются на реальные данные из брони.

«Настройки прокси» — если вы используете прокси-сервер, введите его данные.

8c28e768bd74f31e2018b63a76e1139a.png

 

Вкладка «Настройки по оплатам»

b771eee91f3c9c253a9efdcb32dadffd.png

 

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

«Электронный платеж загружать в документ “Оплата платежной картой”» — чтобы электронный платеж загружался в выписку, а не в оплату платежной картой, снимите галочку.

«Загружать электронный платеж по юр лицам» — электронные платежи обычно загружаются через клиент-банк. Чтобы загружать их через модуль, поставьте галочку.

«Поиск документов при загрузке» — опция сравнивает все документы по дате создания, номеру брони и контрагенту. Благодаря этому дубликаты документов не создаются.

«Загружать платежи только с чеками» — поставьте галочку, чтобы не загружать платежи без чеков.

«Группировать платежи по счету, без разделения по ключевым услугам» — если в TL: WebPMS несколько услуг в одной брони, то в 1С загружается несколько платежей. Чтобы сгруппировать эти платежи в одну оплату, поставьте галочку.

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

 

Вкладка «Выгрузка платежей»

Параметры выгрузки данных из 1С в TL: WebPMS:

d192661bdb8c9507b17c68c196dcc570.png

 

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

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

«Отбирать выписки по выставленным счетам, товары в счете на оплату должны быть из группы товаров в настройках» — в TL: WebPMS будут выгружаться только платежи, которые основаны на счетах с услугами из настройки «Группа для новой номенклатуры» на вкладке «Основные».

 

Экспорт и импорт настроек

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

9955b649e06fbfc9ef9e1b4dfdd376a9.png

 

Как загружать и выгружать документы

Загрузка данных в 1С происходит по нажатию кнопок:

  • «Акты» — загружаются документы «Реализация товаров и услуг»;

  • «Счета» — загружаются документы «Счет на оплату покупателя»;

  • «Платежи» — загружаются наличные и электронные платежи.

По нажатию на кнопку «Выгрузить платежи в TL: WebPMS» из 1С выгружаются поступления по расчетному счету.

8f014c31cff33f9a951f43dd733b252e.png

 

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

Обратиться в службу поддержки TravelLine

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