Описание обмена в формате АТОЛ

Описание обмена от 23. 06. 2016

TabletPOS v. 4.3.0

Введение

Сокращения

Формат АТОЛ

Выгрузка данных

Описание транзакций выгрузки

Обработка ошибок при загрузке информации о реквизитах товаров

Описание транзакций загрузки

Сообщения обмена для журнала операций

Приложение А

ДАЛИОН: Управление магазином.ПРО, редакция 1.2 (1.2.23.01)

Управление торговлей, редакция 10.3 (10.3.24.1)

[Введение] Введение Данный документ предназначен для пользователей программы TabletPOS и описывает организацию обмена данными между TabletPOS и внешними АСТУ.

Документ содержит техническую информацию, и рекомендован к изучению пользователям с соответствующей подготовкой.

Раздел «Формат АТОЛ» содержит общее описание используемого для обмена данными формата. Разделы «Выгрузка данных» и «Загрузка данных» содержат описание форматов файлов выгрузки и загрузки, а также перечень обрабатываемых команд и транзакций. Раздел «Сообщения обмена для журнала операций» содержит перечень предупреждений и ошибок, записываемых в журнал операций TabletPOS. В приложении приведены особенности организации обмена с конкретными АСТУ.

Сокращения АСТУ Автоматизированная система товарного учёта БД База данных ККМ Контрольно-кассовая машина

– – –

Формат АТОЛ Обмен данными между АСТУ и TabletPOS происходит посредством текстовых файлов в кодировке Windows-1251. Данные передаются в формате АТОЛ. Выявленные при тестировании особенности обмена с конкретными АСТУ приведены в приложении А.

Процедуры выгрузки и загрузки отличаются. Выгрузка позволяет сохранить в файл и передать в АСТУ выбранные пользователем данные: историю кассовых операций (выгружается всегда), информацию о проведённых товароучётных действиях. При загрузке из АСТУ в TabletPOS передаётся товарная база, при этом управляющие команды позволяют как заменять новыми данными существующие, так и объединять базы, суммируя остатки товаров из существующей и загружаемой баз.

