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
Передаёт в сторонний сервис массив документов с транзакциями.
Ожидает от стороннего сервиса ответа 200 ОК
. Если ответ не приходит в течение 10 секунд, Облако отправляет уведомление повторно. Важно: Сервис не гаратнирует успешную доставку документов.
Идентификатор магазина в Облаке Эвотор, в рамках которого действует запрос.
Токен пользователя приложения стороннего сервиса для авторизации вебхуков Облака Эвотор в стороннем сервисе.
Параметры отсутствуют.
{
"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": {}
}
OK
Ошибка в запросе
Неверный токен
Требуется оплата
Отсутствует указанный ресурс
Терминал неактивен
Схему любого документа можно разделить на две части:
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” и если оплата производилась через встроенный или подключеный к Эвотору банковский терминал.
Идентификатор драйвера в EvotorMarket, через который производился платеж безналичными средствами.
Наименование драйвера
Расширенная информация о платеже. Присутствует в случае типа оплаты “ELECTRON” и если разработчик драйвера или приложения для оплаты поддержал передачу этого поля. Примеры чеков с заполняемой в cashless_info информацией приведены в статье: https://developer.evotor.ru/docs/doc_java_extended_api_data.html.
Способ безналичной оплаты. Возможные значения:
QR
- Оплата по QR коду, внутри своей банковской системы (Например: SberPay).BIOMETRY
- Оплата по биометрии (Например: оплата Улыбкой).CARD
- Обычная оплата картой.INTERNET_ACQUIRING
- Приложение для оплаты через интернет эквайринг.BANK_TRANSFER
- Банковский перевод на счёт.UNKNOWN
- Неизвестно.Расширенное описание способа безналичной оплаты. Например: SberPay, MtsPay, AliPay.
Уникальный uuid способа безналичной оплаты.
Объект с информацией для электронных платежей, в случае типа оплаты 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” и если оплата производилась через встроенный или подключеный к Эвотору банковский терминал.
Идентификатор драйвера в EvotorMarket, через который производился платеж безналичными средствами.
Наименование драйвера
Расширенная информация о платеже. Присутствует в случае типа оплаты “ELECTRON” и если разработчик драйвера или приложения для оплаты поддержал передачу этого поля. Примеры чеков с заполняемой в cashless_info информацией приведены в статье: https://developer.evotor.ru/docs/doc_java_extended_api_data.html.
Способ безналичной оплаты. Возможные значения:
QR
- Оплата по QR коду, внутри своей банковской системы (Например: SberPay).BIOMETRY
- Оплата по биометрии (Например: оплата Улыбкой).CARD
- Обычная оплата картой.INTERNET_ACQUIRING
- Приложение для оплаты через интернет эквайринг.BANK_TRANSFER
- Банковский перевод на счёт.UNKNOWN
- Неизвестно.Расширенное описание способа безналичной оплаты. Например: SberPay, MtsPay, AliPay.
Уникальный uuid способа безналичной оплаты.
Объект с информацией для электронных платежей, в случае типа оплаты 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” и если оплата производилась через встроенный или подключеный к Эвотору банковский терминал.
Идентификатор драйвера в EvotorMarket, через который производился платеж безналичными средствами.
Наименование драйвера
Расширенная информация о платеже. Присутствует в случае типа оплаты “ELECTRON” и если разработчик драйвера или приложения для оплаты поддержал передачу этого поля. Примеры чеков с заполняемой в cashless_info информацией приведены в статье: https://developer.evotor.ru/docs/doc_java_extended_api_data.html.
Способ безналичной оплаты. Возможные значения:
QR
- Оплата по QR коду, внутри своей банковской системы (Например: SberPay).BIOMETRY
- Оплата по биометрии (Например: оплата Улыбкой).CARD
- Обычная оплата картой.INTERNET_ACQUIRING
- Приложение для оплаты через интернет эквайринг.BANK_TRANSFER
- Банковский перевод на счёт.UNKNOWN
- Неизвестно.Расширенное описание способа безналичной оплаты. Например: SberPay, MtsPay, AliPay.
Уникальный uuid способа безналичной оплаты.
Объект с информацией для электронных платежей, в случае типа оплаты 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” и если оплата производилась через встроенный или подключеный к Эвотору банковский терминал.
Идентификатор драйвера в EvotorMarket, через который производился платеж безналичными средствами.
Наименование драйвера
Расширенная информация о платеже. Присутствует в случае типа оплаты “ELECTRON” и если разработчик драйвера или приложения для оплаты поддержал передачу этого поля. Примеры чеков с заполняемой в cashless_info информацией приведены в статье: https://developer.evotor.ru/docs/doc_java_extended_api_data.html.
Способ безналичной оплаты. Возможные значения:
QR
- Оплата по QR коду, внутри своей банковской системы (Например: SberPay).BIOMETRY
- Оплата по биометрии (Например: оплата Улыбкой).CARD
- Обычная оплата картой.INTERNET_ACQUIRING
- Приложение для оплаты через интернет эквайринг.BANK_TRANSFER
- Банковский перевод на счёт.UNKNOWN
- Неизвестно.Расширенное описание способа безналичной оплаты. Например: SberPay, MtsPay, AliPay.
Уникальный uuid способа безналичной оплаты.
Объект с информацией для электронных платежей, в случае типа оплаты 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
Наименование секции ККТ.
Сумма оплаты по данной секции. До двух знаков в дробной части.