GET /stores/{store-id}/products
GET /stores/{store-id}/products/{product-id}
POST /stores/{store-id}/products
PUT /stores/{store-id}/products
PUT /stores/{store-id}/products/{product-id}
PATCH /stores/{store-id}/products/{product-id}
DELETE /stores/{store-id}/products
DELETE /stores/{store-id}/products/{product-id}
GET /stores/{store-id}/product-groups
GET /stores/{store-id}/product-groups/{product-group-id}
POST /stores/{store-id}/product-groups
PUT /stores/{store-id}/product-groups
PUT /stores/{store-id}/product-groups/{product-group-id}
PATCH /stores/{store-id}/product-groups/{product-group-id}
DELETE /stores/{store-id}/product-groups
DELETE /stores/{store-id}/product-groups/{product-group-id}
GET /api/apps/{application_id}/push-notifications/{push-id}
POST /api/apps/{application_id}/push-notifications
POST /api/apps/{application_id}/devices/{device_uuid}/push-notifications
GET /api/v1/inventories/stores/{store-id}/products/schemes
POST /api/v1/inventories/stores/{store-id}/products/schemes
POST /api/v1/inventories/stores/{store-id}/products/schemes/delete
GET /api/v1/inventories/stores/{store-id}/products/extras
POST /api/v1/inventories/stores/{store-id}/products/extras
POST /api/v1/inventories/stores/{store-id}/products/extras/delete
POST /user/create
POST /user/verify
POST /user/token
GET /commodities
PUT /
POST /inventories/stores/{storeUuid}/products
POST /subscription/event
POST /installation/event
GET mobilecashier.ru/api/v2/authorize
GET mobilecashier.evotor.ru/api/v2/market/user/{userId}/stores
GET mobilecashier.evotor.ru/api/v2/market/user/{userId}/staff?shopId=
GET mobilecashier.evotor.ru/api/v2/market/user/{userId}/devices
POST mobilecashier.ru/api/v4/asc/create/userId
GET mobilecashier.ru/api/v4/asc/get
DELETE mobilecashier.ru/api/v2/asc/delete/{uuid}
POST
GET mobcashier.evotor.ru/api/v1/callback/reset/{userId}
Сервис поможет передать информацию о чеке обратно клиенту.
Для корректной работы метода должен быть поднят веб-сервис, который принимает POST-запрос с JSON. Сервис должен поддерживать https соединение и не требовать авторизации. В ответ ожидаем код 200. Получить информацию о чеке можно также при работе в режиме без фискализации, в таком случае информация о чеке будет направлена после оплаты заказа.
URL веб-сервиса, на который придет запрос, вносится через почту mk@evotor.ru. В письме укажите номер телефона от Личного кабинета Эвотор и перечень терминалов (imei терминалов). Если необходимо внести наш ip-адрес в белый список на вашей стороне, сообщите об этом.
Если мы не получаем код 200 в ответе, сервис пытается отправить callback повторно через 10 секунд, затем 10 попыток с интервалом 40 секунд. Чеки, которые не были приняты от нас сервисом, сохраняются. Для переотправки чеков после устранения проблем можно использовать метод https://developer.evotor.ru/docs/api_v1_callback_reset.html
{
"fiscalization": {
"receipt_uuid": "c2b8f7b6-f6cc-47fe-bf63-f9c2bf795a23",
"device_time": "2024-02-26T12:07:45.000+00:00",
"fiscalized": true,
"error_message": null,
"user_id": "01-000000003879870",
"device_id": "352398085953570",
"fiscalization_info": {
"sessionNumber": 15,
"fnNumber": "9999078902014628",
"creationDate": "1684505160000",
"creationDateFormatted": "20230519T1706",
"fiscalDocumentNumber": "112",
"kktRegistrationNumber": "68",
"fiscalDocumentAttribute": "379262307"
}
},
"receipt": {
"client_email": "test@ya.ru",
"user_id": "01-000000003879870",
"cashier_uuid": "20201015-8BDE-4059-800A-D8FC74F5DDA5",
"payment_type": "COMBO_PAY",
"receipt_uuid": "c2b8f7b6-f6cc-47fe-bf63-f9c2bf795a23",
"operation_type": "SELL",
"payment_place": "Бирюлёвская ул., 19, Москва, Россия, 115404",
"payment_address": "Бирюлёвская ул., 19, Москва, Россия, 115404",
"should_print_receipt": true,
"total_sum": "48.6",
"payments": [
{
"uuid": "a77d1f2b-9de5-4d59-ac53-314f4247c6d3",
"amount": 30,
"payment_type": "ADVANCE"
},
{
"uuid": "a88d1f8b-8de8-4d59-ac53-314f4247c6d3",
"amount": 30,
"payment_type": "CASH"
}
],
"positions": [
{
"position_uuid": "5d4c79d6-3a27-48dc-a434-9b2343aa99a4",
"price": "60",
"name": "Тыква",
"measureName": "шт",
"precision": 100,
"quantity": 1,
"tax": "NO_VAT",
"type": "NORMAL",
"settlement_method_type": "FULL"
}
],
"tapOnPhoneRefId": "0d0c79d6-3a27-48dc-a434-9b2343aa99a0",
"reference_number": "1"
}
}
Фискальный объект
Уникальный идентификатор чека
Время устройства
Статус фискализации
Причина ошибки фискализации
Идентификатор пользователя в базе данных Эвотор. Чтобы получить его, обратитесь с запросом на mk@evotor.ru. В письме опишите сценарий использования API.
Идентификатор кассы. Чтобы получить его, используйте запрос GET mobilecashier.evotor.ru/api/v2/market/user/{userId}/devices.
Объект с информацией о фискальных данных чека
Номер сессии
Номер фискального накопителя
Дата и время фискализации неформатированные (можно игнорировать)
Дата и время фискализации
Фискальный номер документа
Номер ККТ
Фискальный номер атрибута
Объект чека
Идентификатор пользователя в базе данных Эвотор. Чтобы получить его, обратитесь с запросом на mk@evotor.ru. В письме опишите сценарий использования API.
Уникальный идентификатор транзакции Tap on phone
email, куда отправлен эл. чек
Номер телефона, куда отправлена СМС с электронным чеком.
Идентификатор сотрудника. Чтобы получить его, используйте запрос GET mobilecashier.evotor.ru/api/v2/market/user/{userId}/staff.
Способ оплаты:
CASH
— Наличными;QR_PAY
— «Плати QR» от Сбера;TAP_ON_PHONE
— Сервис «Tap On Phone» от Сбера;ELECTRON
— Безналичная оплата через автономный терминал эквайринга;COMBO_PAY
— Комбинированная оплата, в том числе оплата с зачетом аванса.Способ оплаты:
SELL
— Продажа;PAYBACK
— Возврат.Место расчета
Адрес расчета
Был ли напечатан чек
Итоговая сумма
В случае operation_type = PAYBACK (возврат), уникальный идентификатор чека, по которому происходит возврат средств.
Идентификатор места деятельности субъекта обращения в ИС МДЛП (при продаже лекарств)
Произвольный комментарий, не печатается на чеке и отображается только в приложении.
Скидка на чек в рублях
Уникальный идентификатор чека.
Массив с платежами пользователя. Заполняется, если значение параметра payment_type в объекте receipt равняется COMBO_PAY.
Идентификатор платежа
Тип оплаты:
CASH
— Наличными;TAP_ON_PHONE
— Сервис «Tap On Phone» от Сбера;ELECTRON
— Безналичная оплата через автономный терминал эквайринга;ADVANCE
— Авансовый платеж при пробитии закрывающего (итогового) чека.Сумма платежа
Идентификатор транзакции tap on phone
Массив с объектами позиций
Идентификатор позиции
Стоимость позиции
FULL
— Полный расчет;ADVANCE_PAYMENT
— Аванс.Наименование позиции
Единица измерения
Количество товара
NO_VAT
— Без НДС;VAT_0
— Основная ставка НДС 0%;VAT_10
— Основная ставка НДС 10%;VAT_10_110
— Расчётная ставка НДС 10%;VAT_18
— Основная ставка НДС 20%;VAT_18_118
— Расчётная ставка НДС 20%.Тип товара:
NORMAL
— Обычный;WATER_MARKED
— Бутилированная питьевая вода;DAIRY_MARKED
— Молоко и молочная продукция;JUICE_MARKED
— Соки и безалкогольные напитки;ALCOHOL_MARKED
— Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
— Немаркированный алкоголь;TOBACCO_MARKED
— Маркированный табак;SHOES_MARKED
— Маркированная обувь;MEDICINE_MARKED
— Маркированные лекарства;MEDICAL_DEVICES_MARKED
— Медицинские изделия;WHEELCHAIRS_MARKED
— Кресла-коляски;SEVICE
— Услуга;PERFUME_MARKED
— Маркированные духи;PHOTOS_MARKED
— Маркированная фотоаппаратура;TYRES_MARKED
— Маркированные шины;LIGHT_INDUSTRY_MARKED
— Маркированная продукция легкой промышленности;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;TOBACCO_PRODUCTS_MARKED
— Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;JEWELRY_MARKED
— Маркированные ювелирные изделия.Код маркировки
Массив с кодами маркировки, количество кодов равняется количеству товара.
Количество товара в упаковке (при частичной продаже)
Данные по импорту при продаже юр.лицу
Код страны происхождения
Номер таможенной декларации
Номер акциза
Информация об агенте и поставщике
Тип агента
ИНН поставщика
Телефон поставщика
Телефон агента
Телефон субагента
Операция агента (текстовое поле)
Наименование оператора перевода
ИНН оператора перевода
Телефон оператора перевода
Адрес оператора перевода
Телефон оператора по приему платежей
Наименование поставщика
Cтоимость единицы позиции со скидкой.
Признак подакцизности товара (для сладких напитков).
Разрешение на частичную продажу для определенных типов товаров (Табачная продукция, Лекарства, Парфюмерия):
NEVER
— никогда;ALWAYS
— всегда;ON_DEMAND
— иногда;null
— для товара, не подходящего под частичную продажу.Сумма предоплаты.