Руководство пользователя

по работе с обработкой переноса данных из Shelter в 1С:Бухгалтерия (редакции 2.0) 1С:Предприятия 8.2, 1С:Бухгалтерия (редакции 3.0) 1С:Предприятия 8.2 (8.3) и в 1С:Бухгалтерия (редакции 4.5) 1С:Предприятия 7.7

 

Дистрибутив и необходимые обработки находятся тут

ВНИМАНИЕ!!! При работе с ФФД 1.05, при проведении полного расчета после принятий платежей с ПРЕДОПЛАТА/ПРЕДОПЛАТА 100% и зачета аванса (предварительная оплата(аванс)) после принятия платежа с признаком АВАНС, в 1С информация по этим признакам способа расчета передаваться не будет, так как данные признаки способа расчета не являются операцией приема денежных средств от клиента.

 

Описание программного комплекса.

 

Программа предназначена для загрузки данных из Shelter в 1С:Бухгалтерию (редакции 3.0) 1С:Предприятия 8.2(8.3), 1С:Бухгалтерию (редакции 2.0) 1С:Предприятия 8. (Важно! Если 1.6, то обновить до 2.0) и в 1С:Бухгалтерию (редакции 4.5) 1С:Предприятия 7.7. Программа загружает все наличные и безналичные платежи и реализацию услуг. Все типы платежей и реализации услуг переносятся опционально. Что позволяет использовать программу совместно с клиент-банком и другими обработками для 1С:Предприятия. Программа является обработкой, написанной на языке «1С» с открытым исходным кодом, что позволяет пользователю самостоятельно вносить изменения в порядок загрузки данных.

Данные формируются следующим образом: все оплаты выгружаются день в день. Услуги проживающих гостей - только в день выезда гостя. Если услуга была оказана на фолио, до момента размещения в номер (фолио открыто по брони), то эти услуги выгрузятся в день их реализации, т.е. днем, когда они были начислены. После выезда гостя из номера, эти услуги выгружаться не будут. Если услуга(оплата) находится на фолио организации или группы от юридического лица, то она принадлежит юр. лицу. Фолио группы создается на организацию плательщика, установленного в карточке брони. Если услуга(оплата) находится на фолио заезда, то она принадлежит частному лицу, не важно установлена ли в карточке поселения организация или нет. Важно чтобы после выгруженных данных в Shelter не проводились скидки задним числом и не совершались трансферы. Т.е. до момента выгрузки все трансферы и скидки были сделаны.

 

Описание поставки программного комплекса.

Установочный диск (архив):

Firebird_ODBC_2.0.0.148_win32.exe — ODBC драйвер для FireBird

GDS32.DLL – клиентская библиотека FireBird.

UCSimportFromShelterTo1C8_BUX_3_0_709.epf – Обработка 1С:Предприятия 8.2 (8.3) Конфигурация Бухгалтерия предприятия, редакция 3.0. Работает с версиями Shelter 709 и выше, Абонемент 68.

UCSimportFromShelterTo1C8_BUX_3_0_709_ИзФайла.epf – Обработка 1С:Предприятия 8.2 (8.3) Конфигурация Бухгалтерия предприятия, редакция 3.0. Работает с версиями Shelter 709 и выше, Абонемент 68.

UCSimportFromShelterTo1C8_BUX_3_0_709_ВыборОтеля.epf – Обработка 1С:Предприятия 8.2 (8.3) Конфигурация Бухгалтерия предприятия, редакция 3.0. Работает с версиями Shelter 709 и выше, Абонемент 68.

UCSimportFromShelterTo1C8_2_BUX_709.epf – Обработка 1С:Предприятия 8.2 Конфигурация Бухгалтерия предприятия, редакция 2.0. Работает с версиями Shelter 709 и выше, Абонемент 68.

UCSimportFromShelterTo1C8_2_BUX_709_ЧастноеЛицо.epf - Обработка 1С:Предприятия 8.2 Конфигурация Бухгалтерия предприятия, редакция 2.0. Все контрагенты — частные лица заменены одним контрагентом Частное Лицо. Работает с версиями Shelter 709 и выше, Абонемент 68.

UCSimportFromShelterTo1C8_2_BUX_709_Загрузка_ИЗ_Файла.epf - Обработка 1С:Предприятия 8.2 Конфигурация Бухгалтерия предприятия, редакция 2.0. Данные при выгрузке в 1С берутся не из базы Shelter непосредственно, а из файлов, созданных в базе Shelter.

