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

Файл предназначен для передачи справочных данных от товароучетной системы к кассовому ПО.\\
Синоним — "Файл справочников".\\
Формат файла является модификацией CSV формата. Используется определенный [[кассир5:форматобменаданными:форматполейфайлаspr|формат полей файла]].

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

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

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

Таблица допустимых служебных команд.
^ Команда      ^ Описание          ^
| $$$ADD    | добавление количества товара |
| $$$RPL    | замещение количества товара |
| $$$CLR    | очистка справочников перед загрузкой |

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

Таблица дополнительных флагов команды очистки.
^ Имя флага      ^ Описание          ^ПО((Определяет принадлежность к специализированному ПО. Обозначения: Пусто -- используется для всех, Б -- Бармен, Официант.))      ^
| {NO_TOV}    | запрещает очистку справочника товаров |
| {GR_TOV}    | очистка скидочных групп товаров((Флаг используется только для очистки скидочных групп товара при загрузке с флагом {NO_SUBORD_CLR})) |
| {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}    | Очистка справочника Физические лица |

===== Состав файла =====
После шапки файла следует информация о реквизитах загружаемых справочников и управляющие команды. существует два варианта записи информации в файле:
  * В одной строке файла записывается информация об одном элементе справочника или одна управляющая команда. Реквизиты загружаемых данных разделяются «;».
  * Строка начинается с символа «<». Далее до пробела следует имя открывающегося тега. Текущая строка или несколько следующих (до закрывающегося тега) содержат информацию о загружаемом элементе, согласно формату реквизитов этого элемента в файле. В строках с таким форматом символ <code>"</code>(двойная кавычка) в значениях реквизитов нужно заменять на последовательность символов <code>&qout;</code>, чтобы Кассир 5 мог корректно загрузить кавычки в значениях ((Реализовано в релизах Кассир 5.1.7.16+)).
Каждая строка начинается либо с определенного префикса (один или несколько символов), определяющего вид загружаемых данных, либо без префикса (для товара или товарной группы).

Строка без префикса содержит [[кассир5:форматобменаданными:товарреквизиты|реквизиты товара]].

