¶ Описание
Обмен производится в формате EnterpriseData от 1С новость 1С о EnterpriseData, документация 1С. Из ClubIS в 1С выгружаются документы и справочники. Обратно в ClubIS вручную загружаются только поступления товаров: документ 1С становится складским приходом. Автоматической синхронизации в сторону ClubIS нет, и ClubIS не отправляет подтверждения протокола обмена.
Выгрузить XML можно через файл (каталог обмена / FTP) или через web-service ClubIS — см. раздел Выгрузка через web-service. Загрузка поступлений описана в разделе Загрузка поступлений в ClubIS.
¶ Настройка синхронизации в 1С
¶ 
В разделе "Администрирование" выберите "Настройки синхронизации данных".
¶ 
Установите галочку "Синхронизация данных" и выберите справа пункт "Синхронизация данных".
¶ 
Нажмите на кнопку "Настроить синхронизацию данных" и выберите пункт "Через универсальный формат обмена" подпункт "Другая программа"
¶ 
Установите режим "Указать настройки вручную"
¶ 
Установите режим "Другие каналы связи (сетевой каталог, FTP, электронная почта)"
¶ 
Выберите "Каталог", через который будет производиться обмен
¶ 
Снимите галочку "Настроить подключение через FTP-ресурс"
¶ 
Снимите галочку "Настроить подключение по электронной почте"
¶ 
''В поле "Наименование другой информационной базы" укажите "КлабИС", а в поле "Префикс" значение "КП"
¶ 
Проверьте введённые данные
¶ 
Нажмите "Готово"
Настройка завершена.
¶ Настройка выгрузки из клубной программы
В справочнике Юридические лица (раздел Справочники в модуле Администратор) заполните для юр. лица поля "Название", "Короткое название" и "Полное название". Например:
Название = Ромашка ООО
Короткое название = ООО Ромашка
Полное название = Общество с ограниченной ответственностью "Ромашка"
Правильные значения этих параметров можно посмотреть в 1С в разделе Главное, в справочнике Организации.
В 1С "Наименование в программе" = "Название" в клубной.
В 1С "Сокращенное наименование" = "Короткое название" в клубной.
В 1С "Полное наименование" = "Полное название" в клубной.
Для банковского счёта в реализации на вкладке «Основное» заполните «Банк», «БИК», «Кор. счёт» и «Счёт». Как эти поля попадают в документ — в разделе Реализация.
¶ Выгрузка данных из клубной программы
Запустите модуль Администратор, в разделе "Обслуживание" после нажатия кнопки "Мастер изменения данных" выберите пункт "Экспорт в EnterpriseData от 1С".
То же окно открывает кнопка «Экспорт в 1С» в модуле Бухгалтерия.
Выберите "Путь" (должен совпадать с указанным в настройках синхронизации в 1С), задайте "Период" для выгрузки и нажмите "Ок".
Если выставить опцию выгрузки контрагентов в положение "Не выгружать", то все документы будут выгружаться на контрагента "Клиент клуба".
¶ Реализация
Документ реализации формируется, если в «Выгружаемые данные» включена «Реализация», а в «Операции» включены «Чеки» и/или «Контракты». Выгрузка через web-service заполняет документ так же. НДС строки считается от суммы этой строки.
Склад. Для чека в документ попадает склад продажи: поле «Название:» из Администратор → Справочники → Склады. Берётся склад первого складского документа по этому чеку. Если у чека склада нет или в первом документе склад не указан, склад в реализации остаётся пустым. В реализации по контрактам склад не заполняется.
Список «Склады» в окне экспорта ограничивает поступление и списание. Склад в реализации берётся из складского документа чека.
Если включено «Суммировать по дням» и отмечено «ПКО», чеки одного дня собираются в общие документы: отдельно по каждому юрлицу продажи и каждому складу. Продажи без склада идут своим документом. Документ без склада, если он есть за этот день, получает первый номер дня. Каждый следующий документ того же дня получает добавку к номеру.
Повторная загрузка файла добавляет документы и оставляет уже созданные в 1С. Лишний документ за тот же день удаляют в 1С вручную.
Банковский счёт. В реализацию записывается «Счёт» организации из шапки документа. Реквизиты берутся из карточки Администратор → Справочники → Юридические лица, вкладка «Основное»: «Счёт», «Банк», «БИК», «Кор. счёт». Пустое поле «Счёт» оставляет банковский счёт в реализации пустым.
Если в «Юр. лица» отмечен принципал и не отмечен его агент, продажи агента выгружаются на принципала: в шапке его название и его «Счёт». Продажи агента и собственные продажи принципала за один день остаются разными документами. Связь задаётся в карточке юрлица: «Является принципалом» и вкладка «Принципалы».
Договор. В группе «Договоры» значение «Основной договор» записывает в документ договор с названием «Основной договор» — и в отдельную реализацию, и в документ за день. Значение «Название услуги» подставляет имя услуги только в реализацию без суммирования по дням. В документе за день при этом значении название договора из клубной программы не передаётся.
При «Суммировать по дням» контрагент реализации — «Клиент клуба».
В диалоге экспорта можно сохранить текущие параметры в JSON (Сохранить параметры… / Копировать JSON) или загрузить их обратно (Загрузить параметры…). Полученный JSON совпадает с телом запроса POST /api/enterprisedata/export и удобен для настройки автоматического обмена через web-service.
¶ Автоматическая выгрузка
Добавьте в планировщик задач Widndows запуск конвертера (путь для исполняемого файла может отличаться):
"C:\Program Files (x86)\ClubIS\Fitness 3\converter.exe" -edi -u=имя пользователя -p=пароль пользователя`
Выгрузка пройдёт с использованием последних параметров использованных в ручной выгрузке. Данные будут за вчерашний день.
¶ Выгрузка через web-service
Тот же XML, что формирует мастер экспорта, можно получить по HTTP из web-service ClubIS — удобно для автоматического обмена без общего каталога файлов.
Метод: POST /api/enterprisedata/export
Ответ: файл XML (application/xml), имя вида Message_КП_БП.xml.
Авторизация — как у других методов /api/*: в query или заголовках USER_ID и USER_HASH, либо параметр token. У учётной записи обязательно должно быть разрешение EnterpriseData 1C во вкладке «API» свойств сотрудника — оно проверяется всегда, даже если опция «Ограничивать доступ сотрудников к API» выключена.
В теле запроса (application/json) можно указать период (date_from, date_to). Если период не передан, выгрузка идёт за вчерашний день — так же, как при запуске converter.exe -edi. Остальные поля необязательны: если не переданы, используются последние настройки из мастера экспорта. Пустое тело запроса допускается. Вызов через API не меняет сохранённые настройки мастера.
Готовый JSON можно получить из диалога экспорта в ClubIS (Администратор → Обслуживание → Мастер изменения данных → Экспорт в EnterpriseData от 1С): кнопки Сохранить параметры… и Копировать JSON.
| Параметр | Описание |
|---|---|
date_from, date_to |
период выгрузки (YYYY-MM-DD); если оба поля не переданы — вчерашний день |
from_prefix, to_prefix |
Префиксы клубной базы и 1С в имени файла |
data_mode, operations_mode |
Какие данные и операции выгружать (как флажки в мастере) |
contragents_mode |
Контрагенты: все / из документов / не выгружать / в комментарий |
acts_mode |
Реализация по продажам или по оплатам |
paytypes |
Список видов оплат |
day_sum, day_sum_one |
Суммирование по дням |
legal_ids, store_ids |
«Юр. лица» ограничивают выгрузку; «Склады» — только поступление и списание |
price_group, dds_mode, deals_mode |
Группы номенклатуры, ДДС, договоры |
Пример:
curl -X POST "https://сервер:порт/api/enterprisedata/export?USER_ID=…&USER_HASH=…" \
-H "Content-Type: application/json" \
-o Message_КП_БП.xml \
-d '{
"date_from": "2026-08-01",
"date_to": "2026-08-06",
"data_mode": 124,
"operations_mode": 15,
"contragents_mode": 2,
"paytypes": [1, 3]
}'
Полученный файл сохраните в каталог обмена 1С (или загрузите иным способом) и выполните синхронизацию в 1С, как описано ниже.
¶ Загрузка поступлений в ClubIS
В том же окне, что и выгрузка, есть кнопка Импорт поступлений…. Окно открывается из Администратор → Обслуживание → Мастер изменения данных → Экспорт в EnterpriseData от 1С и кнопкой Экспорт в 1С в модуле Бухгалтерия.
Нужно право Добавить для склада в модуле Бухгалтерия. Если обновление базы с идентификаторами 1С ещё не применено, импорт недоступен и программа сообщает об этом.
В меню кнопки два пункта:
- Выбранные XML-файлы — загружаются только отмеченные файлы. Если окно выбора закрыть без файлов, загрузка не начинается.
- Входящий файл каталога — загружается один файл
Message_<префикс 1С>_<префикс клубной>.xmlиз каталога в поле Путь:. Остальные файлы каталога не читаются.
Префикс клубной: и Префикс 1С: должны быть заполнены и различаться. В заголовке файла отправитель — префикс 1С, получатель — префикс клубной. Выгрузка ClubIS, даже переименованная, не загружается.
Принимаются сообщения EnterpriseData версий 1.6 и 1.17 с составом поступления, как в выгрузке ClubIS. Файл с другой версией или с обрывом в конце не записывает ни одного документа. Ошибка одного документа не мешает остальным документам того же файла. Итог показывается в окне Результат.
В приход попадает проведённая покупка у поставщика. Документ с пометкой удаления и явно непроведённый документ пропускаются. Если признак проведения в файле не указан, документ загружается. Услуги, излишки, недостачи и дополнительные расходы в приход не входят: окно Результат называет эти разделы. Характеристика, серия, упаковка или данные ГТД в строке отклоняют весь документ. Номенклатура, которой нет в ClubIS, не создаётся.
Товар или материал ищется по идентификатору 1С, затем по коду ClubIS из префикса клубной и номера карточки, затем по точному наименованию. Подходит активная складская карточка. Несколько совпадений, неактивная карточка или уже записанный другой идентификатор 1С останавливают документ и не меняют справочники. Поставщика без карточки программа создаёт вместе с приходом. Склад и организация должны находиться однозначно; новый склад не создаётся.
В приход записывается закупочное количество и закупочная сумма. Розничная цена из файла не переносится и не меняет карточку. Единица измерения должна совпадать с карточкой; для штук подходят код 796 и названия «шт», «штука», «штуки», «штук», если карточка тоже в штуках. Валюта документа должна совпадать с валютой учёта. Ставка НДС берётся из справочника ставок.
Повтор того же документа не обновляет уже созданный приход, даже если в файле другие суммы или количество. Документ с ошибкой не оставляет частичных строк, нового поставщика и новых идентификаторов. После успешной загрузки список склада в модуле Бухгалтерия обновляется.
Кнопки Сохранить параметры…, Загрузить параметры… и Копировать JSON по-прежнему сохраняют и читают параметры выгрузки.
¶ Загрузка данных в 1С
¶ 
В разделе "Администрирование" выберите "Настройки синхронизации данных".
¶ 
Установите галочку "Синхронизация данных" и выберите справа пункт "Синхронизация данных".
¶ 
Нажмите кнопку "Синхронизировать".
¶ 
Дождитесь окончания процесса синхронизации.
Синхронизация данных завершена. Нажмите "Закрыть".
¶ Конфигурация для Казахстана
В ней есть ошибка, которая лечится только правкой конфигурации. В пакете XDTO версии 1.6 (а, более новые версии эта конфигурация не поддерживает) не хватает поля "Касса" в ПКОРасчетыСКонтрагентами. А, это поле обрабатывается в коде загрузки XDTO и без него падает в ошибку при загрузке приходных кассовых ордеров.
Откройте конфигурацию и в ней откройте Общие -> XDTO-пакеты -> EnterpriseData_1_6_23. В ней в разделе Типы объектов найдите Документ.ПКОРасчетыСКонтрагентами и добавьте туда элемент Касса, строго после Контрагент и перед ВидРасчетов. Тип
КлючевыеСвойстваКасса (http://v8.1c.ru/edi/edi_stnd/EnterpriseData/1.6)
