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
Возвращает массив документов.
Идентификатор магазина в Облаке Эвотор
При указании параметра, ответ будет содержать документы, созданные начиная с заданной даты включительно.
Указывайте параметр только в первом запросе из серии постраничных запросов.
Если требуется получить все документы с момента создания магазина, не указывайте параметр.
При указании параметра, ответ будет содержать только документы, созданные до заданной даты исключительно.
Если параметр не указан, значение автоматически определяется как текущая дата в момент выполнения запроса Облаком Эвотор.
Указывайте параметр только в первом запросе из серии постраничных запросов.
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 — чек коррекции.Указывайте параметр только в первом запросе из серии постраничных запросов.
Идентификатор курсора для постраничного чтения данных. Указывается для получения второй и последующих страниц данных.
Параметр должен принимать значение переменной
next_cursor, которое присутствовало в предыдущем ответе от Облака Эвотор.
Параметры отсутствуют.
{
"items": [
{
"type": "OPEN_SESSION",
"id": "20170222-D58C-40E0-8051-B53ADFF38860",
"extras": {},
"number": 1234,
"close_date": "2017-01-10T09:33:19.757+0000",
"time_zone_offset": 10800000,
"session_id": "1022722e-9441-4beb-beae-c6bc5e7af30d",
"session_number": 80,
"close_user_id": "20170417-46B8-40B9-802E-4DEB67C07565",
"device_id": "20170928-9441-4BEB-BEAE-C6BC5E7AF30D",
"store_id": "20170928-3176-40EB-80E2-A11F032E282A",
"user_id": "09-012345678901234",
"version": "V2",
"body": {}
}
],
"paging": {
"next_cursor": "string"
}
}
Информация о следующей странице. Если текущая страница является последней, то объект пустой.
Значение параметра cursor для получения следующей страницы.
Массив документов. Содержимое зависит от типа документа.
OPEN_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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Информация о приёмке товаров.
Массив товаров к приёмке.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Закупочная стоимость товарной позиции (price*quantity). До двух знаков в дробной части.
Единица измерения из карточки товара.
Массив объектов, соответствующих дополнительным полям (extras) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Наименование товара.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР.
Список всех возможных типов товаров — вы найдёте в разделе «Схемы товаров».
Крепость алкогольной продукции. До трёх знаков в дробной части.
Отпускная стоимость единицы товара.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4, соответствующий RFC.
Штрихкод, по которому товар добавили в документ приёмки.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведется на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null.
Тип марки. Можеть быть null.
RAW — марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS — марка готовая к фискализации: преобразованная в hex.Закупочная стоимость единицы товара.
Общая стоимость принятых товарных позиций. До двух знаков в дробной части.
Идентификатор поставщика. Кассир выбирает поставщика из выпадающего списка перед сохранением документа.
Основание для приёмки товара.
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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Описание документа инвентаризации.
Массив товарных позиций.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4, соответствующий RFC.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив объектов, соответствующих дополнительным полям (extras) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Определяет является инветаризация полной или нет.
true — полная инвентаризация. Остатки меняются у всех товарных позиций. Неупомянутые товарные позиции приобретают значение 0.false — частичная инвентаризация. Остатки меняются только у перечисленных товарныъ позиций.Основание для инвентаризации товаров.
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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Информация о переоценке товаров.
Массив товарных позиций для переоценки.
Код товара или модификации товара.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Данные о ценах товара.
Отпускная цена до переоценки.
Отпускная цена после переоценки.
Цена приёмки.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4, соответствующий RFC.
Массив объектов, соответствующих дополнительным полям (extras) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Идентификатор документа приёмки, на основании которого осуществляется переоценка.
Номер документа, на основании которого осуществляется переоценка.
Основание для переоценки товаров.
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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Документ возврата товара поставщику.
Массив товарных позиций для возврата поставщику.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity). До двух знаков в дробной части.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Единица измерения из карточки товара.
Массив объектов, соответствующих дополнительным полям (extras) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Наименование товара.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР.
Список всех возможных типов товаров — вы найдёте в разделе «Схемы товаров».
Крепость алкогольной продукции. До трёх знаков в дробной части.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4, соответствующий RFC.
Штрихкод, по которому товар добавили в документ.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null.
Тип марки. Можеть быть null.
RAW — марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS — марка готовая к фискализации: преобразованная в hex.Закупочная стоимость единицы товара. До двух знаков в дробной части.
Общая стоимость товарных позиций, которые будут возвращены поставщику. До двух знаков в дробной части.
ФИО поставщика.
Основание для возврата товаров поставщику.
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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Документ списания товара.
Массив списанных товарных позиций.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity). До двух знаков в дробной части.
Единица измерения из карточки товара.
Массив объектов, соответствующих дополнительным полям (extras) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Наименование товара.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Код вида алкогольной продукции ФСРАР.
Список всех возможных типов товаров — вы найдёте в разделе «Схемы товаров».
Крепость алкогольной продукции. До трёх знаков в дробной части.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4, соответствующий RFC.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы.
Номер можно сбросить программно.
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Общая стоимость списанных товарных позиций. До двух знаков в дробной части.
Основание для списания товарных позиций.
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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Документ продажи товара.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUMPERCТип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма чека с учётом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWNCASHELECTRONADVANCECREDITCOUNTEROFFERСпособ платежа. Возможные значения:
UNKNOWN – неизвестно (по умолчанию);CASH – наличными деньгами;ELECTRON – безналичным расчётом;ADVANCE – предоплатой (зачётом аванса);CREDIT – постоплатой (в кредит);COUNTEROFFER – встречным предоставлением.Информация о драйвере, который использовался для оформления платежа. Присутствует в случае типа оплаты “ELECTRON” и если оплата производилась через встроенный или подключеный к Эвотору банковский терминал.
Идентификатор драйвера в EvotorMarket, через который производился платеж безналичными средствами.
Наименование драйвера
Расширенная информация о платеже. Присутствует в случае типа оплаты “ELECTRON” и если разработчик драйвера или приложения для оплаты поддержал передачу этого поля. Примеры чеков с заполняемой в cashless_info информацией приведены в статье: https://developer.evotor.ru/docs/doc_java_extended_api_data.html.
Способ безналичной оплаты. Возможные значения:
QR - Оплата по QR коду, внутри своей банковской системы (Например: SberPay).BIOMETRY - Оплата по биометрии (Например: оплата Улыбкой).CARD - Обычная оплата картой.INTERNET_ACQUIRING - Приложение для оплаты через интернет эквайринг.BANK_TRANSFER - Банковский перевод на счёт.UNKNOWN - Неизвестно.Расширенное описание способа безналичной оплаты. Например: SberPay, MtsPay, AliPay.
Уникальный uuid способа безналичной оплаты.
Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций.
Сумма скидки на документ, распределенная на товарную позицию.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
SUMPERCТип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки, которая была распределена на позицию в момент применения скидки на документ. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Массив разделённых позиций. Используется, когда применение скидок к позициям приводит к дроблению цен с точностью меньше одной копейки.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Сумма НДС на товарную позицию с учетом скидок. До двух знаков в дробной части.
NO_VATVAT_10VAT_18VAT_0VAT_18_118VAT_10_110VAT_5VAT_5_105VAT_7VAT_7_107Ставка НДС. Возможные значения:
"NO_VAT" – без НДС;"VAT_0" – основная ставка 0%;"VAT_10" – основная ставка 10%;"VAT_10_110" – расчётная ставка 10%;"VAT_18" – основная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_18_118" – расчётная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_5" – основная ставка 5%;"VAT_5_105" – расчётная ставка 5%;"VAT_7" – основная ставка 7%;"VAT_7_107" – расчётная ставка 7%.Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Сумма скидки на позицию, применённой в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity). До двух знаков в дробной части.
Массив объектов, соответствующих дополнительным полям (extras) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Код вида алкогольной продукции ФСРАР.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Агентские реквизиты. Присутствует в документе, только если на терминале установлено приложение “Агентская схема”.
Индексы контрагентов из списка в заголовке документа.
Описание операции контрагента.
Сумма акциза, за акцизный товар. Используется при расчётах между юридическими лицами. До двух знаков в дробной части.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4, соответствующий RFC.
Штрихкод, по которому товар добавили в чек. Значение отсутствует, если товар добавлен напрямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив, содержащий объекты с описанием характеристик и их значений на момент формирования документа. Присутствует только в случае, если позиция сформирована на основе модификации товара.
Идентификатор характеристики
Название характеристики
Идентификатор значения характеристики
Текст значения характеристики
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Количество товара в упаковке всего.
Информация о расчете НДС на товарную позицию.
Сумма НДС на товарную позицию с учетом скидок.
Сумма НДС на товарную позицию без применения скидок.
NO_VATVAT_0VAT_10VAT_10_110VAT_18VAT_18_118VAT_5VAT_7VAT_5_105VAT_7_107Ставка НДС. Возможные значения:
"NO_VAT" – без НДС;"VAT_0" – основная ставка 0%;"VAT_10" – основная ставка 10%;"VAT_10_110" – расчётная ставка 10%;"VAT_18" – основная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_18_118" – расчётная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_5" – основная ставка 5%;"VAT_5_105" – расчётная ставка 5%;"VAT_7" – основная ставка 7%;"VAT_7_107" – расчётная ставка 7%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённой к конкретной позиции.
Стоимость одной единицы товара в позиции, с учётом примененной скидки на позицию (в момент добавления позиции в документ). Не учитывает скидку на весь документ. До двух знаков в дробной части.
Сумма скидки на позицию, примененной в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
SUMPERCТип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку — она пересчитывается в суммовую.
Процент скидки на позицию в момент добавления позиции в документ. До пяти знаков в дробной части.
Идентификатор печатной группы при разделении чека.
Перечень позиций в рамках позиции в чеке.
Например: в состав позиции “Кофе с сиропом” могут входить подпозиции “Кофе Американо, 250 мл” и “Кофейный сироп Мята, 30 мл”.
Как правило, подобная компоновка позиций применяется в категории бизнеса HoReCa.
Подпозиции могут быть добавлены в чек только программно, сторонним приложением на смарт-терминале.
Список всех возможных типов товаров — вы найдёте в разделе «Схемы товаров».
Крепость алкогольной продукции. До трёх знаков в дробной части.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null.
Тип марки. Можеть быть null.
RAW — марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS — марка готовая к фискализации: преобразованная в hex.Возможные значения:
PREPAYMENT_FULL — Полная предварительная оплата до момента передачи предмета расчета.PREPAYMENT_PARTIAL — Частичная предварительная оплата до момента передачи предмета расчета .ADVANCE — Аванс.CHECKOUT_FULL — Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчета.CHECKOUT_PARTIAL — Частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит.CREDIT_PASS — Передача предмета расчета без его оплаты в момент его передачи с последующей оплатой в кредит.CREDIT_CHECKOUT — Оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита).Итоговая сумма с учётом налогов. До двух знаков в дробной части.
Печатные группы. Используется для печати нескольких чеков. Например, в случае с разделённой оплатой.
Адрес организации.
ИНН организации.
Идентификатор печатной группы.
CASH_RECEIPTINVOICESTRING_UTIIСпособ оплаты.
Наименование организации.
COMMONSIMPLIFIED_INCOMESIMPLIFIED_INCOME_OUTCOMESINGLE_IMPUTED_INCOMESINGLE_AGRICULTUREPATENTИспользуемая система налогообложения:
COMMON – общая;SIMPLIFIED_INCOME – упрощённая (Доход);SIMPLIFIED_INCOME_OUTCOME – упрощённая (Доход минус Расход);SINGLE_IMPUTED_INCOME – единый налог на вмененный доход;SINGLE_AGRICULTURE – единый сельскохозяйственный налог;PATENT – патентная система налогообложения.Идентификатор места осуществления деятельности. Применяется только для лекарств.
Результаты печати ККТ (массив объектов с фискальными данными). Соответствует зафиксированным в ККТ данным.
Идентификатор печатной группы. Присутствует при разделении чека на печатные группы.
Номер смены в ККТ.
Фискальный номер документа в ККТ из ФН.
Номер чека в ККТ.
Номер документа в ККТ.
Итоговая сумма для печати на документе, с учётом скидок. До двух знаков в дробной части.
Регистрационный номер ККТ.
Дата печати в ККТ на момент печати документа, в формате “DDMMYYYY”.
Серийный номер ККТ.
Номер фискального признака документа.
Заводской номер фискального накопителя.
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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Документ возврата.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUMPERCТип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма с учЁтом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWNCASHELECTRONADVANCECREDITCOUNTEROFFERСпособ платежа. Возможные значения:
UNKNOWN – неизвестно (по умолчанию);CASH – наличными деньгами;ELECTRON – безналичным расчётом;ADVANCE – предоплатой (зачётом аванса);CREDIT – постоплатой (в кредит);COUNTEROFFER – встречным предоставлением.Информация о драйвере, который использовался для оформления платежа. Присутствует в случае типа оплаты “ELECTRON” и если оплата производилась через встроенный или подключеный к Эвотору банковский терминал.
Идентификатор драйвера в EvotorMarket, через который производился платеж безналичными средствами.
Наименование драйвера
Расширенная информация о платеже. Присутствует в случае типа оплаты “ELECTRON” и если разработчик драйвера или приложения для оплаты поддержал передачу этого поля. Примеры чеков с заполняемой в cashless_info информацией приведены в статье: https://developer.evotor.ru/docs/doc_java_extended_api_data.html.
Способ безналичной оплаты. Возможные значения:
QR - Оплата по QR коду, внутри своей банковской системы (Например: SberPay).BIOMETRY - Оплата по биометрии (Например: оплата Улыбкой).CARD - Обычная оплата картой.INTERNET_ACQUIRING - Приложение для оплаты через интернет эквайринг.BANK_TRANSFER - Банковский перевод на счёт.UNKNOWN - Неизвестно.Расширенное описание способа безналичной оплаты. Например: SberPay, MtsPay, AliPay.
Уникальный uuid способа безналичной оплаты.
Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций.
Сумма скидки на документ, распределенная на товарную позицию.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
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_110VAT_5VAT_5_105VAT_7VAT_7_107Ставка НДС. Возможные значения:
"NO_VAT" – без НДС;"VAT_0" – основная ставка 0%;"VAT_10" – основная ставка 10%;"VAT_10_110" – расчётная ставка 10%;"VAT_18" – основная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_18_118" – расчётная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_5" – основная ставка 5%;"VAT_5_105" – расчётная ставка 5%;"VAT_7" – основная ставка 7%;"VAT_7_107" – расчётная ставка 7%.Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Сумма скидки на позицию, применённой в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity). До двух знаков в дробной части.
Массив объектов, соответствующих дополнительным полям (extras) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Код вида алкогольной продукции ФСРАР.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Агентские реквизиты. Присутствует в документе, только если на терминале установлено приложение “Агентская схема”.
Индексы контрагентов из списка в заголовке документа.
Описание операции контрагента.
Сумма акциза, за акцизный товар. Используется при расчётах между юридическими лицами. До двух знаков в дробной части.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4, соответствующий RFC.
Штрихкод, по которому товар добавили в чек. Значение отсутствует, если товар добавлен напрямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив, содержащий объекты с описанием характеристик и их значений на момент формирования документа. Присутствует только в случае, если позиция сформирована на основе модификации товара.
Идентификатор характеристики
Название характеристики
Идентификатор значения характеристики
Текст значения характеристики
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Количество товара в упаковке всего.
Информация о расчете НДС на товарную позицию.
Сумма НДС на товарную позицию с учетом скидок.
Сумма НДС на товарную позицию без применения скидок.
NO_VATVAT_0VAT_10VAT_10_110VAT_18VAT_18_118VAT_5VAT_7VAT_5_105VAT_7_107Ставка НДС. Возможные значения:
"NO_VAT" – без НДС;"VAT_0" – основная ставка 0%;"VAT_10" – основная ставка 10%;"VAT_10_110" – расчётная ставка 10%;"VAT_18" – основная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_18_118" – расчётная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_5" – основная ставка 5%;"VAT_5_105" – расчётная ставка 5%;"VAT_7" – основная ставка 7%;"VAT_7_107" – расчётная ставка 7%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённая к конкретной позиции.
Скидка на единицу товара с учетом налогов. До двух знаков в дробной части.
Сумма скидки на позицию, применённой при добавлении позиции в документ. До двух знаков в дробной части.
SUMPERCТип скидки - сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки на позицию. До пяти знаков в дробной части.
Идентификатор печатной группы при разбивке чека.
Список всех возможных типов товаров — вы найдёте в разделе «Схемы товаров».
Крепость алкогольной продукции. До трёх знаков в дробной части.
Указатель на родительский элемент позиции в древовидной иерархии номенклатуры.
Родительским элементом может быть группа товаров или группа модификаций.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть null.
Тип марки. Можеть быть null.
RAW — марка в одном из форматов: полное значение, укороченное или со скобками;MARK_BY_FISCAL_TAGS — марка готовая к фискализации: преобразованная в hex.Перечень позиций в рамках позиции в чеке.
Например: в состав позиции “Кофе с сиропом” могут входить подпозиции “Кофе Американо, 250 мл” и “Кофейный сироп Мята, 30 мл”.
Как правило, подобная компоновка позиций применяется в категории бизнеса HoReCa.
Подпозиции могут быть добавлены в чек только программно, сторонним приложением на смарт-терминале.
Возможные значения:
PREPAYMENT_FULL — Полная предварительная оплата до момента передачи предмета расчета.PREPAYMENT_PARTIAL — Частичная предварительная оплата до момента передачи предмета расчета .ADVANCE — Аванс.CHECKOUT_FULL — Полная оплата, в том числе с учетом аванса (предварительной оплаты) в момент передачи предмета расчета.CHECKOUT_PARTIAL — Частичная оплата предмета расчета в момент его передачи с последующей оплатой в кредит.CREDIT_PASS — Передача предмета расчета без его оплаты в момент его передачи с последующей оплатой в кредит.CREDIT_CHECKOUT — Оплата предмета расчета после его передачи с оплатой в кредит (оплата кредита).Итоговая сумма с учётом налогов. До двух знаков в дробной части.
Печатные группы. Используется для печати нескольких чеков. Например, в случае с разделённой оплатой.
Адрес организации.
ИНН организации.
Идентификатор печатной группы.
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”.
Серийный номер ККТ.
Номер фискального признака документа.
Заводской номер фискального накопителя.
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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUMPERCТип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма с учетом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWNCASHELECTRONADVANCECREDITCOUNTEROFFERСпособ платежа. Возможные значения:
UNKNOWN – неизвестно (по умолчанию);CASH – наличными деньгами;ELECTRON – безналичным расчётом;ADVANCE – предоплатой (зачётом аванса);CREDIT – постоплатой (в кредит);COUNTEROFFER – встречным предоставлением.Информация о драйвере, который использовался для оформления платежа. Присутствует в случае типа оплаты “ELECTRON” и если оплата производилась через встроенный или подключеный к Эвотору банковский терминал.
Идентификатор драйвера в EvotorMarket, через который производился платеж безналичными средствами.
Наименование драйвера
Расширенная информация о платеже. Присутствует в случае типа оплаты “ELECTRON” и если разработчик драйвера или приложения для оплаты поддержал передачу этого поля. Примеры чеков с заполняемой в cashless_info информацией приведены в статье: https://developer.evotor.ru/docs/doc_java_extended_api_data.html.
Способ безналичной оплаты. Возможные значения:
QR - Оплата по QR коду, внутри своей банковской системы (Например: SberPay).BIOMETRY - Оплата по биометрии (Например: оплата Улыбкой).CARD - Обычная оплата картой.INTERNET_ACQUIRING - Приложение для оплаты через интернет эквайринг.BANK_TRANSFER - Банковский перевод на счёт.UNKNOWN - Неизвестно.Расширенное описание способа безналичной оплаты. Например: SberPay, MtsPay, AliPay.
Уникальный uuid способа безналичной оплаты.
Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций в документе.
Сумма скидки на документ, распределённая на товарную позицию.
Сумма скидки, которая была распределена на позицию при применении скидки на документ. До двух знаков в дробной части.
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_118VAT_5VAT_5_105VAT_7VAT_7_107Ставка НДС. Возможные значения:
"NO_VAT" — без НДС;"VAT_0" — основная ставка 0%;"VAT_10" — основная ставка 10%;"VAT_10_110" — расчётная ставка 10%;"VAT_18" — основная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_18_118" — расчётная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_5" – основная ставка 5%;"VAT_5_105" – расчётная ставка 5%;"VAT_7" – основная ставка 7%;"VAT_7_107" – расчётная ставка 7%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённой к конкретной позиции.
Стоимость одной единицы товара в позиции, с учётом скидки на позицию, применённой при добавлении позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
Сумма скидки на позицию, применённой при добавлении позиции в документ. До двух знаков в дробной части.
SUMPERCТип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки на позицию, при добавлении позиции в документ. До пяти знаков в дробной части.
Идентификатор печатной группы при разбивке чека. Формат – uuid4, в соответствии с RFC
Список всех возможных типов товаров — вы найдёте в разделе «Схемы товаров».
Крепость алкогольной продукции. До трёх знаков в дробной части.
Указатель на родительский элемент позиции в древовидной иерархии номенклатуры.
Родительским элементом может быть группа товаров или группа модификаций.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть 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”.
Серийный номер ККТ.
Номер фискального признака документа.
Заводской номер фискального накопителя.
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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Документ выкупа товара клиентом.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUMPERCТип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма с учётом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWNCASHELECTRONADVANCECREDITCOUNTEROFFERСпособ платежа. Возможные значения:
UNKNOWN – неизвестно (по умолчанию);CASH – наличными деньгами;ELECTRON – безналичным расчётом;ADVANCE – предоплатой (зачётом аванса);CREDIT – постоплатой (в кредит);COUNTEROFFER – встречным предоставлением.Информация о драйвере, который использовался для оформления платежа. Присутствует в случае типа оплаты “ELECTRON” и если оплата производилась через встроенный или подключеный к Эвотору банковский терминал.
Идентификатор драйвера в EvotorMarket, через который производился платеж безналичными средствами.
Наименование драйвера
Расширенная информация о платеже. Присутствует в случае типа оплаты “ELECTRON” и если разработчик драйвера или приложения для оплаты поддержал передачу этого поля. Примеры чеков с заполняемой в cashless_info информацией приведены в статье: https://developer.evotor.ru/docs/doc_java_extended_api_data.html.
Способ безналичной оплаты. Возможные значения:
QR - Оплата по QR коду, внутри своей банковской системы (Например: SberPay).BIOMETRY - Оплата по биометрии (Например: оплата Улыбкой).CARD - Обычная оплата картой.INTERNET_ACQUIRING - Приложение для оплаты через интернет эквайринг.BANK_TRANSFER - Банковский перевод на счёт.UNKNOWN - Неизвестно.Расширенное описание способа безналичной оплаты. Например: SberPay, MtsPay, AliPay.
Уникальный uuid способа безналичной оплаты.
Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций.
Скидка на документ, распределённая на товарную позицию
Сумма скидки, которая была распределена на поззицию при применении скидки на документ. До двух знаков в дробной части.
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_110VAT_5VAT_5_105VAT_7VAT_7_107Ставка НДС. Возможные значения:
"NO_VAT" – без НДС;"VAT_0" – основная ставка 0%;"VAT_10" – основная ставка 10%;"VAT_10_110" – расчётная ставка 10%;"VAT_18" – основная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_18_118" – расчётная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_5" – основная ставка 5%;"VAT_5_105" – расчётная ставка 5%;"VAT_7" – основная ставка 7%;"VAT_7_107" – расчётная ставка 7%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённой к конкретной позиции.
Стоимость одной единицы товара в позиции, с учётом применённой скидки на позицию (в момент добавления позиции в документ). Не учитывает скидку на весь документ. До двух знаков в дробной части.
Сумма скидки на позицию, применённной при добавлении позиции в документ. До двух знаков в дробной части.
SUMPERCТип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки на позицию, при добавлении позиции в документ. До пяти знаков в дробной части.
Идентификатор печатной группы при разбивке чека.
Список всех возможных типов товаров — вы найдёте в разделе «Схемы товаров».
Крепость алкогольной продукции. До трёх знаков в дробной части.
Указатель на родительский элемент позиции в древовидной иерархии номенклатуры.
Родительским элементом может быть группа товаров или группа модификаций.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть 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”.
Серийный номер ККТ.
Номер фискального признака документа.
Заводской номер фискального накопителя.
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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Документ вскрытия тары.
Массив алкогольных товаров для вскрытия тары.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Код товара или модификации товара.
В документах типов 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.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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Пустой объект.
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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Данные о закрытии смены.
Выручка за смену. До двух знаков в дробной части.
Сумма наличных средств в кассе на момент закрытия смены. До двух знаков в дробной части.
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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Данные об открытии смены в ККТ.
Номер смены в ККТ.
Номер чека в ККТ.
Номер документа в ККТ
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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа
Номер смены в ККТ.
Фискальный номер документа в ККТ из ФН.
Номер документа в ККТ.
Номер чека в ККТ.
Имя вносителя средств (“От кого”).
Регистрационный номер ККТ.
Дата в ККТ на момент печати документа. Формат DDMMYYYY.
Серийный номер ККТ.
Основание для внесения.
Сумма для внесения. До двух знаков в дробной части.
Номер фискального признака документа.
Заводской номер фискального накопителя.
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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Документ выплаты наличных.
Номер смены в ККТ.
Номер документа в ККТ.
Имя получателя средств.
Основание для выплаты.
Сумма для выплаты. До двух знаков в дробной части.
Номер фискального признака документа.
123456Числовой идентификатор категории платежа:
1 — инкассация;2 — оплата поставщику;3 — оплата услуг;4 — аренда;5 — заработная плата;6 — прочее.ИнкассацияОплата поставщикуОплата услугАрендаЗаработная платаПрочееТекстовый идентификатор категории платежа.
Заводской номер фискального накопителя.
Фискальный номер документа в ККТ из ФН.
Номер чека в ККТ.
Регистрационный номер ККТ.
Дата печати в ККТ на момент печати документа. Формат DDMMYYYY.
Серийный номер ККТ.
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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
X-отчёт.
Номер смены в ККТ.
Общая сумма продаж за смену на момент формирования отчёта. До двух знаков в дробной части.
Номер чека в ККТ.
Номер документа в ККТ.
Выручка за смену на момент формирования отчёта. До двух знаков в дробной части.
Наличные средства в кассе на момент формирования отчёта. До двух знаков в дробной части.
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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Z-отчёт.
Количество операций выплаты.
Информация о продажах (sales), возвратах продаж (sales_back), покупках (purchases) или возвратах покупок (purchases_back) в разрезе способов оплаты доступных на ККТ.
Сумма обратной операции. До двух знаков в дробной части.
Сумма операции. До двух знаков в дробной части.
Секции оплаты
Номер секции ККТ.
ТАРОЙПЛАТ.КАРТОЙКРЕДИТОМНАЛИЧНЫМИТИП 5ТИП 6ТИП 7ТИП 8ТИП 9ТИП 10Наименование секции ККТ.
Сумма оплаты по данной секции. До двух знаков в дробной части.
Фискальный номер документа в ККТ из ФН.
Общая сумма продаж за смену. До двух знаков в дробной части.
Доход за смену. До двух знаков в дробной части.
Выручка за смену. До двух знаков в дробной части.
Серийный номер ККТ.
Информация о продажах (sales), возвратах продаж (sales_back), покупках (purchases) или возвратах покупок (purchases_back) в разрезе способов оплаты доступных на ККТ.
Сумма обратной операции. До двух знаков в дробной части.
Сумма операции. До двух знаков в дробной части.
Секции оплаты
Номер секции ККТ.
ТАРОЙПЛАТ.КАРТОЙКРЕДИТОМНАЛИЧНЫМИТИП 5ТИП 6ТИП 7ТИП 8ТИП 9ТИП 10Наименование секции ККТ.
Сумма оплаты по данной секции. До двух знаков в дробной части.
Наличные средства в кассе. До двух знаков в дробной части.
Номер смены в ККТ.
Номер документа в ККТ.
Необнуляемая сумма покупок. До двух знаков в дробной части.
Информация о продажах (sales), возвратах продаж (sales_back), покупках (purchases) или возвратах покупок (purchases_back) в разрезе способов оплаты доступных на ККТ.
Сумма обратной операции. До двух знаков в дробной части.
Сумма операции. До двух знаков в дробной части.
Секции оплаты
Номер секции ККТ.
ТАРОЙПЛАТ.КАРТОЙКРЕДИТОМНАЛИЧНЫМИТИП 5ТИП 6ТИП 7ТИП 8ТИП 9ТИП 10Наименование секции ККТ.
Сумма оплаты по данной секции. До двух знаков в дробной части.
Сменный итог по продажам. До двух знаков в дробной части.
Количество операций внесения.
Сумма внесений за смену. До двух знаков в дробной части.
Информация о продажах (sales), возвратах продаж (sales_back), покупках (purchases) или возвратах покупок (purchases_back) в разрезе способов оплаты доступных на ККТ.
Сумма обратной операции. До двух знаков в дробной части.
Сумма операции. До двух знаков в дробной части.
Секции оплаты
Номер секции ККТ.
ТАРОЙПЛАТ.КАРТОЙКРЕДИТОМНАЛИЧНЫМИТИП 5ТИП 6ТИП 7ТИП 8ТИП 9ТИП 10Наименование секции ККТ.
Сумма оплаты по данной секции. До двух знаков в дробной части.
Номер фискального признака документа.
Сумма к инкассации. До двух знаков в дробной части.
Заводской номер фискального накопителя.
Сумма выплат за смену. До двух знаков в дробной части.
Номер чека в ККТ.
Регистрационный номер ККТ.
Необнуляемая сумма продаж. До двух знаков в дробной части.
Число операций продаж (sales) или покупок (purchases), в зависимости от названия объекта. Содержит информацию блока Продажи или Покупки на чеке Z-отчёта, соответственно.
Количество прямых операций.
Количество операций.
Количество обратных операций.
Количество отмен обратных операций
Дата в ККТ на момент печати документа. Формат DDMMYYYY.
Сменный итог покупок. До двух знаков в дробной части.
Число операций продаж (sales) или покупок (purchases), в зависимости от названия объекта. Содержит информацию блока Продажи или Покупки на чеке Z-отчёта, соответственно.
Количество прямых операций.
Количество операций.
Количество обратных операций.
Количество отмен обратных операций
OPEN_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 — государственный орган.Объект с основной информацией о документе. Его структура и наполнение зависит от типа документа.
Документ коррекции.
Массив скидок на документ.
Идентификатор купона (для случаев применения скидки через штатный функционал скидочных купонов).
Сумма скидки. До двух знаков в дробной части.
SUMPERCТип скидки - суммовая или процентная.
Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки. До пяти знаков в дробной части.
Итоговая сумма с учётом налогов и скидок. До двух знаков в дробной части.
Массив платежей.
Массив платежей для разделённой оплаты.
Идентификатор печатной группы при разделении чека.
Часть платежа, которая пошла на оплату данной печатной группы. До двух знаков в дробной части.
Сдача. До двух знаков в дробной части.
Итоговая сумма к оплате данным способом оплаты.
Уникальный идентификатор платежа.
UNKNOWNCASHELECTRONADVANCECREDITCOUNTEROFFERСпособ платежа. Возможные значения:
UNKNOWN – неизвестно (по умолчанию);CASH – наличными деньгами;ELECTRON – безналичным расчётом;ADVANCE – предоплатой (зачётом аванса);CREDIT – постоплатой (в кредит);COUNTEROFFER – встречным предоставлением.Информация о драйвере, который использовался для оформления платежа. Присутствует в случае типа оплаты “ELECTRON” и если оплата производилась через встроенный или подключеный к Эвотору банковский терминал.
Идентификатор драйвера в EvotorMarket, через который производился платеж безналичными средствами.
Наименование драйвера
Расширенная информация о платеже. Присутствует в случае типа оплаты “ELECTRON” и если разработчик драйвера или приложения для оплаты поддержал передачу этого поля. Примеры чеков с заполняемой в cashless_info информацией приведены в статье: https://developer.evotor.ru/docs/doc_java_extended_api_data.html.
Способ безналичной оплаты. Возможные значения:
QR - Оплата по QR коду, внутри своей банковской системы (Например: SberPay).BIOMETRY - Оплата по биометрии (Например: оплата Улыбкой).CARD - Обычная оплата картой.INTERNET_ACQUIRING - Приложение для оплаты через интернет эквайринг.BANK_TRANSFER - Банковский перевод на счёт.UNKNOWN - Неизвестно.Расширенное описание способа безналичной оплаты. Например: SberPay, MtsPay, AliPay.
Уникальный uuid способа безналичной оплаты.
Объект с информацией для электронных платежей, в случае типа оплаты ELECTRON.
Наименование платежной системы. Не более 2048 символов.
Идентификатор приложения, которое произвело платёж электронными средствами.
Адрес электронной почты покупателя.
Номер телефона покупателя.
Массив товарных позиций.
Сумма скидки на документ, распределенная на товарную позицию.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
SUMPERCТип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку – она пересчитывается в суммовую.
Процент скидки, которая была распределена на позицию в момент применения скидки на документ. До пяти знаков в дробной части.
Код товара или модификации товара.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Ёмкость тары алкогольной продукции в литрах. До трёх знаков в дробной части.
Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Массив разделённых позиций. Используется, когда применение скидок к позициям приводит к дроблению цен с точностью меньше одной копейки.
Сумма скидки, которая была распределена на позицию в момент применения скидки на документ. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Сумма НДС на товарную позицию с учетом скидок. До двух знаков в дробной части.
NO_VATVAT_10VAT_18VAT_0VAT_18_118VAT_10_110VAT_5VAT_5_105VAT_7VAT_7_107Ставка НДС. Возможные значения:
"NO_VAT" – без НДС;"VAT_0" – основная ставка 0%;"VAT_10" – основная ставка 10%;"VAT_10_110" – расчётная ставка 10%;"VAT_18" – основная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_18_118" – расчётная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_5" – основная ставка 5%;"VAT_5_105" – расчётная ставка 5%;"VAT_7" – основная ставка 7%;"VAT_7_107" – расчётная ставка 7%.Отпускная стоимость товарной позиции с учётом скидок. До двух знаков в дробной части.
Сумма скидки на позицию, применённой в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Отпускная стоимость товарной позиции (price*quantity). До двух знаков в дробной части.
Массив объектов, соответствующих дополнительным полям (extras) товара, на момент добавления товара в документ.
Уникальный идентификатор дополнительного атрибута товара.
Описание дополнительного атрибута для визуализации на смарт-терминале.
Идентификатор приложения, в рамках которого к товарной позиции привязан дополнительный атрибут.
Уникальный идентификатор товарной позиции в чеке. После преобразования из первой версии документа приобретает значение null.
Полезен в случаях, когда нужно программно (средствами SDK) сослаться на конкретную позицию.
Конечная стоимость единицы позиции после всех калькуляций в чеке (скидки на чек и скидки на позицию). Соответствует значению, которое печатается на чеке. До двух знаков в дробной части.
Код вида алкогольной продукции ФСРАР.
Отпускная стоимость единицы товара. До двух знаков в дробной части.
Агентские реквизиты. Присутствует в документе, только если на терминале установлено приложение “Агентская схема”.
Индексы контрагентов из списка в заголовке документа.
Описание операции контрагента.
Сумма акциза, за акцизный товар. Используется при расчётах между юридическими лицами. До двух знаков в дробной части.
Данные об импорте продукции.
Код страны происхождения. Используется при расчётах между юридическими лицами.
Номер таможенной декларации. Используется при расчётах между юридическими лицами.
Идентификатор товара, уникальный в рамках магазина.
В документах типов SELL, PAYBACK, BUY и BUYBACK поле не передаётся, если операция выполняется с позицией по свободной цене.
Максимальная длина идентификатора — 200 символов. Символы идентификатора должны удолетворять регулярному выражению
A-a0-9-_.
В качестве идентификаторов товаров вы можете использовать, например,
uuid4, соответствующий RFC.
Штрихкод, по которому товар добавили в чек. Значение отсутствует, если товар добавлен напрямую из списка.
Порядковый номер транзакции регистрации позиции в документе. Счёт ведётся на уровне терминала, начиная с единицы. Номер можно сбросить программно.
Массив, содержащий объекты с описанием характеристик и их значений на момент формирования документа. Присутствует только в случае, если позиция сформирована на основе модификации товара.
Идентификатор характеристики
Название характеристики
Идентификатор значения характеристики
Текст значения характеристики
Закупочная стоимость единицы товара. До двух знаков в дробной части.
Количество товара, над которыми выполняется операция. Всегда положительное число. До трёх знаков в дробной части.
Остаток товара до выполнения операции. До трёх знаков в дробной части.
Количество товара в упаковке всего.
Информация о расчете НДС на товарную позицию.
Сумма НДС на товарную позицию с учетом скидок.
Сумма НДС на товарную позицию без применения скидок.
NO_VATVAT_0VAT_10VAT_10_110VAT_18VAT_18_118VAT_5VAT_7VAT_5_105VAT_7_107Ставка НДС. Возможные значения:
"NO_VAT" – без НДС;"VAT_0" – основная ставка 0%;"VAT_10" – основная ставка 10%;"VAT_10_110" – расчётная ставка 10%;"VAT_18" – основная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_18_118" – расчётная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_5" – основная ставка 5%;"VAT_5_105" – расчётная ставка 5%;"VAT_7" – основная ставка 7%;"VAT_7_107" – расчётная ставка 7%.Единица измерения из карточки товара.
Наименование товара.
Объект скидки на позицию, изначально применённой к конкретной позиции.
Стоимость одной единицы товара в позиции, с учётом примененной скидки на позицию (в момент добавления позиции в документ). Не учитывает скидку на весь документ. До двух знаков в дробной части.
Сумма скидки на позицию, примененной в момент добавления позиции в документ. Не учитывает скидку на весь документ. До двух знаков в дробной части.
SUMPERCТип скидки — сумовая или процентная.
Важно! Все скидки сейчас на терминале работают как суммовые. Даже если клиент делает процентную скидку — она пересчитывается в суммовую.
Процент скидки на позицию в момент добавления позиции в документ. До пяти знаков в дробной части.
Идентификатор печатной группы при разделении чека.
Перечень позиций в рамках позиции в чеке.
Например: в состав позиции “Кофе с сиропом” могут входить подпозиции “Кофе Американо, 250 мл” и “Кофейный сироп Мята, 30 мл”.
Как правило, подобная компоновка позиций применяется в категории бизнеса HoReCa.
Подпозиции могут быть добавлены в чек только программно, сторонним приложением на смарт-терминале.
Список всех возможных типов товаров — вы найдёте в разделе «Схемы товаров».
Крепость алкогольной продукции. До трёх знаков в дробной части.
Марка алкогольного товара.
Объект с информацией о марке.
Значение марки. Может быть 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_110VAT_5VAT_5_105VAT_7VAT_7_107Ставка НДС. Возможные значения:
"NO_VAT" – без НДС;"VAT_0" – основная ставка 0%;"VAT_10" – основная ставка 10%;"VAT_10_110" – расчётная ставка 10%;"VAT_18" – основная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_18_118" – расчётная ставка 18%. С первого января 2019 года может содержать 20%;"VAT_5" – основная ставка 5%;"VAT_5_105" – расчётная ставка 5%;"VAT_7" – основная ставка 7%;"VAT_7_107" – расчётная ставка 7%.— CORRECTION_INCOME — CORRECTION_OUTCOME — CORRECTION_RETURN_INCOME — CORRECTION_RETURN_OUTCOMEТип коррекции:
CORRECTION_INCOME — входящая коррекция;CORRECTION_OUTCOME — исходящая коррекция;CORRECTION_RETURN_INCOME — входящая коррекция возврата;CORRECTION_RETURN_OUTCOME — исходящая коррекция возврата.Запрос выполнен успешно
Ошибка авторизации приложения.
Облако передаёт ошибку с кодом 402, в случае, когда происходит попытка обмена данными между смарт-терминалами, привязанными к одному магазину, но приложение не установлено на одно или несколько устройств или количество устройств в магазине превышает количество устройств, оплаченных в приложении.
Нет доступа. Ошибка возникает когда у приложения нет разрешения на запрашиваемое действие или пользователь не установил приложение в Личном кабинете.
Запрашиваемый ресурс не найден.
Тип содержимого, которое возвращает ресурс не соответствует типу содержимого, которое указанно в заголовке Accept.
Превышено максимальное количество запросов в текущем периоде. Работу с ресурсом можно возобновить после окончания времени, указанного в заголовке X-RateLimit-Reset.
Всю необходимую информацию о типах документов можно изучить в разделе Схемы документов.