API кассовых чеков

Отправка чека

POST https://code-qr.ru/api/receipt/add

Входные параметры

Параметр Тип Описание
Обязательные
i int ФД
fn int ФН
fp int ФП (ФПД)
s float Сумма чека
t string Время, формат 2024-12-18 16:52:00
Необязательные
folder_id int Папка (название промо-акции), в которую добавить чек

Ответ

{
  "success": true,
  "hash": "520355e64be0a83c93e82424b32c48f1"
}
Параметр Тип Описание
success bool Статус ответа
hash string Номер чека для получения результата проверки

Ошибки

{
    "success": false,
    "message": "Введите ФД"
}

Отправка изображения чека

POST https://code-qr.ru/api/receipt/add-image

Входные параметры

Параметр Тип Описание
Обязательные
url string Ссылка на изображение чека
Необязательные
folder_id int Папка (название промо-акции), в которую добавить чек

Ответ

{
  "success": true,
  "hash": "520355e64be0a83c93e82424b32c48f1"
}
Параметр Тип Описание
success bool Статус ответа
hash string Номер чека для получения результата проверки

Ошибки

{
    "success": false,
    "message": "Расширение файла jpg или png"
}

Отправка чека из QR-кода

POST https://code-qr.ru/api/receipt/add-qr

Входные параметры

Параметр Тип Описание
Обязательные
qr string Ссылка из QR-кода чека
Необязательные
folder_id int Папка (название промо-акции), в которую добавить чек

Ответ

{
  "success": true,
  "hash": "520355e64be0a83c93e82424b32c48f1"
}
Параметр Тип Описание
success bool Статус ответа
hash string Номер чека для получения результата проверки

Ошибки

{
    "success": false,
    "message": "Расширение файла jpg или png"
}

Получение чека

GET https://code-qr.ru/api/receipt/info

Входные параметры

Параметр Тип Описание
Обязательные
hash string Номер чека

Ответ

