API документация по чекам версии ФФД 1.2 (последняя версия)

 

 

Получение токена (Авторизация)

Описание: Метод для получения токена авторизации, необходимого для использования других методов API.

URL: https://app.ecomkassa.ru/fiscalorder/v5/getToken
Метод: POST
Заголовки: Content-Type: application/json; charset=utf-8
Тело запроса:
{
    "login": "sales@ecomkassa.ru",
    "pass": "ecomkassa1"
}

Описание параметров

Параметр Тип Описание
login string Логин пользователя для авторизации
pass string Пароль пользователя для авторизации
Успешный ответ:
{
    "code": 0,
    "text": "",
    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxLU5vTkFiNkN2bVVDXC9GMFJTVnF5cUtCNFBrcGp5R0RIaFV6V3k4b1Q3a3UzdkZYZWNLK0Q2ZEFsNmExM3ZTMG1kR0twS1wvYU9telZ0SXFhemJyZDdzVWZ5Y0xtT3BKeWI4RERJWWZEU1MrQT09IiwiaXNzIjoiYXBwLmVjb21rYXNzYS5ydSIsImV4cCI6MTczMDg0MTkwNiwiaWF0IjoxNzMwNzU1NTA2LCJqdGkiOiJkZTJlOGM0N2VhNzc2YTQ0NTA2MTk4NDA0ZWU4NzIwNzBkODg2NzU0ZTFlZjlkMWRhZTI4OTZmZTIxMmY2MjhhYzcxYzFiMmY1MGU5ZjdiZTc3ODM1NDM0MWNlMGQ2YWJiNmFlOTUxMzRiOTEyNWVmZWE3NmZhYjEwOWRmMzQ2MmQ0OTcyYmZkYzJjYWQ2ZTQzNmNjZTMyMTY2YTUzMjgzOTY1NTk2NmM4ZDJjNzI1MGExN2Q0OTE1YmUwNmRiMzAxYzY4NDg4YWIxNTYxNjlhZDk5NjcxNGRiZWYwMTQ2ZWIyZTE1ODkwYjI2NWYzYmM2MTdmY2EwYjFlNGM2YTM3In0.XZDZCp048GUyeP0dK1Buod6RgEv2M8cskfiEAkkWvs0"
}

Статус чека

Описание: Получает статус конкретного чека.

URL: https://app.ecomkassa.ru/fiscalorder/v5/700/report/93316864
Метод: GET
Заголовки: Content-Type: application/json; Token: {ваш токен}

Описание параметров

Запрос не требует дополнительных параметров в теле.

Успешный ответ:
{
    "uuid": "93316864",
    "external_id": "000Т-011713",
    "error": null,
    "kind": "CASH_VOUCHER_V3",
    "status": "done",
    "payload": {
        "total": 15,
        "fn_number": "9999078902016832",
        "shift_number": 161,
        "receipt_datetime": "02.11.2024 07:21:50",
        "fiscal_receipt_number": 2,
        "fiscal_document_number": 2326,
        "ecr_registration_number": "0000000002040436",
        "fiscal_document_attribute": 490637464,
        "fns_site": "nalog.gov.ru",
        "ofd_inn": "7704211201"
    },
    "timestamp": "05.11.2024 11:20:04",
    "group_code": "700",
    "permalink": "http://app.ecomkassa.ru/public/order/93316864/0c4c2cbf76aca4df01f2e050917fbb5c",
    "daemon_code": "",
    "device_code": "",
    "callback_url": ""
}

 

 

Создание чека

Описание: Создает новый чек с информацией о клиенте, компании и покупке.

URL: https://app.ecomkassa.ru/fiscalorder/v5/700/sell
Метод: POST
Заголовки: Content-Type: application/json; Token: {ваш токен}
Тело запроса:
{
"timestamp": "24.09.2022 5:34:01",
"external_id": "Ч1Р.2mu897u098097669856776mmm2-00УТ-102633",
"receipt": {
"client": {
"name": "Червякова Наталья",
"email": "help@ecomkassa.ru",
"phone": "+79127641910"
},
"company": {
"payment_address": "https://rusexpress.ru",
"inn": "540320139963",
"sno": "usn_income_outcome",
"email": "info@rusexpress.ru"
},
"payments": [
{
"type": 103,
"sum": 2649
}
],
"items": [
{
"payment_method": "credit",
"vat": {
"type": "none",
"sum": 0
},
"price": 1809,
"name": "Постельное бельё Экономь и Я евро «Сумерки» 200х217 см, 215х240 см, 50х70 см-2шт",
"measure": 0,
"sum": 1809,
"quantity": 1,
"payment_object": 1,
"nomenclature_code": ""
},
{
"payment_method": "credit",
"vat": {
"type": "none",
"sum": 0
},
"price": 840,
"name": "Доставка",
"measure": 0,
"sum": 840,
"quantity": 1,
"payment_object": 3,
"nomenclature_code": ""
}
],
"total": 2649
}
}

