Интеграция с 1С:Отель (КУС) — различия между версиями

Материал из КинтВики
Перейти к: навигация, поиск
(Какие данные передаются)
 
(не показано 19 промежуточных версий этого же участника)
Строка 1: Строка 1:
 
<noinclude>[[Категория: Обмен данными (КУС)]]
 
<noinclude>[[Категория: Обмен данными (КУС)]]
[[Категория: Расширения конфигурации (КУС)]]</noinclude>
+
[[Категория: Интеграция с внешними сервисами (КУС)]]</noinclude>
Интеграция программы «Кинт: Управление санаторием» с программой «1С: Отель» предназначена для случаев, когда организация ведет гостиничный учет в «1С: Отель», а в «Кинт: Управление санаторием» использует модуль «Медицина» для учета пациентов, назначения процедур и иных медицинских задач.  
+
Интеграция программы «Кинт: Управление санаторием» с программой «1С:Отель» предназначена для случаев, когда организация ведет гостиничный учет в «1С:Отель», а в «Кинт: Управление санаторием» использует модуль «Медицина» для учета пациентов, назначения процедур и выполнения других медицинских задач.  
  
Данные о заселении гостей передаются из «1С: Отель» в «Кинт: Управление санаторием», где на их основании создаются карты гостей и их медицинские формы — карты пациента. При отсутствии лицензии на модуль «Гостиница» в интерфейсе программы доступны для работы только карты пациента.
+
Данные о заселении гостей передаются из «1С:Отель» в «Кинт: Управление санаторием», где на их основании автоматически создаются карты гостей и их медицинские формы — карты пациентов. При отсутствии лицензии на модуль «Гостиница» в интерфейсе программы доступны для работы только карты пациентов.
  
== Что передается из «1С: Отель» в «Кинт: Управление санаторием» ==
+
== Какие данные передаются ==
# Документы размещения — автоматически создаются карты гостя.
+
На основании данных документа размещения в «1С:Отель» создается карта гостя в «Кинт: Управлении санаторием».
# Цены проживания, лечения и питания из документа размещения.
+
 
 +
Напрямую передаются данные:
 +
# Номер и дата документа.
 
# Даты заезда и выезда.
 
# Даты заезда и выезда.
# Номер гостиницы —  заполняется, если в справочнике помещений создан элемент с таким же наименованием.
+
# Номер гостиницы.
# Вариант проживания — сопоставляется по принципу:
+
# Номенклатура пребывания (устанавливается по тарифу в «1С:Отель»).
 +
# Организация.
 +
# Автор документа (устанавливается по пользователю в «1С:Отель»).
 +
 
 +
Вычисляются алгоритмами программы:
 +
# Вариант проживания — устанавливается через сопоставление значений «1С:Отель» с вариантами в «Кинт: Управление санаторием»:
 
#* Место в номере = Основное место
 
#* Место в номере = Основное место
 
#* Весь номер = Один в номере
 
#* Весь номер = Один в номере
 
#* Совместно = Без места
 
#* Совместно = Без места
 
#* Дополнительное место = Дополнительное место
 
#* Дополнительное место = Дополнительное место
#: Исключение: ситуация, когда в «1С: Отель» в номер заселены два (или более) гостя, у одного вариант проживания — «Один в номере», у другого — «Дополнительно место». В этом случае в «Кинт: Управление санаторием» перейдет вариант «Без места».  
+
#: Исключение: ситуация, когда в «1С:Отель» в номер заселены два (или более) гостя, у одного вариант проживания — «Один в номере», у другого — «Дополнительное место». В этом случае в «Кинт: Управление санаторием» перейдет вариант «Без места».  
# Тариф — заполняется в качестве номенклатуры пребывания (соответствие устанавливается по наименованию).
+
# Время заезда и выезда.
# Медицинские услуги по путевке — заполняются в качестве варианта лечения (соответствие устанавливается по наименованию).
+
# Количество дней (считается по датам заезда и выезда).  
# Пакет медицинских услуг — заполняется в качестве варианта лечения (соответствие устанавливается по наименованию).
+
# Вариант лечения (определяется по пакету медицинских услуг в «1С:Отель»; сопоставление возможно, если пакет входит в группу, указанную в настройке «Группа пакетов мед. услуг» в «Кинт: Управление санаторием»).
# Услуга питания — заполняется в качестве варианта питания (соответствие устанавливается по наименованию).
+
# Стоимость проживания, лечения и питания.
 
 
В «Кинт: Управление санаторием» должны быть заранее созданы элементы, соответствующие данным из 1С: Отель, с точно совпадающими наименованиями:
 