{
  "success": true,
  "t": "20.03.2019 23:03",
  "fn": 9251440300007971,
  "i": 141637,
  "fp": 4087570038,
  "s": "5 803.00",
  "status": "done",
  "error": "",
  "result": {
    "address": "196084,СПб,Лиговский пр-т,д.283,лит.А ----------------------------------------",
    "user": "ООО \"Лента\"",
    "user_inn": "7814148471",
    "prepaid": 2251,
    "cash": 0,
    "ecash": 0,
    "prepaid_formated": "2 251.00",
    "cash_formated": "0.00",
    "ecash_formated": "0.00",
    "nds10": "295.21",
    "nds18": "425.99",
    "items": [
      {
        "name": "Пакет ЛЕНТА средний майка 12кг",
        "quantity": 2,
        "price": 6.45,
        "sum": 12.90
      },
      {
        "name": "Молоко сгущ ЛЮБ КЛАС с кл эт ГОСТ дп270",
        "quantity": 1,
        "price": 84.48,
        "sum": 84.48
      },
      {
        "name": "Кревет FINET кор в/п с/г в/м 40-50 1кг",
        "quantity": 2,
        "price": 379.49,
        "sum": 758.98
      },
      {
        "name": "Смесь SMART&EASY ов мексикан стил 600г",
        "quantity": 1,
        "price": 170.89,
        "sum": 170.89
      },
      {
        "name": "Пельмени МИРАТОРГ из мрам говяд катБ800г",
        "quantity": 1,
        "price": 454.56,
        "sum": 454.56
      },
      {
        "name": "Молоко СВЕЖЕЕ ЗАВТРА у/п пит 3,2% 500г",
        "quantity": 1,
        "price": 51.83,
        "sum": 51.83
      },
      {
        "name": "Жев. резинка ORBIT Bubblemint XXL 20,4г",
        "quantity": 1,
        "price": 32.27,
        "sum": 32.27
      },
      {
        "name": "Чернослив 365 ДНЕЙ 500г",
        "quantity": 1,
        "price": 174.39,
        "sum": 174.39
      },
      {
        "name": "Пицца-мини FUGERS Салями 320г",
        "quantity": 1,
        "price": 113.92,
        "sum": 113.92
      },
      {
        "name": "Рис PROSTO Краснодарский 62,5г*8пак 500г",
        "quantity": 1,
        "price": 41.77,
        "sum": 41.77
      },
      {
        "name": "Семга ЛЕНТА филе-кусок с/с в/у 200г",
        "quantity": 1,
        "price": 208.85,
        "sum": 208.85
      },
      {
        "name": "Клубника свежая 250г",
        "quantity": 1,
        "price": 189.87,
        "sum": 189.87
      },
      {
        "name": "Рис УВЕЛКА Басмати 80г*5 пак 400г",
        "quantity": 1,
        "price": 91.14,
        "sum": 91.14
      },
      {
        "name": "Колбаса ОСТАНКИНО салями мелкозер с/к120",
        "quantity": 1,
        "price": 73.09,
        "sum": 73.09
      },
      {
        "name": "Рис УВЕЛКА Жасмин 80г*5 пак 400г",
        "quantity": 1,
        "price": 91.14,
        "sum": 91.14
      },
      {
        "name": "Лимоны  вес  1кг",
        "quantity": 0.416,
        "price": 80.69,
        "sum": 33.57
      },
      {
        "name": "Авокадо 1шт",
        "quantity": 3,
        "price": 80.69,
        "sum": 242.07
      },
      {
        "name": "Сыр VALIO Российский п/тв 50% нар 120г",
        "quantity": 2,
        "price": 123.41,
        "sum": 246.82
      },
      {
        "name": "Лук Эконом  вес 1кг",
        "quantity": 0.564,
        "price": 21.73,
        "sum": 12.26
      },
      {
        "name": "Варенье РАТИБОР Вишня 680г",
        "quantity": 1,
        "price": 236.39,
        "sum": 236.39
      },
      {
        "name": "Чай трав ТРАВЫ И ПЧЕЛЫ апельс/мелис20пак",
        "quantity": 1,
        "price": 189.87,
        "sum": 189.87
      },
      {
        "name": "Говядина МИРАТОРГ мяк бедра охл в/у 800г",
        "quantity": 1,
        "price": 379.75,
        "sum": 379.75
      },
      {
        "name": "Ср-во д/пос FAIRY Неж руки чай.д+мят900",
        "quantity": 1,
        "price": 110.12,
        "sum": 110.12
      },
      {
        "name": "Макароны LA MOLISANA 15 Spaghetti 500г",
        "quantity": 1,
        "price": 142.40,
        "sum": 142.40
      },
      {
        "name": "Творог ЛЕНТА 9% 180г",
        "quantity": 2,
        "price": 54.11,
        "sum": 108.22
      },
      {
        "name": "Шоколад KITKAT Молоч с  хруст ваф 202г",
        "quantity": 1,
        "price": 94.93,
        "sum": 94.93
      },
      {
        "name": "Груша Вильямс 1кг",
        "quantity": 0.866,
        "price": 104.42,
        "sum": 90.43
      },
      {
        "name": "Хлеб КАРАВАЙ Дарницкий рж/пш пол 375г",
        "quantity": 1,
        "price": 26.57,
        "sum": 26.57
      },
      {
        "name": "Салфетки 365 ДНЕЙ 24*24см 1-сл. 100шт",
        "quantity": 1,
        "price": 16.13,
        "sum": 16.13
      },
      {
        "name": "Салат листовой в горшочке (Россия) 1шт",
        "quantity": 1,
        "price": 37.30,
        "sum": 37.30
      },
      {
        "name": "Сыр TIROLEZ горгонзолла  гол плес 60%100",
        "quantity": 1,
        "price": 124.36,
        "sum": 124.36
      },
      {
        "name": "Губка д/посуды 365 ДНЕЙ больш90х63х25мм",
        "quantity": 1,
        "price": 12.17,
        "sum": 12.17
      },
      {
        "name": "Салфетки ЛЕНТА целлюлозные  15х15 см 3шт",
        "quantity": 1,
        "price": 53.15,
        "sum": 53.15
      },
      {
        "name": "Печенье MILKA с овс хлоп и мол шок 168 г",
        "quantity": 1,
        "price": 138.70,
        "sum": 138.70
      },
      {
        "name": "Яйцо курин РОСКАР стол Экстра С0 10шт",
        "quantity": 1,
        "price": 79.74,
        "sum": 79.74
      },
      {
        "name": "Томаты сливовидные розовые на ветке 450г",
        "quantity": 1,
        "price": 170.88,
        "sum": 170.88
      },
      {
        "name": "Ролл КАРАВАЙ пшеничный  200г",
        "quantity": 1,
        "price": 35.98,
        "sum": 35.98
      },
      {
        "name": "Капуста брокколи вес 1кг",
        "quantity": 0.378,
        "price": 322.77,
        "sum": 122.01
      },
      {
        "name": "Прокладки SECRETDAY 24,5см 16шт",
        "quantity": 1,
        "price": 128.64,
        "sum": 128.64
      },
      {
        "name": "Шоколад RITTER SPORT Молоч. с ромом 100г",
        "quantity": 1,
        "price": 61.70,
        "sum": 61.70
      },
      {
        "name": "Чай TWININGS Эрл Грей /ар берг 25пак 50г",
        "quantity": 1,
        "price": 170.88,
        "sum": 170.88
      },
      {
        "name": "Т/бумага ZEWA Плюс Белая 2-сл.12шт",
        "quantity": 1,
        "price": 187.88,
        "sum": 187.88
      }
    ]
  }
}
Параметр Тип Описание
status string Статус проверки:
  • done - Чек проверен
  • wait - В очереди на проверку
  • process - Идет проверка
  • error - Ошибка
error string Ошибка:
  • Чек не валиден или любая внутренняя ошибка hsm
  • Ошибка получения изображения чека
  • Ошибка поиска QR-кода на изображения чека

Комментарий к сумме чека

  • prepaid - зачет авансового платежа
  • cash - оплата наличными
  • ecash - безналичная постоплата

Ошибки

{
    "success": false,
    "message": "Чек не найден"
}