Описание параметров

Параметр Тип Описание
timestamp string Дата и время создания чека
external_id string Уникальный идентификатор чека
client object Информация о клиенте
company object Информация о компании
payments array Массив оплат
items array Список товаров и услуг
total number Итоговая сумма чека
Успешный ответ:
{
    "uuid": "93446280",
    "timestamp": "05.11.2024 11:22:30",
    "status": "wait",
    "permalink": "http://app.ecomkassa.ru/public/order/93446280/bedc728ef2b1f5944c8691db0d1936ac",
    "error": null,
    "kind": "CASH_VOUCHER_V3"
}

 

 

Создание агентского чека

Описание: Создает новый чек с информацией о агенте, клиенте, компании и покупке.

URL: https://app.ecomkassa.ru/fiscalorder/v5/700/sell
Метод: POST
Заголовки: Content-Type: application/json; Token: {ваш токен}
Тело запроса:

{
"timestamp": "03.06.2020 12:05:31",
"external_id": "8929246543893234522512289444",
"service": {
"callback_url": "https://shop.ru"
},
"receipt": {
"client": {
"email": "client@client.ru",
"phone": "+70002410085",
"name": "Иванов Иван Иванович",
"inn": "516974792202",
"birthdate": "18.11.1990",
"citizenship": "643",
"document_code": "21",
"document_data": "4507 443564",
"address": "г.Москва, Ленинский проспект д.1 кв 43"
},
"company": {
"email": "email@ofd.ru",
"sno": "osn",
"inn": "5010051677",
"payment_address": "shop-url.ru"
},

"items": [{
"name": "Ваш любимый товар1",
"price": 120,
"quantity": 1.0,
"measure": 0,
"sum": 120,
"payment_method": "full_payment",
"payment_object": 1,
"vat": {
"type": "vat20",
"sum": 20.0

},


"agent_info": {
"type": "another",
"paying_agent": {
"operation": "Операция 1",
"phones": ["+79998887766"]
},

"receive_payments_operator": {
"phones": ["+79998887766"]
},

"money_transfer_operator": {
"phones": ["+79998887766"],
"name": "Оператор перевода",

"address": "г. Москва, ул. Складочная д.3",
"inn": "8634330204"
}
},
"supplier_info": {
"phones": ["+79998887766"],
"name": "Название поставщика",
"inn": "287381373424"
}
}
],
"payments": [{
"type": 1,
"sum": 120.0
}
],
"vats": [{
"type": "vat20",
"sum": 20.0
}
],
"cashier": "кассир",
"cashier_inn": "887405485310",
"additional_check_props": "445334544",
"total": 120.0,
"additional_user_props": {
"name": "название доп реквизита",
"value": "значение доп реквизита"
},
"operating_check_props": {

"name": "0",
"value": "данные операции",
"timestamp": "03.11.2020 12:05:31"
},
"sectoral_check_props": [{
"federal_id": "001",
"date": "18.11.2020",
"number": "123/43",
"value": "Ид1=Знач1&Ид2=Знач2&Ид3=Знач3"
}
]
}
}
Параметр Тип Описание
timestamp string Дата и время создания чека
external_id string Уникальный идентификатор чека
client object Информация о клиенте
company object Информация о компании
payments array Массив оплат
items array Список товаров и услуг
total number Итоговая сумма чека
Успешный ответ:
{
    "uuid": "93446280",
    "timestamp": "05.11.2024 11:22:30",
    "status": "wait",
    "permalink": "http://app.ecomkassa.ru/public/order/93446280/bedc728ef2b1f5944c8691db0d1936ac",
    "error": null,
    "kind": "CASH_VOUCHER_V3"
}

 

 

 

Создание чека с маркировкой

Описание: Создает новый чек с информацией о маркировке, клиенте, компании и покупке.

URL: https://app.ecomkassa.ru/fiscalorder/v5/700/sell
Метод: POST
Заголовки: Content-Type: application/json; Token: {ваш токен}
Тело запроса:

