Перейти к содержимому

Объект items (позиции чека)

Полное описание позиции чека АТОЛ Онлайн v5 - реквизиты, маркировка (mark_code), агенты, поставщики и ОСУ.

Объект items заполняется для каждого добавленного товара; в массиве должен быть минимум один объект.

Основные поля

ПолеТипОбяз.Тег ФФДОписание
namestringДа1030Наименование товара, работы, услуги (до 128 символов)
pricenumberДа1079Цена за единицу с учетом скидок и наценок, в рублях (целая часть до 11 знаков, дробная до 2, максимум 10 000 000 000). Произведение price × quantity не должно превышать максимум цены позиции
quantitynumberДа1023Количество/вес: от 0.000001 до 99 999 999. При wholesale = true - больше 1
measurenumberДа2108Мера количества предмета расчета (см. ниже)
sumnumberДа1043Стоимость позиции с учетом скидок и наценок. Должна равняться price × quantity
payment_methodstringДа1214Признак способа расчета (см. ниже)
payment_objectnumberДа1212Признак предмета расчета (см. ниже)
vatobjectДа1199/1200Налог на позицию: type (обязателен) и sum (необязателен, касса рассчитает сама) - см. vats
user_datastringНет1191Дополнительный реквизит предмета расчета (до 64 символов)
excisenumberНет1229Сумма акциза в рублях (неотрицательная)
country_codestringНет1230Цифровой код страны происхождения товара (3 цифры, короткие коды дополняются пробелами)
declaration_numberstringНет1231Номер таможенной декларации (до 32 символов)
mark_quantityobjectНет1291Дробное количество маркированного товара - только при measure = 0: numerator (тег 1293, строго меньше знаменателя, не 0) и denominator (тег 1294, количество товара в партии/упаковке)
mark_processing_modestringНет2102Режим обработки кода маркировки. Для маркированных товаров - значение "0"
sectoral_item_propsarrayНет1260Отраслевой реквизит предмета расчета. Обязателен при wholesale = true. Структура - как sectoral_check_props
mark_codeobjectНет1163Код товара (см. ниже). Обязателен при wholesale = true
agent_infoobjectНет-Атрибуты агента (см. ниже)
supplier_infoobjectДа, если передан agent_info-Атрибуты поставщика (см. ниже)
wholesalebooleanНет-Признак ОСУ (объемно-сортовой учет) - учет движения товара по партии, а не по каждой промаркированной единице. При true позволяет указать код товара (mark_code) и общее количество в упаковке (quantity) вместо кода маркировки каждого экземпляра
planned_statusnumberНет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).

ПолеТегФормат
unknown1300Нераспознанный код товара (до 32 символов)
ean81301EAN-8, ровно 8 цифр
ean131302EAN-13, ровно 13 цифр
itf141303ITF-14, ровно 14 цифр
gs101304GS1 для товара, не подлежащего маркировке (до 38 символов)
gs1m1305GS1 для маркируемого товара (до 200 символов). Код передается целиком и кодируется в Base64 - в коде могут быть непечатные символы
short1306Короткий код маркировки (до 38 символов)
fur1307КиЗ мехового изделия, ровно 20 символов, маска СС-СССССС-СССССССССС
egais201308ЕГАИС-2.0, ровно 23 символа
egais301309ЕГАИС-3.0, ровно 14 символов

Объект agent_info

ПолеТипОбяз.ТегОписание
typestringДа1222Признак агента: bank_paying_agent, bank_paying_subagent, paying_agent, paying_subagent, attorney (поверенный), commission_agent (комиссионер), another (другой тип агента). Ограничен агентами, введенными в ККТ при фискализации
paying_agentobjectНет-Атрибуты платежного агента: operation (тег 1044, до 24 символов), phones (тег 1073, массив, +{Ц}, до 19 символов)
receive_payments_operatorobjectНет-Оператор по приему платежей: phones (тег 1074)
money_transfer_operatorobjectНет-Оператор перевода: phones (тег 1075), name (тег 1026, до 64), address (тег 1005, до 256), inn (тег 1016, 10 или 12 цифр)

Российские номера с префиксом +7 можно передавать без префикса (9251234567), тогда максимум 17 символов на элемент.

Объект supplier_info

Обязателен, если в чеке передан agent_info.

ПолеТипОбяз.ТегОписание
phonesarrayДа, если agent_info.type - один из bank_paying_agent, bank_paying_subagent, paying_agent, paying_subagent1171Телефоны поставщика
namestringДа (те же условия)1225Наименование поставщика (до 256 символов)
innstringДа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=="
  }
}