ВНИМАНИЕ!
Данная статья содержит информацию по настройкам, релевантным только для обмена с кассами или модулем интеграции. Настройки импорта XML для обмена через сервер доступны по обращению к команде техподдержки УКМ 5.
В данной статье приведены только некоторые настройки, необходимые для корректной работы конвертера Импорт XML. Ознакомиться с подробным описанием структуры файлов импорта можно ЗДЕСЬ.
Оглавление |
---|
Настройка выполняется в конфигурационном файле xml5_import.conf (services\converters\xml5_import.conf), расположенном на кассовом сервере по адресу: Магазин – Типы касс, где нужно выбрать тип кассы и нажать кнопку Настройки:
Загрузка данных о кассирах
...
- defaultRoleIdForUser – роль по - умолчанию;
- roleIdMap;
- createUserCard:
...
- если базе есть идентификатор с таким id, то существующая запись будет полностью заменена.
Пример:
Блок кода | ||||
---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="UTF-8"?> <storeCashiers fullness="F" storeId="00-000001"> <cashier> <id>12</id> <name>Лисник М. В.</name> <password>123345</password> </cashier> <cashier> <roleId>3</roleId> <id>10</id> <name>Иванюк И. В.</name> <password>34567</password> </cashier> </storeCashiers> |
...
Если для магазина мапирование не указано, то файлы будут загружаться с идентификатором, указанным в настройках магазина на кассовом сервере по адресу Магазин – Описание – Интеграция – Id во внешней системе. :
Другими словами, отсутствие записи для магазина в данном параметре эквивалентно следующей записи:
{externalId = 1144, internalId = 39}.
Здесь значения взяты из Справочника справочника магазина:
Блок кода | ||||
---|---|---|---|---|
| ||||
roleIdMap:[ (соответствие идентификаторов ролей кассиров во внешней системе (externalId) и магазинов в УКМ 5 (internalId). Код роли во внешней системе – это roleId в файле storeCashiers) {externalId = 1, internalId = 1} {externalId = 2, internalId = 2} ] defaultRoleIdForUser = 1 (роль, к которой будет привязана новая запись о кассире, если в файле storeCashiers для неё не указан параметр roleId (подробнее см. описание файла storeCashiers)) createUserCard = true (если этот параметр установлен в true, то для всех загружаемых записей будут созданы карты кассиров и в них будет записано содержание поля storeCashiers.password) |
...
Если внешняя система выгружает файлы определенного типа, а конвертер их не загружает (из-за соответствующей настройки), то выгруженные файлы будут оставаться во входном каталоге (inputFolderName).
Правила заполнения справочника налогов
На текущий момент, в России существует только один налог, учитываемый в розничной торговле. Это НДС, имеющий 2 ставки: 10% и 20%.
Пример заполнения справочника групп налогов (таблица tax_group в базе данных):
...
Id (код группы)
...
Tax_id
...
Percent
...
Fp_code
...
Advanced_tax_id
...
Is_preferential
...
Примечание
...
1
...
1
...
10
...
5
...
fasle
...
НДС=10%
...
2
...
1
...
20
...
6
...
fasle
...
НДС=20%
...
3
...
1
...
0
...
fasle
...
НДС=0%
...
4
...
1
...
0
...
true
...
НДС не облагается
...
5
...
1
...
10
...
fasle
...
10/110
...
6
...
1
...
20
...
fasle
...
20/120
Товары со ставкой НДС в 10% в торговой системе привязаны к группе с id=1.
Товары со ставкой НДС в 20% в торговой системе привязаны к группе с id=2.
Если в товарном справочнике в торговой системе есть товары, облагаемые по ставке НДС=0 (не путать с «НДС не облагается»!), то:
- в справочнике должна быть группа со ставкой НДС=0% и значением Is_preferential=false (в данном примере – id=3).
Если предполагается продажа товара без расчета НДС (например, продажа на кассах юр. лица, освобожденного от уплаты НДС), то:
- в справочнике должна быть группа, «отвечающая» за ставку «НДС не облагается» (в данном примере – id=4) с установленным признаком Is_preferential=true;
- независимо от того, какая группа указана у товара, в чеке он будет зарегистрирован с группой id=4.
Если предполагается получение на кассе предоплаты за товары, то:
- в справочнике должны быть группы, «отвечающие» за расчетные ставки (в данном примере – id=5 и 6, соответственно);
- для групп с «обычными» ставками должны быть указаны соответствующие им расчетные группы (в параметре Advanced_tax_id);
- при получении предоплаты за товар с группой id=2, товар будет зарегистрирован в чеке с группой 6 (для группы id=2 указано значение Advanced_tax_id=6);
- при получении предоплаты за товар с группой id=1, товар будет зарегистрирован в чеке с группой 5 (для группы id=1 указано значение Advanced_tax_id=5).
Если предполагается получение на кассе авансовых платежей (например, продажа подарочного сертификата), то:
- в справочнике должна быть группа, «отвечающая» за расчетную ставку (в данном примере – id=6);
- товар, который регистрируется в чеке для получения аванса, должен иметь атрибут Аванс;
- если для SKU указана налоговая ставка с признаком Is_preferential=true, то с этой ставкой он и будет регистрироваться в чеке;
- если SKU продается в магазине, для которого задано, что он не является плательщиком НДС, то SKU регистрируется в чеке с налоговой группой, для которой установлено значение Is_preferential=true;
- если для SKU указана налоговая ставка с заполненным значением Advanced_tax_id (в справочнике налоговых групп), то SKU регистрируется с налоговой группой, указанной в Advanced_tax_id;
- если для SKU указана налоговая ставка с незаполненным Advanced_tax_id, то SKU регистрируется с указанной для него налоговой группой.
Следует помнить о том, что для правильной регистрации товаров в ККТ необходимо устанавливать соответствие между налоговыми группами в кассовой программе и в конкретных моделях ККТ. Установка соответствия происходит в разделе fiscalprinter настроек оборудования.
Например, для ККТ СП-801 и справочника налогов, приведенного выше, соответствие должно быть установлено следующим образом:
# Соответствие налога в ККТ СП и налоговой группы в УКМ 5
# Налоги в ККТ СП-801
# tax0 – НДС 20;
# tax1 – НДС 10;
# tax2 – НДС 0;
# tax3 – без НДС;
# tax4 – 20/120;
# tax5 – 10/110.
...
language | scala |
---|---|
theme | Confluence |
...