{
"timestamp": "03.06.2020 12:05:31",
"external_id": "8929246543893234522512289444",
"service": {
"callback_url": "https://shop.ru"
},
"receipt": {
"client": {
"email": "client@client.ru",
"phone": "+70002410085",
"name": "Иванов Иван Иванович",
"inn": "516974792202",
"birthdate": "18.11.1990",
"citizenship": "643",
"document_code": "21",
"document_data": "4507 443564",
"address": "г.Москва, Ленинский проспект д.1 кв 43"
},
"company": {
"email": "email@ofd.ru",
"sno": "osn",
"inn": "5010051677",
"payment_address": "shop-url.ru"
},

"items": [{
"name": "Ваш любимый товар1",
"price": 120,
"quantity": 1.0,
"measure": 0,
"sum": 120,
"payment_method": "full_payment",
"payment_object": 1,
"vat": {
"type": "vat20",
"sum": 20.0

},
"user_data": "Дополнительный реквизит предмета расчета",
"excise": 10.0,
"country_code": "056",
"declaration_number": "12332234533",
"mark_quantity": {
"numerator": 1,
"denominator": 2

},
"mark_processing_mode": "0",
"sectoral_item_props": [{
"federal_id": "001",
"date": "18.11.2020",
"number": "123/43",
"value": "Ид1=Знач1&Ид2=Знач2&Ид3=Знач3"

}
],
"mark_code": "MDEwNDY4MDA0NjI3MzI2MDIxNWo8O2xiNEc9aldPYx9kOTFFRTA4H2Q5MklRU25hZG9Gbm9SRkZYMzZjbzMwM01zYlVMRWdhWXpFTGFMRkcvNFJUL2c9"
},
"agent_info": {
"type": "another",
"paying_agent": {
"operation": "Операция 1",
"phones": ["+79998887766"]
},

"receive_payments_operator": {
"phones": ["+79998887766"]
},

"money_transfer_operator": {
"phones": ["+79998887766"],
"name": "Оператор перевода",

"address": "г. Москва, ул. Складочная д.3",
"inn": "8634330204"
}
},
"supplier_info": {
"phones": ["+79998887766"],
"name": "Название поставщика",
"inn": "287381373424"
}
}
],
"payments": [{
"type": 1,
"sum": 120.0
}
],
"vats": [{
"type": "vat20",
"sum": 20.0
}
],
"cashier": "кассир",
"cashier_inn": "887405485310",
"additional_check_props": "445334544",
"total": 120.0,
"additional_user_props": {
"name": "название доп реквизита",
"value": "значение доп реквизита"
},
"operating_check_props": {

"name": "0",
"value": "данные операции",
"timestamp": "03.11.2020 12:05:31"
},
"sectoral_check_props": [{
"federal_id": "001",
"date": "18.11.2020",
"number": "123/43",
"value": "Ид1=Знач1&Ид2=Знач2&Ид3=Знач3"
}
]
}
}
Параметр Тип Описание
timestamp string Дата и время создания чека
external_id string Уникальный идентификатор чека
client object Информация о клиенте
company object Информация о компании
payments array Массив оплат
items array Список товаров и услуг
total number Итоговая сумма чека
Успешный ответ:
{
    "uuid": "93446280",
    "timestamp": "05.11.2024 11:22:30",
    "status": "wait",
    "permalink": "http://app.ecomkassa.ru/public/order/93446280/bedc728ef2b1f5944c8691db0d1936ac",
    "error": null,
    "kind": "CASH_VOUCHER_V3"
}

 

 

 

Создание чека аванса

Описание: Создает новый чек аванса с информацией , клиенте, компании и покупке.

URL: https://app.ecomkassa.ru/fiscalorder/v5/700/sell
Метод: POST
Заголовки: Content-Type: application/json; Token: {ваш токен}
Тело запроса:
{
"timestamp": "24.09.2022 5:34:01",
"external_id": "Ч1Р.2muummm2-00УТ-102633",
"receipt": {
"client": {
"name": "Червякова Наталья",
"email": "help@ecomkassa.ru",
"phone": "+79127641910"
},
"company": {
"payment_address": "https://rusexpress.ru",
"inn": "540320139963",
"sno": "usn_income_outcome",
"email": "info@rusexpress.ru"
},
"payments": [
{
"type": 3,
"sum": 2649
}
],
"items": [
{
"payment_method": "full_prepayment",
"vat": {
"type": "none",
"sum": 0
},
"price": 1809,
"name": "Постельное бельё Экономь и Я евро «Сумерки» 200х217 см, 215х240 см, 50х70 см-2шт",
"measure": 0,
"sum": 1809,
"quantity": 1,
"payment_object": 1,
"nomenclature_code": ""
},
{
"payment_method": "full_prepayment",
"vat": {
"type": "none",
"sum": 0
},
"price": 840,
"name": "Доставка",
"measure": 0,
"sum": 840,
"quantity": 1,
"payment_object": 3,
"nomenclature_code": ""
}
],
"total": 2649
}
}


