GET /stores/{store-id}/products
GET /stores/{store-id}/products/{product-id}
POST /stores/{store-id}/products
PUT /stores/{store-id}/products
PUT /stores/{store-id}/products/{product-id}
PATCH /stores/{store-id}/products/{product-id}
DELETE /stores/{store-id}/products
DELETE /stores/{store-id}/products/{product-id}
GET /stores/{store-id}/product-groups
GET /stores/{store-id}/product-groups/{product-group-id}
POST /stores/{store-id}/product-groups
PUT /stores/{store-id}/product-groups
PUT /stores/{store-id}/product-groups/{product-group-id}
PATCH /stores/{store-id}/product-groups/{product-group-id}
DELETE /stores/{store-id}/product-groups
DELETE /stores/{store-id}/product-groups/{product-group-id}
GET /api/apps/{application_id}/push-notifications/{push-id}
POST /api/apps/{application_id}/push-notifications
POST /api/apps/{application_id}/devices/{device_uuid}/push-notifications
GET /api/v1/inventories/stores/{store-id}/products/schemes
POST /api/v1/inventories/stores/{store-id}/products/schemes
POST /api/v1/inventories/stores/{store-id}/products/schemes/delete
GET /api/v1/inventories/stores/{store-id}/products/extras
POST /api/v1/inventories/stores/{store-id}/products/extras
POST /api/v1/inventories/stores/{store-id}/products/extras/delete
POST /user/create
POST /user/verify
POST /user/token
GET /commodities
PUT /
POST /inventories/stores/{storeUuid}/products
POST /subscription/event
POST /installation/event
GET mobilecashier.ru/api/v2/authorize
GET mobilecashier.evotor.ru/api/v2/market/user/{userId}/stores
GET mobilecashier.evotor.ru/api/v2/market/user/{userId}/staff?shopId=
GET mobilecashier.evotor.ru/api/v2/market/user/{userId}/devices
POST mobilecashier.ru/api/v4/asc/create/userId
GET mobilecashier.ru/api/v4/asc/get
DELETE mobilecashier.ru/api/v2/asc/delete/{uuid}
POST
GET mobcashier.evotor.ru/api/v1/callback/reset/{userId}
Возвращает массив документов.
Идентификатор магазина в Облаке Эвотор
При указании параметра, ответ будет содержать документы, созданные начиная с заданной даты включительно.
Указывайте параметр только в первом запросе из серии постраничных запросов.
Если требуется получить все документы с момента создания магазина, не указывайте параметр.
При указании параметра, ответ будет содержать только документы, созданные до заданной даты исключительно.
Если параметр не указан, значение автоматически определяется как текущая дата в момент выполнения запроса Облаком Эвотор.
Указывайте параметр только в первом запросе из серии постраничных запросов.
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Параметр определяет какие типы документов будет содержать ответ. Если параметр не задан, ответ будет содержать документы всех типов. Вы можете указать несколько типов через запятую.
Возможные значения:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Указывайте параметр только в первом запросе из серии постраничных запросов.
Идентификатор курсора для постраничного чтения данных. Указывается для получения второй и последующих страниц данных.
Параметр должен принимать значение переменной
next_cursor
, которое присутствовало в предыдущем ответе от Облака Эвотор.
Параметры отсутствуют.
{
"items": [
{
"type": "OPEN_SESSION",
"id": "20170222-D58C-40E0-8051-B53ADFF38860",
"extras": {},
"number": 1234,
"close_date": "2017-01-10T09:33:19.757+0000",
"time_zone_offset": 10800000,
"session_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"session_number": 80,
"close_user_id": "20170417-46B8-40B9-802E-4DEB67C07565",
"device_id": "20170928-9441-4BEB-BEAE-C6BC5E7AF30D",
"store_id": "20170928-3176-40EB-80E2-A11F032E282A",
"user_id": "09-012345678901234",
"version": "V2",
"body": {}
}
],
"paging": {
"next_cursor": "string"
}
}
Информация о следующей странице. Если текущая страница является последней, то объект пустой.
Значение параметра cursor
для получения следующей страницы.
Массив документов. Содержимое зависит от типа документа.
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Информация о приёмке товаров.
Массив товаров к приёмке.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Закупочная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Единица измерения из карточки товара.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Наименование товара.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР.
Тип товара или модификации товара:
NORMAL
— Обычный;DAIRY_MARKED
— Молоко и молочная продукция;WATER_MARKED
— Маркированная питьевая вода;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;JUICE_MARKED
— Соки и безалкогольные напитки;SHOES_MARKED
— Маркированная обувь;SERVICE
– Услуга;MEDICINE_MARKED
— Маркированные лекарства;TOBACCO_MARKED
— Маркированный табак (сигареты);PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышлености;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;JEWELRY_MARKED
— Маркированные ювелирные изделия;FUR_MARKED
— Маркированные шубы и меховые изделия;BIKE_MARKED
— Маркированные велосипедные товары;MEDICAL_DEVICES_MARKED
— Маркированные медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;LOTTERY_TICKET
— Лотерейный билет;LOTTERY_PRIZE
— Выигрыш в лотерею.Крепость алкогольной продукции. До трёх знаков в дробной части.
Закупочная стоимость единицы товара из документа. До двух знаков в дробной части.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Штрихкод, по которому товар добавили в документ приёмки.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведется на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null
.
Тип марки. Можеть быть null
.
RAW
— марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS
— марка готовая к фискализации: преобразованная в hex
.Закупочная стоимость единицы товара из карточки товара. До двух знаков в дробной части.
Общая стоимость принятых товарных позиций. До двух знаков в дробной части.
Идентификатор поставщика. Кассир выбирает поставщика из выпадающего списка перед сохранением документа.
Основание для приёмки товара.
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Описание документа инвентаризации.
Массив товарных позиций.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Определяет является инветаризация полной или нет.
true
— полная инвентаризация. Остатки меняются у всех товарных позиций. Неупомянутые товарные позиции приобретают значение 0
.false
— частичная инвентаризация. Остатки меняются только у перечисленных товарныъ позиций.Основание для инвентаризации товаров.
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Информация о переоценке товаров.
Массив товарных позиций для переоценки.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Данные о ценах товара.
Отпускная цена до переоценки.
Отпускная цена после переоценки.
Цена приёмки.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Идентификатор документа приёмки, на основании которого осуществляется переоценка.
Номер документа, на основании которого осуществляется переоценка.
Основание для переоценки товаров.
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Документ возврата товара поставщику.
Массив товарных позиций для возврата поставщику.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Единица измерения из карточки товара.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Наименование товара.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР.
Тип товара или модификации товара:
NORMAL
— Обычный;DAIRY_MARKED
— Молоко и молочная продукция;WATER_MARKED
— Маркированная питьевая вода;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;JUICE_MARKED
— Соки и безалкогольные напитки;SHOES_MARKED
— Маркированная обувь;SERVICE
– Услуга;MEDICINE_MARKED
— Маркированные лекарства;TOBACCO_MARKED
— Маркированный табак (сигареты);PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышлености;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;JEWELRY_MARKED
— Маркированные ювелирные изделия;FUR_MARKED
— Маркированные шубы и меховые изделия;BIKE_MARKED
— Маркированные велосипедные товары;MEDICAL_DEVICES_MARKED
— Маркированные медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;LOTTERY_TICKET
— Лотерейный билет;LOTTERY_PRIZE
— Выигрыш в лотерею.Крепость алкогольной продукции. До трёх знаков в дробной части.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Штрихкод, по которому товар добавили в документ.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null
.
Тип марки. Можеть быть null
.
RAW
— марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS
— марка готовая к фискализации: преобразованная в hex
.Закупочная стоимость единицы товара. До двух знаков в дробной части.
Общая стоимость товарных позиций, которые будут возвращены поставщику. До двух знаков в дробной части.
ФИО поставщика.
Основание для возврата товаров поставщику.
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Документ списания товара.
Массив списанных товарных позиций.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Единица измерения из карточки товара.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Наименование товара.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР.
Тип товара или модификации товара:
NORMAL
— Обычный;DAIRY_MARKED
— Молоко и молочная продукция;WATER_MARKED
— Маркированная питьевая вода;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;JUICE_MARKED
— Соки и безалкогольные напитки;SHOES_MARKED
— Маркированная обувь;SERVICE
– Услуга;MEDICINE_MARKED
— Маркированные лекарства;TOBACCO_MARKED
— Маркированный табак (сигареты);PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышлености;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;JEWELRY_MARKED
— Маркированные ювелирные изделия;FUR_MARKED
— Маркированные шубы и меховые изделия;BIKE_MARKED
— Маркированные велосипедные товары;MEDICAL_DEVICES_MARKED
— Маркированные медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;LOTTERY_TICKET
— Лотерейный билет;LOTTERY_PRIZE
— Выигрыш в лотерею.Крепость алкогольной продукции. До трёх знаков в дробной части.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы.
Номер можно сбросить программно.
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Общая стоимость списанных товарных позиций. До двух знаков в дробной части.
Основание для списания товарных позиций.
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Документ продажи товара.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUM
PERC
Тип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма чека с учётом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWN
CASH
ELECTRON
ADVANCE
CREDIT
COUNTEROFFER
Способ платежа. Возможные значения:
UNKNOWN
– неизвестно (по умолчанию);CASH
– наличными деньгами;ELECTRON
– безналичным расчётом;ADVANCE
– предоплатой (зачётом аванса);CREDIT
– постоплатой (в кредит);COUNTEROFFER
– встречным предоставлением.Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON
.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций.
Сумма скидки на документ, распределенная на товарную позицию.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки, которая была распределена на позицию в момент применения скидки на документ. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Массив разделённых позиций. Используется, когда применение скидок к позициям приводит к дроблению цен с точностью меньше одной копейки.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Сумма НДС на товарную позицию с учетом скидок. До двух знаков в дробной части.
NO_VAT
VAT_10
VAT_18
VAT_0
VAT_18_118
VAT_10_110
Ставка НДС. Возможные значения:
"NO_VAT"
– без НДС;"VAT_0"
– основная ставка 0%;"VAT_10"
– основная ставка 10%;"VAT_10_110"
– расчётная ставка 10%;"VAT_18"
– основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
– расчётная ставка 18%. С первого января 2019 года может содержать 20%.Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Сумма скидки на позицию, применённой в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Код вида алкогольной продукции ФСРАР.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Агентские реквизиты. Присутствует в документе, только если на терминале установлено приложение “Агентская схема”.
Индексы контрагентов из списка в заголовке документа.
Описание операции контрагента.
Сумма акциза, за акцизный товар. Используется при расчётах между юридическими лицами. До двух знаков в дробной части.
Данные об импорте продукции.
Код страны происхождения. Используется при расчётах между юридическими лицами.
Номер таможенной декларации. Используется при расчётах между юридическими лицами.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Штрихкод, по которому товар добавили в чек. Значение отсутствует, если товар добавлен напрямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив, содержащий объекты с описанием характеристик и их значений на момент формирования документа. Присутствует только в случае, если позиция сформирована на основе модификации товара.
Идентификатор характеристики
Название характеристики
Идентификатор значения характеристики
Текст значения характеристики
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Количество товара в упаковке всего.
Информация о расчете НДС на товарную позицию.
Сумма НДС на товарную позицию с учетом скидок.
Сумма НДС на товарную позицию без применения скидок.
NO_VAT
VAT_0
VAT_10
VAT_10_110
VAT_18
VAT_18_118
Ставка НДС. Возможные значения:
"NO_VAT"
– без НДС;"VAT_0"
– основная ставка 0%;"VAT_10"
– основная ставка 10%;"VAT_10_110"
– расчётная ставка 10%;"VAT_18"
– основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
– расчётная ставка 18%. С первого января 2019 года может содержать 20%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённой к конкретной позиции.
Стоимость одной единицы товара в позиции, с учётом примененной скидки на позицию (в момент добавления позиции в документ). Не учитывает скидку на весь документ. До двух знаков в дробной части.
Сумма скидки на позицию, примененной в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку — она пересчитывается в суммовую.
Процент скидки на позицию в момент добавления позиции в документ. До пяти знаков в дробной части.
Идентификатор печатной группы при разделении чека.
Перечень позиций в рамках позиции в чеке.
Например: в состав позиции “Кофе с сиропом” могут входить подпозиции “Кофе Американо, 250 мл” и “Кофейный сироп Мята, 30 мл”.
Как правило, подобная компоновка позиций применяется в категории бизнеса HoReCa.
Подпозиции могут быть добавлены в чек только программно, сторонним приложением на смарт-терминале.
Тип товара или модификации товара:
NORMAL
— Обычный;DAIRY_MARKED
— Молоко и молочная продукция;WATER_MARKED
— Маркированная питьевая вода;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;JUICE_MARKED
— Соки и безалкогольные напитки;SHOES_MARKED
— Маркированная обувь;SERVICE
– Услуга;MEDICINE_MARKED
— Маркированные лекарства;TOBACCO_MARKED
— Маркированный табак (сигареты);PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышлености;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;JEWELRY_MARKED
— Маркированные ювелирные изделия;FUR_MARKED
— Маркированные шубы и меховые изделия;BIKE_MARKED
— Маркированные велосипедные товары;MEDICAL_DEVICES_MARKED
— Маркированные медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;LOTTERY_TICKET
— Лотерейный билет;LOTTERY_PRIZE
— Выигрыш в лотерею.Крепость алкогольной продукции. До трёх знаков в дробной части.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null
.
Тип марки. Можеть быть null
.
RAW
— марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS
— марка готовая к фискализации: преобразованная в hex
.Итоговая сумма с учётом налогов. До двух знаков в дробной части.
Печатные группы. Используется для печати нескольких чеков. Например, в случае с разделённой оплатой.
Адрес организации.
ИНН организации.
Идентификатор печатной группы.
CASH_RECEIPT
INVOICE
STRING_UTII
Способ оплаты.
Наименование организации.
COMMON
SIMPLIFIED_INCOME
SIMPLIFIED_INCOME_OUTCOME
SINGLE_IMPUTED_INCOME
SINGLE_AGRICULTURE
PATENT
Используемая система налогообложения:
COMMON
– общая;SIMPLIFIED_INCOME
– упрощённая (Доход);SIMPLIFIED_INCOME_OUTCOME
– упрощённая (Доход минус Расход);SINGLE_IMPUTED_INCOME
– единый налог на вмененный доход;SINGLE_AGRICULTURE
– единый сельскохозяйственный налог;PATENT
– патентная система налогообложения.Идентификатор места осуществления деятельности. Применяется только для лекарств.
Результаты печати ККТ (массив объектов с фискальными данными). Соответствует зафиксированным в ККТ данным.
Идентификатор печатной группы. Присутствует при разделении чека на печатные группы.
Номер смены в ККТ.
Фискальный номер документа в ККТ из ФН.
Номер чека в ККТ.
Номер документа в ККТ.
Итоговая сумма для печати на документе, с учётом скидок. До двух знаков в дробной части.
Регистрационный номер ККТ.
Дата печати в ККТ на момент печати документа, в формате “DDMMYYYY”.
Серийный номер ККТ.
Номер фискального признака документа.
Заводской номер фискального накопителя.
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Документ возврата.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUM
PERC
Тип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма с учЁтом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWN
CASH
ELECTRON
ADVANCE
CREDIT
COUNTEROFFER
Способ платежа. Возможные значения:
UNKNOWN
– неизвестно (по умолчанию);CASH
– наличными деньгами;ELECTRON
– безналичным расчётом;ADVANCE
– предоплатой (зачётом аванса);CREDIT
– постоплатой (в кредит);COUNTEROFFER
– встречным предоставлением.Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON
.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций.
Сумма скидки на документ, распределенная на товарную позицию.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки, которая была распределена на позицию в момент применения скидки на документ. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Признак способа расчёта согласно ФФД 1.05 и выше.
Сумма первичного взноса.
Поле присутствует только если в качестве способа расчёта используется частичная оплата предмета расчёта в момент его передачи с последующей оплатой в кредит ("type":"CHECKOUT_PARTIAL"
).
PREPAYMENT_FULL
PREPAYMENT_PARTIAL
ADVANCE
CHECKOUT_PARTIAL
CREDIT_PASS
CREDIT_CHECKOUT
Тип признака способа расчёта. Возможные значения:
PREPAYMENT_FULL
– Полная предварительная оплата до момента передачи предмета расчета;PREPAYMENT_PARTIAL
– Частичная предварительная оплата до момента передачи предмета расчета;ADVANCE
– Аванс; CHECKOUT_FULL
– Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчета;CHECKOUT_PARTIAL
– Частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит;CREDIT_PASS
– Передача предмета расчета без его оплаты в момент его передачи с последующей оплатой в кредит;CREDIT_CHECKOUT
– Оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита).Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Массив разделённых позиций. Используется, когда применение скидок к позициям приводит к дроблению цен с точностью меньше одной копейки.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Сумма НДС на товарную позицию с учетом скидок. До двух знаков в дробной части.
NO_VAT
VAT_10
VAT_18
VAT_0
VAT_18_118
VAT_10_110
Ставка НДС. Возможные значения:
"NO_VAT"
– без НДС;"VAT_0"
– основная ставка 0%;"VAT_10"
– основная ставка 10%;"VAT_10_110"
– расчётная ставка 10%;"VAT_18"
– основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
– расчётная ставка 18%. С первого января 2019 года может содержать 20%.Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Сумма скидки на позицию, применённой в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Код вида алкогольной продукции ФСРАР.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Агентские реквизиты. Присутствует в документе, только если на терминале установлено приложение “Агентская схема”.
Индексы контрагентов из списка в заголовке документа.
Описание операции контрагента.
Сумма акциза, за акцизный товар. Используется при расчётах между юридическими лицами. До двух знаков в дробной части.
Данные об импорте продукции.
Код страны происхождения. Используется при расчётах между юридическими лицами.
Номер таможенной декларации. Используется при расчётах между юридическими лицами.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Штрихкод, по которому товар добавили в чек. Значение отсутствует, если товар добавлен напрямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив, содержащий объекты с описанием характеристик и их значений на момент формирования документа. Присутствует только в случае, если позиция сформирована на основе модификации товара.
Идентификатор характеристики
Название характеристики
Идентификатор значения характеристики
Текст значения характеристики
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Количество товара в упаковке всего.
Информация о расчете НДС на товарную позицию.
Сумма НДС на товарную позицию с учетом скидок.
Сумма НДС на товарную позицию без применения скидок.
NO_VAT
VAT_0
VAT_10
VAT_10_110
VAT_18
VAT_18_118
Ставка НДС. Возможные значения:
"NO_VAT"
– без НДС;"VAT_0"
– основная ставка 0%;"VAT_10"
– основная ставка 10%;"VAT_10_110"
– расчётная ставка 10%;"VAT_18"
– основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
– расчётная ставка 18%. С первого января 2019 года может содержать 20%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённая к конкретной позиции.
Скидка на единицу товара с учетом налогов. До двух знаков в дробной части.
Сумма скидки на позицию, применённой при добавлении позиции в документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки - сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки на позицию. До пяти знаков в дробной части.
Идентификатор печатной группы при разбивке чека.
Тип товара или модификации товара:
NORMAL
— Обычный;DAIRY_MARKED
— Молоко и молочная продукция;WATER_MARKED
— Маркированная питьевая вода;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;JUICE_MARKED
— Соки и безалкогольные напитки;SHOES_MARKED
— Маркированная обувь;SERVICE
– Услуга;MEDICINE_MARKED
— Маркированные лекарства;TOBACCO_MARKED
— Маркированный табак (сигареты);PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышлености;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;JEWELRY_MARKED
— Маркированные ювелирные изделия;FUR_MARKED
— Маркированные шубы и меховые изделия;BIKE_MARKED
— Маркированные велосипедные товары;MEDICAL_DEVICES_MARKED
— Маркированные медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;LOTTERY_TICKET
— Лотерейный билет;LOTTERY_PRIZE
— Выигрыш в лотерею.Крепость алкогольной продукции. До трёх знаков в дробной части.
Указатель на родительский элемент позиции в древовидной иерархии номенклатуры.
Родительским элементом может быть группа товаров или группа модификаций.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null
.
Тип марки. Можеть быть null
.
RAW
— марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS
— марка готовая к фискализации: преобразованная в hex
.Перечень позиций в рамках позиции в чеке.
Например: в состав позиции “Кофе с сиропом” могут входить подпозиции “Кофе Американо, 250 мл” и “Кофейный сироп Мята, 30 мл”.
Как правило, подобная компоновка позиций применяется в категории бизнеса HoReCa.
Подпозиции могут быть добавлены в чек только программно, сторонним приложением на смарт-терминале.
Итоговая сумма с учётом налогов. До двух знаков в дробной части.
Печатные группы. Используется для печати нескольких чеков. Например, в случае с разделённой оплатой.
Адрес организации.
ИНН организации.
Идентификатор печатной группы.
CASH_RECEIPT
INVOICE
STRING_UTII
Способ оплаты.
Наименование организации.
COMMON
SIMPLIFIED_INCOME
SIMPLIFIED_INCOME_OUTCOME
SINGLE_IMPUTED_INCOME
SINGLE_AGRICULTURE
PATENT
Используемая система налогообложения:
COMMON
– общая;SIMPLIFIED_INCOME
– упрощённая (Доход);SIMPLIFIED_INCOME_OUTCOME
– упрощённая (Доход минус Расход);SINGLE_IMPUTED_INCOME
– единый налог на вмененный доход;SINGLE_AGRICULTURE
– единый сельскохозяйственный налог;PATENT
– патентная система налогообложения.Идентификатор места осуществления деятельности. Применяется только для лекарств.
Соответствует атрибуту id
документа продажи, на основании которого оформляется возврат (если производится возврат на основе чека). Не имеет значения если возврат производится без чека.
Соответствует атрибуту number
документа продажи, на основании которого оформляется возврат (если производится возврат на основе чека). Не имеет значения если возврат производится без чека.
Результаты печати ККТ (массив объектов с фискальными данными). Соответствует зафиксированным в ККТ данным.
Идентификатор печатной группы. Присутствует при разделении чека на печатные группы.
Номер смены в ККТ.
Фискальный номер документа в ККТ из ФН.
Номер чека в ККТ.
Номер документа в ККТ.
Итоговая сумма для печати на документе, с учётом скидок. До двух знаков в дробной части.
Регистрационный номер ККТ.
Дата печати в ККТ на момент печати документа, в формате “DDMMYYYY”.
Серийный номер ККТ.
Номер фискального признака документа.
Заводской номер фискального накопителя.
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUM
PERC
Тип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма с учетом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWN
CASH
ELECTRON
ADVANCE
CREDIT
COUNTEROFFER
Способ платежа. Возможные значения:
UNKNOWN
– неизвестно (по умолчанию);CASH
– наличными деньгами;ELECTRON
– безналичным расчётом;ADVANCE
– предоплатой (зачётом аванса);CREDIT
– постоплатой (в кредит);COUNTEROFFER
– встречным предоставлением.Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON
.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций в документе.
Сумма скидки на документ, распределённая на товарную позицию.
Сумма скидки, которая была распределена на позицию при применении скидки на документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки - сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки, которая была распределена на позицию при применении скидки на документ. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Агентские реквизиты. Присутствует в документе, только если на терминале установлено приложение “Агентская схема”.
Индексы контрагентов из списка в заголовке документа.
Описание операции контрагента.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Штрихкод, по которому товар добавили в чек. Значение отсутствует, если товар добавлен напрямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счет ведется на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив, содержащий объекты с описанием характеристик и их значений на момент формирования документа. Присутствует только в случае, если позиция сформирована на основе модификации товара.
Идентификатор характеристики
Название характеристики
Идентификатор значения характеристики
Текст значения характеристики
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Информация о расчёте НДС на товарную позицию.
Сумма НДС на товарную позицию с учетом скидок.
Сумма НДС на товарную позицию без применения скидок.
NO_VAT
VAT_0
VAT_10
VAT_10_110
VAT_18
VAT_18_118
Ставка НДС. Возможные значения:
"NO_VAT"
— без НДС;"VAT_0"
— основная ставка 0%;"VAT_10"
— основная ставка 10%;"VAT_10_110"
— расчётная ставка 10%;"VAT_18"
— основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
— расчётная ставка 18%. С первого января 2019 года может содержать 20%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённой к конкретной позиции.
Стоимость одной единицы товара в позиции, с учётом скидки на позицию, применённой при добавлении позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
Сумма скидки на позицию, применённой при добавлении позиции в документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки на позицию, при добавлении позиции в документ. До пяти знаков в дробной части.
Идентификатор печатной группы при разбивке чека. Формат – uuid4
, в соответствии с RFC
Тип товара или модификации товара:
NORMAL
— Обычный;DAIRY_MARKED
— Молоко и молочная продукция;WATER_MARKED
— Маркированная питьевая вода;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;JUICE_MARKED
— Соки и безалкогольные напитки;SHOES_MARKED
— Маркированная обувь;SERVICE
– Услуга;MEDICINE_MARKED
— Маркированные лекарства;TOBACCO_MARKED
— Маркированный табак (сигареты);PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышлености;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;JEWELRY_MARKED
— Маркированные ювелирные изделия;FUR_MARKED
— Маркированные шубы и меховые изделия;BIKE_MARKED
— Маркированные велосипедные товары;MEDICAL_DEVICES_MARKED
— Маркированные медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;LOTTERY_TICKET
— Лотерейный билет;LOTTERY_PRIZE
— Выигрыш в лотерею.Крепость алкогольной продукции. До трёх знаков в дробной части.
Указатель на родительский элемент позиции в древовидной иерархии номенклатуры.
Родительским элементом может быть группа товаров или группа модификаций.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null
.
Тип марки. Можеть быть null
.
RAW
— марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS
— марка готовая к фискализации: преобразованная в hex
.Итоговая сумма с учётом налогов. До двух знаков в дробной части.
Печатные группы. Используется для печати нескольких чеков. Например, в случае с разделённой оплатой.
Адрес организации.
ИНН организации.
Идентификатор печатной группы.
CASH_RECEIPT
INVOICE
STRING_UTII
Способ оплаты.
Наименование организации.
COMMON
SIMPLIFIED_INCOME
SIMPLIFIED_INCOME_OUTCOME
SINGLE_IMPUTED_INCOME
SINGLE_AGRICULTURE
PATENT
Используемая система налогообложения:
COMMON
– общая;SIMPLIFIED_INCOME
– упрощённая (Доход);SIMPLIFIED_INCOME_OUTCOME
– упрощённая (Доход минус Расход);SINGLE_IMPUTED_INCOME
– единый налог на вмененный доход;SINGLE_AGRICULTURE
– единый сельскохозяйственный налог;PATENT
– патентная система налогообложения.Идентификатор места осуществления деятельности. Применяется только для лекарств.
Результаты печати ККТ (массив объектов с фискальными данными). Соответствует зафиксированным в ККТ данным.
Идентификатор печатной группы. Присутствует при разделении чека на печатные группы.
Номер смены в ККТ.
Фискальный номер документа в ККТ из ФН.
Номер чека в ККТ.
Номер документа в ККТ.
Итоговая сумма для печати на документе, с учётом скидок. До двух знаков в дробной части.
Регистрационный номер ККТ.
Дата печати в ККТ на момент печати документа, в формате “DDMMYYYY”.
Серийный номер ККТ.
Номер фискального признака документа.
Заводской номер фискального накопителя.
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Документ выкупа товара клиентом.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUM
PERC
Тип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма с учётом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWN
CASH
ELECTRON
ADVANCE
CREDIT
COUNTEROFFER
Способ платежа. Возможные значения:
UNKNOWN
– неизвестно (по умолчанию);CASH
– наличными деньгами;ELECTRON
– безналичным расчётом;ADVANCE
– предоплатой (зачётом аванса);CREDIT
– постоплатой (в кредит);COUNTEROFFER
– встречным предоставлением.Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON
.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций.
Скидка на документ, распределённая на товарную позицию
Сумма скидки, которая была распределена на поззицию при применении скидки на документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Обязательно для алкогольных типов товаров.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Перечень позиций в рамках позиции в чеке.
Например: в состав позиции “Кофе с сиропом” могут входить подпозиции “Кофе Американо, 250 мл” и “Кофейный сироп Мята, 30 мл”.
Как правило, подобная компоновка позиций применяется в категории бизнеса HoReCa.
Подпозиции могут быть добавлены в чек только программно, сторонним приложением на смарт-терминале.
Отпускная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР.
Обязательное поле для алкогольных типов товаров.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Агентские реквизиты. Присутствует в документе, только если на терминале установлено приложение “Агентская схема”.
Индексы контрагентов из списка в заголовке документа.
Описание операции контрагента.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Штрихкод, по которому товар добавили в чек. Значение отсутствует, если товар добавлен напрямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив, содержащий объекты с описанием характеристик и их значений на момент формирования документа. Присутствует только в случае, если позиция сформирована на основе модификации товара.
Идентификатор характеристики
Название характеристики
Идентификатор значения характеристики
Текст значения характеристики
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Информация о расчёте НДС на товарную позицию.
Сумма НДС на товарную позицию с учётом скидок. До двух знаков в дробной части.
Сумма НДС на товарную позицию без применения скидок. До двух знаков в дробной части.
NO_VAT
VAT_10
VAT_18
VAT_0
VAT_18_118
VAT_10_110
Ставка НДС. Возможные значения:
"NO_VAT"
– без НДС;"VAT_0"
– основная ставка 0%;"VAT_10"
– основная ставка 10%;"VAT_10_110"
– расчётная ставка 10%;"VAT_18"
– основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
– расчётная ставка 18%. С первого января 2019 года может содержать 20%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённой к конкретной позиции.
Стоимость одной единицы товара в позиции, с учётом применённой скидки на позицию (в момент добавления позиции в документ). Не учитывает скидку на весь документ. До двух знаков в дробной части.
Сумма скидки на позицию, применённной при добавлении позиции в документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки на позицию, при добавлении позиции в документ. До пяти знаков в дробной части.
Идентификатор печатной группы при разбивке чека.
Тип товара или модификации товара:
NORMAL
— Обычный;DAIRY_MARKED
— Молоко и молочная продукция;WATER_MARKED
— Маркированная питьевая вода;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;JUICE_MARKED
— Соки и безалкогольные напитки;SHOES_MARKED
— Маркированная обувь;SERVICE
– Услуга;MEDICINE_MARKED
— Маркированные лекарства;TOBACCO_MARKED
— Маркированный табак (сигареты);PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышлености;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;JEWELRY_MARKED
— Маркированные ювелирные изделия;FUR_MARKED
— Маркированные шубы и меховые изделия;BIKE_MARKED
— Маркированные велосипедные товары;MEDICAL_DEVICES_MARKED
— Маркированные медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;LOTTERY_TICKET
— Лотерейный билет;LOTTERY_PRIZE
— Выигрыш в лотерею.Крепость алкогольной продукции. До трёх знаков в дробной части.
Указатель на родительский элемент позиции в древовидной иерархии номенклатуры.
Родительским элементом может быть группа товаров или группа модификаций.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null
.
Тип марки. Можеть быть null
.
RAW
— марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS
— марка готовая к фискализации: преобразованная в hex
.Итоговая сумма с учётом налогов. До двух знаков в дробной части.
Печатные группы. Используется для печати нескольких чеков. Например, в случае с разделённой оплатой.
Адрес организации.
ИНН организации.
Идентификатор печатной группы.
CASH_RECEIPT
INVOICE
STRING_UTII
Способ оплаты.
Наименование организации.
COMMON
SIMPLIFIED_INCOME
SIMPLIFIED_INCOME_OUTCOME
SINGLE_IMPUTED_INCOME
SINGLE_AGRICULTURE
PATENT
Используемая система налогообложения:
COMMON
– общая;SIMPLIFIED_INCOME
– упрощённая (Доход);SIMPLIFIED_INCOME_OUTCOME
– упрощённая (Доход минус Расход);SINGLE_IMPUTED_INCOME
– единый налог на вмененный доход;SINGLE_AGRICULTURE
– единый сельскохозяйственный налог;PATENT
– патентная система налогообложения.Идентификатор места осуществления деятельности. Применяется только для лекарств.
Соответствует атрибуту id
документа продажи, на основании которого оформляется возврат (если производится возврат на основе чека). Не имеет значения если возврат производится без чека.
Соответствует атрибуту number
документа продажи, на основании которого оформляется возврат (если производится возврат на основе чека). Не имеет значения если возврат производится без чека.
Результаты печати ККТ (массив объектов с фискальными данными). Соответствует зафиксированным в ККТ данным.
Идентификатор печатной группы. Присутствует при разделении чека на печатные группы.
Номер смены в ККТ.
Фискальный номер документа в ККТ из ФН.
Номер чека в ККТ.
Номер документа в ККТ.
Итоговая сумма для печати на документе, с учётом скидок. До двух знаков в дробной части.
Регистрационный номер ККТ.
Дата печати в ККТ на момент печати документа, в формате “DDMMYYYY”.
Серийный номер ККТ.
Номер фискального признака документа.
Заводской номер фискального накопителя.
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Документ вскрытия тары.
Массив алкогольных товаров для вскрытия тары.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Поле обязательно для алкогольных типов товаров.
Отпускная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Единица измерения из карточки товара.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Наименование товара.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР
Поле обязательно для алкогольных типов товаров.
ALCOHOL_MARKED
ALCOHOL_NOT_MARKED
Тип товара:
ALCOHOL_MARKED
— маркированный алкоголь.ALCOHOL_NOT_MARKED
— немаркированный алкоголь.Крепость алкогольной продукции. До трёх знаков в дробной части.
Поле обязательно для немаркированного алкоголя.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Штрихкод, по которому товар добавлен в документ. Поле пустое, если товар выбран на прямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null
.
Тип марки. Можеть быть null
.
RAW
— марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS
— марка готовая к фискализации: преобразованная в hex
.OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Пустой объект.
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Данные о закрытии смены.
Выручка за смену. До двух знаков в дробной части.
Сумма наличных средств в кассе на момент закрытия смены. До двух знаков в дробной части.
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Данные об открытии смены в ККТ.
Номер смены в ККТ.
Номер чека в ККТ.
Номер документа в ККТ
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа
Номер смены в ККТ.
Фискальный номер документа в ККТ из ФН.
Номер документа в ККТ.
Номер чека в ККТ.
Имя вносителя средств (“От кого”).
Регистрационный номер ККТ.
Дата в ККТ на момент печати документа. Формат DDMMYYYY
.
Серийный номер ККТ.
Основание для внесения.
Сумма для внесения. До двух знаков в дробной части.
Номер фискального признака документа.
Заводской номер фискального накопителя.
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Документ выплаты наличных.
Номер смены в ККТ.
Номер документа в ККТ.
Имя получателя средств.
Основание для выплаты.
Сумма для выплаты. До двух знаков в дробной части.
Номер фискального признака документа.
1
2
3
4
5
6
Числовой идентификатор категории платежа:
1
— инкассация;2
— оплата поставщику;3
— оплата услуг;4
— аренда;5
— заработная плата;6
— прочее.Инкассация
Оплата поставщику
Оплата услуг
Аренда
Заработная плата
Прочее
Текстовый идентификатор категории платежа.
Заводской номер фискального накопителя.
Фискальный номер документа в ККТ из ФН.
Номер чека в ККТ.
Регистрационный номер ККТ.
Дата печати в ККТ на момент печати документа. Формат DDMMYYYY
.
Серийный номер ККТ.
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
X-отчёт.
Номер смены в ККТ.
Общая сумма продаж за смену на момент формирования отчёта. До двух знаков в дробной части.
Номер чека в ККТ.
Номер документа в ККТ.
Выручка за смену на момент формирования отчёта. До двух знаков в дробной части.
Наличные средства в кассе на момент формирования отчёта. До двух знаков в дробной части.
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Z-отчёт.
Количество операций выплаты.
Информация о продажах (sales
), возвратах продаж (sales_back
), покупках (purchases
) или возвратах покупок (purchases_back
) в разрезе способов оплаты доступных на ККТ.
Сумма обратной операции. До двух знаков в дробной части.
Сумма операции. До двух знаков в дробной части.
Секции оплаты
Номер секции ККТ.
ТАРОЙ
ПЛАТ.КАРТОЙ
КРЕДИТОМ
НАЛИЧНЫМИ
ТИП 5
ТИП 6
ТИП 7
ТИП 8
ТИП 9
ТИП 10
Наименование секции ККТ.
Сумма оплаты по данной секции. До двух знаков в дробной части.
Фискальный номер документа в ККТ из ФН.
Общая сумма продаж за смену. До двух знаков в дробной части.
Доход за смену. До двух знаков в дробной части.
Выручка за смену. До двух знаков в дробной части.
Серийный номер ККТ.
Информация о продажах (sales
), возвратах продаж (sales_back
), покупках (purchases
) или возвратах покупок (purchases_back
) в разрезе способов оплаты доступных на ККТ.
Сумма обратной операции. До двух знаков в дробной части.
Сумма операции. До двух знаков в дробной части.
Секции оплаты
Номер секции ККТ.
ТАРОЙ
ПЛАТ.КАРТОЙ
КРЕДИТОМ
НАЛИЧНЫМИ
ТИП 5
ТИП 6
ТИП 7
ТИП 8
ТИП 9
ТИП 10
Наименование секции ККТ.
Сумма оплаты по данной секции. До двух знаков в дробной части.
Наличные средства в кассе. До двух знаков в дробной части.
Номер смены в ККТ.
Номер документа в ККТ.
Необнуляемая сумма покупок. До двух знаков в дробной части.
Информация о продажах (sales
), возвратах продаж (sales_back
), покупках (purchases
) или возвратах покупок (purchases_back
) в разрезе способов оплаты доступных на ККТ.
Сумма обратной операции. До двух знаков в дробной части.
Сумма операции. До двух знаков в дробной части.
Секции оплаты
Номер секции ККТ.
ТАРОЙ
ПЛАТ.КАРТОЙ
КРЕДИТОМ
НАЛИЧНЫМИ
ТИП 5
ТИП 6
ТИП 7
ТИП 8
ТИП 9
ТИП 10
Наименование секции ККТ.
Сумма оплаты по данной секции. До двух знаков в дробной части.
Сменный итог по продажам. До двух знаков в дробной части.
Количество операций внесения.
Сумма внесений за смену. До двух знаков в дробной части.
Информация о продажах (sales
), возвратах продаж (sales_back
), покупках (purchases
) или возвратах покупок (purchases_back
) в разрезе способов оплаты доступных на ККТ.
Сумма обратной операции. До двух знаков в дробной части.
Сумма операции. До двух знаков в дробной части.
Секции оплаты
Номер секции ККТ.
ТАРОЙ
ПЛАТ.КАРТОЙ
КРЕДИТОМ
НАЛИЧНЫМИ
ТИП 5
ТИП 6
ТИП 7
ТИП 8
ТИП 9
ТИП 10
Наименование секции ККТ.
Сумма оплаты по данной секции. До двух знаков в дробной части.
Номер фискального признака документа.
Сумма к инкассации. До двух знаков в дробной части.
Заводской номер фискального накопителя.
Сумма выплат за смену. До двух знаков в дробной части.
Номер чека в ККТ.
Регистрационный номер ККТ.
Необнуляемая сумма продаж. До двух знаков в дробной части.
Число операций продаж (sales
) или покупок (purchases
), в зависимости от названия объекта. Содержит информацию блока Продажи или Покупки на чеке Z-отчёта, соответственно.
Количество прямых операций.
Количество операций.
Количество обратных операций.
Количество отмен обратных операций
Дата в ККТ на момент печати документа. Формат DDMMYYYY
.
Сменный итог покупок. До двух знаков в дробной части.
Число операций продаж (sales
) или покупок (purchases
), в зависимости от названия объекта. Содержит информацию блока Продажи или Покупки на чеке Z-отчёта, соответственно.
Количество прямых операций.
Количество операций.
Количество обратных операций.
Количество отмен обратных операций
OPEN_SESSION
POS_OPEN_SESSION
CLOSE_SESSION
CASH_INCOME
CASH_OUTCOME
INVENTORY
ACCEPT
REVALUATION
WRITE_OFF
RETURN
OPEN_TARE
SELL
PAYBACK
BUY
BUYBACK
X_REPORT
Z_REPORT
CORRECTION
Тип документа:
OPEN_SESSION
— открытие смены на смарт-терминале;POS_OPEN_SESSION
— открытие смены в ККТ;CLOSE_SESSION
— закрытие смены;CASH_INCOME
— внесение наличных в кассу;CASH_OUTCOME
— изъятие наличных из кассы;INVENTORY
— инвентаризация;ACCEPT
— приемка товара;REVALUATION
— переоценка товара;WRITE_OFF
— списание товара;RETURN
— возврат товара поставщику;OPEN_TARE
— вскрытие тары;SELL
— продажа товара;PAYBACK
— возврат товара продавцу;BUY
— выкуп (товара у клиента);BUYBACK
— обратный выкуп (товара клиентом);X_REPORT
— X-отчет (без гашения);Z_REPORT
— Z-отчет (с гашением);CORRECTION
— чек коррекции.Уникальный в рамках магазина идентификатор документа в Облаке Эвотор. Формируется смарт-терминалом в момент сохранения документа.
Объект с дополнительной информацией, которую могут добавлять в документ сторонние приложения, установленные на смарт-терминале.
Каждое приложение получает в extras
только те данные, которые были записаны в его контексте.
Порядковый номер документа на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Дата на смарт-терминале в момент сохранения документа. Представляется в формате ISO 8601 и приводится к TZ +0000.
Отражает настройки часового пояса на смарт-терминале в момент сохранения документа. Смещение для даты сохранения документа на смарт-терминале в миллисекундах относительно UTC.
Может принимать как положительные, так и отрицательные значения.
Уникальный идентификатор смены. Смарт-терминал присваивает идентификатор в момент открытия смены документом OPEN_SESSION
. Все документы в рамках одной смены имеют одинаковый идентификатор смены.
Порядковый номер смены на смарт-терминале. Отсчёт ведётся с момента активации смарт-терминала. При выполнении программного сброса отсчёт начинается с единицы.
Уникальный идентификатор сотрудника под учётными данными которого был создан документ.
Идентификатор смарт-терминала, на котором был сформирован документ.
Уникальный идентификатор магазина, в котором находился смарт-терминал, когда был сформирован документ.
Идентификатор пользователя Эвотор, соответствующий учётной записи владельца бизнеса, на которую активирован смарт-терминал, сформировавший документ.
V2
Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENT
SUBAGENT
PRINCIPAL
TRANSACTION_OPERATOR
Роль контрагента. Возможные значения:
AGENT
– агент;SUBAGENT
– субагент;PRINCIPAL
– принципал;TRANSACTION_OPERATOR
– оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT
или SUBAGENT
.
AGENT
COMMISSIONER
ATTORNEY_IN_FACT
PAYMENT_AGENT
BANK_PAYMENT_AGENT
Тип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT
. Возможные значения:
AGENT
– агент;COMMISSIONER
– комиссионер;ATTORNEY_IN_FACT
– поверенный;PAYMENT_AGENT
– платёжный агент;BANK_PAYMENT_AGENT
– банковский платёжный агент.PAYMENT_SUBAGENT
BANK_PAYMENT_SUBAGENT
Тип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT
. Возможные значения:
PAYMENT_SUBAGENT
– платёжный субагент;BANK_PAYMENT_SUBAGENT
– банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITY
INDIVIDUAL_ENTREPRENEUR
GOVERNMENT_AGENCY
Тип контрагента:
LEGAL_ENTITY
— юридическое лицо;INDIVIDUAL_ENTREPRENEUR
— индивидуальный предприниматель;GOVERNMENT_AGENCY
— государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Документ коррекции.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUM
PERC
Тип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма с учётом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWN
CASH
ELECTRON
ADVANCE
CREDIT
COUNTEROFFER
Способ платежа. Возможные значения:
UNKNOWN
– неизвестно (по умолчанию);CASH
– наличными деньгами;ELECTRON
– безналичным расчётом;ADVANCE
– предоплатой (зачётом аванса);CREDIT
– постоплатой (в кредит);COUNTEROFFER
– встречным предоставлением.Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON
.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций.
Сумма скидки на документ, распределенная на товарную позицию.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки, которая была распределена на позицию в момент применения скидки на документ. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Массив разделённых позиций. Используется, когда применение скидок к позициям приводит к дроблению цен с точностью меньше одной копейки.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Сумма НДС на товарную позицию с учетом скидок. До двух знаков в дробной части.
NO_VAT
VAT_10
VAT_18
VAT_0
VAT_18_118
VAT_10_110
Ставка НДС. Возможные значения:
"NO_VAT"
– без НДС;"VAT_0"
– основная ставка 0%;"VAT_10"
– основная ставка 10%;"VAT_10_110"
– расчётная ставка 10%;"VAT_18"
– основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
– расчётная ставка 18%. С первого января 2019 года может содержать 20%.Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Сумма скидки на позицию, применённой в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Код вида алкогольной продукции ФСРАР.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Агентские реквизиты. Присутствует в документе, только если на терминале установлено приложение “Агентская схема”.
Индексы контрагентов из списка в заголовке документа.
Описание операции контрагента.
Сумма акциза, за акцизный товар. Используется при расчётах между юридическими лицами. До двух знаков в дробной части.
Данные об импорте продукции.
Код страны происхождения. Используется при расчётах между юридическими лицами.
Номер таможенной декларации. Используется при расчётах между юридическими лицами.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Штрихкод, по которому товар добавили в чек. Значение отсутствует, если товар добавлен напрямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив, содержащий объекты с описанием характеристик и их значений на момент формирования документа. Присутствует только в случае, если позиция сформирована на основе модификации товара.
Идентификатор характеристики
Название характеристики
Идентификатор значения характеристики
Текст значения характеристики
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Количество товара в упаковке всего.
Информация о расчете НДС на товарную позицию.
Сумма НДС на товарную позицию с учетом скидок.
Сумма НДС на товарную позицию без применения скидок.
NO_VAT
VAT_0
VAT_10
VAT_10_110
VAT_18
VAT_18_118
Ставка НДС. Возможные значения:
"NO_VAT"
– без НДС;"VAT_0"
– основная ставка 0%;"VAT_10"
– основная ставка 10%;"VAT_10_110"
– расчётная ставка 10%;"VAT_18"
– основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
– расчётная ставка 18%. С первого января 2019 года может содержать 20%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённой к конкретной позиции.
Стоимость одной единицы товара в позиции, с учётом примененной скидки на позицию (в момент добавления позиции в документ). Не учитывает скидку на весь документ. До двух знаков в дробной части.
Сумма скидки на позицию, примененной в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку — она пересчитывается в суммовую.
Процент скидки на позицию в момент добавления позиции в документ. До пяти знаков в дробной части.
Идентификатор печатной группы при разделении чека.
Перечень позиций в рамках позиции в чеке.
Например: в состав позиции “Кофе с сиропом” могут входить подпозиции “Кофе Американо, 250 мл” и “Кофейный сироп Мята, 30 мл”.
Как правило, подобная компоновка позиций применяется в категории бизнеса HoReCa.
Подпозиции могут быть добавлены в чек только программно, сторонним приложением на смарт-терминале.
Тип товара или модификации товара:
NORMAL
— Обычный;DAIRY_MARKED
— Молоко и молочная продукция;WATER_MARKED
— Маркированная питьевая вода;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;JUICE_MARKED
— Соки и безалкогольные напитки;SHOES_MARKED
— Маркированная обувь;SERVICE
– Услуга;MEDICINE_MARKED
— Маркированные лекарства;TOBACCO_MARKED
— Маркированный табак (сигареты);PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышлености;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;JEWELRY_MARKED
— Маркированные ювелирные изделия;FUR_MARKED
— Маркированные шубы и меховые изделия;BIKE_MARKED
— Маркированные велосипедные товары;MEDICAL_DEVICES_MARKED
— Маркированные медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;LOTTERY_TICKET
— Лотерейный билет;LOTTERY_PRIZE
— Выигрыш в лотерею.Крепость алкогольной продукции. До трёх знаков в дробной части.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null
.
Тип марки. Можеть быть null
.
RAW
— марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS
— марка готовая к фискализации: преобразованная в hex
.Печатные группы. Используется для печати нескольких чеков. Например, в случае с разделённой оплатой.
Адрес организации.
ИНН организации.
Идентификатор печатной группы.
CASH_RECEIPT
INVOICE
STRING_UTII
Способ оплаты.
Наименование организации.
COMMON
SIMPLIFIED_INCOME
SIMPLIFIED_INCOME_OUTCOME
SINGLE_IMPUTED_INCOME
SINGLE_AGRICULTURE
PATENT
Используемая система налогообложения:
COMMON
– общая;SIMPLIFIED_INCOME
– упрощённая (Доход);SIMPLIFIED_INCOME_OUTCOME
– упрощённая (Доход минус Расход);SINGLE_IMPUTED_INCOME
– единый налог на вмененный доход;SINGLE_AGRICULTURE
– единый сельскохозяйственный налог;PATENT
– патентная система налогообложения.Идентификатор места осуществления деятельности. Применяется только для лекарств.
Результаты печати ККТ (массив объектов с фискальными данными). Соответствует зафиксированным в ККТ данным.
Идентификатор печатной группы. Присутствует при разделении чека на печатные группы.
Номер смены в ККТ.
Фискальный номер документа в ККТ из ФН.
Номер чека в ККТ.
Номер документа в ККТ.
Итоговая сумма для печати на документе, с учётом скидок. До двух знаков в дробной части.
Регистрационный номер ККТ.
Дата печати в ККТ на момент печати документа, в формате “DDMMYYYY”.
Серийный номер ККТ.
Номер фискального признака документа.
Заводской номер фискального накопителя.
— ELECTRON — CASH
Тип принятой оплаты:
ELECTRON
– безналичная оплата;CASH
– оплата наличными.Дата коррекции.
Номер документа
Причина коррекции.
— INDEPENDENT — REQUIREMENT
Тип поррекции:
INDEPENDENT
- самостоятельная;REQUIREMENT
- по требованию.— SELL — BUY — RETURN
Тип операции, по которой происходит коррекция.
Сумма возврата.
COMMON
SIMPLIFIED_INCOME
SIMPLIFIED_INCOME_OUTCOME
SINGLE_IMPUTED_INCOME
SINGLE_AGRICULTURE
PATENT
Используемая система налогообложения:
COMMON
– общая;SIMPLIFIED_INCOME
– упрощённая (Доход);SIMPLIFIED_INCOME_OUTCOME
– упрощённая (Доход минус Расход);SINGLE_IMPUTED_INCOME
– единый налог на вмененный доход;SINGLE_AGRICULTURE
– единый сельскохозяйственный налог;PATENT
– патентная система налогообложения.— CASH — ELECTRON
Способ возврата средств клиенту:
ELECTRON
– безналичный расчёт;CASH
— наличный расчёт.NO_VAT
VAT_10
VAT_18
VAT_0
VAT_18_118
VAT_10_110
Ставка НДС. Возможные значения:
"NO_VAT"
– без НДС;"VAT_0"
– основная ставка 0%;"VAT_10"
– основная ставка 10%;"VAT_10_110"
– расчётная ставка 10%;"VAT_18"
– основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
– расчётная ставка 18%. С первого января 2019 года может содержать 20%.— CORRECTION_INCOME — CORRECTION_OUTCOME — CORRECTION_RETURN_INCOME — CORRECTION_RETURN_OUTCOME
Тип коррекции:
CORRECTION_INCOME
— входящая коррекция;CORRECTION_OUTCOME
— исходящая коррекция;CORRECTION_RETURN_INCOME
— входящая коррекция возврата;CORRECTION_RETURN_OUTCOME
— исходящая коррекция возврата.Запрос выполнен успешно
Ошибка авторизации приложения.
Облако передаёт ошибку с кодом 402, в случае, когда происходит попытка обмена данными между смарт-терминалами, привязанными к одному магазину, но приложение не установлено на одно или несколько устройств или количество устройств в магазине превышает количество устройств, оплаченных в приложении.
Нет доступа. Ошибка возникает когда у приложения нет разрешения на запрашиваемое действие или пользователь не установил приложение в Личном кабинете.
Запрашиваемый ресурс не найден.
Тип содержимого, которое возвращает ресурс не соответствует типу содержимого, которое указанно в заголовке Accept
.
Превышено максимальное количество запросов в текущем периоде. Работу с ресурсом можно возобновить после окончания времени, указанного в заголовке X-RateLimit-Reset
.
Схему любого документа можно разделить на две части:
body
.
Объект body
содержит данные, уникальные для каждого типа документов.Ниже представлены примеры объекта body
, в зависимости от типа документа.
{
"body": {
"positions": [
{
"product_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"quantity": 123.123,
"initial_quantity": 123.123,
"bar_code": null,
"product_type": "NORMAL",
"mark": null,
"alcohol_by_volume": 123.123,
"alcohol_product_kind_code": 123.123,
"tare_volume": 123.123,
"code": "42",
"product_name": null,
"measure_name": null,
"id": 12,
"uuid": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"extra_keys": [
{
"extra_key": {
"identity": "string",
"app_id": "string",
"description": "string"
}
}
],
"price": 12.12,
"cost_price": 12.12,
"sum": 12.12
}
],
"supplier_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"sum": 2123.12
}
}
Информация о приёмке товаров.
Массив товаров к приёмке.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Закупочная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Единица измерения из карточки товара.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Наименование товара.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР.
Тип товара или модификации товара:
NORMAL
— Обычный;DAIRY_MARKED
— Молоко и молочная продукция;WATER_MARKED
— Маркированная питьевая вода;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;JUICE_MARKED
— Соки и безалкогольные напитки;SHOES_MARKED
— Маркированная обувь;SERVICE
– Услуга;MEDICINE_MARKED
— Маркированные лекарства;TOBACCO_MARKED
— Маркированный табак (сигареты);PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышлености;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;JEWELRY_MARKED
— Маркированные ювелирные изделия;FUR_MARKED
— Маркированные шубы и меховые изделия;BIKE_MARKED
— Маркированные велосипедные товары;MEDICAL_DEVICES_MARKED
— Маркированные медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;LOTTERY_TICKET
— Лотерейный билет;LOTTERY_PRIZE
— Выигрыш в лотерею.Крепость алкогольной продукции. До трёх знаков в дробной части.
Закупочная стоимость единицы товара из документа. До двух знаков в дробной части.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Штрихкод, по которому товар добавили в документ приёмки.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведется на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null
.
Тип марки. Можеть быть null
.
RAW
— марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS
— марка готовая к фискализации: преобразованная в hex
.Закупочная стоимость единицы товара из карточки товара. До двух знаков в дробной части.
Общая стоимость принятых товарных позиций. До двух знаков в дробной части.
Идентификатор поставщика. Кассир выбирает поставщика из выпадающего списка перед сохранением документа.
Основание для приёмки товара.
{
"body": {
"positions": [
{
"product_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"quantity": 123.123,
"initial_quantity": 123.123,
"code": "42",
"id": 12,
"uuid": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"extra_keys": [
{
"extra_key": {
"identity": "string",
"app_id": "string",
"description": "string"
}
}
]
}
],
"complete_inventory": true
}
}
Описание документа инвентаризации.
Массив товарных позиций.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Определяет является инветаризация полной или нет.
true
— полная инвентаризация. Остатки меняются у всех товарных позиций. Неупомянутые товарные позиции приобретают значение 0
.false
— частичная инвентаризация. Остатки меняются только у перечисленных товарныъ позиций.Основание для инвентаризации товаров.
{
"body": {
"base_document_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"base_document_number": 212,
"positions": [
{
"uuid": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"product_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"code": "42",
"price": {
"before": 12.12,
"after": 12.12,
"accept": 12.12
},
"extra_keys": [
{
"extra_key": {
"identity": "string",
"app_id": "string",
"description": "string"
}
}
]
}
]
}
}
Информация о переоценке товаров.
Массив товарных позиций для переоценки.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Данные о ценах товара.
Отпускная цена до переоценки.
Отпускная цена после переоценки.
Цена приёмки.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Идентификатор документа приёмки, на основании которого осуществляется переоценка.
Номер документа, на основании которого осуществляется переоценка.
Основание для переоценки товаров.
{
"body": {
"positions": [
{
"product_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"quantity": 123.123,
"initial_quantity": 123.123,
"bar_code": null,
"product_type": "NORMAL",
"mark": null,
"alcohol_by_volume": 123.123,
"alcohol_product_kind_code": 123.123,
"tare_volume": 123.123,
"code": "42",
"product_name": null,
"measure_name": null,
"id": 12,
"uuid": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"extra_keys": [
{
"extra_key": {
"identity": "string",
"app_id": "string",
"description": "string"
}
}
],
"price": 12.12,
"cost_price": 12.12,
"sum": 12.12
}
],
"supplier_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"sum": 2123.12
}
}
Документ возврата товара поставщику.
Массив товарных позиций для возврата поставщику.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Единица измерения из карточки товара.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Наименование товара.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР.
Тип товара или модификации товара:
NORMAL
— Обычный;DAIRY_MARKED
— Молоко и молочная продукция;WATER_MARKED
— Маркированная питьевая вода;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;JUICE_MARKED
— Соки и безалкогольные напитки;SHOES_MARKED
— Маркированная обувь;SERVICE
– Услуга;MEDICINE_MARKED
— Маркированные лекарства;TOBACCO_MARKED
— Маркированный табак (сигареты);PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышлености;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;JEWELRY_MARKED
— Маркированные ювелирные изделия;FUR_MARKED
— Маркированные шубы и меховые изделия;BIKE_MARKED
— Маркированные велосипедные товары;MEDICAL_DEVICES_MARKED
— Маркированные медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;LOTTERY_TICKET
— Лотерейный билет;LOTTERY_PRIZE
— Выигрыш в лотерею.Крепость алкогольной продукции. До трёх знаков в дробной части.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Штрихкод, по которому товар добавили в документ.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null
.
Тип марки. Можеть быть null
.
RAW
— марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS
— марка готовая к фискализации: преобразованная в hex
.Закупочная стоимость единицы товара. До двух знаков в дробной части.
Общая стоимость товарных позиций, которые будут возвращены поставщику. До двух знаков в дробной части.
ФИО поставщика.
Основание для возврата товаров поставщику.
{
"body": {
"positions": [
{
"product_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"quantity": 123.123,
"initial_quantity": 123.123,
"product_type": "NORMAL",
"alcohol_by_volume": 123.123,
"alcohol_product_kind_code": 123.123,
"tare_volume": 123.123,
"code": "42",
"product_name": null,
"measure_name": null,
"id": 12,
"uuid": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"extra_keys": [
{
"extra_key": {
"identity": "string",
"app_id": "string",
"description": "string"
}
}
],
"price": 12.12,
"cost_price": 12.12,
"sum": 12.12
}
],
"sum": 2123.12
}
}
Документ списания товара.
Массив списанных товарных позиций.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Единица измерения из карточки товара.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Наименование товара.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР.
Тип товара или модификации товара:
NORMAL
— Обычный;DAIRY_MARKED
— Молоко и молочная продукция;WATER_MARKED
— Маркированная питьевая вода;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;JUICE_MARKED
— Соки и безалкогольные напитки;SHOES_MARKED
— Маркированная обувь;SERVICE
– Услуга;MEDICINE_MARKED
— Маркированные лекарства;TOBACCO_MARKED
— Маркированный табак (сигареты);PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышлености;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;JEWELRY_MARKED
— Маркированные ювелирные изделия;FUR_MARKED
— Маркированные шубы и меховые изделия;BIKE_MARKED
— Маркированные велосипедные товары;MEDICAL_DEVICES_MARKED
— Маркированные медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;LOTTERY_TICKET
— Лотерейный билет;LOTTERY_PRIZE
— Выигрыш в лотерею.Крепость алкогольной продукции. До трёх знаков в дробной части.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы.
Номер можно сбросить программно.
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Общая стоимость списанных товарных позиций. До двух знаков в дробной части.
Основание для списания товарных позиций.
{
"body": {
"positions": [
{
"agent_requisites": {
"counterparty_indexes": [
0,
1,
2,
3
],
"operation_description": "Some description"
},
"product_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"attributes_choices": [
{
"attribute_id": "5f4c26b9-3a19-4f6e-bb67-5c71efa712ad",
"attribute_name": "Цвет",
"choice_id": "ec990252-4de7-4a00-9782-f65a8e847d2a",
"choice_value": "Бесцветный"
}
],
"quantity": 123.123,
"initial_quantity": 123.123,
"quantityInPackage": 10,
"product_type": "NORMAL",
"mark": null,
"alcohol_by_volume": 123.123,
"alcohol_product_kind_code": 123.123,
"tare_volume": 123.123,
"settlement_method": {
"amount": 5,
"type": "CHECKOUT_FULL"
},
"code": "42",
"bar_сode": null,
"product_name": null,
"measure_name": null,
"id": 12,
"uuid": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"price": 12.12,
"cost_price": 12.12,
"result_price": 12.12,
"sum": 12.12,
"result_sum": 12.12,
"tax": {
"type": "NO_VAT",
"sum": 0,
"result_sum": 0
},
"doc_distributed_discount": {
"discount_type": "SUM",
"discount_sum": 12.12,
"discount_percent": 12.12345
},
"position_discount": {
"discount_type": "SUM",
"discount_sum": 12.12,
"discount_percent": 12.12345,
"discount_price": 12.12
},
"extra_keys": [
{
"extra_key": {
"identity": "string",
"app_id": "string",
"description": "string"
}
}
],
"print_group_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"splitted_positions": [
{
"splitted_position": {
"quantity": 123.123,
"result_price": 12.12,
"result_sum": 12.12,
"position_discount": 12.12,
"doc_distributed_discount": 12.12,
"tax_type": "NO_VAT",
"result_tax_sum": 12.12
}
}
],
"sub_positions": [
{
"id": 12,
"uuid": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"product_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"product_name": null,
"product_type": "NORMAL",
"measure_name": null,
"initial_quantity": 123.123,
"quantity": 123.123,
"price": 12.12,
"cost_price": 12.12,
"result_price": 12.12,
"sum": 12.12,
"result_sum": 12.12,
"alcohol_by_volume": 123.123,
"alcohol_product_kind_code": 123.123
}
]
}
],
"doc_discounts": [
{
"doc_discount": {
"discount_type": "SUM",
"discount_sum": 12.12,
"discount_percent": 12.12345,
"coupon": "string"
}
}
],
"payments": [
{
"payment": {
"id": "string",
"type": "CASH",
"sum": 12.12,
"app_payment": {
"app_id": "string",
"name": "string"
},
"parts": [
{
"print_group_id": "string",
"part_sum": 12.12,
"change": 12.12
}
]
}
}
],
"print_groups": [
{
"print_group": {
"id": "string",
"type": "CASH_RECEIPT",
"org_name": "string",
"org_inn": "string",
"org_address": "string",
"taxation_system": "COMMON"
}
}
],
"pos_print_results": [
{
"pos_print_result": {
"print_group_id": "string",
"receipt_number": 0,
"document_number": 0,
"session_number": 0,
"check_sum": 0,
"receipt_date": "string",
"fn_serial_number": "string",
"kkt_serial_number": "string",
"kkt_reg_number": "string",
"fiscal_sign_doc_number": "string",
"fiscal_document_number": 0
}
}
],
"sum": 2123.12,
"result_sum": 2123.12,
"customer_email": "ivanov@example.ru",
"customer_phone": 79876543210
}
}
Документ продажи товара.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUM
PERC
Тип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма чека с учётом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWN
CASH
ELECTRON
ADVANCE
CREDIT
COUNTEROFFER
Способ платежа. Возможные значения:
UNKNOWN
– неизвестно (по умолчанию);CASH
– наличными деньгами;ELECTRON
– безналичным расчётом;ADVANCE
– предоплатой (зачётом аванса);CREDIT
– постоплатой (в кредит);COUNTEROFFER
– встречным предоставлением.Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON
.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций.
Сумма скидки на документ, распределенная на товарную позицию.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки, которая была распределена на позицию в момент применения скидки на документ. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Массив разделённых позиций. Используется, когда применение скидок к позициям приводит к дроблению цен с точностью меньше одной копейки.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Сумма НДС на товарную позицию с учетом скидок. До двух знаков в дробной части.
NO_VAT
VAT_10
VAT_18
VAT_0
VAT_18_118
VAT_10_110
Ставка НДС. Возможные значения:
"NO_VAT"
– без НДС;"VAT_0"
– основная ставка 0%;"VAT_10"
– основная ставка 10%;"VAT_10_110"
– расчётная ставка 10%;"VAT_18"
– основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
– расчётная ставка 18%. С первого января 2019 года может содержать 20%.Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Сумма скидки на позицию, применённой в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Код вида алкогольной продукции ФСРАР.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Агентские реквизиты. Присутствует в документе, только если на терминале установлено приложение “Агентская схема”.
Индексы контрагентов из списка в заголовке документа.
Описание операции контрагента.
Сумма акциза, за акцизный товар. Используется при расчётах между юридическими лицами. До двух знаков в дробной части.
Данные об импорте продукции.
Код страны происхождения. Используется при расчётах между юридическими лицами.
Номер таможенной декларации. Используется при расчётах между юридическими лицами.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Штрихкод, по которому товар добавили в чек. Значение отсутствует, если товар добавлен напрямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив, содержащий объекты с описанием характеристик и их значений на момент формирования документа. Присутствует только в случае, если позиция сформирована на основе модификации товара.
Идентификатор характеристики
Название характеристики
Идентификатор значения характеристики
Текст значения характеристики
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Количество товара в упаковке всего.
Информация о расчете НДС на товарную позицию.
Сумма НДС на товарную позицию с учетом скидок.
Сумма НДС на товарную позицию без применения скидок.
NO_VAT
VAT_0
VAT_10
VAT_10_110
VAT_18
VAT_18_118
Ставка НДС. Возможные значения:
"NO_VAT"
– без НДС;"VAT_0"
– основная ставка 0%;"VAT_10"
– основная ставка 10%;"VAT_10_110"
– расчётная ставка 10%;"VAT_18"
– основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
– расчётная ставка 18%. С первого января 2019 года может содержать 20%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённой к конкретной позиции.
Стоимость одной единицы товара в позиции, с учётом примененной скидки на позицию (в момент добавления позиции в документ). Не учитывает скидку на весь документ. До двух знаков в дробной части.
Сумма скидки на позицию, примененной в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку — она пересчитывается в суммовую.
Процент скидки на позицию в момент добавления позиции в документ. До пяти знаков в дробной части.
Идентификатор печатной группы при разделении чека.
Перечень позиций в рамках позиции в чеке.
Например: в состав позиции “Кофе с сиропом” могут входить подпозиции “Кофе Американо, 250 мл” и “Кофейный сироп Мята, 30 мл”.
Как правило, подобная компоновка позиций применяется в категории бизнеса HoReCa.
Подпозиции могут быть добавлены в чек только программно, сторонним приложением на смарт-терминале.
Тип товара или модификации товара:
NORMAL
— Обычный;DAIRY_MARKED
— Молоко и молочная продукция;WATER_MARKED
— Маркированная питьевая вода;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;JUICE_MARKED
— Соки и безалкогольные напитки;SHOES_MARKED
— Маркированная обувь;SERVICE
– Услуга;MEDICINE_MARKED
— Маркированные лекарства;TOBACCO_MARKED
— Маркированный табак (сигареты);PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышлености;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;JEWELRY_MARKED
— Маркированные ювелирные изделия;FUR_MARKED
— Маркированные шубы и меховые изделия;BIKE_MARKED
— Маркированные велосипедные товары;MEDICAL_DEVICES_MARKED
— Маркированные медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;LOTTERY_TICKET
— Лотерейный билет;LOTTERY_PRIZE
— Выигрыш в лотерею.Крепость алкогольной продукции. До трёх знаков в дробной части.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null
.
Тип марки. Можеть быть null
.
RAW
— марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS
— марка готовая к фискализации: преобразованная в hex
.Итоговая сумма с учётом налогов. До двух знаков в дробной части.
Печатные группы. Используется для печати нескольких чеков. Например, в случае с разделённой оплатой.
Адрес организации.
ИНН организации.
Идентификатор печатной группы.
CASH_RECEIPT
INVOICE
STRING_UTII
Способ оплаты.
Наименование организации.
COMMON
SIMPLIFIED_INCOME
SIMPLIFIED_INCOME_OUTCOME
SINGLE_IMPUTED_INCOME
SINGLE_AGRICULTURE
PATENT
Используемая система налогообложения:
COMMON
– общая;SIMPLIFIED_INCOME
– упрощённая (Доход);SIMPLIFIED_INCOME_OUTCOME
– упрощённая (Доход минус Расход);SINGLE_IMPUTED_INCOME
– единый налог на вмененный доход;SINGLE_AGRICULTURE
– единый сельскохозяйственный налог;PATENT
– патентная система налогообложения.Идентификатор места осуществления деятельности. Применяется только для лекарств.
Результаты печати ККТ (массив объектов с фискальными данными). Соответствует зафиксированным в ККТ данным.
Идентификатор печатной группы. Присутствует при разделении чека на печатные группы.
Номер смены в ККТ.
Фискальный номер документа в ККТ из ФН.
Номер чека в ККТ.
Номер документа в ККТ.
Итоговая сумма для печати на документе, с учётом скидок. До двух знаков в дробной части.
Регистрационный номер ККТ.
Дата печати в ККТ на момент печати документа, в формате “DDMMYYYY”.
Серийный номер ККТ.
Номер фискального признака документа.
Заводской номер фискального накопителя.
{
"body": {
"base_document_number": 212,
"base_document_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"doc_discounts": [
{
"doc_discount": {
"discount_type": "SUM",
"discount_sum": 12.12,
"discount_percent": 12.12345,
"coupon": "string"
}
}
],
"payments": [
{
"payment": {
"id": "string",
"type": "CASH",
"sum": 12.12,
"app_payment": {
"app_id": "string",
"name": "string"
},
"parts": [
{
"print_group_id": "string",
"part_sum": 12.12,
"change": 12.12
}
]
}
}
],
"print_groups": [
{
"print_group": {
"id": "string",
"type": "CASH_RECEIPT",
"org_name": "string",
"org_inn": "string",
"org_address": "string",
"taxation_system": "COMMON"
}
}
],
"positions": [
{
"agent_requisites": {
"counterparty_indexes": [
0,
1,
2,
3
],
"operation_description": "Some description"
},
"product_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"parent_id": "1c4ba9e5-27f1-40a6-87a7-dfb08aa0cca8",
"attributes_choices": {
"attribute_id": "5f4c26b9-3a19-4f6e-bb67-5c71efa712ad",
"attribute_name": "Цвет",
"choice_id": "ec990252-4de7-4a00-9782-f65a8e847d2a",
"choice_value": "Бесцветный"
},
"quantity": 123.123,
"initial_quantity": 123.123,
"quantityInPackage": 10,
"product_type": "NORMAL",
"mark": null,
"alcohol_by_volume": 123.123,
"alcohol_product_kind_code": 123.123,
"tare_volume": 123.123,
"settlement_method": {
"amount": 5,
"type": "CHECKOUT_FULL"
},
"code": "42",
"bar_сode": null,
"product_name": null,
"measure_name": null,
"id": 12,
"uuid": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"price": 12.12,
"cost_price": 12.12,
"result_price": 12.12,
"sum": 12.12,
"result_sum": 12.12,
"tax": {
"type": "NO_VAT",
"sum": 0,
"result_sum": 0
},
"doc_distributed_discount": {
"discount_type": "SUM",
"discount_sum": 12.12,
"discount_percent": 12.12345
},
"position_discount": {
"discount_type": "SUM",
"discount_sum": 12.12,
"discount_percent": 12.12345,
"discount_price": 12.12
},
"extra_keys": [
{
"extra_key": {
"identity": "string",
"app_id": "string",
"description": "string"
}
}
],
"print_group_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"splitted_positions": [
{
"splitted_position": {
"quantity": 123.123,
"result_price": 12.12,
"result_sum": 12.12,
"position_discount": 12.12,
"doc_distributed_discount": 12.12,
"tax_type": "NO_VAT",
"result_tax_sum": 12.12
}
}
]
}
],
"pos_print_results": [
{
"pos_print_result": {
"print_group_id": "string",
"receipt_number": 0,
"document_number": 0,
"session_number": 0,
"check_sum": 0,
"receipt_date": "string",
"fn_serial_number": "string",
"kkt_serial_number": "string",
"kkt_reg_number": "string",
"fiscal_sign_doc_number": "string",
"fiscal_document_number": 0
}
}
],
"sum": 2123.12,
"result_sum": 2123.12,
"customer_email": "ivanov@example.ru",
"customer_phone": 79876543210
}
}
Документ возврата.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUM
PERC
Тип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма с учЁтом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWN
CASH
ELECTRON
ADVANCE
CREDIT
COUNTEROFFER
Способ платежа. Возможные значения:
UNKNOWN
– неизвестно (по умолчанию);CASH
– наличными деньгами;ELECTRON
– безналичным расчётом;ADVANCE
– предоплатой (зачётом аванса);CREDIT
– постоплатой (в кредит);COUNTEROFFER
– встречным предоставлением.Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON
.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций.
Сумма скидки на документ, распределенная на товарную позицию.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки, которая была распределена на позицию в момент применения скидки на документ. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Признак способа расчёта согласно ФФД 1.05 и выше.
Сумма первичного взноса.
Поле присутствует только если в качестве способа расчёта используется частичная оплата предмета расчёта в момент его передачи с последующей оплатой в кредит ("type":"CHECKOUT_PARTIAL"
).
PREPAYMENT_FULL
PREPAYMENT_PARTIAL
ADVANCE
CHECKOUT_PARTIAL
CREDIT_PASS
CREDIT_CHECKOUT
Тип признака способа расчёта. Возможные значения:
PREPAYMENT_FULL
– Полная предварительная оплата до момента передачи предмета расчета;PREPAYMENT_PARTIAL
– Частичная предварительная оплата до момента передачи предмета расчета;ADVANCE
– Аванс; CHECKOUT_FULL
– Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчета;CHECKOUT_PARTIAL
– Частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит;CREDIT_PASS
– Передача предмета расчета без его оплаты в момент его передачи с последующей оплатой в кредит;CREDIT_CHECKOUT
– Оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита).Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Массив разделённых позиций. Используется, когда применение скидок к позициям приводит к дроблению цен с точностью меньше одной копейки.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Сумма НДС на товарную позицию с учетом скидок. До двух знаков в дробной части.
NO_VAT
VAT_10
VAT_18
VAT_0
VAT_18_118
VAT_10_110
Ставка НДС. Возможные значения:
"NO_VAT"
– без НДС;"VAT_0"
– основная ставка 0%;"VAT_10"
– основная ставка 10%;"VAT_10_110"
– расчётная ставка 10%;"VAT_18"
– основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
– расчётная ставка 18%. С первого января 2019 года может содержать 20%.Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Сумма скидки на позицию, применённой в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Код вида алкогольной продукции ФСРАР.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Агентские реквизиты. Присутствует в документе, только если на терминале установлено приложение “Агентская схема”.
Индексы контрагентов из списка в заголовке документа.
Описание операции контрагента.
Сумма акциза, за акцизный товар. Используется при расчётах между юридическими лицами. До двух знаков в дробной части.
Данные об импорте продукции.
Код страны происхождения. Используется при расчётах между юридическими лицами.
Номер таможенной декларации. Используется при расчётах между юридическими лицами.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Штрихкод, по которому товар добавили в чек. Значение отсутствует, если товар добавлен напрямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив, содержащий объекты с описанием характеристик и их значений на момент формирования документа. Присутствует только в случае, если позиция сформирована на основе модификации товара.
Идентификатор характеристики
Название характеристики
Идентификатор значения характеристики
Текст значения характеристики
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Количество товара в упаковке всего.
Информация о расчете НДС на товарную позицию.
Сумма НДС на товарную позицию с учетом скидок.
Сумма НДС на товарную позицию без применения скидок.
NO_VAT
VAT_0
VAT_10
VAT_10_110
VAT_18
VAT_18_118
Ставка НДС. Возможные значения:
"NO_VAT"
– без НДС;"VAT_0"
– основная ставка 0%;"VAT_10"
– основная ставка 10%;"VAT_10_110"
– расчётная ставка 10%;"VAT_18"
– основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
– расчётная ставка 18%. С первого января 2019 года может содержать 20%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённая к конкретной позиции.
Скидка на единицу товара с учетом налогов. До двух знаков в дробной части.
Сумма скидки на позицию, применённой при добавлении позиции в документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки - сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки на позицию. До пяти знаков в дробной части.
Идентификатор печатной группы при разбивке чека.
Тип товара или модификации товара:
NORMAL
— Обычный;DAIRY_MARKED
— Молоко и молочная продукция;WATER_MARKED
— Маркированная питьевая вода;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;JUICE_MARKED
— Соки и безалкогольные напитки;SHOES_MARKED
— Маркированная обувь;SERVICE
– Услуга;MEDICINE_MARKED
— Маркированные лекарства;TOBACCO_MARKED
— Маркированный табак (сигареты);PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышлености;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;JEWELRY_MARKED
— Маркированные ювелирные изделия;FUR_MARKED
— Маркированные шубы и меховые изделия;BIKE_MARKED
— Маркированные велосипедные товары;MEDICAL_DEVICES_MARKED
— Маркированные медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;LOTTERY_TICKET
— Лотерейный билет;LOTTERY_PRIZE
— Выигрыш в лотерею.Крепость алкогольной продукции. До трёх знаков в дробной части.
Указатель на родительский элемент позиции в древовидной иерархии номенклатуры.
Родительским элементом может быть группа товаров или группа модификаций.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null
.
Тип марки. Можеть быть null
.
RAW
— марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS
— марка готовая к фискализации: преобразованная в hex
.Перечень позиций в рамках позиции в чеке.
Например: в состав позиции “Кофе с сиропом” могут входить подпозиции “Кофе Американо, 250 мл” и “Кофейный сироп Мята, 30 мл”.
Как правило, подобная компоновка позиций применяется в категории бизнеса HoReCa.
Подпозиции могут быть добавлены в чек только программно, сторонним приложением на смарт-терминале.
Итоговая сумма с учётом налогов. До двух знаков в дробной части.
Печатные группы. Используется для печати нескольких чеков. Например, в случае с разделённой оплатой.
Адрес организации.
ИНН организации.
Идентификатор печатной группы.
CASH_RECEIPT
INVOICE
STRING_UTII
Способ оплаты.
Наименование организации.
COMMON
SIMPLIFIED_INCOME
SIMPLIFIED_INCOME_OUTCOME
SINGLE_IMPUTED_INCOME
SINGLE_AGRICULTURE
PATENT
Используемая система налогообложения:
COMMON
– общая;SIMPLIFIED_INCOME
– упрощённая (Доход);SIMPLIFIED_INCOME_OUTCOME
– упрощённая (Доход минус Расход);SINGLE_IMPUTED_INCOME
– единый налог на вмененный доход;SINGLE_AGRICULTURE
– единый сельскохозяйственный налог;PATENT
– патентная система налогообложения.Идентификатор места осуществления деятельности. Применяется только для лекарств.
Соответствует атрибуту id
документа продажи, на основании которого оформляется возврат (если производится возврат на основе чека). Не имеет значения если возврат производится без чека.
Соответствует атрибуту number
документа продажи, на основании которого оформляется возврат (если производится возврат на основе чека). Не имеет значения если возврат производится без чека.
Результаты печати ККТ (массив объектов с фискальными данными). Соответствует зафиксированным в ККТ данным.
Идентификатор печатной группы. Присутствует при разделении чека на печатные группы.
Номер смены в ККТ.
Фискальный номер документа в ККТ из ФН.
Номер чека в ККТ.
Номер документа в ККТ.
Итоговая сумма для печати на документе, с учётом скидок. До двух знаков в дробной части.
Регистрационный номер ККТ.
Дата печати в ККТ на момент печати документа, в формате “DDMMYYYY”.
Серийный номер ККТ.
Номер фискального признака документа.
Заводской номер фискального накопителя.
{
"body": {
"positions": [
{
"agent_requisites": {
"counterparty_indexes": [
0,
1,
2,
3
],
"operation_description": "Some description"
},
"product_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"parent_id": "1c4ba9e5-27f1-40a6-87a7-dfb08aa0cca8",
"attributes_choices": {
"attribute_id": "5f4c26b9-3a19-4f6e-bb67-5c71efa712ad",
"attribute_name": "Цвет",
"choice_id": "ec990252-4de7-4a00-9782-f65a8e847d2a",
"choice_value": "Бесцветный"
},
"quantity": 123.123,
"initial_quantity": 123.123,
"product_type": "NORMAL",
"mark": null,
"alcohol_by_volume": 123.123,
"alcohol_product_kind_code": 123.123,
"tare_volume": 123.123,
"settlement_method": {
"amount": 5,
"type": "CHECKOUT_FULL"
},
"code": "42",
"bar_сode": null,
"product_name": null,
"measure_name": null,
"id": 12,
"uuid": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"price": 12.12,
"cost_price": 12.12,
"result_price": 12.12,
"sum": 12.12,
"result_sum": 12.12,
"tax": {
"type": "NO_VAT",
"sum": 0,
"result_sum": 0
},
"doc_distributed_discount": {
"discount_type": "SUM",
"discount_sum": 12.12,
"discount_percent": 12.12345
},
"position_discount": {
"discount_type": "SUM",
"discount_sum": 12.12,
"discount_percent": 12.12345,
"discount_price": 12.12
},
"extra_keys": [
{
"extra_key": {
"identity": "string",
"app_id": "string",
"description": "string"
}
}
],
"print_group_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"splitted_positions": [
{
"splitted_position": {
"quantity": 123.123,
"result_price": 12.12,
"result_sum": 12.12,
"position_discount": 12.12,
"doc_distributed_discount": 12.12,
"tax_type": "NO_VAT",
"result_tax_sum": 12.12
}
}
]
}
],
"doc_discounts": [
{
"doc_discount": {
"discount_type": "SUM",
"discount_sum": 12.12,
"discount_percent": 12.12345,
"coupon": "string"
}
}
],
"payments": [
{
"payment": {
"id": "string",
"type": "CASH",
"sum": 12.12,
"app_payment": {
"app_id": "string",
"name": "string"
},
"parts": [
{
"print_group_id": "string",
"part_sum": 12.12,
"change": 12.12
}
]
}
}
],
"print_groups": [
{
"print_group": {
"id": "string",
"type": "CASH_RECEIPT",
"org_name": "string",
"org_inn": "string",
"org_address": "string",
"taxation_system": "COMMON"
}
}
],
"pos_print_results": [
{
"pos_print_result": {
"print_group_id": "string",
"receipt_number": 0,
"document_number": 0,
"session_number": 0,
"check_sum": 0,
"receipt_date": "string",
"fn_serial_number": "string",
"kkt_serial_number": "string",
"kkt_reg_number": "string",
"fiscal_sign_doc_number": "string",
"fiscal_document_number": 0
}
}
],
"sum": 2123.12,
"result_sum": 2123.12,
"customer_email": "ivanov@example.ru",
"customer_phone": 79876543210
}
}
Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUM
PERC
Тип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма с учетом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWN
CASH
ELECTRON
ADVANCE
CREDIT
COUNTEROFFER
Способ платежа. Возможные значения:
UNKNOWN
– неизвестно (по умолчанию);CASH
– наличными деньгами;ELECTRON
– безналичным расчётом;ADVANCE
– предоплатой (зачётом аванса);CREDIT
– постоплатой (в кредит);COUNTEROFFER
– встречным предоставлением.Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON
.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций в документе.
Сумма скидки на документ, распределённая на товарную позицию.
Сумма скидки, которая была распределена на позицию при применении скидки на документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки - сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки, которая была распределена на позицию при применении скидки на документ. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Агентские реквизиты. Присутствует в документе, только если на терминале установлено приложение “Агентская схема”.
Индексы контрагентов из списка в заголовке документа.
Описание операции контрагента.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Штрихкод, по которому товар добавили в чек. Значение отсутствует, если товар добавлен напрямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счет ведется на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив, содержащий объекты с описанием характеристик и их значений на момент формирования документа. Присутствует только в случае, если позиция сформирована на основе модификации товара.
Идентификатор характеристики
Название характеристики
Идентификатор значения характеристики
Текст значения характеристики
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Информация о расчёте НДС на товарную позицию.
Сумма НДС на товарную позицию с учетом скидок.
Сумма НДС на товарную позицию без применения скидок.
NO_VAT
VAT_0
VAT_10
VAT_10_110
VAT_18
VAT_18_118
Ставка НДС. Возможные значения:
"NO_VAT"
— без НДС;"VAT_0"
— основная ставка 0%;"VAT_10"
— основная ставка 10%;"VAT_10_110"
— расчётная ставка 10%;"VAT_18"
— основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
— расчётная ставка 18%. С первого января 2019 года может содержать 20%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённой к конкретной позиции.
Стоимость одной единицы товара в позиции, с учётом скидки на позицию, применённой при добавлении позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
Сумма скидки на позицию, применённой при добавлении позиции в документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки на позицию, при добавлении позиции в документ. До пяти знаков в дробной части.
Идентификатор печатной группы при разбивке чека. Формат – uuid4
, в соответствии с RFC
Тип товара или модификации товара:
NORMAL
— Обычный;DAIRY_MARKED
— Молоко и молочная продукция;WATER_MARKED
— Маркированная питьевая вода;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;JUICE_MARKED
— Соки и безалкогольные напитки;SHOES_MARKED
— Маркированная обувь;SERVICE
– Услуга;MEDICINE_MARKED
— Маркированные лекарства;TOBACCO_MARKED
— Маркированный табак (сигареты);PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышлености;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;JEWELRY_MARKED
— Маркированные ювелирные изделия;FUR_MARKED
— Маркированные шубы и меховые изделия;BIKE_MARKED
— Маркированные велосипедные товары;MEDICAL_DEVICES_MARKED
— Маркированные медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;LOTTERY_TICKET
— Лотерейный билет;LOTTERY_PRIZE
— Выигрыш в лотерею.Крепость алкогольной продукции. До трёх знаков в дробной части.
Указатель на родительский элемент позиции в древовидной иерархии номенклатуры.
Родительским элементом может быть группа товаров или группа модификаций.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null
.
Тип марки. Можеть быть null
.
RAW
— марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS
— марка готовая к фискализации: преобразованная в hex
.Итоговая сумма с учётом налогов. До двух знаков в дробной части.
Печатные группы. Используется для печати нескольких чеков. Например, в случае с разделённой оплатой.
Адрес организации.
ИНН организации.
Идентификатор печатной группы.
CASH_RECEIPT
INVOICE
STRING_UTII
Способ оплаты.
Наименование организации.
COMMON
SIMPLIFIED_INCOME
SIMPLIFIED_INCOME_OUTCOME
SINGLE_IMPUTED_INCOME
SINGLE_AGRICULTURE
PATENT
Используемая система налогообложения:
COMMON
– общая;SIMPLIFIED_INCOME
– упрощённая (Доход);SIMPLIFIED_INCOME_OUTCOME
– упрощённая (Доход минус Расход);SINGLE_IMPUTED_INCOME
– единый налог на вмененный доход;SINGLE_AGRICULTURE
– единый сельскохозяйственный налог;PATENT
– патентная система налогообложения.Идентификатор места осуществления деятельности. Применяется только для лекарств.
Результаты печати ККТ (массив объектов с фискальными данными). Соответствует зафиксированным в ККТ данным.
Идентификатор печатной группы. Присутствует при разделении чека на печатные группы.
Номер смены в ККТ.
Фискальный номер документа в ККТ из ФН.
Номер чека в ККТ.
Номер документа в ККТ.
Итоговая сумма для печати на документе, с учётом скидок. До двух знаков в дробной части.
Регистрационный номер ККТ.
Дата печати в ККТ на момент печати документа, в формате “DDMMYYYY”.
Серийный номер ККТ.
Номер фискального признака документа.
Заводской номер фискального накопителя.
{
"body": {
"base_document_number": 212,
"base_document_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"doc_discounts": [
{
"doc_discount": {
"discount_type": "SUM",
"discount_sum": 12.12,
"discount_percent": 12.12345,
"coupon": "string"
}
}
],
"payments": [
{
"payment": {
"id": "string",
"type": "CASH",
"sum": 12.12,
"app_payment": {
"app_id": "string",
"name": "string"
},
"parts": [
{
"print_group_id": "string",
"part_sum": 12.12,
"change": 12.12
}
]
}
}
],
"print_groups": [
{
"print_group": {
"id": "string",
"type": "CASH_RECEIPT",
"org_name": "string",
"org_inn": "string",
"org_address": "string",
"taxation_system": "COMMON"
}
}
],
"positions": [
{
"agent_requisites": {
"counterparty_indexes": [
0,
1,
2,
3
],
"operation_description": "Some description"
},
"product_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"parent_id": "1c4ba9e5-27f1-40a6-87a7-dfb08aa0cca8",
"attributes_choices": {
"attribute_id": "5f4c26b9-3a19-4f6e-bb67-5c71efa712ad",
"attribute_name": "Цвет",
"choice_id": "ec990252-4de7-4a00-9782-f65a8e847d2a",
"choice_value": "Бесцветный"
},
"quantity": 123.123,
"initial_quantity": 123.123,
"product_type": "NORMAL",
"mark": null,
"alcohol_by_volume": 123.123,
"alcohol_product_kind_code": 123.123,
"tare_volume": 123.123,
"settlement_method": {
"amount": 5,
"type": "CHECKOUT_FULL"
},
"code": "42",
"bar_сode": null,
"product_name": null,
"measure_name": null,
"id": 12,
"uuid": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"price": 12.12,
"cost_price": 12.12,
"result_price": 12.12,
"sum": 12.12,
"result_sum": 12.12,
"tax": {
"type": "NO_VAT",
"sum": 0,
"result_sum": 0
},
"doc_distributed_discount": {
"discount_type": "SUM",
"discount_sum": 12.12,
"discount_percent": 12.12345
},
"position_discount": {
"discount_type": "SUM",
"discount_sum": 12.12,
"discount_percent": 12.12345,
"discount_price": 12.12
},
"extra_keys": [
{
"extra_key": {
"identity": "string",
"app_id": "string",
"description": "string"
}
}
],
"print_group_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"splitted_positions": [
{
"splitted_position": {
"quantity": 123.123,
"result_price": 12.12,
"result_sum": 12.12,
"position_discount": 12.12,
"doc_distributed_discount": 12.12,
"tax_type": "NO_VAT",
"result_tax_sum": 12.12
}
}
]
}
],
"pos_print_results": [
{
"pos_print_result": {
"print_group_id": "string",
"receipt_number": 0,
"document_number": 0,
"session_number": 0,
"check_sum": 0,
"receipt_date": "string",
"fn_serial_number": "string",
"kkt_serial_number": "string",
"kkt_reg_number": "string",
"fiscal_sign_doc_number": "string",
"fiscal_document_number": 0
}
}
],
"sum": 2123.12,
"result_sum": 2123.12,
"customer_email": "ivanov@example.ru",
"customer_phone": 79876543210
}
}
Документ выкупа товара клиентом.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUM
PERC
Тип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма с учётом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWN
CASH
ELECTRON
ADVANCE
CREDIT
COUNTEROFFER
Способ платежа. Возможные значения:
UNKNOWN
– неизвестно (по умолчанию);CASH
– наличными деньгами;ELECTRON
– безналичным расчётом;ADVANCE
– предоплатой (зачётом аванса);CREDIT
– постоплатой (в кредит);COUNTEROFFER
– встречным предоставлением.Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON
.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций.
Скидка на документ, распределённая на товарную позицию
Сумма скидки, которая была распределена на поззицию при применении скидки на документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Обязательно для алкогольных типов товаров.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Перечень позиций в рамках позиции в чеке.
Например: в состав позиции “Кофе с сиропом” могут входить подпозиции “Кофе Американо, 250 мл” и “Кофейный сироп Мята, 30 мл”.
Как правило, подобная компоновка позиций применяется в категории бизнеса HoReCa.
Подпозиции могут быть добавлены в чек только программно, сторонним приложением на смарт-терминале.
Отпускная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР.
Обязательное поле для алкогольных типов товаров.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Агентские реквизиты. Присутствует в документе, только если на терминале установлено приложение “Агентская схема”.
Индексы контрагентов из списка в заголовке документа.
Описание операции контрагента.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Штрихкод, по которому товар добавили в чек. Значение отсутствует, если товар добавлен напрямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив, содержащий объекты с описанием характеристик и их значений на момент формирования документа. Присутствует только в случае, если позиция сформирована на основе модификации товара.
Идентификатор характеристики
Название характеристики
Идентификатор значения характеристики
Текст значения характеристики
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Информация о расчёте НДС на товарную позицию.
Сумма НДС на товарную позицию с учётом скидок. До двух знаков в дробной части.
Сумма НДС на товарную позицию без применения скидок. До двух знаков в дробной части.
NO_VAT
VAT_10
VAT_18
VAT_0
VAT_18_118
VAT_10_110
Ставка НДС. Возможные значения:
"NO_VAT"
– без НДС;"VAT_0"
– основная ставка 0%;"VAT_10"
– основная ставка 10%;"VAT_10_110"
– расчётная ставка 10%;"VAT_18"
– основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
– расчётная ставка 18%. С первого января 2019 года может содержать 20%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённой к конкретной позиции.
Стоимость одной единицы товара в позиции, с учётом применённой скидки на позицию (в момент добавления позиции в документ). Не учитывает скидку на весь документ. До двух знаков в дробной части.
Сумма скидки на позицию, применённной при добавлении позиции в документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки на позицию, при добавлении позиции в документ. До пяти знаков в дробной части.
Идентификатор печатной группы при разбивке чека.
Тип товара или модификации товара:
NORMAL
— Обычный;DAIRY_MARKED
— Молоко и молочная продукция;WATER_MARKED
— Маркированная питьевая вода;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;JUICE_MARKED
— Соки и безалкогольные напитки;SHOES_MARKED
— Маркированная обувь;SERVICE
– Услуга;MEDICINE_MARKED
— Маркированные лекарства;TOBACCO_MARKED
— Маркированный табак (сигареты);PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышлености;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;JEWELRY_MARKED
— Маркированные ювелирные изделия;FUR_MARKED
— Маркированные шубы и меховые изделия;BIKE_MARKED
— Маркированные велосипедные товары;MEDICAL_DEVICES_MARKED
— Маркированные медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;LOTTERY_TICKET
— Лотерейный билет;LOTTERY_PRIZE
— Выигрыш в лотерею.Крепость алкогольной продукции. До трёх знаков в дробной части.
Указатель на родительский элемент позиции в древовидной иерархии номенклатуры.
Родительским элементом может быть группа товаров или группа модификаций.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null
.
Тип марки. Можеть быть null
.
RAW
— марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS
— марка готовая к фискализации: преобразованная в hex
.Итоговая сумма с учётом налогов. До двух знаков в дробной части.
Печатные группы. Используется для печати нескольких чеков. Например, в случае с разделённой оплатой.
Адрес организации.
ИНН организации.
Идентификатор печатной группы.
CASH_RECEIPT
INVOICE
STRING_UTII
Способ оплаты.
Наименование организации.
COMMON
SIMPLIFIED_INCOME
SIMPLIFIED_INCOME_OUTCOME
SINGLE_IMPUTED_INCOME
SINGLE_AGRICULTURE
PATENT
Используемая система налогообложения:
COMMON
– общая;SIMPLIFIED_INCOME
– упрощённая (Доход);SIMPLIFIED_INCOME_OUTCOME
– упрощённая (Доход минус Расход);SINGLE_IMPUTED_INCOME
– единый налог на вмененный доход;SINGLE_AGRICULTURE
– единый сельскохозяйственный налог;PATENT
– патентная система налогообложения.Идентификатор места осуществления деятельности. Применяется только для лекарств.
Соответствует атрибуту id
документа продажи, на основании которого оформляется возврат (если производится возврат на основе чека). Не имеет значения если возврат производится без чека.
Соответствует атрибуту number
документа продажи, на основании которого оформляется возврат (если производится возврат на основе чека). Не имеет значения если возврат производится без чека.
Результаты печати ККТ (массив объектов с фискальными данными). Соответствует зафиксированным в ККТ данным.
Идентификатор печатной группы. Присутствует при разделении чека на печатные группы.
Номер смены в ККТ.
Фискальный номер документа в ККТ из ФН.
Номер чека в ККТ.
Номер документа в ККТ.
Итоговая сумма для печати на документе, с учётом скидок. До двух знаков в дробной части.
Регистрационный номер ККТ.
Дата печати в ККТ на момент печати документа, в формате “DDMMYYYY”.
Серийный номер ККТ.
Номер фискального признака документа.
Заводской номер фискального накопителя.
{
"body": {
"positions": [
{
"product_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"quantity": 123.123,
"initial_quantity": 123.123,
"product_type": "ALCOHOL_MARKED",
"mark": null,
"alcohol_by_volume": 123.123,
"alcohol_product_kind_code": 123.123,
"tare_volume": 123.123,
"code": "42",
"bar_code": null,
"product_name": null,
"measure_name": null,
"id": 12,
"uuid": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"extra_keys": [
{
"extra_key": {
"identity": "string",
"app_id": "string",
"description": "string"
}
}
],
"price": 12.12,
"sum": 12.12
}
]
}
}
Документ вскрытия тары.
Массив алкогольных товаров для вскрытия тары.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Поле обязательно для алкогольных типов товаров.
Отпускная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Единица измерения из карточки товара.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Наименование товара.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР
Поле обязательно для алкогольных типов товаров.
ALCOHOL_MARKED
ALCOHOL_NOT_MARKED
Тип товара:
ALCOHOL_MARKED
— маркированный алкоголь.ALCOHOL_NOT_MARKED
— немаркированный алкоголь.Крепость алкогольной продукции. До трёх знаков в дробной части.
Поле обязательно для немаркированного алкоголя.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Штрихкод, по которому товар добавлен в документ. Поле пустое, если товар выбран на прямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null
.
Тип марки. Можеть быть null
.
RAW
— марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS
— марка готовая к фискализации: преобразованная в hex
.{
"body": {}
}
Пустой объект.
{
"body": {
"revenue": 0,
"total": 0
}
}
Данные о закрытии смены.
Выручка за смену. До двух знаков в дробной части.
Сумма наличных средств в кассе на момент закрытия смены. До двух знаков в дробной части.
{
"body": {
"receipt_number": 0,
"document_number": 0,
"session_number": 0
}
}
Данные об открытии смены в ККТ.
Номер смены в ККТ.
Номер чека в ККТ.
Номер документа в ККТ
{
"body": {
"session_number": 1,
"document_number": 1,
"receipt_number": 1,
"receipt_date": 12122017,
"fn_serial_number": null,
"kkt_serial_number": "string",
"kkt_reg_number": "string",
"fiscal_sign_doc_number": null,
"fiscal_document_number": null,
"sum": null,
"description": null,
"contributor": null
}
}
Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа
Номер смены в ККТ.
Фискальный номер документа в ККТ из ФН.
Номер документа в ККТ.
Номер чека в ККТ.
Имя вносителя средств (“От кого”).
Регистрационный номер ККТ.
Дата в ККТ на момент печати документа. Формат DDMMYYYY
.
Серийный номер ККТ.
Основание для внесения.
Сумма для внесения. До двух знаков в дробной части.
Номер фискального признака документа.
Заводской номер фискального накопителя.
{
"body": {
"session_number": 1,
"document_number": 1,
"receipt_number": 1,
"receipt_date": 12122017,
"fn_serial_number": null,
"kkt_serial_number": "string",
"kkt_reg_number": "string",
"fiscal_sign_doc_number": null,
"fiscal_document_number": null,
"description": null,
"sum": null,
"payment_category_name": "Инкассация",
"payment_category_id": 1,
"receiver": "string"
}
}
Документ выплаты наличных.
Номер смены в ККТ.
Номер документа в ККТ.
Имя получателя средств.
Основание для выплаты.
Сумма для выплаты. До двух знаков в дробной части.
Номер фискального признака документа.
1
2
3
4
5
6
Числовой идентификатор категории платежа:
1
— инкассация;2
— оплата поставщику;3
— оплата услуг;4
— аренда;5
— заработная плата;6
— прочее.Инкассация
Оплата поставщику
Оплата услуг
Аренда
Заработная плата
Прочее
Текстовый идентификатор категории платежа.
Заводской номер фискального накопителя.
Фискальный номер документа в ККТ из ФН.
Номер чека в ККТ.
Регистрационный номер ККТ.
Дата печати в ККТ на момент печати документа. Формат DDMMYYYY
.
Серийный номер ККТ.
{
"body": {
"receipt_number": 0,
"document_number": 0,
"session_number": 0,
"total": 0,
"proceeds": 0,
"cash": 0
}
}
X-отчёт.
Номер смены в ККТ.
Общая сумма продаж за смену на момент формирования отчёта. До двух знаков в дробной части.
Номер чека в ККТ.
Номер документа в ККТ.
Выручка за смену на момент формирования отчёта. До двух знаков в дробной части.
Наличные средства в кассе на момент формирования отчёта. До двух знаков в дробной части.
{
"body": {
"receipt_number": 0,
"document_number": 0,
"session_number": 0,
"receipt_date": 12122017,
"fn_serial_number": null,
"kkt_serial_number": "string",
"kkt_reg_number": "string",
"fiscal_sign_doc_number": null,
"fiscal_document_number": null,
"total": 0,
"proceeds": 0,
"cash": 0,
"cash_in_sum": 12.12,
"cash_out_sum": 12.12,
"cash_in_quantity": 0,
"cash_out_quantity": 0,
"collection": 12.12,
"revenue": 12.12,
"session_sales_results": 12.12,
"session_purchases_results": 12.12,
"nonzero_sum_sales": 12.12,
"nonzero_sum_purchases": 12.12,
"quantity_sales": {
"quantity": 0,
"reversal": 0,
"back": 0,
"reversal_back": 0
},
"quantity_purchases": {
"quantity": 0,
"reversal": 0,
"back": 0,
"reversal_back": 0
},
"sales": {
"summ": 0,
"reversal": 0,
"sections": [
{
"number": 0,
"name": "ТАРОЙ",
"value": 0
}
]
},
"sales_back": {
"summ": 0,
"reversal": 0,
"sections": [
{
"number": 0,
"name": "ТАРОЙ",
"value": 0
}
]
},
"purchases": {
"summ": 0,
"reversal": 0,
"sections": [
{
"number": 0,
"name": "ТАРОЙ",
"value": 0
}
]
},
"purchases_back": {
"summ": 0,
"reversal": 0,
"sections": [
{
"number": 0,
"name": "ТАРОЙ",
"value": 0
}
]
}
}
}
Z-отчёт.
Количество операций выплаты.
Информация о продажах (sales
), возвратах продаж (sales_back
), покупках (purchases
) или возвратах покупок (purchases_back
) в разрезе способов оплаты доступных на ККТ.
Сумма обратной операции. До двух знаков в дробной части.
Сумма операции. До двух знаков в дробной части.
Секции оплаты
Номер секции ККТ.
ТАРОЙ
ПЛАТ.КАРТОЙ
КРЕДИТОМ
НАЛИЧНЫМИ
ТИП 5
ТИП 6
ТИП 7
ТИП 8
ТИП 9
ТИП 10
Наименование секции ККТ.
Сумма оплаты по данной секции. До двух знаков в дробной части.
Фискальный номер документа в ККТ из ФН.
Общая сумма продаж за смену. До двух знаков в дробной части.
Доход за смену. До двух знаков в дробной части.
Выручка за смену. До двух знаков в дробной части.
Серийный номер ККТ.
Информация о продажах (sales
), возвратах продаж (sales_back
), покупках (purchases
) или возвратах покупок (purchases_back
) в разрезе способов оплаты доступных на ККТ.
Сумма обратной операции. До двух знаков в дробной части.
Сумма операции. До двух знаков в дробной части.
Секции оплаты
Номер секции ККТ.
ТАРОЙ
ПЛАТ.КАРТОЙ
КРЕДИТОМ
НАЛИЧНЫМИ
ТИП 5
ТИП 6
ТИП 7
ТИП 8
ТИП 9
ТИП 10
Наименование секции ККТ.
Сумма оплаты по данной секции. До двух знаков в дробной части.
Наличные средства в кассе. До двух знаков в дробной части.
Номер смены в ККТ.
Номер документа в ККТ.
Необнуляемая сумма покупок. До двух знаков в дробной части.
Информация о продажах (sales
), возвратах продаж (sales_back
), покупках (purchases
) или возвратах покупок (purchases_back
) в разрезе способов оплаты доступных на ККТ.
Сумма обратной операции. До двух знаков в дробной части.
Сумма операции. До двух знаков в дробной части.
Секции оплаты
Номер секции ККТ.
ТАРОЙ
ПЛАТ.КАРТОЙ
КРЕДИТОМ
НАЛИЧНЫМИ
ТИП 5
ТИП 6
ТИП 7
ТИП 8
ТИП 9
ТИП 10
Наименование секции ККТ.
Сумма оплаты по данной секции. До двух знаков в дробной части.
Сменный итог по продажам. До двух знаков в дробной части.
Количество операций внесения.
Сумма внесений за смену. До двух знаков в дробной части.
Информация о продажах (sales
), возвратах продаж (sales_back
), покупках (purchases
) или возвратах покупок (purchases_back
) в разрезе способов оплаты доступных на ККТ.
Сумма обратной операции. До двух знаков в дробной части.
Сумма операции. До двух знаков в дробной части.
Секции оплаты
Номер секции ККТ.
ТАРОЙ
ПЛАТ.КАРТОЙ
КРЕДИТОМ
НАЛИЧНЫМИ
ТИП 5
ТИП 6
ТИП 7
ТИП 8
ТИП 9
ТИП 10
Наименование секции ККТ.
Сумма оплаты по данной секции. До двух знаков в дробной части.
Номер фискального признака документа.
Сумма к инкассации. До двух знаков в дробной части.
Заводской номер фискального накопителя.
Сумма выплат за смену. До двух знаков в дробной части.
Номер чека в ККТ.
Регистрационный номер ККТ.
Необнуляемая сумма продаж. До двух знаков в дробной части.
Число операций продаж (sales
) или покупок (purchases
), в зависимости от названия объекта. Содержит информацию блока Продажи или Покупки на чеке Z-отчёта, соответственно.
Количество прямых операций.
Количество операций.
Количество обратных операций.
Количество отмен обратных операций
Дата в ККТ на момент печати документа. Формат DDMMYYYY
.
Сменный итог покупок. До двух знаков в дробной части.
Число операций продаж (sales
) или покупок (purchases
), в зависимости от названия объекта. Содержит информацию блока Продажи или Покупки на чеке Z-отчёта, соответственно.
Количество прямых операций.
Количество операций.
Количество обратных операций.
Количество отмен обратных операций
{
"body": {
"positions": [
{
"product_id": "KO0_hns2dN",
"quantity": 1,
"product_type": "MEDICINE_MARKED",
"mark": "",
"product_name": "неподдельный франко-вагон",
"measure_name": "обрастание",
"id": 1,
"uuid": "761fff9f-62c8-4f0a-995e-e3ab42179209",
"extra_keys": [],
"sub_positions": [],
"measure_precision": 3,
"price": 27.37,
"cost_price": 7490.09,
"result_price": 100,
"sum": 100,
"tax": {
"type": "VAT_10",
"sum": 10,
"result_sum": 10
},
"result_sum": 100,
"position_discount": {
"discount_sum": 0,
"discount_percent": 0,
"discount_type": "SUM",
"discount_price": 0
},
"doc_distributed_discount": {
"discount_sum": 0,
"discount_percent": 0,
"discount_type": "SUM",
"discount_price": 0
},
"print_group_id": "6b9f7929-cd35-4c19-880a-b049094ad7d1",
"attributes_choices": [
{
"attribute_id": "e9f68ad9-445b-44f1-ba40-640cd768aa8d",
"attribute_name": "тестИмяАтрибута CбФMэ",
"choice_id": "cd791517-38d5-42a6-a148-d26ebe548cd2",
"choice_value": "тестChoiseName ЪЙбмЖ"
}
],
"settlement_method": {
"type": "CREDIT_CHECKOUT"
}
}
],
"doc_discounts": [
{
"discount_sum": 1,
"discount_percent": 1,
"discount_type": "SUM"
}
],
"payments": [
{
"id": "4ba6ac50-75d5-41f8-89fb-1380bf35f121",
"sum": 100,
"type": "CASH",
"rrn": "",
"parts": [
{
"print_group_id": "aeddf187-728a-4179-a497-f30e3deec36c",
"part_sum": 50,
"change": 0.5
},
{
"print_group_id": "93b4611c-dae1-4640-a00f-cf65fdf52846",
"part_sum": 69.5,
"change": 20
}
],
"merchant_info": {
"number": "ТЕСТ metchantInfo.number zC jf",
"english_name": "ТЕСТ metchantInfo.englishName цеABЕ",
"category_code": "ТЕСТ metchantInfo.categoryCode сТ rр"
},
"bank_info": {
"name": "ТЕСТ информация о банке DYпcРa1E0й"
},
"app_info": {
"name": "ТЕСТ Имя приложения gЯTиW9FPЬЗ"
}
}
],
"print_groups": [
{
"id": "f9fe6ae6-2850-4da5-8286-6f996aeb128c",
"type": "CASH_RECEIPT",
"org_name": "orgName",
"org_inn": "orgInn",
"org_address": "orgAdress",
"taxation_system": "COMMON"
}
],
"pos_print_results": [
{
"receipt_number": 63732,
"document_number": 63733,
"session_number": 32110,
"receipt_date": "07112022",
"fiscal_sign_doc_number": "13733",
"fiscal_document_number": 52297,
"fn_serial_number": "000000000015275",
"kkt_serial_number": "00000000018958",
"kkt_reg_number": "0000000000057329",
"print_group_id": "f9fe6ae6-2850-4da5-8286-6f996aeb128c",
"check_sum": 6628.75
}
],
"payment_source": "ELECTRON",
"document_timestamp": 1667828418912,
"document_number": "35172",
"reason": "Случайная причина коррекции",
"type": "INDEPENDENT",
"target": "SELL",
"sum": 100,
"result_sum": 99,
"taxation_system": "SINGLE_IMPUTED_INCOME",
"payment_type": "ELECTRON",
"tax_type": "VAT_18",
"settlement_type": "CORRECTION_INCOME"
}
}
Документ коррекции.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUM
PERC
Тип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма с учётом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWN
CASH
ELECTRON
ADVANCE
CREDIT
COUNTEROFFER
Способ платежа. Возможные значения:
UNKNOWN
– неизвестно (по умолчанию);CASH
– наличными деньгами;ELECTRON
– безналичным расчётом;ADVANCE
– предоплатой (зачётом аванса);CREDIT
– постоплатой (в кредит);COUNTEROFFER
– встречным предоставлением.Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON
.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций.
Сумма скидки на документ, распределенная на товарную позицию.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки, которая была распределена на позицию в момент применения скидки на документ. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Массив разделённых позиций. Используется, когда применение скидок к позициям приводит к дроблению цен с точностью меньше одной копейки.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Сумма НДС на товарную позицию с учетом скидок. До двух знаков в дробной части.
NO_VAT
VAT_10
VAT_18
VAT_0
VAT_18_118
VAT_10_110
Ставка НДС. Возможные значения:
"NO_VAT"
– без НДС;"VAT_0"
– основная ставка 0%;"VAT_10"
– основная ставка 10%;"VAT_10_110"
– расчётная ставка 10%;"VAT_18"
– основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
– расчётная ставка 18%. С первого января 2019 года может содержать 20%.Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Сумма скидки на позицию, применённой в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity
). До двух знаков в дробной части.
Массив объектов, соответствующих дополнительным полям (extras
) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null
.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Код вида алкогольной продукции ФСРАР.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Агентские реквизиты. Присутствует в документе, только если на терминале установлено приложение “Агентская схема”.
Индексы контрагентов из списка в заголовке документа.
Описание операции контрагента.
Сумма акциза, за акцизный товар. Используется при расчётах между юридическими лицами. До двух знаков в дробной части.
Данные об импорте продукции.
Код страны происхождения. Используется при расчётах между юридическими лицами.
Номер таможенной декларации. Используется при расчётах между юридическими лицами.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL
, PAYBACK
, BUY
и BUYBACK
поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_
.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4
, соответствующий RFC.
Штрихкод, по которому товар добавили в чек. Значение отсутствует, если товар добавлен напрямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив, содержащий объекты с описанием характеристик и их значений на момент формирования документа. Присутствует только в случае, если позиция сформирована на основе модификации товара.
Идентификатор характеристики
Название характеристики
Идентификатор значения характеристики
Текст значения характеристики
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Количество товара в упаковке всего.
Информация о расчете НДС на товарную позицию.
Сумма НДС на товарную позицию с учетом скидок.
Сумма НДС на товарную позицию без применения скидок.
NO_VAT
VAT_0
VAT_10
VAT_10_110
VAT_18
VAT_18_118
Ставка НДС. Возможные значения:
"NO_VAT"
– без НДС;"VAT_0"
– основная ставка 0%;"VAT_10"
– основная ставка 10%;"VAT_10_110"
– расчётная ставка 10%;"VAT_18"
– основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
– расчётная ставка 18%. С первого января 2019 года может содержать 20%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённой к конкретной позиции.
Стоимость одной единицы товара в позиции, с учётом примененной скидки на позицию (в момент добавления позиции в документ). Не учитывает скидку на весь документ. До двух знаков в дробной части.
Сумма скидки на позицию, примененной в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
SUM
PERC
Тип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку — она пересчитывается в суммовую.
Процент скидки на позицию в момент добавления позиции в документ. До пяти знаков в дробной части.
Идентификатор печатной группы при разделении чека.
Перечень позиций в рамках позиции в чеке.
Например: в состав позиции “Кофе с сиропом” могут входить подпозиции “Кофе Американо, 250 мл” и “Кофейный сироп Мята, 30 мл”.
Как правило, подобная компоновка позиций применяется в категории бизнеса HoReCa.
Подпозиции могут быть добавлены в чек только программно, сторонним приложением на смарт-терминале.
Тип товара или модификации товара:
NORMAL
— Обычный;DAIRY_MARKED
— Молоко и молочная продукция;WATER_MARKED
— Маркированная питьевая вода;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;JUICE_MARKED
— Соки и безалкогольные напитки;SHOES_MARKED
— Маркированная обувь;SERVICE
– Услуга;MEDICINE_MARKED
— Маркированные лекарства;TOBACCO_MARKED
— Маркированный табак (сигареты);PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышлености;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;JEWELRY_MARKED
— Маркированные ювелирные изделия;FUR_MARKED
— Маркированные шубы и меховые изделия;BIKE_MARKED
— Маркированные велосипедные товары;MEDICAL_DEVICES_MARKED
— Маркированные медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;LOTTERY_TICKET
— Лотерейный билет;LOTTERY_PRIZE
— Выигрыш в лотерею.Крепость алкогольной продукции. До трёх знаков в дробной части.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null
.
Тип марки. Можеть быть null
.
RAW
— марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS
— марка готовая к фискализации: преобразованная в hex
.Печатные группы. Используется для печати нескольких чеков. Например, в случае с разделённой оплатой.
Адрес организации.
ИНН организации.
Идентификатор печатной группы.
CASH_RECEIPT
INVOICE
STRING_UTII
Способ оплаты.
Наименование организации.
COMMON
SIMPLIFIED_INCOME
SIMPLIFIED_INCOME_OUTCOME
SINGLE_IMPUTED_INCOME
SINGLE_AGRICULTURE
PATENT
Используемая система налогообложения:
COMMON
– общая;SIMPLIFIED_INCOME
– упрощённая (Доход);SIMPLIFIED_INCOME_OUTCOME
– упрощённая (Доход минус Расход);SINGLE_IMPUTED_INCOME
– единый налог на вмененный доход;SINGLE_AGRICULTURE
– единый сельскохозяйственный налог;PATENT
– патентная система налогообложения.Идентификатор места осуществления деятельности. Применяется только для лекарств.
Результаты печати ККТ (массив объектов с фискальными данными). Соответствует зафиксированным в ККТ данным.
Идентификатор печатной группы. Присутствует при разделении чека на печатные группы.
Номер смены в ККТ.
Фискальный номер документа в ККТ из ФН.
Номер чека в ККТ.
Номер документа в ККТ.
Итоговая сумма для печати на документе, с учётом скидок. До двух знаков в дробной части.
Регистрационный номер ККТ.
Дата печати в ККТ на момент печати документа, в формате “DDMMYYYY”.
Серийный номер ККТ.
Номер фискального признака документа.
Заводской номер фискального накопителя.
— ELECTRON — CASH
Тип принятой оплаты:
ELECTRON
– безналичная оплата;CASH
– оплата наличными.Дата коррекции.
Номер документа
Причина коррекции.
— INDEPENDENT — REQUIREMENT
Тип поррекции:
INDEPENDENT
- самостоятельная;REQUIREMENT
- по требованию.— SELL — BUY — RETURN
Тип операции, по которой происходит коррекция.
Сумма возврата.
COMMON
SIMPLIFIED_INCOME
SIMPLIFIED_INCOME_OUTCOME
SINGLE_IMPUTED_INCOME
SINGLE_AGRICULTURE
PATENT
Используемая система налогообложения:
COMMON
– общая;SIMPLIFIED_INCOME
– упрощённая (Доход);SIMPLIFIED_INCOME_OUTCOME
– упрощённая (Доход минус Расход);SINGLE_IMPUTED_INCOME
– единый налог на вмененный доход;SINGLE_AGRICULTURE
– единый сельскохозяйственный налог;PATENT
– патентная система налогообложения.— CASH — ELECTRON
Способ возврата средств клиенту:
ELECTRON
– безналичный расчёт;CASH
— наличный расчёт.NO_VAT
VAT_10
VAT_18
VAT_0
VAT_18_118
VAT_10_110
Ставка НДС. Возможные значения:
"NO_VAT"
– без НДС;"VAT_0"
– основная ставка 0%;"VAT_10"
– основная ставка 10%;"VAT_10_110"
– расчётная ставка 10%;"VAT_18"
– основная ставка 18%. С первого января 2019 года может содержать 20%"VAT_18_118"
– расчётная ставка 18%. С первого января 2019 года может содержать 20%.— CORRECTION_INCOME — CORRECTION_OUTCOME — CORRECTION_RETURN_INCOME — CORRECTION_RETURN_OUTCOME
Тип коррекции:
CORRECTION_INCOME
— входящая коррекция;CORRECTION_OUTCOME
— исходящая коррекция;CORRECTION_RETURN_INCOME
— входящая коррекция возврата;CORRECTION_RETURN_OUTCOME
— исходящая коррекция возврата.