Файл загрузки данных формата SPR

Файл загрузки данных формата SPR

Файл предназначен для передачи справочных данных от товароучетной системы к кассовому ПО.
Синоним — «Файл справочников».
Формат файла является модификацией CSV формата. Используется определенный формат полей файла.

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


Шапка файла

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

  • первая строка — строка инициализации файла «##@@&&» (6 обязательных символов);
  • вторая строка — признак загрузки данного файла «#» или «@» (1 символ).

Работа с признаком загрузки файла осуществляется по следующему сценарию.
Товароучетная система формирует файл справочников с признаком загрузки «#».
Кассовое ПО открывает файл монопольно, загружает файл и меняет признак загрузки на «@».
После обработки файл освобождается.

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

Таблица допустимых служебных команд.

КомандаОписание
$$$ADDдобавление количества товара
$$$RPLзамещение количества товара
$$$CLRочистка справочников перед загрузкой

С командой $$$CLR используются дополнительные флаги, уточняющие виды справочников, к которым применяется или не применяется очистка. Эти флаги находятся в одной строке с управляющей командой очистки.

Таблица дополнительных флагов команды очистки.

Имя флагаОписаниеПО1)
{NO_TOV}запрещает очистку справочника товаров
{GR_TOV}очистка скидочных групп товаров2)
{AUT_S}очистка схем автоматических скидок
{DIS_C}очистка списка дисконтных карт
{USR}очистка справочника пользователей
{NAB_P}очистка наборов прав
{FIX_S}очистка фиксированных скидок
{V_SHK}очистка весовых штрихкодов
{PAY_C}очистка списка платежных карт
{PAY_T}очистка видов платежных карт
{NAL}очистка списка налогов
{GR_NL}очистка налоговых групп
{PROD}очистка списка продавцов
{B_CRD}очистка списка банковских кредитных карт
{MES}очистка списка сообщений по дисконтным картам
{VAL}очистка списка валют
{HOT_K}очистка «горячих» клавиш
{MOB_OP}очистка справочника операторов связи
{COM_GR_TOV}очистка групп товаров
{COM_GR_DC}очистка групп дисконтных карт
{COM_GR_PT}очистка групп видов оплат
{SKL}очистка складов
{DIS_P}очистка реквизитов дисконтных карт
{DOC_TYPE}очистка типов документов
{DOC_REC}очистка типов реквизитов документов
{SPR_TYPE}очистка типов справочников документов
{SPR_DOC}очистка справочников документов
{SERT}очистка сертификатов
{COUPON}очистка купонов
{PAY_TYPE}очистка видов оплат
{APP_SCH}очистка схем применимости
{LBL_CPLX}очистка комплексов этикетирования
{MES_ATTR}очистка атрибутов сообщений
{COM_GR_GF}очистка групп разрезов характеристик
{GOOD_F}очистка справочника характеристик
{TOV_F}очистка справочника разрезов характеристик
{PRAVA_P}очистка определяемых пользователем прав
{STOL_TYPE}очистка типов столовБ
{ZAL}очистка залов и столовБ
{MODIF}очистка модификаторовБ
{MENU}очистка менюБ
{PRICH_OTKAZ}очистка причин отказовБ
{KAT_TOV}очистка категорий блюдБ
{MENU_DOST}очистка условий доступности менюБ
{PECH_NAPR}очистка направлений печатиБ
{INC_FLOW}Очистка справочника причин внесения/выплаты
{NO_SUBORD_CLR}Отключает очистку всех подчинённых при загрузке владельца
{MES_USR}Очистка регистра сообщений кассиру
{PRODUCER}Очистка справочника Производители ЕГАИС алкогольной продукции
{SDDS}Очистка справочника Статьи движения денежных средств
{PST}Очистка справочника Причины списания товаров
{HK_DECOR}Очистка справочника Оформление горячих клавиш
{HK_SSCO}Очистка справочника Горячие клавиши КСО
{PLAYLIST}Очистка справочника Плейлисты
{PRICH_OPER}Очистка справочника Причины операции
{RS}Очистка справочника Наборы прав по расписанию
{ORG}Очистка справочника Организации
{FIRM}Очистка справочника Фирмы
{PRICH_VOZVRAT}Очистка справочника Причины возвратов от покупателей
{PRICH_VOZVRAT_POST}Очистка справочника Причины возврата поставщикам
{PRICH_PEREM}Очистка справочника Причины перемещения
{PRICH_OPRIH}Очистка справочника Причины оприходования товаров
{KRAN}Очистка справочника Краны
{LOTTERY}Очистка Товаров для продажи лотерейных билетов
{PAY_P}Очистка справочника свойств платежных карт
{HK_TOV}Очистка справочника Горячие клавиши товаров
{CASH_DENOM}Очистка справочника Наличность: купюры и монеты
{MES_S}Очистка справочника Сообщения кассиру в скидках
{FIZ_L}Очистка справочника Физические лица