Параметр Тип Описание
timestamp string Дата и время создания чека
external_id string Уникальный идентификатор чека
client object Информация о клиенте
company object Информация о компании
payments array Массив оплат
items array Список товаров и услуг
total number Итоговая сумма чека
Успешный ответ:
{
    "uuid": "93446280",
    "timestamp": "05.11.2024 11:22:30",
    "status": "wait",
    "permalink": "http://app.ecomkassa.ru/public/order/93446280/bedc728ef2b1f5944c8691db0d1936ac",
    "error": null,
    "kind": "CASH_VOUCHER_V3"
}

 

 

 

Создание чека зачет аванса

Описание: Создает новый чек аванса с информацией , клиенте, компании и покупке.

URL: https://app.ecomkassa.ru/fiscalorder/v5/700/sell
Метод: POST
Заголовки: Content-Type: application/json; Token: {ваш токен}
Тело запроса:
{
"timestamp": "24.09.2022 5:34:01",
"external_id": "Ч1Р.2muummm2-00УТ-102633",
"receipt": {
"client": {
"name": "Червякова Наталья",
"email": "help@ecomkassa.ru",
"phone": "+79127641910"
},
"company": {
"payment_address": "https://rusexpress.ru",
"inn": "540320139963",
"sno": "usn_income_outcome",
"email": "info@rusexpress.ru"
},
"payments": [
{
"type": 3,
"sum": 2649
}
],
"items": [
{
"payment_method": "full_payment",
"vat": {
"type": "none",
"sum": 0
},
"price": 1809,
"name": "Постельное бельё Экономь и Я евро «Сумерки» 200х217 см, 215х240 см, 50х70 см-2шт",
"measure": 0,
"sum": 1809,
"quantity": 1,
"payment_object": 1,
"nomenclature_code": ""
},
{
"payment_method": "full_payment",
"vat": {
"type": "none",
"sum": 0
},
"price": 840,
"name": "Доставка",
"measure": 0,
"sum": 840,
"quantity": 1,
"payment_object": 3,
"nomenclature_code": ""
}
],
"total": 2649
}
}


Параметр Тип Описание
timestamp string Дата и время создания чека
external_id string Уникальный идентификатор чека
client object Информация о клиенте
company object Информация о компании
payments array Массив оплат
items array Список товаров и услуг
total number Итоговая сумма чека
Успешный ответ:
{
    "uuid": "93446280",
    "timestamp": "05.11.2024 11:22:30",
    "status": "wait",
    "permalink": "http://app.ecomkassa.ru/public/order/93446280/bedc728ef2b1f5944c8691db0d1936ac",
    "error": null,
    "kind": "CASH_VOUCHER_V3"
}

Создание чека кредит

Описание: Создает новый чек кредита с информацией о клиенте, компании и покупке.

URL: https://app.ecomkassa.ru/fiscalorder/v5/700/sell
Метод: POST
Заголовки: Content-Type: application/json; Token: {ваш токен}
Тело запроса:
{
"timestamp": "24.09.2022 5:34:01",
"external_id": "Ч1Р.2mu897ummm2-00УТ-102633",
"receipt": {
"client": {
"name": "Червякова Наталья",
"email": "help@ecomkassa.ru",
"phone": "+79127641910"
},
"company": {
"payment_address": "https://rusexpress.ru",
"inn": "540320139963",
"sno": "usn_income_outcome",
"email": "info@rusexpress.ru"
},
"payments": [
{
"type": 3,
"sum": 2649
}
],
"items": [
{
"payment_method": "credit",
"vat": {
"type": "none",
"sum": 0
},
"price": 1809,
"name": "Постельное бельё Экономь и Я евро «Сумерки» 200х217 см, 215х240 см, 50х70 см-2шт",
"measure": 0,
"sum": 1809,
"quantity": 1,
"payment_object": 1,
"nomenclature_code": ""
},
{
"payment_method": "credit",
"vat": {
"type": "none",
"sum": 0
},
"price": 840,
"name": "Доставка",
"measure": 0,
"sum": 840,
"quantity": 1,
"payment_object": 3,
"nomenclature_code": ""
}
],
"total": 2649
}
}

Описание параметров

Параметр Тип Описание
timestamp string Дата и время создания чека
external_id string Уникальный идентификатор чека
client object Информация о клиенте
company object Информация о компании
payments array Массив оплат
items array Список товаров и услуг
total number Итоговая сумма чека
Успешный ответ:
{
    "uuid": "93446280",
    "timestamp": "05.11.2024 11:22:30",
    "status": "wait",
    "permalink": "http://app.ecomkassa.ru/public/order/93446280/bedc728ef2b1f5944c8691db0d1936ac",
    "error": null,
    "kind": "CASH_VOUCHER_V3"
}

 

 