UCSimportFromShelterTo1C8_2_BUX_709_ВыборОтеля.epf – Обработка 1С:Предприятия 8.2 Конфигурация Бухгалтерия предприятия, редакция 2.0. Работает с версиями Shelter 709 и выше, Абонемент 68.

UCSimportFromShelterTo1C8_BUX.epf - Обработка 1С:Предприятия 8. Конфигурация Бухгалтерия предприятия, редакция 2.0. Работает с версиями Shelter ниже 709.

UCSimportFromShelterTo1C8_BUX_Казахстан.epf - Обработка 1С:Предприятия 8.2 Конфигурация Бухгалтерский учет для Казахстана, редакция 2.5. Работает с версиями Shelter ниже 709.

UCSimportfromShelterTo1C77_Complex_709.ert – Обработка 1С:Предприятия 7.7. Комплексная конфигурация ред. 4.5. Работает с версиями Shelter 709 и выше, Абонемент 68.

UCSimportfromShelterTo1C77_BUH_709.ert - Обработка 1С:Предприятия 7.7. Конфигурация Бухгалтерский учет, редакция 4.5. Работает с версиями Shelter 709 и выше, Абонемент 68.

UCSimportfromShelterTo1C77_USN_ЧастноеЛицо_709.ert - Обработка 1С:Предприятия 7.7. Конфигурация Упрощенная система налогообложения, ред. 1.3. Все контрагенты — частные лица заменены одним контрагентом Частное Лицо. Работает с версиями Shelter 709 и выше, Абонемент 68.

UCSimportfromShelterTo1C77_USN_709.ert - Обработка 1С:Предприятия 7.7. Конфигурация Упрощенная система налогообложения, ред. 1.3. Работает с версиями Shelter 709 и выше, Абонемент 68.

 

Описание установки программного комплекса.

Проверить наличие лицензии (проект 4, модуль 12)

Установить ODBC драйвер (Firebird_ODBC_2.0.0.148_win32.exe) для 32-битной ОС.

Либо установить драйвер (Firebird_ODBC_2.0.0.151_x64.exe) для 64-битной ОС.

Скопировать библиотеку GDS32.DLL в Windows\System32 (если ее там нет) для 32-битной ОС, либо в Windows\sysWOW64 и Windows\System32 для 64-битной ОС

ВАЖНО!!! Иногда бывают случаи, когда необходимо использовать модифицированную версию библиотеки gds32.dll - зависит от разрядности 1С. Скачать ее можно тут
ВАЖНО!!! На актуальной версии Shelter 2 можно использовать стаднартный сервер блокировок для подключения(UCS Shelter Lock Server). Убедиться, что в папке UDF на сервере Shelter присутствует sh2_udf.dll

Из 1С-Бухгалтерии v8.1 ред. 2.0 запустить UCSimportFromShelter.epf или из 1С-Бухгалтерии v7.7 ред. 4.5 запустить UCSimportFromShelter.ert.

Если используется v8.2, предварительно открыть обработку в конфигураторе для конвертации.

На странице настроек все выбрать и сохранить настройки. Далее сначала "Заполнить", потом "Загрузить" на каждой странице отдельно или "Загрузить все".

 

Проверить подключение можно следующим образом:

Если запустить ODBC из директории SYSTEM32, настроить по аналогии с рисунком 1 и нажать "Проверка соединения", то получим ошибку, что GDS32.dll не загружена. Также эта ошибка может возникать из-за версионности библиотеки (x32/x64).

Рис 1

Если запустить ODBC из директории SYSWOW64 и по аналогии настроить, то ошибок не будет и соединение с БД пройдет корректно

Рис 2.

Также неоходимо проверить корректность директории SYSWOW64 и SYSTEM32, т.к может быть установлено несколько ОС и библиотека скопирована в не тот экземпляр windows.

 

 

Описание настройки программного комплекса.

 

[LOCK.SERVER]

TCPHost: ip адрес или dns имя сервера блокировок.

TCPPort: tcp порт сервера блокировок.

Проверить настройки сервера блокировок можно кнопкой «Проверить».

DbName: ip адрес или dns имя сервера FireBird и путь к файлу БД.

