Переключение темы
Айтида обменивается данными с кассовой программой Frontol 6 и Frontol xPOS 3 через текстовые файлы в формате "АТОЛ". Обмен двусторонний:
- выгрузка - Айтида передает во Frontol товары, группы, штрихкоды, цены, налоги, пользователей, дисконтные карты, клиентов, скидки и другие справочники;
- загрузка - Айтида забирает из Frontol кассовые транзакции (продажи, возвраты, внесения, выплаты, смены) и формирует по ним документы кассовой смены и другие документы.
Обмен выполняются посредством профилей оборудования "Обмен данными с Фронтол 6" и "Обмен данными с Frontol xPOS3". Профили рассчитаны на Frontol 6.28.0, Frontol xPOS 3.16.0 и выше и Айтиду версии 4.7.5 и выше.
ИНФОРМАЦИЯ
Описание формата файлов обмена - в документе АТОЛ "Frontol. Руководство интегратора", раздел "Обмен с АСТУ - Формат АТОЛ". Настройки обмена на стороне Frontol - в документе "Frontol. Руководство администратора", раздел "Обмен данными".
Как устроен обмен
Обмен идет через пары файлов "файл данных + файл-флаг":
- Выгрузка во Frontol. Айтида записывает данные в файл загрузки Frontol и создает файл-флаг. Служба FrontolService видит флаг, загружает файл, меняет в нем признак
#на@и удаляет флаг. Результат загрузки Frontol пишет в файлLoadResult<идентификатор БД>.txt. - Загрузка из Frontol. Айтида создает файл-флаг с командой, какие транзакции выгрузить (новые, за период, за смены и т. д.). Frontol выгружает транзакции в файл выгрузки и удаляет флаг. Айтида загружает файл и формирует документы.
Пока Frontol не обработал предыдущую выгрузку (файл-флаг еще существует), новые данные в эту кассу не выгружаются - Айтида выдает ошибку "Обнаружены необработанные данные (найден файл-флаг …)". Если Frontol еще не загрузил файл данных (признак #), новая выгрузка дописывается в конец этого файла.
Два механизма загрузки продаж
Загруженные продажи можно хранить двумя способами.
| Классический (таблица транзакций) | Через таблицу чеков | |
|---|---|---|
| Где хранятся продажи | Кассовые транзакции, как они пришли из Frontol | Чеки, строки чеков, оплаты - в тех же таблицах, что и у Айтида РМК |
| Как формируются документы | Из транзакций загруженного файла | Из загруженных чеков |
| Универсальный отчет по чекам | Нет | Да |
| Остатки с учетом текущих продаж на кассах | Нет | Да |
| Как включить | Используется по умолчанию | Параметр профиля "Загружать чеки" |
Механизм чеков появился в профилях с версии Айтиды 4.4.9. Его преимущества: продажи хранятся в таблицах, приспособленных для чеков (меньше места, быстрее доступ); по чекам работает универсальный отчет по чекам; фиксируется факт обработки чека и включения его в документ кассовой смены; становятся доступны остатки с учетом текущих продаж на кассах. Как включить механизм - в разделе Включение механизма чеков. Правила, по которым транзакции превращаются в документы, в двух механизмах немного отличаются - см. раздел Правила загрузки продаж.
Настройка
Настройка Frontol
В приложении "Frontol Администратор" откройте "Настройки \ БД и обмен данными \ Обмен данными \ План обмена" и создайте задание:
- Закладка "Общее": установите флаг "Автоматический обмен" и задайте "Период выполнения, сек." - как часто служба FrontolService проверяет файлы-флаги. Для ручного обмена с кассы можно дополнительно установить флаг "Ручной обмен".
- Закладка "Формат": формат "АТОЛ". В группе "Файлы" укажите:
- Файл загрузки и Файл-флаг загрузки - файлы, которые создает Айтида при выгрузке справочников;
- Файл выгрузки и Файл-флаг выгрузки - файлы для выгрузки продаж в Айтиду.
- Закладка "Каналы": добавьте входящий и исходящий канал типа "Каталог" (или FTP, e-mail) с папкой обмена.
После изменения настроек перезапустите службу FrontolService или перезагрузите кассовый компьютер.
Для загрузки продаж через таблицу чеков удобно включить оперативную сводку (там же, в разделе "Обмен данными"): Frontol будет сам выгружать закрытые чеки, и Айтида сможет загружать их в течение смены.
ВНИМАНИЕ
Коды товаров во Frontol - целые числа. Не используйте в Айтиде коды товаров ("Код в главной базе") с лидирующими нулями: при загрузке продаж товары ищутся по этому коду.
Настройка Айтиды
- Загрузите профиль оборудования "Обмен данными с Фронтол 6" или "Обмен данными с Frontol xPOS 3" из поставки обновления (подробнее - Подключение профилей оборудования).
- В справочнике "Торговое оборудование" создайте карточку ККМ и выберите в ней профиль. Общие поля карточки описаны в разделе ККМ руководства администратора.
- Заполните пути к файлам так, чтобы они совпадали с заданием Frontol:
| Карточка ККМ в Айтиде | Задание Frontol |
|---|---|
| "Выгрузка данных" - "Имя файла" | Файл загрузки |
| "Выгрузка данных" - "Имя файла флага" | Файл-флаг загрузки |
| "Загрузка данных" - "Имя файла" | Файл выгрузки |
| "Загрузка данных" - "Имя файла флага" | Файл-флаг выгрузки |
| Параметры выгрузки данных | Параметры загрузки данных |
|---|---|
 |  |
На вкладке "Прочие параметры" укажите фирму, склад и денежный карман кассы и заполните список фискальных регистраторов.
Сохраните карточку и откройте параметры профиля (кнопка настройки профиля в карточке). Параметры описаны в следующем разделе.
Если из Frontol нужно загружать нефискальные документы (приход и расход товаров, инвентаризацию и т. п.) отдельными документами Айтиды, укажите в форме обмена коды видов документов Frontol - см. Сопоставление типов документов.
Признаки карточки, которые учитывает профиль:
| Признак карточки | Влияние на обмен |
|---|---|
| "Выгружать коды налогов" | Выгружаются ставки и налоговые группы, у товаров заполняется налоговая группа |
| "Выгружать разрезы товаров" и переключатель "Карточки и разрезы / Карточки / Разрезы" | Выгружаются схемы, разрезы, значения разрезов и остатки по разрезам |
| "Не выгружать остатки" / "Перезаписывать" / "Добавлять" | "Перезаписывать" - начальный остаток во Frontol заменяется ($$$REPLACEQUANTITYWITHOUTSALE), в остальных случаях добавляется ($$$ADDQUANTITY) |
| "Ручной обмен данными при загрузке" | Айтида не создает файл-флаг выгрузки, а сразу берет готовый файл продаж |
| "Проверять признак загрузки файла" | Загружаются только файлы с признаком # в первой строке |
| "Не сохранять транзакции" | Транзакции не сохраняются в базе после формирования документов; рекомендуется для механизма чеков |
Параметры профиля
Параметры задаются в форме настройки профиля и хранятся отдельно для каждой карточки оборудования.
ИНФОРМАЦИЯ
Раньше эти настройки задавались константами системы (_ВЫГРУЖАТЬГРУППЫПЕЧАТИ_ФРОНТОЛ52, _ФРОНТОЛ_ЗАГРУЖАТЬЧЕКИ и другими). При открытии формы профиль предлагает перенести значения констант в параметры, а после сохранения - удалить константы. Пока константа существует и равна "Истина", она имеет приоритет над параметром, и выключить опцию формой нельзя.
| Настройки выгрузки | Настройки загрузки |
|---|---|
 |  |
Настройки выгрузки
| Параметр | По умолчанию | Назначение |
|---|---|---|
| Выгружать группы печати из доп.свойств | Да | Группы печати чека, копии, счета и марки берутся из дополнительных свойств товара КодГруппыПечатиЧека, КодГруппыПечатиКопии, КодГруппыПечатиСчета, КодГруппыПечатиМарки. Если параметр выключен, в группу печати выгружается код ФР из группы ресурсов, выбранной в карточке товара |
| Выгружать модификаторы | Нет | Выгружаются группы модификаторов и модификаторы, их связь с товарами, а также меню из документов "План-меню" |
| Выгружать алкокоды | Нет | Выгружаются алкокоды ЕГАИС товаров |
| Выгружать спец.цены | Нет | Действующие документы переоценки выгружаются маркетинговыми акциями "СПЕЦЦЕНЫ" |
| Выгружать классификаторы | Нет | Группы ресурсов выгружаются классификаторами товаров, товары привязываются к ним |
| Выгружать реквизиты агентов | Нет | Для агентских товаров выгружаются реквизиты поставщика-агента |
| Выгружать прайс-листы | Нет | Виды цен Айтиды (кроме категории цен склада кассы) выгружаются прайс-листами Frontol |
| Номер рабочего места | - | Коды рабочих мест Frontol через запятую для привязки меню. Если не заполнено, берется серийный номер из карточки оборудования |
| Налог на позицию по свободной цене | Не заполнять | Налоговая группа по умолчанию для продажи по свободной цене. Передается во Frontol при очистке ККМ |
| Налог на позицию по коду | Не заполнять | Налоговая группа по умолчанию для продажи по коду |
| Задержка перед формированием файла-флага (секунд) | - | Пауза перед созданием флага, например при передаче файлов через синхронизируемую папку |
| Определять налог по товару вместо фирмы | Нет | Налоговая группа берется из товара, даже если у фирмы задан свой налог или фирма не плательщик НДС |
Настройки загрузки
| Параметр | По умолчанию | Назначение |
|---|---|---|
| Использовать альтернативные параметры загрузки | Нет | При автоматической загрузке брать пути к файлам и признаки обмена из альтернативных параметров карточки |
| Загружать чеки | Нет | Записывать продажи в таблицу чеков (механизм чеков) |
| Формировать документы по загружаемым чекам | Нет | При ручной загрузке формировать документы из чеков. Если выключено, чеки загружаются только для отчетов, а документы формируются классическим способом |
| Формировать документы по загружаемым чекам при автоматической загрузке | Да | При автоматической загрузке через службу IDMService сразу формировать документы (по транзакциям загруженного файла). Если выключено, загружаются только чеки, а документ кассовой смены формируется позже - вручную через форму обмена или скриптом Сервис.РМКСоздатьДокументы( "", "" );. Автоматическая загрузка распознается, только если включен параметр "Использовать альтернативные параметры загрузки" |
| Определять тип документа только по форме обмена | Нет | Тип документа определяется только по кодам видов документов Frontol, заданным в форме обмена, для любой операции (см. Сопоставление типов документов) |
| Рабочие места - отдельные ККМ | Нет | Рабочие места Frontol сопоставляются с отдельными карточками оборудования по полю "Внешний код" |
| Делить строки товаров по видам оплат | Нет | Строки документа кассовой смены разделяются по видам оплаты чека |
| Загружать склад получателя для перемещений из комментария | Нет | Для внутренних перемещений склад-получатель берется из кода комментария документа Frontol |
| Учитывать деление упаковки на кассе | Да | Количество и цена пересчитываются для товаров, проданных частями упаковки |
| Коды операций оплат для суммы б/нал (через запятую) | 1,7 | Какие коды операций вида оплаты Frontol (поле 10 транзакции оплаты) считать безналичной оплатой: 1 - банковская карта или QR-код, 7 - пользовательская оплата (Frontol по умолчанию фискализирует ее как безналичную, поэтому эквайринг, заведенный пользовательским видом оплаты, учитывается без дополнительной настройки). Если пользовательским видом оформлена не безналичная оплата, например кредит, уберите 7 из списка |
| Задержка перед загрузкой файла продаж (секунд) | 0 | Пауза перед обработкой файла продаж |
Включение механизма чеков
Механизм чеков включается параметрами профиля из группы "Работа с чеками":
- Загружать чеки - продажи из файла Frontol записываются в таблицу чеков. Без этого параметра работает классический механизм.
- Формировать документы по загружаемым чекам - при ручной загрузке документы формируются из загруженных чеков. Если параметр выключен, чеки загружаются только для отчетов и остатков, а документы формируются классическим способом по транзакциям файла. Чеки Айтида РМК хранятся в тех же таблицах, поэтому при включенном параметре документы по продажам Frontol и РМК можно формировать единообразно.
- Формировать документы по загружаемым чекам при автоматической загрузке - для автоматической загрузки службой IDMService. Если выключить, служба будет только загружать чеки, а документ кассовой смены нужно формировать отдельно: вручную через форму обмена или скриптом
Сервис.РМКСоздатьДокументы.
Удобный вариант для оперативного контроля: настроить во Frontol автоматическое формирование сводки по продажам, а в Айтиде - автоматическую загрузку с выключенным третьим параметром. Тогда в течение дня чеки и остатки с учетом продаж обновляются, а документ кассовой смены формируется один раз, после закрытия смены. Если автоматическая загрузка выполняется раз в сутки и документ нужен сразу, третий параметр оставьте включенным.
В карточке оборудования при работе с чеками рекомендуется установить признак "Не сохранять транзакции" (вкладка "Загрузка данных"): транзакции после формирования документов не хранятся, и база растет медленнее.
В профилях до версии 4.7.9 механизм включался константами _ФРОНТОЛ_ЗАГРУЖАТЬЧЕКИ, _ФРОНТОЛ_ФОРМИРОВАТЬДОКУМЕНТЫИЗЧЕКОВ и _ФРОНТОЛ_ФОРМИРОВАТЬДОКУМЕНТПРИАВТОМАТИЧЕСКОЙЗАГРУЗКЕ - о переносе их значений в параметры см. Параметры профиля.
Что дает загрузка чеков - универсальный отчет по чекам, остатки с учетом текущих продаж, сведения для ГИИС ДМДК - описано на странице Чеки Frontol: отчеты и остатки.
Что выгружает профиль
Выгрузка запускается из формы "Сервис - Обмен данными с оборудованием". Товары выгружаются с вкладки "Выгрузка товаров", пользователи - с вкладки "Выгрузка кассиров", скидки, карты и клиенты - с вкладки "Скидки". Сначала выгружайте товары, потом скидки: скидки ссылаются на товары и группы, и Frontol отклонит скидку на товар, которого у него еще нет.
Товары и справочники
| Данные | Когда выгружаются | Особенности |
|---|---|---|
| Группы товаров | Всегда | Папки справочников ТМЦ и услуг. Идентификатор группы во Frontol = 1 000 000 000 + внутренний код папки |
| Товары и услуги | Всегда | Идентификатор = "Код в главной базе". Выгружаются цена, остаток, минимальная цена, срок годности, артикул, PLU, секция, макс. скидка, ёмкость, признак предмета расчета, способ расчета, мера количества, тип номенклатуры маркировки. Товары с нулевой ценой пропускаются, если в форме обмена не разрешена выгрузка товаров с нулевой ценой |
| Штрихкоды | Всегда | С коэффициентом штрихкода |
| Схемы разрезов, разрезы, значения, остатки по разрезам | Флаг карточки "Выгружать разрезы товаров" | Не более 5 разрезов в схеме |
| Налоговые ставки и группы | Флаг карточки "Выгружать коды налогов" | Ставка передается с актуальной на текущую дату записью |
| Виды оплат, группы сертификатов, сертификаты, комментарии | Всегда, если есть данные | Берутся из пользовательских таблиц "Фронтол виды оплат", "Фронтол группа сертификатов", "Фронтол сертификаты", "Фронтол комментарии" |
| Пользователи и сотрудники | Вкладка "Выгрузка кассиров" | Сотрудник связывается с пользователем Frontol, если у работника установлено доп. свойство ФронтолСправочникСотрудниковПользователь (тип логический) |
| Модификаторы и меню | Параметр "Выгружать модификаторы" | Меню - из документов "План-меню", по дням недели |
| Алкокоды | Параметр "Выгружать алкокоды" | |
| Спеццены | Параметр "Выгружать спец.цены" | Все проведенные переоценки, у которых не закончился срок акции |
| Классификаторы товаров | Параметр "Выгружать классификаторы" | Группы ресурсов, кроме папок, архивных и с признаком "не выгружать в ККМ" |
| Прайс-листы | Параметр "Выгружать прайс-листы" | |
| Реквизиты агентов | Параметр "Выгружать реквизиты агентов" | Для товаров с признаком агентского товара |
Как заполняются отдельные реквизиты товара:
- Наименование - полное наименование с весом или объемом, до 100 символов. Символ ";" заменяется на "¤", как требует формат.
- Флаги товара. Продажа, возврат, отрицательные остатки, списание остатков и редактирование цены разрешены всегда. Дробное количество - для весовых товаров и товаров с дробным количеством. Запрос цены - по признаку товара "Вводить цену". Деление упаковки - если для товара разрешено изменение количества.
- Маркировка. Для маркированных товаров тип номенклатуры определяется по товарной группе маркировки, признак "Разрешить продажу без КМ" - по признаку товара. Крепкий алкоголь выгружается как "Алкогольная продукция", маркированное пиво - как фасованное или разливное.
- Разливной крепкий алкоголь - цена пересчитывается за единицу объема ЕГАИС, мера количества - миллилитры.
- Признак предмета расчета - из группы ресурсов. Если не задан: подакцизный товар для алкоголя и пива, услуга для услуг, товар для остальных.
- Налоговая группа - при установленном флаге "Выгружать коды налогов" из товара. Если фирма кассы не плательщик НДС - группа "Без НДС", если у фирмы задан свой налог - налог фирмы (кроме случая, когда включен параметр "Определять налог по товару вместо фирмы").
Команды удаления
| Что удаляется во Frontol | Когда |
|---|---|
Все товары ($$$DELETEALLWARES) | Флаг "Очистить список товаров перед загрузкой" |
Выгружаемые товары по коду ($$$DELETEWARESBYWARECODE) | Если не установлены флаги "Очистить список…", "Не удалять товары перед загрузкой" и не выбрано "Перезаписывать" |
| Налоги, реквизиты агентов, пользователи, алкокоды выгружаемых товаров | Выгрузка с очисткой списка в ККМ |
Все маркетинговые акции ($$$DELETEALLMARKETINGACTIONS) | Любой из флагов вкладки "Скидки", удаляющих ставки, схемы или объекты скидок. Удаляются и акции спеццен |
| Все дисконтные карты | Флаг "Удалять дисконтные карты перед загрузкой" |
ВНИМАНИЕ
Если в одном файле стоят команды полного удаления и добавления, Frontol не удаляет записи физически, а только помечает их на удаление (см. "Руководство интегратора"). Чтобы реально очистить справочник, выполните выгрузку с очисткой отдельно, дождитесь ее загрузки во Frontol и только потом выгружайте данные.
Правила выгрузки скидок
Скидки Айтиды выгружаются во Frontol маркетинговыми акциями. Каждая схема скидок становится отдельной акцией, код акции = код схемы + 5. Внутри акции создаются мероприятия: действие (какую скидку дать) и условия (когда ее дать).
Перед выгрузкой для группы "Скидки" устанавливается правило объединения "Максимум": если сработало несколько акций, применяется та, что дает наибольшую скидку.
Какое действие получает схема
| Скидка в Айтиде | Объекты схемы | Действие во Frontol |
|---|---|---|
| Автоматическая | Товары или группы товаров | Товарная скидка - список товаров и групп с процентом (или суммой) по каждому объекту |
| Автоматическая | Только дисконтные карты или клиенты | Скидка на документ |
| Ручная | Товары или группы товаров | Ручная скидка + условие "Товар" (см. ниже) |
| Ручная | Только карты или клиенты, либо без объектов | Ручная скидка без условия "Товар" |
| Автоматическая | Без объектов | Не выгружается |
Для ручной скидки выгружаются:
- назначение - на позицию или на чек;
- тип значения - процент или сумма;
- значение - фиксированное или, если в карточке скидки задан диапазон "с … по …", кассир вводит значение из диапазона.
Значение скидки берется из объекта схемы. Для ручной скидки, если в объекте значение не задано, оно берется из карточки скидки.
Ручная скидка на товары и группы
Frontol объединяет условия одного мероприятия по "И". Поэтому для ручной скидки на несколько товаров или групп создается отдельное мероприятие на каждый товар или группу внутри одной акции. К имени такого мероприятия добавляется наименование товара или группы, например "Скидка на бакалею (Чипсы)", "Скидка на бакалею (Приправы)".
ВНИМАНИЕ
Условие "Товар" во Frontol проверяет наличие товара в чеке, а не товар текущей позиции. Ручная скидка "на текущую позицию" станет доступна кассиру, как только в чеке появится товар из схемы, и ее можно применить к любой позиции чека. Если в чеке нет товаров схемы, скидка недоступна.
Условие "Товар" ссылается на товар или группу по идентификатору, поэтому к моменту загрузки скидок товары и группы уже должны быть во Frontol. Иначе Frontol вернет ошибку "значение кода … недопустимо для поля 3".
Условия скидки
Кроме товаров, во Frontol передаются условия из карточки скидки и схемы:
| Ограничение в Айтиде | Условие во Frontol |
|---|---|
| Дисконтные карты схемы | "Классификаторы карт". Для схемы с картами создается классификатор (код = 1 500 000 000 + код схемы), к нему привязываются номера карт |
| Клиенты схемы | "Клиенты" |
| Диапазон суммы чека | "Сумма документа" (от и до) |
| Диапазон суммы позиции | "Сумма товара" (от и до) |
| Диапазон количества в чеке | "Количество" (от и до) |
| Диапазон количества позиции | "Количество товара" (от и до) |
| Время действия | "Время действия" |
| Дни недели | "Дни недели" |
| Скидка по дате рождения клиента | "Дата рождения клиента" |
Период действия схемы становится периодом действия акции.
ВНИМАНИЕ
В профилях до версии 4.7.9 (октябрь 2026) классификатор карт схемы получал код, равный коду схемы, и мог совпасть с классификатором группы ресурсов с тем же кодом. Начиная с версии 4.7.9 код классификатора карт = 1 500 000 000 + код схемы. После обновления профиля заново выгрузите дисконтные карты и схемы скидок с картами (вкладка "Скидки" формы обмена): классификатор с новым кодом создается при выгрузке карт, а условие скидки начинает ссылаться на него при выгрузке схем. Пока карты не выгружены, скидка по картам схемы не сработает. Классификаторы карт со старыми кодами остаются во Frontol; при необходимости удалите их вручную.
Дисконтные карты и клиенты
- Дисконтные карты выгружаются с видом карты, сроком действия и признаком блокировки. Символ ";" в номере карты заменяется на "¤".
- Клиенты и папки клиентов выгружаются в справочник клиентов Frontol. Идентификатор папки = 1 000 000 000 + внутренний код папки.
- Привязка карт к клиентам выгружается, если в форме обмена установлен флаг "Выгружать карты клиентов".
Правила загрузки продаж
Запуск загрузки
Загрузка запускается из формы обмена (вкладка "Загрузка данных") или автоматически службой Айтиды IDMService. Если в карточке не установлен флаг "Ручной обмен данными при загрузке", Айтида создает файл-флаг выгрузки с командой для Frontol:
| Выбор в форме обмена | Команда Frontol |
|---|---|
| Новые продажи | $$$NEWTRANSACTIONS - транзакции, еще не выгруженные ранее |
| За период | $$$TRANSACTIONSBYDATETIMERANGE - за период по дате и времени |
| Кассовые смены | $$$TRANSACTIONSBYSESSIONSRANGE - за диапазон смен |
| Все продажи, хранящиеся в ККМ | $$$ALLTRANSACTIONS |
| Загрузить последнюю кассовую смену | $$$LASTSESSIONTRANSACTIONS |
Команда выгружает транзакции всех рабочих мест базы Frontol. Когда Frontol удалит флаг, Айтида загружает все файлы, подходящие под маску "Имя файла". При ручной загрузке исходный файл после чтения переименовывается в <имя файла><дата и время>.bak.
Какие транзакции обрабатываются
| Транзакции Frontol | Что делает Айтида |
|---|---|
| Регистрация и сторно товара (1, 2, 11, 12) | Строки документа: товар, количество, цена, сумма со скидками |
| Модификаторы (30, 31) | Строки документа (только в классическом механизме) |
| Открытие документа (42) | Начало чека; склад получателя для перемещений |
| Оплаты (40, 41, 43) | Суммы оплат, безналичная часть, деление по видам оплат |
| Закрытие документа в ККТ (45) | Фискальные данные чека: регистрационный номер ККТ, ФН, ФД, ФП (механизм чеков) |
| Закрытие документа (55) | Контрагент по коду клиента Frontol; запись чека |
| Отмена документа (56) | Строки чека исключаются |
| Внесение и выплата (50, 51) | Внесения и выплаты |
| Открытие и закрытие смены, Z-отчет (61–64) | Границы смены; дата закрытия смены |
| Постановка на кран (операция 27) | Документ маркировки "Постановка на кран" |
Скидки отдельно не разбираются: в строке товара уже есть сумма со скидками. Если в карточке задан список фискальных регистраторов, транзакции групп печати, которых нет в списке, пропускаются (кроме оплат). Операции вскрытия тары, постановки и снятия с крана в продажи не попадают.
Сопоставление типов документов
Продажи, возвраты и другие фискальные операции попадают в документ кассовой смены (ДКС). Нефискальные документы Frontol можно загружать в другие документы Айтиды. Тип документа Айтиды определяется по двум признакам документа Frontol:
- операция (вид операции ККМ в настройке вида документа Frontol): "Приход товаров", "Расход товаров", "Инвентаризация", "Пользовательская" и т. д.;
- код вида документа Frontol - если он указан в форме обмена Айтиды.
Каждый документ Frontol, который не попал в ДКС, загружается отдельным документом Айтиды.
ВНИМАНИЕ
Операции "Расход товаров" и "Расход" во Frontol - разные. "Расход товаров" - нефискальный документ, списывающий остаток. "Расход" - фискальный чек с признаком расчета "Расход" (выплата покупателю), он всегда загружается в ДКС.
Коды видов документов в форме обмена
В форме обмена Айтиды для каждого из типов документов Айтиды можно указать коды видов документов Frontol. Несколько кодов перечисляются через запятую.
| Документ Айтиды | Код |
|---|---|
| Инвентаризация | 007 |
| Приходная накладная | 001 |
| Расходная накладная | 002 |
| Списание / оприходование | 003 |
| Внутреннее перемещение | 019 |
Других типов документов для сопоставления в форме обмена нет. В частности, заказ от покупателя штатно не загружается: для этого нужна доработка профиля.
Без параметра "Определять тип документа только по форме обмена"
Режим по умолчанию. Коды из формы обмена проверяются только для документов с операциями "Приход товаров", "Расход товаров", "Инвентаризация" и "Пользовательская". Все остальные операции загружаются в ДКС, даже если код их вида документа указан в форме обмена.
| Операция Frontol | Код вида найден в форме обмена | Код вида не найден |
|---|---|---|
| Приход товаров | Документ из формы обмена | Внутреннее перемещение |
| Расход товаров | Документ из формы обмена | Внутреннее перемещение |
| Инвентаризация | Документ из формы обмена | Инвентаризация |
| Пользовательская | Документ из формы обмена | ДКС |
| Остальные (продажа, возврат, расход и т. д.) | ДКС | ДКС |
Так, чтобы нефискальный документ "Расход товаров" загружался расходной накладной, а не внутренним перемещением, укажите код его вида документа в поле "Расходная накладная".
С параметром "Определять тип документа только по форме обмена"
Коды из формы обмена проверяются для документов с любой операцией, в том числе для продаж. Документ Айтиды выбирается только по коду вида документа: если код не найден ни в одном поле формы обмена, документ загружается в ДКС, независимо от операции. В этом режиме "Приход товаров" или "Расход товаров" без кода в форме обмена попадут в ДКС, а не во внутреннее перемещение.
Параметр удобен, если по отдельным видам документов продаж нужно формировать не ДКС, а, например, расходные накладные.
Механизм чеков
В механизме чеков (параметр "Загружать чеки") без параметра "Определять тип документа только по форме обмена" тип документа определяется только по операции Frontol, коды из формы обмена не используются:
| Операция Frontol | Документ Айтиды |
|---|---|
| Приход товаров | Приходная накладная |
| Расход товаров | Расходная накладная |
| Инвентаризация | Инвентаризация |
| Вскрытие тары | Вскрытие тары |
| Переоценка | Документ не формируется |
| Остальные | ДКС |
С параметром "Определять тип документа только по форме обмена" механизм чеков работает так же, как классический: документ выбирается по коду вида документа из формы обмена, а без кода загружается в ДКС.
Товары, склад, фирма
- Поиск товара - по коду товара Frontol, который сравнивается с "Кодом в главной базе". По артикулу и штрихкоду товар не ищется.
- Разрезы - модификация товара находится по значениям разрезов. Если такой модификации нет, строка загружается без товара с наименованием "Головной товар / разрез1 / …".
- Товар не найден или продан по свободной цене - строка загружается как "Свободная продажа" (в документе кассовой смены) или "Операция по свободной цене".
- Склад - склад кассы. Если в форме обмена или в карточке включено определение склада по группе товаров, берется склад группы товара.
- Фирма - фирма фискального регистратора из карточки. Если в форме обмена включено определение фирмы по группе товаров, берется фирма группы.
- Рабочие места - отдельные ККМ - код рабочего места Frontol ищется среди внешних кодов карточек оборудования; найденная карточка и ее склад подставляются в строки.
Оплаты
- Безналичная оплата - сумма оплат с кодами операций из параметра "Коды операций оплат для суммы б/нал" (по умолчанию 1 - оплата банковской картой или QR-кодом и 7 - пользовательская оплата). Параметр действует в обоих механизмах.
- Деление по видам оплат - строки чека помечаются кодом вида оплаты, и в документе кассовой смены товары разделяются по видам оплат.
- В механизме чеков безналичная часть определяется по тому же параметру, остальные оплаты раскладываются по операции Frontol: 0 - наличные, 3 - предоплата, 6 и 8 - сертификат, прочие - "прочее". Пользовательская оплата (7), убранная из списка, считается наличными.
- Чек, закрытый без единой оплаты, считается передачей в кредит и не загружается.
Дата документов
Дата формируемых документов задается в форме обмена: "Брать дату из ККМ", "Дата", "Дата закрытия смены". При варианте "Дата закрытия смены" строкам смены проставляется время закрытия смены (транзакция закрытия смены или Z-отчета). Разделение документов по кассам и сменам задается флагами "Формировать документы раздельно".
Маркированный и разливной товар
- Постановка на кран (операция 27 во Frontol) - создается документ маркировки "Постановка на кран" с КМ кеги, датой и складом кассы. Повторно для того же КМ и той же транзакции документ не создается.
- Разливной крепкий алкоголь - в классическом механизме количество из миллилитров пересчитывается в литры, цена - за литр.
- Коды маркировки в обоих механизмах сохраняются с привязкой к строке документа кассовой смены (таблица
barcodes); в механизме чеков они дополнительно хранятся в строках чека.
Особенности и ограничения
- Сначала выгружайте товары, затем скидки.
- Для каждой кассы выгрузка возможна, только когда Frontol обработал предыдущую (удалил файл-флаг).
- Ответ Frontol (
LoadResult<идентификатор БД>.txt) Айтида не читает. Ошибки загрузки смотрите в этом файле в каталоге обмена. - Цена товара выгружается с точностью до 99 999,99.
- Модификаторы, классификаторы и налоги выгружаются с числовыми кодами. Если во Frontol идентификатор товара - артикул, связи с товарами могут не совпасть.
- Меню выгружается только вместе с модификаторами.
- Спеццены выгружаются по всем действующим переоценкам, а не только по выгружаемым товарам. Старые акции спеццен удаляются только очисткой маркетинговых акций.
- Дата регистрации клиента во Frontol при выгрузке заполняется текущей датой.