Объект items (позиции чека)
Полное описание позиции чека АТОЛ Онлайн v5 - реквизиты, маркировка (mark_code), агенты, поставщики и ОСУ.
Объект items заполняется для каждого добавленного товара; в массиве должен
быть минимум один объект.
Основные поля
| Поле | Тип | Обяз. | Тег ФФД | Описание |
|---|---|---|---|---|
name | string | Да | 1030 | Наименование товара, работы, услуги (до 128 символов) |
price | number | Да | 1079 | Цена за единицу с учетом скидок и наценок, в рублях (целая часть до 11 знаков, дробная до 2, максимум 10 000 000 000). Произведение price × quantity не должно превышать максимум цены позиции |
quantity | number | Да | 1023 | Количество/вес: от 0.000001 до 99 999 999. При wholesale = true - больше 1 |
measure | number | Да | 2108 | Мера количества предмета расчета (см. ниже) |
sum | number | Да | 1043 | Стоимость позиции с учетом скидок и наценок. Должна равняться price × quantity |
payment_method | string | Да | 1214 | Признак способа расчета (см. ниже) |
payment_object | number | Да | 1212 | Признак предмета расчета (см. ниже) |
vat | object | Да | 1199/1200 | Налог на позицию: type (обязателен) и sum (необязателен, касса рассчитает сама) - см. vats |
user_data | string | Нет | 1191 | Дополнительный реквизит предмета расчета (до 64 символов) |
excise | number | Нет | 1229 | Сумма акциза в рублях (неотрицательная) |
country_code | string | Нет | 1230 | Цифровой код страны происхождения товара (3 цифры, короткие коды дополняются пробелами) |
declaration_number | string | Нет | 1231 | Номер таможенной декларации (до 32 символов) |
mark_quantity | object | Нет | 1291 | Дробное количество маркированного товара - только при measure = 0: numerator (тег 1293, строго меньше знаменателя, не 0) и denominator (тег 1294, количество товара в партии/упаковке) |
mark_processing_mode | string | Нет | 2102 | Режим обработки кода маркировки. Для маркированных товаров - значение "0" |
sectoral_item_props | array | Нет | 1260 | Отраслевой реквизит предмета расчета. Обязателен при wholesale = true. Структура - как sectoral_check_props |
mark_code | object | Нет | 1163 | Код товара (см. ниже). Обязателен при wholesale = true |
agent_info | object | Нет | - | Атрибуты агента (см. ниже) |
supplier_info | object | Да, если передан agent_info | - | Атрибуты поставщика (см. ниже) |
wholesale | boolean | Нет | - | Признак ОСУ (объемно-сортовой учет) - учет движения товара по партии, а не по каждой промаркированной единице. При true позволяет указать код товара (mark_code) и общее количество в упаковке (quantity) вместо кода маркировки каждого экземпляра |
planned_status | number | Нет | 2003 | Планируемое изменение статуса маркированного товара. Обязателен при передаче кодов маркировки gs1m/short: 1 - штучный реализован; 2 - мерный в стадии реализации; 3 - штучный возвращен; 4 - часть товара возвращена; 5 - штучный в стадии реализации; 6 - мерный реализован |
Мера количества (measure, тег 2108)
| Код | Значение | Код | Значение | |
|---|---|---|---|---|
| 0 | Поштучно или единицами | 42 | Кубический метр | |
| 10 | Грамм | 50 | Киловатт-час | |
| 11 | Килограмм | 51 | Гигакалория | |
| 12 | Тонна | 70 | Сутки (день) | |
| 20 | Сантиметр | 71 | Час | |
| 21 | Дециметр | 72 | Минута | |
| 22 | Метр | 73 | Секунда | |
| 30 | Квадратный сантиметр | 80 | Килобайт | |
| 31 | Квадратный дециметр | 81 | Мегабайт | |
| 32 | Квадратный метр | 82 | Гигабайт | |
| 40 | Миллилитр | 83 | Терабайт | |
| 41 | Литр | 255 | Иные единицы измерения |
Признак способа расчета (payment_method, тег 1214)
| Значение | Описание |
|---|---|
full_prepayment | Предоплата 100% - полная предварительная оплата до передачи предмета расчета |
prepayment | Предоплата - частичная предварительная оплата |
advance | Аванс |
full_payment | Полный расчет - полная оплата, в том числе с учетом аванса, в момент передачи |
partial_payment | Частичный расчет и кредит |
credit | Передача в кредит |
credit_payment | Оплата кредита |
Признак предмета расчета (payment_object, тег 1212)
| Код | Значение |
|---|---|
| 1 | Реализуемый товар (кроме подакцизных и маркируемых) |
| 2 | Подакцизный товар (кроме маркируемых) |
| 3 | Работа |
| 4 | Услуга |
| 5 | Прием ставок (азартные игры) |
| 6 | Выплата выигрыша (азартные игры) |
| 7 | Прием средств при реализации лотерейных билетов, ставок |
| 8 | Выплата выигрыша (лотереи) |
| 9 | Предоставление прав на использование РИД |
| 10 | Аванс, задаток, предоплата, кредит |
| 11 | Вознаграждение агента |
| 12 | Взнос, пеня, штраф, вознаграждение, бонус |
| 13 | Иной предмет расчета |
| 14 | Передача имущественных прав |
| 15 | Внереализационный доход |
| 16 | Расходы, уменьшающие сумму налога |
| 17 | Торговый сбор |
| 18 | Туристический налог |
| 19 | Залог |
| 20 | Расходы по ст. 346.16 НК РФ |
| 21–25 | Страховые взносы (ОПС/ОМС/ОСС, ИП и организации) |
| 26 | Обменные знаки игорного заведения |
| 27 | Выдача денежных средств банковским платежным агентом |
| 30 | Подакцизный маркируемый товар без кода маркировки |
| 31 | Подакцизный маркируемый товар с кодом маркировки |
| 32 | Маркируемый товар без кода маркировки (кроме подакцизных) |
| 33 | Маркируемый товар с кодом маркировки (кроме подакцизных) |
Объект mark_code (тег 1163)
Передается один из реквизитов. Значения формируются согласно Приложению № 2 к приказу ФНС России от 14.09.2020 № ЕД-7-20/662@ (таблица 118).
| Поле | Тег | Формат |
|---|---|---|
unknown | 1300 | Нераспознанный код товара (до 32 символов) |
ean8 | 1301 | EAN-8, ровно 8 цифр |
ean13 | 1302 | EAN-13, ровно 13 цифр |
itf14 | 1303 | ITF-14, ровно 14 цифр |
gs10 | 1304 | GS1 для товара, не подлежащего маркировке (до 38 символов) |
gs1m | 1305 | GS1 для маркируемого товара (до 200 символов). Код передается целиком и кодируется в Base64 - в коде могут быть непечатные символы |
short | 1306 | Короткий код маркировки (до 38 символов) |
fur | 1307 | КиЗ мехового изделия, ровно 20 символов, маска СС-СССССС-СССССССССС |
egais20 | 1308 | ЕГАИС-2.0, ровно 23 символа |
egais30 | 1309 | ЕГАИС-3.0, ровно 14 символов |
Объект agent_info
| Поле | Тип | Обяз. | Тег | Описание |
|---|---|---|---|---|
type | string | Да | 1222 | Признак агента: bank_paying_agent, bank_paying_subagent, paying_agent, paying_subagent, attorney (поверенный), commission_agent (комиссионер), another (другой тип агента). Ограничен агентами, введенными в ККТ при фискализации |
paying_agent | object | Нет | - | Атрибуты платежного агента: operation (тег 1044, до 24 символов), phones (тег 1073, массив, +{Ц}, до 19 символов) |
receive_payments_operator | object | Нет | - | Оператор по приему платежей: phones (тег 1074) |
money_transfer_operator | object | Нет | - | Оператор перевода: phones (тег 1075), name (тег 1026, до 64), address (тег 1005, до 256), inn (тег 1016, 10 или 12 цифр) |
Российские номера с префиксом +7 можно передавать без префикса
(9251234567), тогда максимум 17 символов на элемент.
Объект supplier_info
Обязателен, если в чеке передан agent_info.
| Поле | Тип | Обяз. | Тег | Описание |
|---|---|---|---|---|
phones | array | Да, если agent_info.type - один из bank_paying_agent, bank_paying_subagent, paying_agent, paying_subagent | 1171 | Телефоны поставщика |
name | string | Да (те же условия) | 1225 | Наименование поставщика (до 256 символов) |
inn | string | Да | 1226 | ИНН поставщика (10 или 12 цифр). Значение 000000000000 - если поставщику не присвоен ИНН в РФ |
Пример позиции с маркировкой
json
{
"name": "Кроссовки маркированные",
"price": 5990,
"quantity": 1.0,
"measure": 0,
"sum": 5990,
"payment_method": "full_payment",
"payment_object": 33,
"vat": { "type": "vat20" },
"mark_processing_mode": "0",
"planned_status": 1,
"mark_code": {
"gs1m": "MDEwNDYwNzQyODY3OTA5MDIxNmVKSWpvV0g1NERkVSA5MWZmZDAgOTJzejZrU1BpckFwZk1CZnR2TGJvRTFkbFdDLzU4aEV4UVVxdjdCQmtabWs0PQ=="
}
}