Кнопка «Сформировать список отелей»: при её нажатии считывается информация из Абонемента(Shelter) по отелям и организациям-собственникам. Заполняются: поле списка «Наименование отеля», поле списка выгруженных значений «Наименование организации».

«Наименование отеля»: тот отель, по которому будут заполнены и загружены данные из Абонемента(Shelter).

«Наименование организации: та организация, по которой будут заполнены и загружены данные из Абонемента(Shelter).

Организация: Организация в 1С:Предприятие для создания документов.

Группа контрагентов: Группа контрагентов в 1С:Предприятие. В эту группу будут заноситься новые контрагенты из Shelter с указанием их адреса и паспортных данных (если клиент - физ.лицо).

Группа услуг: группа справочника номенклатура в 1С:Предприятие. В эту группу будут заноситься новые услуги из Shelter, т.е номенклатура с признаком услуг в Shelter.

Группа товаров: группа справочника номенклатура в 1С:Предприятие. В эту группу будет заноситься новый товар из Shelter, т.е номенклатура с признаком товара в Shelter.

Склад: Место Хранения (Склад) в 1С:Предприятие. Для подстановки в документы. Необязательный параметр, так как номенклатура Shelter — суть услуги.

Банковский счет (кк): Банковский счет в 1С:Предприятие. Для отражения операций оплаты по кредитным картам.

Платежные карты

Банковский счет (бп): Банковский счет в 1С:Предприятие. Для отражения операций оплаты банковскими переводами.

Флажок «Загружать реализации услуг». Указывает, загружать ли документы «Реализация товаров и услуг». При загрузке документов реализации если сумма указана отрицательная, то вместо документа "Реализация товаров и услуг" формируется документ "Возврат товаров от покупателя". Этот документ только записывается (не проводится), т.к. в колонку "Номенклатура" из Shelter может переноситься не только товар, но и услуга. Поэтому (на усмотрение бухгалтера) можно сделать изменения в конфигурации, которые позволят провести этот документ, или перевыбрать услугу на товар и тоже провести.

Флажок "Группировка услуг по контрагенту". При включенном флаге суммируются по контрагентам количество и суммы услуг за день. Т.е., если по контрагенту за день введена какая-либо услуга и она же прошла как возврат(отсторнирована) на эту же сумму, то при включении этого флажка не будут формироваться документы  "Реализация товаров и услуг" и "Возврат товаров от покупателя". При этой группировке не учитываются даты начала и окончания оказания услуг.

Флажок «Загружать оплаты наличными». Указывает, загружать ли документы «Приходный кассовый ордер» и «Расходный кассовый ордер». Если сумма указана отрицательная, то вместо документа "Приходный кассовый ордер" формируется документ "Расходный кассовый ордер".

Флажок «Загружать оплаты кредитными картами (кк)». Указывает, загружать ли оплаты кредитными картами.

Вид загрузки КК: «Оплата платёжной картой» либо «Операция БУ». Если выбрать значение «Оплата платёжной картой», при загрузке будут сформированы документы «Оплата платёжной картой». Если выбрать значение «Операции БУ» будут формироваться два вида документа «Операция БУ» (Проводки: Дт 57.03  Кт 62.02) и «Поступление на расчетный счет» (Проводки: Дт 51  Кт 57.03).

Флажок «Загружать оплаты банковским переводом (бп)». Указывает, загружать ли документы «Поступление на расчетный счет в банке».

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

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

Флажок «Формировать счета - фактуры». Указывает, формировать ли на основании созданного проведенного документа "Реализация товаров и услуг" счет-фактуру выданную. По кнопке "Печать методом подстановки" можно увидеть печатную форму счета-фактуры, сформированную методом "подстановки". Если в этой печатной форме в колонке оказанных услуг необходимо вместе с наименованием услуги указывать даты заезда-выезда гостя, то в списке кодов, вызванных по кнопке "Коды услуг", необходимо отметить эти коды. Коды совпадают с кодами услуг из Shelter.

Флажок «Загружать счета». Показывать/Загружать ли выставленные счета на оплату покупателю. Счет выставляется только юридическому лицу.

Флажок «Частное лицо»(Только для Бухгалтерия 3.0). Указывает, формировать ли все документы частных лиц на одного контрагента «Частное лицо».

Рис.1

 

