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}
Возвращает документ с указанным идентификатором.
Идентификатор магазина в Облаке Эвотор
Идентификатор документа в Облаке Эвотор.
Параметры отсутствуют.
{
"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": {}
}
OPEN_SESSIONPOS_OPEN_SESSIONCLOSE_SESSIONCASH_INCOMECASH_OUTCOMEINVENTORYACCEPTREVALUATIONWRITE_OFFRETURNOPEN_TARESELLPAYBACKBUYBUYBACKX_REPORTZ_REPORTCORRECTIONТип документа:
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Версия схемы документа.
Массив контрагентов.
Массив присутствует в документе, только если на смарт-терминале установлено приложение “Агентская схема”.
Список адресов контрагента.
Полное наименование контрагента.
Порядковый номер в списке (индекс).
ИНН контрагента.
Идентификатор контрагента, который задаёт приложение.
КПП контрагента.
Список номеров телефонов контрагента.
AGENTSUBAGENTPRINCIPALTRANSACTION_OPERATORРоль контрагента. Возможные значения:
AGENT – агент;SUBAGENT – субагент;PRINCIPAL – принципал;TRANSACTION_OPERATOR – оператор перевода.Свойства, присущие данной роли. Объект присутствует только у контрагентов с ролью AGENT или SUBAGENT.
AGENTCOMMISSIONERATTORNEY_IN_FACTPAYMENT_AGENTBANK_PAYMENT_AGENTТип агента. Поле присутствует в объекте, только у контрагентов с ролью AGENT. Возможные значения:
AGENT – агент;COMMISSIONER – комиссионер;ATTORNEY_IN_FACT – поверенный;PAYMENT_AGENT – платёжный агент;BANK_PAYMENT_AGENT – банковский платёжный агент.PAYMENT_SUBAGENTBANK_PAYMENT_SUBAGENTТип субагента. Поле присутствует в объекте, только у контрагентов с ролью SUBAGENT. Возможные значения:
PAYMENT_SUBAGENT – платёжный субагент;BANK_PAYMENT_SUBAGENT – банковский платёжный субагент.Краткое наименование контрагента.
LEGAL_ENTITYINDIVIDUAL_ENTREPRENEURGOVERNMENT_AGENCYТип контрагента:
LEGAL_ENTITY — юридическое лицо;INDIVIDUAL_ENTREPRENEUR — индивидуальный предприниматель;GOVERNMENT_AGENCY — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Успешно
Ошибка авторизации приложения.
Облако передаёт ошибку с кодом 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
}
}
Документ продажи товара.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUMPERCТип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма чека с учётом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWNCASHELECTRONADVANCECREDITCOUNTEROFFERСпособ платежа. Возможные значения:
UNKNOWN – неизвестно (по умолчанию);CASH – наличными деньгами;ELECTRON – безналичным расчётом;ADVANCE – предоплатой (зачётом аванса);CREDIT – постоплатой (в кредит);COUNTEROFFER – встречным предоставлением.Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций.
Сумма скидки на документ, распределенная на товарную позицию.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
SUMPERCТип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки, которая была распределена на позицию в момент применения скидки на документ. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Массив разделённых позиций. Используется, когда применение скидок к позициям приводит к дроблению цен с точностью меньше одной копейки.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Сумма НДС на товарную позицию с учетом скидок. До двух знаков в дробной части.
NO_VATVAT_10VAT_18VAT_0VAT_18_118VAT_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_VATVAT_0VAT_10VAT_10_110VAT_18VAT_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%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённой к конкретной позиции.
Стоимость одной единицы товара в позиции, с учётом примененной скидки на позицию (в момент добавления позиции в документ). Не учитывает скидку на весь документ. До двух знаков в дробной части.
Сумма скидки на позицию, примененной в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
SUMPERCТип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку — она пересчитывается в суммовую.
Процент скидки на позицию в момент добавления позиции в документ. До пяти знаков в дробной части.
Идентификатор печатной группы при разделении чека.
Перечень позиций в рамках позиции в чеке.
Например: в состав позиции “Кофе с сиропом” могут входить подпозиции “Кофе Американо, 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_RECEIPTINVOICESTRING_UTIIСпособ оплаты.
Наименование организации.
COMMONSIMPLIFIED_INCOMESIMPLIFIED_INCOME_OUTCOMESINGLE_IMPUTED_INCOMESINGLE_AGRICULTUREPATENTИспользуемая система налогообложения:
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
}
}
Документ возврата.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUMPERCТип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма с учЁтом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWNCASHELECTRONADVANCECREDITCOUNTEROFFERСпособ платежа. Возможные значения:
UNKNOWN – неизвестно (по умолчанию);CASH – наличными деньгами;ELECTRON – безналичным расчётом;ADVANCE – предоплатой (зачётом аванса);CREDIT – постоплатой (в кредит);COUNTEROFFER – встречным предоставлением.Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций.
Сумма скидки на документ, распределенная на товарную позицию.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
SUMPERCТип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки, которая была распределена на позицию в момент применения скидки на документ. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Признак способа расчёта согласно ФФД 1.05 и выше.
Сумма первичного взноса.
Поле присутствует только если в качестве способа расчёта используется частичная оплата предмета расчёта в момент его передачи с последующей оплатой в кредит ("type":"CHECKOUT_PARTIAL").
PREPAYMENT_FULLPREPAYMENT_PARTIALADVANCECHECKOUT_PARTIALCREDIT_PASSCREDIT_CHECKOUTТип признака способа расчёта. Возможные значения:
PREPAYMENT_FULL – Полная предварительная оплата до момента передачи предмета расчета;PREPAYMENT_PARTIAL – Частичная предварительная оплата до момента передачи предмета расчета;ADVANCE – Аванс; CHECKOUT_FULL – Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчета;CHECKOUT_PARTIAL – Частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит;CREDIT_PASS – Передача предмета расчета без его оплаты в момент его передачи с последующей оплатой в кредит;CREDIT_CHECKOUT – Оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита).Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Массив разделённых позиций. Используется, когда применение скидок к позициям приводит к дроблению цен с точностью меньше одной копейки.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Сумма НДС на товарную позицию с учетом скидок. До двух знаков в дробной части.
NO_VATVAT_10VAT_18VAT_0VAT_18_118VAT_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_VATVAT_0VAT_10VAT_10_110VAT_18VAT_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%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённая к конкретной позиции.
Скидка на единицу товара с учетом налогов. До двух знаков в дробной части.
Сумма скидки на позицию, применённой при добавлении позиции в документ. До двух знаков в дробной части.
SUMPERCТип скидки - сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки на позицию. До пяти знаков в дробной части.
Идентификатор печатной группы при разбивке чека.
Тип товара или модификации товара:
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_RECEIPTINVOICESTRING_UTIIСпособ оплаты.
Наименование организации.
COMMONSIMPLIFIED_INCOMESIMPLIFIED_INCOME_OUTCOMESINGLE_IMPUTED_INCOMESINGLE_AGRICULTUREPATENTИспользуемая система налогообложения:
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
}
}Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUMPERCТип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма с учетом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWNCASHELECTRONADVANCECREDITCOUNTEROFFERСпособ платежа. Возможные значения:
UNKNOWN – неизвестно (по умолчанию);CASH – наличными деньгами;ELECTRON – безналичным расчётом;ADVANCE – предоплатой (зачётом аванса);CREDIT – постоплатой (в кредит);COUNTEROFFER – встречным предоставлением.Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций в документе.
Сумма скидки на документ, распределённая на товарную позицию.
Сумма скидки, которая была распределена на позицию при применении скидки на документ. До двух знаков в дробной части.
SUMPERCТип скидки - сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки, которая была распределена на позицию при применении скидки на документ. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity). До двух знаков в дробной части.
Массив объектов, соответствующих дополнительным полям (extras) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Агентские реквизиты. Присутствует в документе, только если на терминале установлено приложение “Агентская схема”.
Индексы контрагентов из списка в заголовке документа.
Описание операции контрагента.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4, соответствующий RFC.
Штрихкод, по которому товар добавили в чек. Значение отсутствует, если товар добавлен напрямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счет ведется на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив, содержащий объекты с описанием характеристик и их значений на момент формирования документа. Присутствует только в случае, если позиция сформирована на основе модификации товара.
Идентификатор характеристики
Название характеристики
Идентификатор значения характеристики
Текст значения характеристики
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Информация о расчёте НДС на товарную позицию.
Сумма НДС на товарную позицию с учетом скидок.
Сумма НДС на товарную позицию без применения скидок.
NO_VATVAT_0VAT_10VAT_10_110VAT_18VAT_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%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённой к конкретной позиции.
Стоимость одной единицы товара в позиции, с учётом скидки на позицию, применённой при добавлении позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
Сумма скидки на позицию, применённой при добавлении позиции в документ. До двух знаков в дробной части.
SUMPERCТип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки на позицию, при добавлении позиции в документ. До пяти знаков в дробной части.
Идентификатор печатной группы при разбивке чека. Формат – 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_RECEIPTINVOICESTRING_UTIIСпособ оплаты.
Наименование организации.
COMMONSIMPLIFIED_INCOMESIMPLIFIED_INCOME_OUTCOMESINGLE_IMPUTED_INCOMESINGLE_AGRICULTUREPATENTИспользуемая система налогообложения:
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
}
}Документ выкупа товара клиентом.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUMPERCТип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма с учётом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWNCASHELECTRONADVANCECREDITCOUNTEROFFERСпособ платежа. Возможные значения:
UNKNOWN – неизвестно (по умолчанию);CASH – наличными деньгами;ELECTRON – безналичным расчётом;ADVANCE – предоплатой (зачётом аванса);CREDIT – постоплатой (в кредит);COUNTEROFFER – встречным предоставлением.Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций.
Скидка на документ, распределённая на товарную позицию
Сумма скидки, которая была распределена на поззицию при применении скидки на документ. До двух знаков в дробной части.
SUMPERCТип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Обязательно для алкогольных типов товаров.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Перечень позиций в рамках позиции в чеке.
Например: в состав позиции “Кофе с сиропом” могут входить подпозиции “Кофе Американо, 250 мл” и “Кофейный сироп Мята, 30 мл”.
Как правило, подобная компоновка позиций применяется в категории бизнеса HoReCa.
Подпозиции могут быть добавлены в чек только программно, сторонним приложением на смарт-терминале.
Отпускная стоимость товарной позиции (price*quantity). До двух знаков в дробной части.
Массив объектов, соответствующих дополнительным полям (extras) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР.
Обязательное поле для алкогольных типов товаров.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Агентские реквизиты. Присутствует в документе, только если на терминале установлено приложение “Агентская схема”.
Индексы контрагентов из списка в заголовке документа.
Описание операции контрагента.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4, соответствующий RFC.
Штрихкод, по которому товар добавили в чек. Значение отсутствует, если товар добавлен напрямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив, содержащий объекты с описанием характеристик и их значений на момент формирования документа. Присутствует только в случае, если позиция сформирована на основе модификации товара.
Идентификатор характеристики
Название характеристики
Идентификатор значения характеристики
Текст значения характеристики
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Информация о расчёте НДС на товарную позицию.
Сумма НДС на товарную позицию с учётом скидок. До двух знаков в дробной части.
Сумма НДС на товарную позицию без применения скидок. До двух знаков в дробной части.
NO_VATVAT_10VAT_18VAT_0VAT_18_118VAT_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%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённой к конкретной позиции.
Стоимость одной единицы товара в позиции, с учётом применённой скидки на позицию (в момент добавления позиции в документ). Не учитывает скидку на весь документ. До двух знаков в дробной части.
Сумма скидки на позицию, применённной при добавлении позиции в документ. До двух знаков в дробной части.
SUMPERCТип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки на позицию, при добавлении позиции в документ. До пяти знаков в дробной части.
Идентификатор печатной группы при разбивке чека.
Тип товара или модификации товара:
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_RECEIPTINVOICESTRING_UTIIСпособ оплаты.
Наименование организации.
COMMONSIMPLIFIED_INCOMESIMPLIFIED_INCOME_OUTCOMESINGLE_IMPUTED_INCOMESINGLE_AGRICULTUREPATENTИспользуемая система налогообложения:
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_MARKEDALCOHOL_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"
}
}Документ выплаты наличных.
Номер смены в ККТ.
Номер документа в ККТ.
Имя получателя средств.
Основание для выплаты.
Сумма для выплаты. До двух знаков в дробной части.
Номер фискального признака документа.
123456Числовой идентификатор категории платежа:
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"
}
} Документ коррекции.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUMPERCТип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма с учётом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWNCASHELECTRONADVANCECREDITCOUNTEROFFERСпособ платежа. Возможные значения:
UNKNOWN – неизвестно (по умолчанию);CASH – наличными деньгами;ELECTRON – безналичным расчётом;ADVANCE – предоплатой (зачётом аванса);CREDIT – постоплатой (в кредит);COUNTEROFFER – встречным предоставлением.Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций.
Сумма скидки на документ, распределенная на товарную позицию.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
SUMPERCТип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки, которая была распределена на позицию в момент применения скидки на документ. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Массив разделённых позиций. Используется, когда применение скидок к позициям приводит к дроблению цен с точностью меньше одной копейки.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Сумма НДС на товарную позицию с учетом скидок. До двух знаков в дробной части.
NO_VATVAT_10VAT_18VAT_0VAT_18_118VAT_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_VATVAT_0VAT_10VAT_10_110VAT_18VAT_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%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённой к конкретной позиции.
Стоимость одной единицы товара в позиции, с учётом примененной скидки на позицию (в момент добавления позиции в документ). Не учитывает скидку на весь документ. До двух знаков в дробной части.
Сумма скидки на позицию, примененной в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
SUMPERCТип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку — она пересчитывается в суммовую.
Процент скидки на позицию в момент добавления позиции в документ. До пяти знаков в дробной части.
Идентификатор печатной группы при разделении чека.
Перечень позиций в рамках позиции в чеке.
Например: в состав позиции “Кофе с сиропом” могут входить подпозиции “Кофе Американо, 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_RECEIPTINVOICESTRING_UTIIСпособ оплаты.
Наименование организации.
COMMONSIMPLIFIED_INCOMESIMPLIFIED_INCOME_OUTCOMESINGLE_IMPUTED_INCOMESINGLE_AGRICULTUREPATENTИспользуемая система налогообложения:
COMMON – общая;SIMPLIFIED_INCOME – упрощённая (Доход);SIMPLIFIED_INCOME_OUTCOME – упрощённая (Доход минус Расход);SINGLE_IMPUTED_INCOME – единый налог на вмененный доход;SINGLE_AGRICULTURE – единый сельскохозяйственный налог;PATENT – патентная система налогообложения.Идентификатор места осуществления деятельности. Применяется только для лекарств.
Результаты печати ККТ (массив объектов с фискальными данными). Соответствует зафиксированным в ККТ данным.
Идентификатор печатной группы. Присутствует при разделении чека на печатные группы.
Номер смены в ККТ.
Фискальный номер документа в ККТ из ФН.
Номер чека в ККТ.
Номер документа в ККТ.
Итоговая сумма для печати на документе, с учётом скидок. До двух знаков в дробной части.
Регистрационный номер ККТ.
Дата печати в ККТ на момент печати документа, в формате “DDMMYYYY”.
Серийный номер ККТ.
Номер фискального признака документа.
Заводской номер фискального накопителя.
— ELECTRON — CASHТип принятой оплаты:
ELECTRON – безналичная оплата;CASH – оплата наличными.Дата коррекции.
Номер документа
Причина коррекции.
— INDEPENDENT — REQUIREMENTТип поррекции:
INDEPENDENT - самостоятельная;REQUIREMENT - по требованию.— SELL — BUY — RETURNТип операции, по которой происходит коррекция.
Сумма возврата.
COMMONSIMPLIFIED_INCOMESIMPLIFIED_INCOME_OUTCOMESINGLE_IMPUTED_INCOMESINGLE_AGRICULTUREPATENTИспользуемая система налогообложения:
COMMON – общая;SIMPLIFIED_INCOME – упрощённая (Доход);SIMPLIFIED_INCOME_OUTCOME – упрощённая (Доход минус Расход);SINGLE_IMPUTED_INCOME – единый налог на вмененный доход;SINGLE_AGRICULTURE – единый сельскохозяйственный налог;PATENT – патентная система налогообложения.— CASH — ELECTRONСпособ возврата средств клиенту:
ELECTRON – безналичный расчёт;CASH — наличный расчёт.NO_VATVAT_10VAT_18VAT_0VAT_18_118VAT_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 — исходящая коррекция возврата.