Таблица префиксов, используемых в файле справочников.
^ Префикс      ^ Загружаемый объект          ^ ПО((Определяет принадлежность к специализированному ПО. Обозначения: Пусто -- используется для всех, Б -- Бармен, Официант.))      ^
|    #    | [[кассир5:форматобменаданными:единицареквизиты|Единицы измерения товара]]|    |
|    ?    | [[кассир5:форматобменаданными:допценареквизиты|Дополнительные цены товара]]|    |
|    !    | [[кассир5:форматобменаданными:схемаскидкиреквизиты|Схемы автоматических скидок/надбавок]]|    |
|    @    | [[кассир5:форматобменаданными:скидкареквизиты|Автоматические скидки/надбавки]]|    |
|    %    | [[кассир5:форматобменаданными:дисконтнаякартареквизиты|Дисконтные карты]]|    |
|    %%^%%    | [[кассир5:форматобменаданными:фиксированнаяскидкареквизиты|Фиксированные скидки]]|    |
|    )    | [[кассир5:форматобменаданными:платежнаякартареквизиты|Платежные (кредитные) карты]]|    |
|    ~    | [[кассир5:форматобменаданными:наборправреквизиты|Наборы прав]]|    |
|    ~~    | [[кассир5:форматобменаданными:добавитьправокнабору|Добавить право в набор прав]]|    |
|    ~*    | [[кассир5:форматобменаданными:правареквизиты|Права пользователей]]|    |
|    &    | [[кассир5:форматобменаданными:пользовательреквизиты|Пользователи]]|    |
|    (    | [[кассир5:форматобменаданными:весовойштрихкодреквизиты|Весовые штрихкода]]|    |
|    +    | [[кассир5:форматобменаданными:налогреквизиты|Налоги]]|    |
|    *    | [[кассир5:форматобменаданными:налоговаягруппареквизиты|Налоговые группы]]|    |
|    }    | [[кассир5:форматобменаданными:сообщениеподисконтнойкартереквизиты|Сообщения по дисконтным картам]]|    |
|    [    | [[кассир5:форматобменаданными:продавецреквизиты|Продавцы]]|    |
|    ’    | [[кассир5:форматобменаданными:горячаяклавишареквизиты|Горячие клавиши]]|    |
|    "    | [[кассир5:форматобменаданными:товарнагорячейклавишереквизиты|Товары на горячих клавишах]]|    |
|    '{    | [[кассир5:форматобменаданными:оформлениегк|Оформление горячих клавиш]]|    |
|    '$    | [[кассир5:форматобменаданными:горячиеклавишиксо|Горячие клавиши КСО]]|    |
|    '%    | [[кассир5:форматобменаданными:горячиеклавишитоваров|Горячие клавиши товаров]]|    |
|    {+    | [[кассир5:форматобменаданными:товарусловиескидкиреквизиты|Товары-условия товарных скидок]]|    |
|    {-    | [[кассир5:форматобменаданными:товаррезультатскидкиреквизиты|Товары-результаты товарных скидок]]|    |
|    \    | [[кассир5:форматобменаданными:видсертификатареквизиты|Виды сертификатов]]|    |
|    /    | [[кассир5:форматобменаданными:сертификатреквизиты|Сертификаты]]|    |
|    \+    | [[кассир5:форматобменаданными:группатоваровсертификатареквизиты|Группы товаров, являющихся условиями применения сертификата]]|    |
|    \*    | [[кассир5:форматобменаданными:товардляпродажисертификатареквизиты|Товары для продажи сертификатов]]|    |
|    %$    | [[кассир5:форматобменаданными:купоныгруппы|Группы купонов]]|    |
|    $%    | [[кассир5:форматобменаданными:купоны|Купоны]]|    |
|    %%\\%%    | [[кассир5:форматобменаданными:товарыдляпродажилотерейныхбилетов|Товары для продажи лотерейных билетов (НЛ)]]|    |
|    \\*    | [[кассир5:форматобменаданными:товардлявыплатывыигрыша|Товар для выплаты выигрыша (НЛ)]]|    |
|    {*    | [[кассир5:форматобменаданными:справочникдокументовреквизиты|Справочники документов]]|    |
|    <appscheme    | [[кассир5:форматобменаданными:схемаприменимостиоплатыреквизиты2|Схемы применимости оплаты]]|    |
|    {!    | [[кассир5:форматобменаданными:схемаприменимостиоплатыреквизиты|Схемы применимости оплаты]]|    |
|    {!*    | [[кассир5:форматобменаданными:применимостьоплатыреквизиты|Применимость оплаты]]|    |
|    {&    | [[кассир5:форматобменаданными:комплексэтикетированияреквизиты|Комплекс этикетирования]]|    |
|    {&#    | [[кассир5:форматобменаданными:комплексэтикетированиятоварыреквизиты|Товары комплекса этикетирования]]|    |
|    {&%    | [[кассир5:форматобменаданными:комплексэтикетированиясообщреквизиты|Сообщения комплекса этикетирования]]|    |
|    {%%^%%%%^%%    | [[кассир5:форматобменаданными:сообщенияреквизиты|Сообщения]]|    |
|    {%%^%%%    | [[кассир5:форматобменаданными:атрибутысообщенийреквизиты|Атрибуты сообщений]]|    |
|    {%!    | [[кассир5:форматобменаданными:сообщениякассирувскидках|Сообщения кассиру в скидках]]|    |
|    {%%%^%%!    | [[кассир5:форматобменаданными:типыстолов|Типы столов]]|  Б  |
|    {%%%^%%@    | [[кассир5:форматобменаданными:залы|Залы]]|  Б  |
|    {%%%^%%#    | [[кассир5:форматобменаданными:столы|Столы]]|  Б  |
|    {%%%^%%$    | [[кассир5:форматобменаданными:модификаторы|Модификаторы]]|  Б  |
|    {%%%^%%%    | [[кассир5:форматобменаданными:меню|Меню]]|  Б  |
|    {%%%^%%%%^%%    | [[кассир5:форматобменаданными:причиныотказов|Причины отказов]]|  Б  |
|    {%%%^%%&    | [[кассир5:форматобменаданными:категорииблюд|Категории блюд]]|  Б  |
|    {%%%^%%*    | [[кассир5:форматобменаданными:условиядоступностименю|Условия доступности меню]]|  Б  |
|    {%%%^%%(    | [[кассир5:форматобменаданными:направленияпечати|Направления печати]]|  Б  |
|    {%%%^%%)    | [[кассир5:форматобменаданными:единицытарификации|Единицы тарификации]]|  Б  |
|    {%%%^%%+    | [[кассир5:форматобменаданными:заказы|Заказы]]|  Б  |
|    {%%%^%%++    | [[кассир5:форматобменаданными:транзакциизаказы|Транзакции заказов]]|  Б  |
|    {%%%^%%-    | [[кассир5:форматобменаданными:схемытарификации|Схемы тарификации]]|  Б  |
|    {%%%^%%--    | [[кассир5:форматобменаданными:тарифицируемыетоварысхемытарификации|Тарифицируемые товары схем тарификации]]|  Б  |
|    {%%%^%%=    | [[кассир5:форматобменаданными:тарифы|Тарифы]]|  Б  |
|    {%%%^%%==   | [[кассир5:форматобменаданными:товарыусловиятарифы|Товары-условия тарифов]]|  Б  |
|    {@    | [[кассир5:форматобменаданными:разрезыхарактеристикреквизиты| Параметры разрезов характеристик товара ]]|    |
|    {#    | [[кассир5:форматобменаданными:разрезыхарактеристиктоварареквизиты| Разрезы характеристик товара ]]|    |
|    {№    | [[кассир5:форматобменаданными:ценыиостаткихарактеристиктовара| Цены и остатки разрезов характеристик товара ]]|    |
|    {%%^%%$    | [[кассир5:форматобменаданными:причинывнесениявыплаты|Причины внесения/выплаты]]|    |
|    {%%^%%#    | [[кассир5:форматобменаданными:статьидвиженияденежныхсредств|Статьи движения денежных средств]]|    |
|    {%%^%%!    | [[кассир5:форматобменаданными:причинысписаниятоваров|Причины списания товаров]]|    |
|    {%%^%%@    | [[кассир5:форматобменаданными:причиныоперации|Причины операции]]|    |
|    {%%^%%&    | [[кассир5:форматобменаданными:причинывозвратовотпокупателей|Причины возвратов от покупателей]]|    |
|    {%%^%%*    | [[кассир5:форматобменаданными:причинывозвратапоставщикам|Причины возврата поставщикам]]|    |
|    {%%^%%}    | [[кассир5:форматобменаданными:причиныперемещения|Причины перемещения]]|    |
|    {%%^%%{    | [[кассир5:форматобменаданными:причиныоприходованиятоваров|Причины оприходования товаров]]|    |
|    !!    | [[кассир5:форматобменаданными:напоминанияштрихмкассир|Напоминания]]|    |
|    $    | [[кассир5:форматобменаданными:краны|Краны оборудования для розлива]]|    |
|    $$    | [[кассир5:форматобменаданными:срокигодностикм|Сроки годности КМ]]|    |
|    =$=    | [[кассир5:форматобменаданными:наличностькупюрыимонеты|Наличность: купюры и монеты]]|    |
|    <description    | [[кассир5:форматобменаданными:описаниетоварареквизиты|Описание товара]]|    |
|    <sticker    | [[кассир5:форматобменаданными:этикеткатоварареквизиты|Текст для этикетки товара]]|    |
|    <goods_attr    | [[кассир5:форматобменаданными:допреквизитытовара|Дополнительный реквизит товара]]|    |
|    <htmldescription    | [[кассир5:форматобменаданными:htmlописаниетоварареквизиты|html описание товара (URL)]]|    |
|    <goods_img    | [[кассир5:форматобменаданными:goodsimg|картинка товара (двоичные данные)]]|    |
|    <payment_type    | [[кассир5:форматобменаданными:видоплатыреквизиты|Виды оплаты]]|    |
|    <store    | [[кассир5:форматобменаданными:складреквизиты|Склады]]|    |
|    <price_change    | [[кассир5:форматобменаданными:документпереоценкареквизиты|Документ «Переоценка»]]|    |
|    <discount_card_property    | [[кассир5:форматобменаданными:справочниксвойствдисконтнойкартыреквизиты|Справочник свойств дисконтных карт]]|    |
|    <discountcard    | [[кассир5:форматобменаданными:свойстводисконтнойкартыреквизиты|Дополнительные реквизиты дисконтных карт]]|    |
|    <group_tov    | [[кассир5:форматобменаданными:скидочнаягруппатоварареквизиты|Справочник «Группы товаров»]]|    |
|    <group_dc    | [[кассир5:форматобменаданными:скидочнаягруппадисконтнойкартыреквизиты|Справочник «Группы дисконтных карт»]]|    |
|    <group_pt    | [[кассир5:форматобменаданными:скидочнаягруппавидаоплатыреквизиты|Справочник «Группы видов оплат»]]|    |
|    <group_gf    | [[кассир5:форматобменаданными:скидочнаягруппаразрхарреквизиты|Справочник «Группы разрезов характеристик»]]|    |
|    <document_type    | [[кассир5:форматобменаданными:типдокументареквизиты|Справочник «Типы документов»]]|    |
|    <document_fields_type    | [[кассир5:форматобменаданными:справочниктиповреквизитовдокареквизиты|Справочник «Типы реквизитов документов»]]|    |
|    <document_catalogs_type    | [[кассир5:форматобменаданными:справочниктиповсправочниковдокреквизиты|Справочник «Типы справочников документов»]]|    |
|    <document_object    | [[кассир5:форматобменаданными:документ|Универсальный документ]]|    |
|    <good_feature    | [[кассир5:форматобменаданными:справочникхарактеристикиреквизиты|Справочник «Характеристики»]]|    |
|    <delete    | [[кассир5:форматобменаданными:удалитьэлементсправочника|Удалить элемент справочника]]|    |
|    <delete_document    | [[кассир5:форматобменаданными:удалитьдокумент|Удалить документ]]|    |
|    %%|%%    | [[кассир5:форматобменаданными:константынастройки|Константы/настройки]]|    |
|    {=    | [[кассир5:форматобменаданными:ценыиостаткитоваров|Изменение цены и остатка товара]]|    |
|    %%{=)%%    | [[кассир5:форматобменаданными:изменениекредитаплатежнойкарты|Изменение кредита платежной карты]]|    |
|    {=%    | [[кассир5:форматобменаданными:изменениенакопленийдисконтнойкарты|Изменение накоплений дисконтной карты]]|    |
|    <paymentcard_limit    | [[кассир5:форматобменаданными:ограниченияпокредитнымкартам|Ограничения оплаты товаров кредитной картой]]|    |
|    <paymentcard_type    | [[кассир5:форматобменаданными:видыплатежныхкарт|Виды платежных карт]]|    |
|    <goods_set    | [[кассир5:форматобменаданными:товарысоставнабора|Состав набора]]|    |
|    ]+    | [[кассир5:форматобменаданными:производителиалкоголя|Производители ЕГАИС алкогольной продукции]]|    |
|    ]-    | [[кассир5:форматобменаданными:товарыпроизводителейалкоголя|Товары ЕГАИС производителей алкогольной продукции]]|    |
|    {\    | [[кассир5:форматобменаданными:организации|Организации]]|    |
|    <playlist    | [[кассир5:форматобменаданными:плейлисты|Рекламные плейлисты]]|    |
|    <rights_override    | [[кассир5:форматобменаданными:наборыправпорасписанию|Наборы прав по расписанию]]|    |
|    <firms   | [[кассир5:форматобменаданными:фирмы|Фирмы]]|    |
|    <product_group   | [[кассир5:форматобменаданными:товарныегруппы|Товарные группы]]|    |
|    <period_attr    | [[кассир5:форматобменаданными:ПериодическиеРеквизитыТоваров|Периодические реквизиты товаров]]|    |
|    <paymentcard_card_property    | [[кассир5:форматобменаданными:справочниксвойствплатежныхкарт|Справочник свойств платежных карт]]|    |
|    <paymentcard    | [[кассир5:форматобменаданными:значениясвойствплатежныхкарт|Значения свойств платежных карт]]|    |
|    <tax_changes    | [[кассир5:форматобменаданными:графикналоговыхставок|График налоговых ставок]]|    |
|    <coupon_text    | [[кассир5:форматобменаданными:текстдляпечатикупона|Текст для печати купона]]|    |
|    <fiz_l    | [[кассир5:форматобменаданными:физическиелица|Физические лица]]|    |