* Номера гостиницы — элементы справочника «Помещения — Гостиничный номер».
 
* Номенклатура пребывания — аналог тарифа.
 
* Варианты лечения — соответствуют медицинским услугам и пакетам медицинских услуг.
 
* Варианты питания — соответствуют услугам питания.
 
 
 
Сопоставление происходит по наименованию: если названия не совпадают, корректное сопоставление невозможно.
 
 
 
 
 
 
 
 
 
 
 
  
 +
Не передаются:
 +
* Комментарий из «1С:Отель».
 +
* Вариант питания — в карте гостя устанавливается значение по умолчанию.
  
 +
Для корректного сопоставления данных необходимо занести в справочники «Кинт: Управление санаторием» номера гостиницы, номенклатуру пребывания, варианты лечения и группы услуг с наименованиями, идентичными их аналогам в «1С:Отель».
  
 +
== Настройка интеграции ==
  
 +
Для настройки выполните следующие шаги:
  
== Форма расширения ==
+
# Установите расширение «Обмен1СОтель», следуя [[Инструкция по установке расширений|инструкции]].
Расширение «Обмен данными с 1С:Отель» позволяет выполнять обмен данными между «Кинт: Управление санаторием» и «1С:Отель». Производить обмен можно как вручную, так и автоматически по заданному регламенту.
+
# Перейдите в раздел «Обмен с 1С:Отель», предназначенный для настройки и выполнения обмена. Он отобразится в разделе программы АДМИНИСТРИРОВАНИЕ — '''Обмен данными''' после установки расширения.
Чтобы настроить регламентное задание для обмена:
+
# Заполните данные:
# Откройте форму расширения и поставить галочку напротив строки «Выполнять по расписанию»
+
#* База «1С:Отель» — выбирается из справочника «Информационные базы». Если нужного элемента нет, его необходимо создать, заполнив карточку информационной базы. Данные для этого предоставляет ИТ-специалист санатория.
# Кликните по появившейся ссылке справа от строки. Откроется окно «Расписание».
+
#* Организация — указывается при мультифирменном учете, когда в программе заведено несколько организаций.
# Подберите необходимое расписание и нажмите '''''ОК'''''.
+
#* Группа мед. услуг, Группа пакетов мед. услуг и Группа услуг питания — заносятся наименования групп из «1С:Отель».
: [[Файл:Обмен с 1С-Отель настройка расписания.png|800px]]
+
#*:В «1С:Отель» для медицинских услуг должен быть снят флаг «По умолчанию это доход от продажи номеров».
После этого в «Консоли заданий» появится соответствующая строка:
+
# Активируйте опцию «Регистрировать карты гостя», чтобы при обмене в программе создавались зарегистрированные карты гостей.
: [[Файл:Консоль заданий обмен 1СОтель.png|900px]]
+
# Опцию «Без проживания» можно активировать, если не требуется учитывать вариант проживания гостя. Актуально, если номерной фонд не актуализируется или ведется условно.
 +
# Задайте период, за который будут выгружаться данные из «1С:Отель». Для регулярного обмена рекомендуется использовать «Последние 7 дней». При внеплановой выгрузке можно указать необходимый период.
 +
# При необходимости настройте выполнение обмена в автоматическом режиме:  
 +
## Активируйте опцию «Выполнять по расписанию».
 +
## Кликните по ссылке «Расписание».
 +
## В открывшемся окне укажите дни и периодичность запуска задания по выполнению обмена.
 +
## В разделе АДМИНИСТРИРОВАНИЕ – '''Сервис''' – «Консоль заданий» в регламентном задании укажите пользователя с правами администратора.
  
== Настройка расширения ==
+
Запуск обмена осуществляется нажатием кнопки '''''Выполнить обмен'''''. По завершении обмена информация отображается в табличной части раздела.
# Установите расширение, используя [[Инструкция по установке расширений|«Инструкцию по установке расширений»]].  
+
:[[Файл:Обмен с 1С Отель.png|900px]]
# Опубликуйте http-сервисы расширения:
 
