Набор программных продуктов компании 1С предназначен для автоматизации бухгалтерского и налогового учета, для работы с отчетностью. Это профессиональный инструмент бухгалтера, которым пользуется большое количество наших партнеров, пользователей TL: WebPMS. Чтобы было удобно работать с документами в привычной среде, мы разработали API для интеграции TL: WebPMS и 1С.
Как работает API
API помогает TL: WebPMS и 1C обмениваться данными. Вам не придется вручную переносить и создавать документы — достаточно один раз настроить связку через API.
Из TL: WebPMS в 1C передаются:
начисления по броням за проживание и платные услуги;
начисления от продажи услуг, которые не связаны с проживанием;
наличные платежи и платежи банковской картой, оформленные в шахматке.
На основе этих данных в 1С могут создаваться различные документы:
TL: WebPMS | 1С |
Начисления | Счета, акты выполненных работ (реализация товаров и услуг), счета-фактуры. |
Наличные платежи | Приходные кассовые ордеры и расходные кассовые ордеры для возврата денежных средств. |
Электронные платежи | Документы «Операции по платежным картам» и «Поступление на расчетный счет». |
Примеры документов, которые создаются в 1С:
Поступления на расчетный счет гостиницы выгружаются из 1С в TL: WebPMS в виде платежей по брони. Чтобы документ «Поступление на расчетный счет» выгрузился в TL: WebPMS и привязался к брони, выберите документ-основание в выписке. Документ-основание — это счет на оплату, который ранее был загружен из TL: WebPMS.
Если по какой-то причине платеж не привязался к брони автоматически, то он оказывается в списке «Недоставленные платежи». Смотрите подробности в статье «Как обрабатывать платежи недоставленные из 1С».
Как настроить интеграцию
Модуль интеграции
Мы понимаем, что не в каждой гостинице есть 1С разработчик. Поэтому мы создали специальной модуль для взаимодействия 1С с API.
Стоимость модуля — от 20000 рублей. Для подключения отправьте запрос на salesplus@travelline.ru.
Самостоятельная разработка модуля
Это возможно через API, который работает на тарифе PREMIUM. Напишите нам на salesplus@travelline.ru, чтобы подключить этот тариф. После заключения договора мы предоставим описание API TL:WebPMS вашему техническому специалисту для разработки и настройки модуля.
Какие версии 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С. Если вы используете специфическую версию или конфигурация, то для подключения модуля могут потребоваться доработки за дополнительную плату. Чтобы узнать все подробности пишите по адресу salesplus@travelline.ru.
Как установить модуль
Вам потребуются права на подключение внешних обработок в 1С. Модуль внешней обработки не вносит изменений в конфигурацию 1С, при установке база данных останется нетронутой.
1. Получите модуль интеграции и API Key от сотрудника TravelLine. Пишите по адресу salesplus@travelline.ru.
2. На странице «Администрирование» откройте пункт «Печатные формы, отчеты и обработки»:
3. Откройте «Дополнительные отчеты и обработки»:
4. Нажмите на кнопку «Добавить из файла...»:
5. Откроется окно «Предупреждение безопасности». Нажмите на кнопку «Продолжить»:
6. Откройте файл, который передал вам сотрудник TravelLine:
7. Настройте размещение:
8. Выберите размещение в разделах «Администрирование», «Продажи» и нажмите на кнопку «ОК»:
9. Настройте быстрый доступ:
10. Добавьте пользователей, которые будут работать с модулем и нажмите на кнопку «ОК»:
Как запустить модуль
1. На странице «Продажи» откройте сервис «Дополнительные обработки»:
2. В открывшемся окне нажмите «Настроить список»:
3. Выберите модуль «Интеграция 1С с TL: WebPMS» и нажмите на кнопку «OK»:
4. Нажмите на кнопку «Выполнить»:
5. Модуль готов к работе:
Как настроить модуль
На вкладках «Основные», «Настройки по документам» и «Настройки по оплатам» находятся параметры загрузки данных из TL: WebPMS в 1С.
Вкладка «Основные»
«Период загрузки» — промежуток времени для загрузки и выгрузки данных. Эта настройка дублируется на каждой вкладке.
«API Key» — ключ для работы модуля через API выдается сотрудником TravelLine. Вставьте ключ и нажмите на кнопку «Проверить API key». Вы увидите сообщение о готовности API к работе.
«Организация для загрузки» — юридическое лицо гостиницы.
«Банковский счет» — основной банковский счет юридического лица, на который приходят все документы.
«Выставлять документы на каждое физлицо» — при отключении опции выбирается одно общее физическое лицо для выставления всех документов физических лиц:
Документы для юридических лиц выставляются на каждое юридическое лицо отдельно.
«Валюта по умолчанию» — выберите валюту учета.
«Создавать ненайденных контрагентов» — поиск в базе происходит по ИНН, КПП и наименованию. Если данные не находятся, то добавляется новый контрагент. При отключении опции в документах не будет контрагента.
«Группа для новых контрагентов» — вы можете выбрать папки, куда будут добавляться новые юридические и физические лица.
«Группа для новой номенклатуры» — если из TL: WebPMS приходит услуга, которой нет в 1С, то для услуги создается новая номенклатура. В этой настройке выбирается папка для новой номенклатуры.
«Единица для новой номенклатуры» — выберите единицу измерения.
«Поиск номенклатуры в выбранной папке» — при выборе опции модуль будет искать номенклатуру в указанной папке. Если настройка не выбрана, то поиск будет проходить по всей базе.
«Проводить документы» — документы из TL: WebPMS будут проводиться автоматически. Если вы хотите проводить документы вручную, снимите галочку.
Вкладка «Настройки по документам»
«Тип выгрузки по дате» — выберите признак, по которому из TL: WebPMS будут выгружаться документы:
«по выезду» — выгружается информация о бронях, дата выезда которых попала в запрашиваемый период. Обычно используется для загрузки актов и счетов.
«по пребыванию» — выгружается информация о начислениях, которые были сделаны в запрашиваемый период. Обычно используется для загрузки актов.
«создание брони» — выгружается информация о бронях, созданных в запрашиваемый период.
«Загружать каждую услугу отдельно» — каждая услуга (проживание, дополнительные услуги, ранний заезд, поздний выезд и трансферы) будет загружена отдельной строкой в акте. Если настройка не выбрана, то в акте будет одна общая услуга.
При выборе этой настройки появляется опция «Группировать услуги в документах» — повторяющиеся услуги будут сгруппированы:
Чтобы все услуги загружались в виде одной номенклатуры, снимите галочку. В этом случае выберите документ для загрузки:
«Не создавать акт для физ лица» и «Не создавать счет на оплату для физ лица» — поставьте галочки, чтобы не загружать документы для физических лиц.
«Создавать счет на оплату для физ лица от компании-агента» — счет на оплату физическим лицам будет выставляться для услуг, оказанных компанией-агентом.
При выборе этой настройки появятся опция «Выставлять счет на оплату для физ лица на компанию-агента» — в качестве плательщика в счете будет указана компания-агент.
«Устанавливать номер акта из WebPMS» — номер акта будет копироваться из TL: WebPMS в 1С.
«Устанавливать номер счета на оплату из WebPMS» — номер счета будет копироваться из TL: WebPMS в 1С.
«Выставлять счет текущей датой» — в счете будет выбрана текущая дата на момент передачи информации, а не дата создания брони.
«Загружать только, когда заезд гостя зафиксировать» — из TL: WebPMS будут загружаться только те брони, по которым гость заселился в номер.
«Сумма включает НДС» — НДС будет входить в стоимость услуги.
«Создавать счет-фактуру» — настройка для организаций, которые работают с НДС.
«Общий счет, акт, платеж для групповой брони» — для групповой брони будет создаваться общий пакет документов всех броней группы.
«Не выставлять акт с оплатой без чека» — брони, оплаченные без чека, не попадут в 1C.
«Не обновлять проведенные документы» — документы загруженные и проведенные ранее не будут обновляться при загрузке из TL: WebPMS.
Номенклатура для печатной формы счета и акта формируется при помощи шаблонов:
Соберите свои шаблоны при помощи переменных в квадратных кавычках. При печати документов переменные автоматически заменяются на реальные данные из брони.
«Настройки прокси» — если вы используете прокси-сервер, введите его данные.
Вкладка «Настройки по оплатам»
Выберите типы и методы оплаты, которые будет обрабатывать модуль. Наличные платежи оформляются в виде приходных кассовых ордеров, возвраты в виде расходных кассовых ордеров. Электронные платежи в виде оплаты платежной картой или возврата.
«Электронный платеж загружать в документ “Оплата платежной картой”» — чтобы электронный платеж загружался в выписку, а не в оплату платежной картой, снимите галочку.
«Загружать электронный платеж по юр лицам» — электронные платежи обычно загружаются через клиент-банк. Чтобы загружать их через модуль, поставьте галочку.
«Поиск документов при загрузке» — опция сравнивает все документы по дате создания, номеру брони и контрагенту. Благодаря этому дубликаты документов не создаются.
«Загружать платежи только с чеками» — поставьте галочку, чтобы не загружать платежи без чеков.
«Группировать платежи по счету, без разделения по ключевым услугам» — если в TL: WebPMS несколько услуг в одной брони, то в 1С загружается несколько платежей. Чтобы сгруппировать эти платежи в одну оплату, поставьте галочку.
Данные блока «Заполнение документов» используются в качестве реквизитов в документе на оплату по умолчанию. Введите свои данные из плана счетов бухгалтерского учета.
Вкладка «Выгрузка платежей»
Параметры выгрузки данных из 1С в TL: WebPMS:
Вы можете выбрать для выгрузки вид операции, банковский счет и статью доходов.
«Выгружать платежи по расшифровкам» — платежи будут выгружаться отдельно для каждой расшифровки из документа «Поступление на расчетный счет».
«Отбирать выписки по выставленным счетам, товары в счете на оплату должны быть из группы товаров в настройках» — в TL: WebPMS будут выгружаться только платежи, которые основаны на счетах с услугами из настройки «Группа для новой номенклатуры» на вкладке «Основные».
Экспорт и импорт настроек
Вы можете экспортировать и импортировать все настройки модуля. Функция будет полезна для работы нескольких пользователей в одной организации и поможет при физическом перемещении базы данных 1С.
Как загружать и выгружать документы
Загрузка данных в 1С происходит по нажатию кнопок:
«Акты» — загружаются документы «Реализация товаров и услуг»;
«Счета» — загружаются документы «Счет на оплату покупателя»;
«Платежи» — загружаются наличные и электронные платежи из шахматки TL: WebPMS в 1С.
По нажатию на кнопку «Выгрузить платежи в TL: WebPMS» из 1С выгружаются поступления по расчетному счету.
Данные обрабатываются в соответствии с настройками, которые вы установили на вкладках. При повторной загрузке или выгрузке данные перезаписываются новой информацией.