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}
Запрос должен включать в себя заголовок авторизации, содержащий Bearer Token.
Идентификатор пользователя в базе данных Эвотор. Чтобы получить его, обратитесь с запросом на mk@evotor.ru. В письме опишите сценарий использования API.
Параметры отсутствуют.
{
"receipt_uuid": "547e108b-94d2-42dd-add5-9fb1e5137450",
"positions": [
{
"position_uuid": "e5f8b835-140c-4be3-9648-b7842988cb61",
"price": 99.0,
"name": "Капучино 350мл",
"measureName": "шт",
"precision": 100,
"quantity": 2,
"tax": "VAT_18",
"commodity_id": "e5f8b835-140c-4be3-9648-b7842988cb69",
"mark": null,
"marks": null,
"type": "NORMAL",
"tare_volume": 350,
"alcohol_product_kind_code": null,
"alcohol_by_volume": null,
"settlement_method_type": "FULL",
"priceWithDiscount": null,
"code": null,
"importation_data": null,
"is_excisable": true,
"agentInfo": {
"type": "AGENT",
"principal_inn": "7710044110",
"principal_name": "Вкусно и точка",
"principal_phone": "+79997776655"
}
}
],
"client_email": "d@mail.ru",
"client_phone": "+79997776665",
"payment_type": "CASH",
"cashier_uuid": "20210810-C581-40C6-8093-3C6D0C033D07",
"should_print_receipt": true,
"extra": {"Клиент": "Петров Иван", "НомерЗаказа": "000000"}
"editable": true,
"purchaser": {
"name": "Петров Алексей Сидорович",
"document_number": "123456677",
"type": "NATURAL_PERSON",
"birth_date": "25.05.1989",
"document_type": "PASSPORT_RF(21)",
"inn_number": "771004411000"
},
"mdlp": null,
"receiptDiscount": null,
"note": "Акция 2 по цене 1",
"order_number": "111222333",
"device_id": "999900000002295",
"order_code": null
}
Уникальный идентификатор чека
Позиции заказа
Уникальный идентификатор позиции. Если не передан, то генерируется на нашей стороне.
Объём алкогольной тары.
Крепость алкоголя.
Признак способа расчёта. Возможные значения:
FULL
– Полная оплата;ADVANCE_PAYMENT
– Аванс;FULL_PREPAYMENT
– Полная предоплата;PARTIAL_PREPAYMENT
– Частичная предоплата.Код товара.
Цена за единицу товара.
Сумма предоплаты — Указывается только при частичной предоплате.
Объект данных для импорта.
Код страны происхождения. Минимальная длина — 1 символ, Максимальная длина — 3 символа.
Номер таможенной декларации.
Акциз.
Цена одной позиции со скидкой
Указывает, является ли товар подакцизным:
true
– Товар подакцизный;false
– Товар не подакцизный.
Значение по умолчанию, если не передан: false
.
Признак is_excisable применим только для товаров с типом TOBACCO_PRODUCTS_MARKED, NORMAL, BEER_MARKED, BEER_MARKED_KEG,ALCOHOL_MARKED, ALCOHOL_NOT_MARKED и JUICE_MARKED. При этом его можно проставить и для других товарных групп через api облака, но при загрузке карточки товара на терминал признак будет проигнорирован..
Наименование товара. До 128 символов.
Единицы измерения товара
Количество товара. Целая часть до 5 символов, дробная часть до 3 символов, они отделяются точкой, максимальное значение 99 999.999.
NO_VAT
VAT_0
VAT_10
VAT_10_110
VAT_18
VAT_18_118
Тип налогообложения:
NO_VAT
– Без НДС;VAT_0
– Основная ставка НДС 0%;VAT_10
– Основная ставка НДС 10%;VAT_10_110
– Расчётная ставка НДС 10%;VAT_18
– Основная ставка НДС 20%;VAT_18_118
– Расчётная ставка НДС 20%.Идентификатор позиции в товароучётной системе
Код маркировки, если имеется. По умолчанию null
NORMAL
WATER_MARKED
DAIRY_MARKED
ALCOHOL_MARKED
BEER_MARKED_KEG
ALCOHOL_NOT_MARKED
TOBACCO_MARKED
SHOES_MARKED
MEDICINE_MARKED
SERVICE
PERFUME_MARKED
PHOTOS_MARKED
LIGHT_INDUSTRY_MARKED
TYRES_MARKED
JEWELRY_MARKED
Тип товара:
NORMAL
– Обычный;WATER_MARKED
– Бутилированная питьевая вода;DAIRY_MARKED
— Молоко и молочная продукция;JUICE_MARKED
— Соки и безалкогольные напитки;ALCOHOL_MARKED
– Маркированный алкоголь;BEER_MARKED_KEG
— Маркированное пиво (Кеги);BEER_MARKED
— Маркированное пиво;ALCOHOL_NOT_MARKED
– немаркированный алкоголь;TOBACCO_MARKED
– Маркированный табак (сигареты);SHOES_MARKED
– Маркированная обувь;MEDICINE_MARKED
– Маркированные лекарства;WHEELCHAIRS_MARKED
— Кресла-коляски;SERVICE
– Услуга;PERFUME_MARKED
– Маркированные духи;PHOTOS_MARKED
– Маркированная фотоаппаратура;MEDICAL_DEVICES_MARKED
– Маркированные медицинские изделия;TYRES_MARKED
– Маркированные шины;LIGHT_INDUSTRY_MARKED
– Маркированная продукция легкой промышленности;DIETARY_SUPPLEMENTS_MARKED
— БАДы (биоактивные добавки);ANTISEPTIC_MARKED
— Антисептики;TOBACCO_PRODUCTS_MARKED
– Маркированный альтернативный табак (сигары, кретек, кальянный табак и т.д.). Никотиносодержащая продукция (стики, жидкости и капсулы для электронных сигарет, курительные смеси для кальяна, не содержащие табак), в том числе безникотиновая продукция, согласно ППРФ от 30.11.2022 №2178;JEWELRY_MARKED
— Маркированные ювелирные изделия.Код вида алкогольной продукции согласно Классификатору видов продукции ФСРАР. По умолчанию null
Объект с агентскими реквизитами
AGENT
– Агент;COMMISSIONER
– Комиссионер;ATTORNEY_IN_FACT
– Поверенный;PAYMENT_AGENT
– Платёжный агент;BANK_PAYMENT_AGENT
– Банковский платёжный агент;PAYMENT_SUBAGENT
– Платёжный субагент;BANK_PAYMENT_SUBAGENT
– Банковский платёжный субагент.ИНН поставщика. 10 или 12 цифр.
Наименование поставщика. До 256 символов.
Телефон поставщика. Номер телефона должен начинаться с одной из цифр — 9/8/+7. Если начинается с 9, то формат 10 цифр. Если начинается с 8, то формат 11 цифр. Если начинается с +7, то формат + и 11 цифр.
Телефон агента. Обязателен для всех, кроме AGENT
, COMMISSIONER
, ATTORNEY_IN_FACT
.
Телефон субагента. Обязателен для BANK_PAYMENT_SUBAGENT
и PAYMENT_SUBAGENT
.
Операция агента. Обязателен для BANK_PAYMENT_SUBAGENT
.
Наименование оператора перевода. Обязателен для BANK_PAYMENT_SUBAGENT
.
ИНН оператора перевода. Обязателен для BANK_PAYMENT_SUBAGENT
.
Телефон оператора перевода. Обязателен для BANK_PAYMENT_SUBAGENT
.
Адрес оператора перевода. Обязателен для BANK_PAYMENT_SUBAGENT
.
Телефон оператора по приёму платежей . Обязателен для PAYMENT_SUBAGENT
.
Отраслевой реквизит предмета расчёта. Используется при онлайн проверке кода маркировки в системе “Честный Знак”. Если указан, то остальные поля объекта должны быть заполнены. Если не указан, то приложение “Мобильный кассир” не передаст в чек результат онлайн проверки марки
Идентификатор ФОИВ. Передавайте значение “030”.
Дата документа основания. Формат “ДД.ММ.ГГГГ”. Передавайте значение “21.11.2023”.
Номер документа основания (Максимум 32 символа). Передавайте значение “1944”.
Значение отраслевого реквизита (Максимум 256 символов). Передавайте значение в формате”UUID=&Time=”, где UUID - reqId, а Time - reqTimestamp из ответа метода онлайн проверки марки у “Честного знака”.
Мониторинг движения лекарственных препаратов.
Уникальный идентификатор кассы. Используется для определения кассы, на которой будет пробит чек по заказу. Если не передан, по умолчанию используется та касса, на которой авторизован сотрудник в мобильном приложении. Чтобы получить его, используйте запрос GET mobilecashier.evotor.ru/api/v2/market/user/{userId}/devices.
Телефон покупателя. Для успешной фискализации нужен телефон или email покупателя. Номер телефона должен начинаться с одной из цифр — 9/8/+7. Если начинается с 9, то формат 10 цифр. Если начинается с 8, то формат 11 цифр. Если начинается с +7, то формат + и 11 цифр.
Email покупателя. Для успешной фискализации нужен телефон или email покупателя. Если переданы оба параметра, в чек запишется почта. До 64 символов
Идентификатор сотрудника. Чтобы его получить, используйте запрос GET mobilecashier.evotor.ru/api/v2/market/user/{userId}/staff.
Настройки печати чека: true
— напечатать чек, false
— не печатать чек.
Признак редактирования заказа, если false
- заказ на смартфоне недоступен для редактирования.
Номер заказа. Используется только в заказе, в чек не передается.
Дополнительные поля. Произвольный набор полей, не больше 10 в объекте.
Реквизиты покупателя. Необязательно для торговли с физ. лицами. По закону реквизиты нужны только для расчётов с юр. лицами.
ФИО физического лица или название компании. До 256 символов.
Дата рождения
Тип документа:
PASSPORT_RF(21)
— Паспорт гражданина РФ, дипломатический паспорт, служебный паспорт, удостоверяющий личность гражданина Российской Федерации за пределами РФ;PASSPORT_DIPLOMATIC(22)
— Временное удостоверение личности гражданина Российской Федерации, выдаваемое на период оформления паспорта гражданина РФ.TEMP_IDENTIFICATION(26)
— Свидетельство о рождении гражданина РФ (для граждан Российской Федерации в возрасте до 14 лет).BIRTH_CERTIFICATE(27)
— Иные документы, признаваемые документами, удостоверяющими личность гражданина РФ в соответствии с законодательством РФ.OTHER_IDENTITY_DOC_RF(28)
— Паспорт иностранного гражданина.
PASSPORT_FOREIGN_CITIZEN(31)
— Иные документы, признаваемые документами,удостоверяющими личность иностранного гражданина в соответствии с законодательством РФ и международным договором РФ.OTHER_DOC_FOREIGN_CITIZEN_RECOGNIZED_RF(32)
— Документ, выданный иностранным государством и признаваемый в соответствии с международным договором РФ в качестве документа,удостоверяющего личность лица без гражданства.DOC_BY_FOREIGN_STATE_TO_STATELESS_PERSON(33)
— Вид на жительство (для лиц без гражданства).RESIDENT_CARD(34)
— Разрешение на временное проживание (для лиц без гражданства).TEMP_RESIDENCE_PERMIT(35)
— Свидетельство о рассмотрении ходатайства о признании лица без гражданства беженцем на территории РФ по существу.APP_REVIEW_CERTIFICATE_RECOGNITION_REFUGEE_PERSON_RF(36)
— Удостоверение беженца.REFUGEE_IDENTIFICATION(37)
— Иные документы, признаваемые документами, удостоверяющими личность лиц без гражданства в соответствии с законодательством РФ и международным договором РФ.OTHER_IDENTITY_DOC_STATELESS_PERSONS(38)
— Документ, удостоверяющий личность лица, не имеющего действительного документа, удостоверяющего личность, на период рассмотрения заявления о признании гражданином РФ или о приеме в гражданство РФ.DOC_FOR_PERIOD_OF_CONSIDERATION_CITIZENSHIP_RF(40)
Номер документа
ИНН физ.лица, ИП или юр.лица. Для физ.лица указывается либо ИНН, либо номер документа, тип документа и дата рождения (формат 25.05.1989)
NATURAL_PERSON
ENTREPRENEUR
LEGAL_ENTITY
Тип покупателя:
NATURAL_PERSON
— Физическое лицо;ENTREPRENEUR
— Индивидуальный предприниматель;LEGAL_ENTITY
— Юридическое лицо.Итоговая скидка на чек
Произвольный комментарий, не печатается на чеке и отображается только в приложении
Успешно
Неправильный синтаксис запроса. Измените запрос перед повторным выполнением. Некорректный параметр указан в тексте ошибки.
Ошибка авторизации приложения.
Запрашиваемый ресурс не найден.
Передан неуникальный receipt_uuid
, который уже сохранен в системе.