Файлы выгрузки и загрузки состоят из строк. Каждая строка соответствует отдельному признаку файла, управляющей команде или набору данных для отдельного элемента (товара, транзакции). Строки разделяются символами перевода строки CR (#0Dh) или LF (#0Ah). Строки с данными состоят из полей (при этом количество полей для разных элементов различно), разделённых символом «;».

Файл выгрузки содержит:

строки с выгружаемыми данными.

Файл загрузки содержит:

шапку файла с информацией о документе;

управляющие команды;

строки с данными элементов, относящихся к управляющим командам.

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

Для корректной передачи данных необходимо учитывать, что в формате АТОЛ применяются следующие правила:

TabletPOS позволяет загружать текстовые файлы и архивы *.zip, при этом в архив должен быть упакован одноимённый текстовый файл;

десятичный разделитель при загрузке – любой знак кроме «;», « », «|»;

формат даты и времени, а также десятичный разделитель при выгрузке фиксируется соответствующими настройками программы (см. раздел «Настройки» Руководства по эксплуатации);

при выгрузке данных с символом «;» (#3Ah) он заменяется символом «¤» (#А4h), при загрузке необходимо провести такую же замену;

при передаче символов CR (#0Dh) или LF (#0Ah) их необходимо заменить символом « » (#20h, пробел) или «|» (#7Ch).

[Выгрузка данных] Выгрузка данных Файл выгрузки данных состоит из двух частей: шапки файла и непосредственно выгружаемых данных.

Шапка файла состоит из трёх строк:

– – –

[Выгрузка данных] Некоторые поля в таблицах, приведённых в следующих разделах, выделены цветом.

Расшифровка цветовых обозначений представлена в таблице:

ХХХ Значение передаётся отрицательным при возврате товара покупателем и положительным для других документов ХХХ Значение передаётся отрицательным при продаже и положительным при возврате

– – –

Особенности полей:

Транзакция №45 выгружается только в случае закрытия документа на ККМ.

Поле №8 заполняется только для документов продажи и возврата покупателем.

Поле №25 заполняется только для документов возврата покупателем на основании. В поле записывается номер документа, на основании которого произведён возврат.

Поле №36 заполняется только для документов переоценки.

– – –

Шапка файла состоит из двух строк:

– – –

Признак обработки данного файла товароучётной программой «#» (1 символ) После шапки файла следуют непосредственно данные и управляющие команды.

Все управляющие команды можно разделить на две группы:

требующие дополнительных данных;

не требующие дополнительных данных.

Команды первой группы действуют на все последующие данные до следующей команды.

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

Если после шапки файла не следует никакой команды, считается, что подана команда $$$ADDQUANTITY.

В файле загрузки могут встречаться однострочные комментарии, которые начинаются с символов «//».

Если при загрузке данных в справочнике уже присутствует элемент с таким же уникальным ключом, его данные будут изменены в соответствии с загрузкой, а если элемента нет, он будет создан.

После успешной загрузки файла программой TabletPOS файл удаляется.

Обработка ошибок при загрузке информации о реквизитах товаров При загрузке данных о реквизитах товаров возможны следующие ошибки при разборе содержимого:

в файле присутствует неизвестная команда;

поля команды содержат некорректные данные.

В случае нахождения в файле неизвестной команды:

в журнал операций записывается соответствующая ошибка (см. «Сообщения обмена для журнала операций»);

«Данные из файла путь/имя файла загружены с ошибками. Подробнее смотрите журнал операций».

В случае наличия некорректных данных в полях команд:

в журнал операций записываются соответствующие сообщения об ошибках (см. «Сообщения обмена для журнала операций»);

выдаётся сообщение:

«Ошибка загрузки данных. Подробнее смотрите журнал операций».

Описание транзакций загрузки

– – –

Добавить пользователей $$$ADDUSERS Удалить пользователя по $$$DELETEUSERSBYCODE коду Удалить всех $$$DELETEALLUSERS пользователей Добавить связки товаров и кодов продукции $$$ADDALCCODES согласно ЕГАИС Удалить все связки товаров и кодов $$$DELETEALLALCCODES продукции согласно ЕГАИС Удалить связки кодов продукции согласно $$$DELETEALCCODESBYWARE ЕГАИС и товаров по коду товара Удалить связки кодов продукции согласно ЕГАИС и товаров $$$DELETEALCCODESBYALCCODE по коду продукции согласно ЕГАИС Добавить товары $$$ADDQUANTITY – с добавлением остатка. Указанный остаток добавляется к текущему.

$$$REPLACEQUANTITYWITHOUTSALE – с замещением остатка. Указанный остаток заменяет текущий.

– – –

Особенности полей:

Если в поле №8 не указаны значения для всех или нескольких флагов, для них будут применены значения по умолчанию: состояние «Включен» для всех флагов. Незаданным флагам, которые идут после последнего заданного, будут присвоены значения по умолчанию, даже если не проставлены соответствующие им запятые в файле загрузки.

Значением «выключено» считается «0», значением «включено» - «1». Любые другие значения будут трактоваться как значения по умолчанию.

В поле №15 загружается единица измерения товара (наименование). При загрузке ищется соответствующая единица измерения в справочнике. Если загружаемая единица не будет найдена, то она добавится в справочник (точность = 0,001).

Если в поле №31 не указан путь к картинке, то она должна находиться рядом с файлом загрузки, содержащим команду:

При загрузке из каталога – в каталоге загрузки.

При загрузке файла из архива картинка должна находиться в архиве с файлом загрузки.

При загрузке поддерживаются следующие единицы измерения:

– – –

Поле №16 предназначено для построения иерархического списка товаров, т.е. для разбиения товаров по соответствующим товарным группам. Если иерархия не используется, то значение поля №16 = 0.

Удалить все товары $$$DELETEALLWARES

– – –

Если в поле №2 задано значение, удаляется только указанный штрихкод. Если значение не задано, удаляются все штрихкоды товара.

Добавить штрихкоды $$$ADDBARCODES

Данные:

– – –

Строка шаблона в команде загрузки: Н:2 К:5:2:3 М:5:0.001:1 Н:1

Удалить все шаблоны штрихкодов $$$DELETEALLBARCODETEMPLATES Удалить шаблон штрихкодов по коду

$$$DELETEBARCODETEMPLATEBYCODE

– – –

Особенности полей:

TabletPOS работает только с процентными типами налогов. Поэтому при наличии в файле суммовых ставок (поле №4 = 1) загрузка будет прервана с откатом всех изменений и сообщением: «Ошибка загрузки данных. Подробнее смотрите журнал операций». При этом в лог операций запишется соответствующее сообщение.

Удалить все налоговые ставки $$$DELETEALLTAXRATES Данных нет.

[Загрузка данных] Налоговую ставку можно удалить, только если она не используется в какой-либо налоговой группе. В противном случае загрузка будет прервана с откатом всех изменений и сообщением об ошибке. При этом в лог операций запишется соответствующее сообщение.

Если удалены и налоговая группа, и ставка, при просмотре журнала документов в соответствующих транзакциях вместо наименования ставки будет выведено «Код|Неизвестно».

Добавить налоговые группы $$$ADDTAXGROUPS

– – –

Удалить налоговую группу можно только в случае отсутствия на неё ссылок в товарах. В противном случае загрузка будет прервана с откатом всех изменений и сообщением об ошибке.

При этом в лог операций запишется сообщение с уровнем «Ошибка».

При просмотре журнала документов в соответствующих транзакциях вместо наименования группы будет выведено «Неизвестно».

Включить налоговые ставки в группу

– – –

Удалить всех пользователей $$$DELETEALLUSERS Данных нет.

После обработки всего файла загрузки проводится проверка на наличие пользователя с правами администратора. Если после загрузки ни одного пользователя с профилем «Администратор» не останется, загрузка будет прервана с откатом всех изменений и сообщением об ошибке. При этом в лог операций запишется сообщение.

Добавить связки товаров и кодов продукции согласно ЕГАИС $$$ADDALCCODES [Загрузка данных]

– – –

Сообщения обмена для журнала операций При выполнении обмена в журнал операций записываются сопутствующие события.

Возможные сообщения об ошибках и предупреждения приведены в таблице:

– – –

Ошибка загрузки данных из файла Ошибка возникает при попытке:

file.txt. Неверные данные в строке m - удаления по коду товара, которого нет в БД;

изменение/удаления цены для товара, которого нет в БД.

Ошибка загрузки данных из файла file.txt. Неверные данные в строке m – не заданы обязательные параметры.

Загрузка прервана Ошибка загрузки данных из файла file.txt. Ошибка изменения данных в БД при обработке строки m. Повторите попытку позднее. Загрузка прервана Ошибка выгрузки данных в файл file.txt. Не удалось открыть файл для записи данных. Выгрузка прервана Ошибка выгрузки данных в файл file.txt. Не удалось упаковать файл file2.txt в zip-архив. Выгрузка прервана Ошибка выгрузки данных в файл file.txt. Не удалось записать данные в файл. Выгрузка прервана Ошибка выгрузки данных в файл Если название транзакции определить не выгрузить удалось, указывается «Неизвестная транзакция»

Не удалось file.txt.

транзакцию название транзакции номер k. Выгрузка прервана Ошибка выгрузки данных в файл Не удалось прочитать file.txt.

транзакции из базы данных. Выгрузка прервана Ошибка выгрузки данных в файл file.txt. Нет данных для выгрузки.

Выгрузка прервана

– – –

Приложение А

При тестировании проверялась корректность обмена данными со следующими АСТУ:

Далион: Управление магазином;

Управление торговлей, редакция 10.3.

Выявленные особенности обмена данными с указанными АСТУ приведены ниже.

ДАЛИОН: Управление магазином.ПРО, редакция 1.2 (1.2.23.01) Особенности настройки При настройке в параметрах оборудования указывалась модель «Атол: Frontol (версии 4.9 и выше)».

1. С отключённым флагом предварительной очистки данных (Управление кассами/Очистить ККМ перед загрузкой) в файле загрузки используется поддерживаемая в TabletPOS команда $$$REPLACEQUANTITYWITHOUTSALE. Данные успешно загружаются в TabletPOS.

2. В Далион с включённым флагом предварительной очистки данных (Управление кассами/Очистить ККМ перед загрузкой) в файле загрузки используется не поддерживаемая TabletPOS команда $$$REPLACEQUANTITY. Для корректной загрузки такого файла в TabletPOS необходимо заменить $$$REPLACEQUANTITY на $$$ADDQUANTITY или $$$REPLACEQUANTITYWITHOUTSALE.

Выгрузка

1. Для обработки выгруженных товароучётных документов в Далион необходимо указать соответствующие параметры загрузки. Для этого в справочнике Кассовые узлы нужно выбрать интересующий узел и на закладке "Документы" указать соответствие шаблонов документов Далион кодам видов документов TabletPOS.

2. При загрузке отчёта в Далион будет создан документ "Отчёт кассовой смены", содержащий все операции за смену кроме внесения и выплаты, а также документы, настроенные согласно п.1.

АЙТИДА Особенности настройки

При настройке в карточке оборудования указывались параметры:

производитель: «АТОЛ»;

профиль: «Обмен данными с Фронтол.WIN32 V.2».

[Приложение А] Загрузка При загрузке ККМ товарами используются поддерживаемые в TabletPOS команды $$$ADDQUANTITY и $$$REPLACEQUANTITYWITHOUTSALE (в зависимости от настройки). Данные успешно загружаются в TabletPOS.

Выгрузка

1. Для обработки выгруженных товароучётных документов в Айтида необходимо на форме обмена данными с торговым оборудованием настроить соответствие документов Айтида кодам видов документов TabletPOS.

2. При загрузке отчёта в Айтида будет создан документ "Документ кассовой смены", содержащий все операции за смену кроме внесения и выплаты, а также документы, настроенные согласно п.1.

Управление торговлей, редакция 10.3 (10.3.24.1)

1. Обработка обслуживания: 82ATOLCashierECROfflineEx_v2_34_free.epf При загрузке ККМ товарами в файле загрузки используется не поддерживаемая TabletPOS команда $$$REPLACEQUANTITY. Для корректной загрузки такого файла в TabletPOS необходимо заменить $$$REPLACEQUANTITY на $$$ADDQUANTITY или $$$REPLACEQUANTITYWITHOUTSALE.

2. Обработка обслуживания: ATOLCashierECROffline_v2.epf, версия 2.29 При загрузке ККМ товарами в файле загрузки используется поддерживаемая TabletPOS команда $$$ADDQUANTITY, однако перед блоком товаров следует не поддерживаемая TabletPOS команда $$$DELETEALLASPECTREMAINS. Для корректной загрузки такого файла в TabletPOS необходимо удалить данную команду.

Выгрузка

В Управление торговлей доступна выгрузка только кассовых документов. При выгрузке товароучётных документов после загрузки файла в АСТУ соответствующие товароучётные транзакции попадают в отчёт о розничных продажах, что приводит к некорректным итогам смены.

Сторонние форматы обмена поддержаны не в полном объеме. Передача всех реквизитов осуществляется в формате AIF.

С полным описанием формата можно ознакомиться в документации "Руководство системного интегратора - Атол" . В данном разделе приведено описание особенностей загружаемых справочников и перечень расширений формата для более полного использования функционала Artix.

Загружаемые справочники

Загружаемые справочники		Примечание
1	Каталоги
2	Цены
3	Товары
4	Штрих-коды
5	Виды оплат
6	Пользователи
7	Весы с печатью этикеток
8	Налоговые ставки
9	Схемы разрезов
10	Переоценки	Справочник переоценок должен загружаться после справочника товаров (одним файлом). Если переоценки загружать до загрузки товаров, то минимальная цена переоценки будет равна 0.00. В поле documenid таблицы prices записывается дата переоценки. Значение минимальной цены переоценки принимается равной минимальной цене товара.

Краткое описание формата

Для обмена данными в формате Атол используется 2 вида файлов: файл загрузки и файл выгрузки.

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

Файл загрузки данных состоит из двух частей: шапки файла и непосредственно информации о реквизитах товара.
Шапка файла состоит из двух строк:

Первая строка – строка инициализации файла «##@@&&» (6 символов).
Вторая строка – признак загрузки данного файла «#» (1 символ).

После успешной загрузки файла признак загрузки меняется с «#» на «@»

При загрузке данных, если у файла признак загрузки «@», то он просто пропускается, и загружаются только файлы с признаком загрузки «#». Если файлов загрузки нет по указанному пути или же все файлы имеют признак загрузки «@», то будет выдано соответствующее сообщение об ошибке.

Выгрузка данных

Файл выгрузки данных состоит из двух частей: шапки файла и непосредственно выгружаемых данных.
Шапка файла состоит из трех строк:

Признак обработки данного файла товароучетной программой «#» (1 символ). После того как файл будет обработан АСТУ, символ «#» должен быть заменен на «@» для возможности выгружать другие отчеты в файл с тем же именем.
Логический номер ПК (см. документ «Руководство администратора»).
Порядковый номер отчета.

После шапки файла следуют выгружаемые данные.

При повторной выгрузке данных (когда файл выгрузки уже существует), действия РМК зависят от признака обработки данного файла (символы «#» и «@»). Если в шапке файла стоит символ «#», то новые транзакции будут добавлены к уже имеющимся в тот же файл. Если в шапке файла выгрузки стоит символ «@», то при новой выгрузке этот файл будет удален, и создан новый вместо него.

Компания АТОЛ представила рынку новую возможность в сервисе АТОЛ Онлайн по формированию кассовых чеков для интернет-площадок, которые принимают оплату на сайтах с использованием электронных средств платежа, например, банковских карт.

Все пользователи сервиса АТОЛ Онлайн могут корректно отображать в чеке операции по продаже подарочных карт, приему и зачету авансов, оплате кредитов за реализованные товары, комиссионные и агентские схемы. Все необходимые реквизиты передаются в чеке в полном соответствии с 54-ФЗ и форматом фискальных документов 1.05 (ФФД 1.05), переход на который очень востребован в связи с ограниченностью легитимности ранее применяемого ФФД 1.0. Другими словами, с 1 января 2019 г. использование ФФД 1.0 станет нарушением законодательства, и бизнес будет обязан перейти или на ФФД 1.05, или сразу на ФФД 1.1.

Формат 1.05 технически поддерживается во всех составляющих АТОЛ Онлайн – в API сервиса (интерфейс программирования приложений), прошивке предоставляемых в аренду онлайн-касс АТОЛ 42ФС и в личном кабинете пользователя. Кроме того, прием фискальных документов в данном формате обеспечивают все 11 операторов фискальных данных, доступных при подключении в АТОЛ Онлайн.

Для работы по ФФД 1.05 интернет-площадкам важно обратить внимание на поддержку соответствующего формата со стороны CRM-, CMS-платформ или платежного сервиса. Ведь состав обязательных реквизитов в ФФД 1.05 расширенный, и их передача в сервис должна быть обеспечена интегрированной системой.

Для удобства пользователей компания АТОЛ также добавила новые возможности в личный кабинет АТОЛ Онлайн. Например, раздел «Статистика чеков» предоставляет исчерпывающую информацию по всем фискальным операциям. Теперь каждый пользователь сможет увидеть свои чеки, а также всю информацию по ним, такую как тип чека, итог, дата, статус и идентификационный номер. Если чек вдруг не пройдет фискализацию, отобразится информация с указанием ошибки.

Функция «Формирование чека» позволит пользователю создать и отправить кассовый чек в ручном режиме без участия CMS-системы из личного кабинета.

Благодаря новой опции о состоянии баланса пользователь АТОЛ Онлайн всегда может отслеживать актуальность средств на своем счете, чтобы заблаговременно оплатить услуги сервиса. Данная информация доступна в разделе «Мои компании». Получить расчетные документы можно будет благодаря функции автоматического выставления счета в личном кабинете.

Кроме того, для новых пользователей сервиса обеспечена интеграция с личными кабинетами операторов «Платформа ОФД» и «Первый ОФД», что позволит сократить число действий при подключении сервиса и активации промо-тарифов.

В настоящее время формирование чеков по ФФД 1.05 носит рекомендательный характер. Тем не менее этот формат очень востребован именно в сфере e-commerce. Его возможности дают предприятиям большей гибкости в учетной политике. Это обеспечивает прозрачность ведения кассового учета. Например, при оплате услуг клиентом интернет-провайдеру будет оформлен чек на аванс.

«В преддверии новогодних праздников мы предложили нашим пользователям новые функциональные возможности, – комментирует Юлия Носова, руководитель бизнес-проекта АТОЛ Онлайн. – Надеемся, они будут востребованы и обеспечат более высокий уровень удобства работы с сервисом».

Справка о компании АТОЛ

АТОЛ – российский производитель контрольно-кассовой техники (ККТ) и программного обеспечения для нее с 16-летней историей. Компания выпустила более 35 моделей касс. Причем 14 из них уже обеспечивают соответствие поправкам в федеральный закон 54-ФЗ и приказами ФНС России включены в реестр ККТ. Это модели АТОЛ 90Ф, АТОЛ 30Ф, АТОЛ 11Ф, АТОЛ 55Ф, АТОЛ 22Ф, АТОЛ 25Ф, АТОЛ 77Ф, АТОЛ 42ФС, АТОЛ 52Ф, АТОЛ 60Ф, АТОЛ 15Ф, АТОЛ 20Ф, АТОЛ 50Ф, АТОЛ 91Ф. Кроме того, компания разработала первый на российском рынке сервис по аренде онлайн-касс для интернет-магазинов – АТОЛ Онлайн. В ассортименте АТОЛ есть также POS-системы, оборудование для штрихкодирования, весы, решения для организации торгового эквайринга.
Партнерская сеть компании объединяет более 600 компаний, представленных во всех федеральных округах России. Сервисная сеть включает более 530 авторизованных сервисных центров в 206 городах России.
Ключевые клиенты АТОЛ – крупнейшие представители сетевого ритейла, региональные лидеры food- и non-food-розницы, ведущие сети общественного питания, большая тройка телекоммуникационных операторов, лидеры аптечного рынка и др. (Например, нефтегазовая сеть Роснефть, торговые сети Х5 Retail Group, АШАН, Leroy Merlin, «Детский мир», рестораны Burger King, KFC, операторы МТС и «Мегафон», интернет-ритейлеры Эльдорадо, Ozon.ru, Ростелеком, Robo.market).