Состав файла

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

  • В одной строке файла записывается информация об одном элементе справочника или одна управляющая команда. Реквизиты загружаемых данных разделяются «;».
  • Строка начинается с символа «<». Далее до пробела следует имя открывающегося тега. Текущая строка или несколько следующих (до закрывающегося тега) содержат информацию о загружаемом элементе, согласно формату реквизитов этого элемента в файле. В строках с таким форматом символ
    "

    (двойная кавычка) в значениях реквизитов нужно заменять на последовательность символов

    &qout;

    , чтобы Кассир 5 мог корректно загрузить кавычки в значениях 3).


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

Строка без префикса содержит реквизиты товара.

Таблица префиксов, используемых в файле справочников.

ПрефиксЗагружаемый объектПО4)
#Единицы измерения товара
?Дополнительные цены товара
!Схемы автоматических скидок/надбавок
@Автоматические скидки/надбавки
%Дисконтные карты
^Фиксированные скидки
)Платежные (кредитные) карты
~Наборы прав
~~Добавить право в набор прав
~*Права пользователей
&Пользователи
(Весовые штрихкода
+Налоги
*Налоговые группы
}Сообщения по дисконтным картам
[Продавцы
Горячие клавиши
«Товары на горячих клавишах
'{Оформление горячих клавиш
'$Горячие клавиши КСО
'%Горячие клавиши товаров
{+Товары-условия товарных скидок
{-Товары-результаты товарных скидок
\Виды сертификатов
/Сертификаты
\+Группы товаров, являющихся условиями применения сертификата
\*Товары для продажи сертификатов
%$Группы купонов
$%Купоны
\\Товары для продажи лотерейных билетов (НЛ)
\\*Товар для выплаты выигрыша (НЛ)
{*Справочники документов
<appschemeСхемы применимости оплаты
{!Схемы применимости оплаты
{!*Применимость оплаты
{&Комплекс этикетирования
{&#Товары комплекса этикетирования
{&%Сообщения комплекса этикетирования
{^^Сообщения
{^%Атрибуты сообщений
{%!Сообщения кассиру в скидках
{%^!Типы столовБ
{%^@ЗалыБ
{%^#СтолыБ
{%^$МодификаторыБ
{%^%МенюБ
{%^^Причины отказовБ
{%^&Категории блюдБ
{%^*Условия доступности менюБ
{%^(Направления печатиБ
{%^)Единицы тарификацииБ
{%^+ЗаказыБ
{%^++Транзакции заказовБ
{%^-Схемы тарификацииБ
{%^–Тарифицируемые товары схем тарификацииБ
{%^=ТарифыБ
{%^==Товары-условия тарифовБ
{@Параметры разрезов характеристик товара
{#Разрезы характеристик товара
{№Цены и остатки разрезов характеристик товара
{^$Причины внесения/выплаты
{^#Статьи движения денежных средств
{^!Причины списания товаров
{^@Причины операции
{^&Причины возвратов от покупателей
{^*Причины возврата поставщикам
{^}Причины перемещения
{^{Причины оприходования товаров
!!Напоминания
$Краны оборудования для розлива
$$Сроки годности КМ
=$=Наличность: купюры и монеты
<descriptionОписание товара
<sticker