Создание чека коррекции

Описание: Создает новый чек коррекции с информацией о клиенте, компании и покупке.

URL: https://app.ecomkassa.ru/fiscalorder/v5/700/sell_correction
Метод: POST
Заголовки: Content-Type: application/json; Token: {ваш токен}
Тело запроса:
{
"timestamp": "24.09.2022 5:34:01",
"external_id": "Ч1Р.2muummm2-0087658753446365УТ-102633",
"correction": {
"client": {
"name": "Червякова Наталья",
"email": "help@ecomkassa.ru",
"phone": "+79127641910"
},
"company": {
"payment_address": "https://rusexpress.ru",
"inn": "540320139963",
"sno": "usn_income_outcome",
"email": "info@rusexpress.ru"
},
"correction_info": {
    "type": "self",
 "base_date": "23.11.2020",
 "base_number": "123/46533"
 },
"payments": [
{
"type": 3,
"sum": 2649
}
],
"items": [
{
"payment_method": "credit",
"vat": {
"type": "none",
"sum": 0
},
"price": 1809,
"name": "Постельное бельё Экономь и Я евро «Сумерки» 200х217 см, 215х240 см, 50х70 см-2шт",
"measure": 0,
"sum": 1809,
"quantity": 1,
"payment_object": 1,
"nomenclature_code": ""
},
{
"payment_method": "credit",
"vat": {
"type": "none",
"sum": 0
},
"price": 840,
"name": "Доставка",
"measure": 0,
"sum": 840,
"quantity": 1,
"payment_object": 3,
"nomenclature_code": ""
}
],
"total": 2649
}
}
Параметр Тип Описание
timestamp string Дата и время создания чека
external_id string Уникальный идентификатор чека
client object Информация о клиенте
company object Информация о компании
payments array Массив оплат
items array Список товаров и услуг
total number Итоговая сумма чека
Успешный ответ:
{
    "uuid": "93446280",
    "timestamp": "05.11.2024 11:22:30",
    "status": "wait",
    "permalink": "http://app.ecomkassa.ru/public/order/93446280/bedc728ef2b1f5944c8691db0d1936ac",
    "error": null,
    "kind": "CASH_VOUCHER_V3"
}

Создание чека возврат прихода

Описание: Создает новый чек возврат прихода с информацией о клиенте, компании и покупке.

URL: https://app.ecomkassa.ru/fiscalorder/v5/700/sell_refund
Метод: POST
Заголовки: Content-Type: application/json; Token: {ваш токен}
Тело запроса:
{
"timestamp": "24.09.2022 5:34:01",
"external_id": "Ч1Р.2mu897ummm2-00УТ-102633",
"receipt": {
"client": {
"name": "Червякова Наталья",
"email": "help@ecomkassa.ru",
"phone": "+79127641910"
},
"company": {
"payment_address": "https://rusexpress.ru",
"inn": "540320139963",
"sno": "usn_income_outcome",
"email": "info@rusexpress.ru"
},
"payments": [
{
"type": 3,
"sum": 2649
}
],
"items": [
{
"payment_method": "credit",
"vat": {
"type": "none",
"sum": 0
},
"price": 1809,
"name": "Постельное бельё Экономь и Я евро «Сумерки» 200х217 см, 215х240 см, 50х70 см-2шт",
"measure": 0,
"sum": 1809,
"quantity": 1,
"payment_object": 1,
"nomenclature_code": ""
},
{
"payment_method": "full_payment",
"vat": {
"type": "none",
"sum": 0
},
"price": 840,
"name": "Доставка",
"measure": 0,
"sum": 840,
"quantity": 1,
"payment_object": 3,
"nomenclature_code": ""
}
],
"total": 2649
}
}

Описание параметров

Параметр Тип Описание
timestamp string Дата и время создания чека
external_id string Уникальный идентификатор чека
client object Информация о клиенте
company object Информация о компании
payments array Массив оплат
items array Список товаров и услуг
total number Итоговая сумма чека
Успешный ответ:
{
    "uuid": "93446280",
    "timestamp": "05.11.2024 11:22:30",
    "status": "wait",
    "permalink": "http://app.ecomkassa.ru/public/order/93446280/bedc728ef2b1f5944c8691db0d1936ac",
    "error": null,
    "kind": "CASH_VOUCHER_V3"
}

Не нашли ответ?

Обратитесь в отдел сопровождения по контактам ниже