#: [[Файл:Настройка публикации.png]]
 

Текущая версия на 10:33, 25 декабря 2025

Интеграция программы «Кинт: Управление санаторием» с программой «1С:Отель» предназначена для случаев, когда организация ведет гостиничный учет в «1С:Отель», а в «Кинт: Управление санаторием» использует модуль «Медицина» для учета пациентов, назначения процедур и выполнения других медицинских задач.

Данные о заселении гостей передаются из «1С:Отель» в «Кинт: Управление санаторием», где на их основании автоматически создаются карты гостей и их медицинские формы — карты пациентов. При отсутствии лицензии на модуль «Гостиница» в интерфейсе программы доступны для работы только карты пациентов.

Какие данные передаются

На основании данных документа размещения в «1С:Отель» создается карта гостя в «Кинт: Управлении санаторием».

Напрямую передаются данные:

  1. Номер и дата документа.
  2. Даты заезда и выезда.
  3. Номер гостиницы.
  4. Номенклатура пребывания (устанавливается по тарифу в «1С:Отель»).
  5. Организация.
  6. Автор документа (устанавливается по пользователю в «1С:Отель»).

Вычисляются алгоритмами программы:

  1. Вариант проживания — устанавливается через сопоставление значений «1С:Отель» с вариантами в «Кинт: Управление санаторием»:
    • Место в номере = Основное место
    • Весь номер = Один в номере
    • Совместно = Без места
    • Дополнительное место = Дополнительное место
    Исключение: ситуация, когда в «1С:Отель» в номер заселены два (или более) гостя, у одного вариант проживания — «Один в номере», у другого — «Дополнительное место». В этом случае в «Кинт: Управление санаторием» перейдет вариант «Без места».
  2. Время заезда и выезда.
  3. Количество дней (считается по датам заезда и выезда).
  4. Вариант лечения (определяется по пакету медицинских услуг в «1С:Отель»; сопоставление возможно, если пакет входит в группу, указанную в настройке «Группа пакетов мед. услуг» в «Кинт: Управление санаторием»).
  5. Стоимость проживания, лечения и питания.

Не передаются:

  • Комментарий из «1С:Отель».
  • Вариант питания — в карте гостя устанавливается значение по умолчанию.

Для корректного сопоставления данных необходимо занести в справочники «Кинт: Управление санаторием» номера гостиницы, номенклатуру пребывания, варианты лечения и группы услуг с наименованиями, идентичными их аналогам в «1С:Отель».

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

Для настройки выполните следующие шаги:

  1. Установите расширение «Обмен1СОтель», следуя инструкции.
  2. Перейдите в раздел «Обмен с 1С:Отель», предназначенный для настройки и выполнения обмена. Он отобразится в разделе программы АДМИНИСТРИРОВАНИЕ — Обмен данными после установки расширения.
  3. Заполните данные:
    • База «1С:Отель» — выбирается из справочника «Информационные базы». Если нужного элемента нет, его необходимо создать, заполнив карточку информационной базы. Данные для этого предоставляет ИТ-специалист санатория.
    • Организация — указывается при мультифирменном учете, когда в программе заведено несколько организаций.
    • Группа мед. услуг, Группа пакетов мед. услуг и Группа услуг питания — заносятся наименования групп из «1С:Отель».
      В «1С:Отель» для медицинских услуг должен быть снят флаг «По умолчанию это доход от продажи номеров».
  4. Активируйте опцию «Регистрировать карты гостя», чтобы при обмене в программе создавались зарегистрированные карты гостей.
  5. Опцию «Без проживания» можно активировать, если не требуется учитывать вариант проживания гостя. Актуально, если номерной фонд не актуализируется или ведется условно.
  6. Задайте период, за который будут выгружаться данные из «1С:Отель». Для регулярного обмена рекомендуется использовать «Последние 7 дней». При внеплановой выгрузке можно указать необходимый период.
  7. При необходимости настройте выполнение обмена в автоматическом режиме:
    1. Активируйте опцию «Выполнять по расписанию».
    2. Кликните по ссылке «Расписание».
    3. В открывшемся окне укажите дни и периодичность запуска задания по выполнению обмена.
    4. В разделе АДМИНИСТРИРОВАНИЕ – Сервис – «Консоль заданий» в регламентном задании укажите пользователя с правами администратора.

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

Обмен с 1С Отель.png