P.S.: Образцы всех настроек показаны на рис.1

Рис.2

 

Загрузка данных.

 

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

Потом нажать кнопку «Заполнить». Просмотреть и отметить нужные документы. Нажать либо кнопку «Загрузить» на каждой нужной закладке либо «Загрузить все». См. Рис.2

Рис.3

На командной панели имеются 4 кнопки:

 

Кнопка «Коды услуг», по которой заносятся в список код услуги из Shelter. При печати счет - фактуры методом «подстановки» эти услуги печатаются с датой проживания. См. Рис.3

Рис.4

 

 

Кнопка «Соответствие контрагентов 1С и Shelter» показывает наличие (выделено зеленым цветом) или отсутствие (показано в таблице «Соответствие не найдено»)

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

 

 

Кнопка «Соответствие номенклатуры 1С и Shelter» показывает наличие (выделено зеленым цветом) или отсутствие (показано в таблице «Соответствие не найдено») номенклатуры, которые будут участвовать в создании документов. Если нажать кнопку «Заполнить», то для всех строк списка внизу формы будут добавлены новые элементы в справочник Номенклатура в группу услуг либо группу товаров, указанных в настройках в зависимости от вида номенклатуры.См. Рис.5

 

См. Рис.5

 

Кнопка «Печать Запроса». По ней в удобной форме можно посмотреть результат запроса из Shelter (Абонемента). Данная печатная форма используется в случайх, когда необходимо выяснить какие-либо несоответствия данных , полученных из Shelter. Данные запроса могут группироваться различным способами для удобства чтения информации. При необходимости форму можно распечатать. Пример формы печати запроса см. на рис.6

Рис.6

 

Возможные ошибки при подключении к базе данных SHELTER( Абонемент) и методы их решения

 

 

  1. Сообщение в 1С об ошибке при вызове метода контекста (Execute): «Произошла исключительная ситуация (Microsoft OLE DB Provider for ODBC Drivers): [ODBC Firebird Driver][Firebird]invalid request BLR at offset 63

function CHKLIC is not defined
module name or entrypoint could not be found»

Причина ошибки: в базе данных не найдена функция, отвечающая за нахождение лицензии выгрузки в 1С.Метод исправления ошибки: в папку UDF необходимо поместить файл sh_licudf.dll . И кроме того необходимо выполнить скрипт script_1c.sql.

 

 

  1. Сообщение в 1С об ошибке при вызове метода контекста (RecordCount)

Если НаборЗаписей.RecordCount() <> 0

По причине: Произошла исключительная ситуация (ADODB.Recordset): Операция не допускается, если объект закрыт. В той же задаче сообщение об ошибке SQL error code = - 104. Причина ошибки: возможные ошибки в SQL запросе, в том числе использование некоторых функций. Например, использование функции Iif, с которой firebird 1.5 ещё не знаком.

 

 

  1. Сообщение в 1С об ошибке при вызове метода контекста (Open)

​По причине: Произошла исключительная ситуация (Microsoft OLE DB Provider for ODBC Driver): [ODBC Firebird Driver] File Database is not found. Причина ошибки : некорректно заполнено поле «DbName». Пример  правильного заполнения поля указан ниже:     127.0.0.1/3080:C:\КакаяТоПапка\SHELTER.FDB

 

 

  1. Сообщение в 1С об ошибке при вызове метода контекста (Open

По причине: Произошла исключительная ситуация: SQLCODE = - 902: I/O error during «@1» operation for file «@2». Error while trying to open file. Причина ошибки: см.пункт 3

 

 

  1. Сообщение в 1С об ошибке при вызове метода контекста (Open): Произошла исключительная ситуация (Microsoft OLE DB Provider for ODBC Drivers): [ODBC Firebird Driver]unavailable database

Не удалось подключиться к FireBird.

Причина ошибки : некорректно заполнено поле «DbName. См. п. 3

 

 

  1. Сообщение в 1С об ошибке при вызове метода контекста(EOF) по причине: Произошла исключительная ситуация (Microsoft OLE DB Provider for ODBC Drivers): [ODBC Firebird Driver] [Firebird] Error reading from the connection

​Причина ошибки : некорректная установка необходимых драйверов Firebird (для 32 либо 64-битной системы) .

Информация о выгрузке из Абонемент в 1С находится тут