{
"info": {
"_postman_id": "6f1a6f4e-3c9a-4a3f-9a1e-chequechecker01",
"name": "ChequeChecker API",
"description": "REST API для перевірки фіскальних чеків у реєстрі Державної податкової служби України.\n\nСервіс приймає реквізити чека, звертається до реєстру ДПС, зберігає відповідь і віддає її у форматі JSON. Успішно знайдені чеки кешуються: повторний запит тих самих реквізитів обслуговується з локальної бази миттєво і **не списує баланс**.\n\n**Тарифікація.** Кожне звернення до реєстру списує з балансу 1 запит, якщо чек знайдено, і 0,5 запиту, якщо реєстр відповів помилкою. Відповідь із кешу безкоштовна. Коли залишок падає нижче 1, сервіс перестає звертатися до реєстру і повертає `success: false`.",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
},
"auth": {
"type": "basic",
"basic": [
{
"key": "username",
"value": "{{login}}",
"type": "string"
},
{
"key": "password",
"value": "{{password}}",
"type": "string"
}
]
},
"item": [
{
"name": "Чеки",
"description": "Перевірка фіскальних чеків",
"item": [
{
"name": "Отримати дані фіскального чека",
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/cheque_info",
"host": [
"{{baseUrl}}"
],
"path": [
"cheque_info"
],
"query": [
{
"key": "url",
"value": "https://cabinet.tax.gov.ua/cashregs/check?id=PDgeh4_KHik&date=20260910&time=12%3A57%3A37&fn=4001127837&sm=471.00",
"description": "Необовʼязковий. Посилання з QR-коду чека — альтернатива чотирьом параметрам вище. Сервіс сам дістане з нього `id`, `fn`, `sm` і склеїть `date` з окремих `date` та `time`. Якщо параметр передано разом із явними — явні мають перевагу.\n\nРозпізнаються обидва варіанти, які трапляються на практиці: числовий `id` з `time=1431` і рядковий `id` з `time=12%3A57%3A37`. Пробіл-роздільник тисяч у сумі (зокрема `%20` та нерозривний) прибирається, кома як дробовий роздільник замінюється крапкою. Зайві параметри на кшталт `mac` ігноруються.",
"disabled": true
},
{
"key": "id",
"value": "2037032",
"description": "Необовʼязковий. Ідентифікатор чека — фіскальний номер документа. У QR-коді чека це параметр `id`. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "date",
"value": "2026-09-10 09:25:00",
"description": "Необовʼязковий. Дата й час чека у форматі `YYYY-MM-DD HH:MM:SS`. Береться з чека; секунди зазвичай нульові. Значення потребує URL-кодування (пробіл → `%20`). Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "fn",
"value": "3001164740",
"description": "Необовʼязковий. Фіскальний номер РРО або ПРРО, на якому видано чек — 10 цифр. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "sm",
"value": "270.0",
"description": "Необовʼязковий. Загальна сума чека в гривнях. Роздільник дробової частини — крапка. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "forced",
"value": "1",
"description": "Необовʼязковий. Передайте `1`, щоб ігнорувати кеш і перезапитати реєстр. Таке звернення завжди списує баланс. Будь-яке інше значення або відсутність параметра означає звичайний режим із кешем.",
"disabled": true
}
]
},
"description": "Повертає чек за його реквізитами. Усі чотири параметри обовʼязкові й мають точно збігатися з даними на чеку або в його QR-коді — реєстр шукає за повним збігом.\n\nЯкщо такий чек уже успішно перевірявся раніше, відповідь віддається з локального кешу (`fromDFS: false`) без списання балансу. Щоб примусово перезапитати реєстр, передайте `forced=1`."
},
"response": [
{
"name": "Чек знайдено (з реєстру)",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/cheque_info",
"host": [
"{{baseUrl}}"
],
"path": [
"cheque_info"
],
"query": [
{
"key": "url",
"value": "https://cabinet.tax.gov.ua/cashregs/check?id=PDgeh4_KHik&date=20260910&time=12%3A57%3A37&fn=4001127837&sm=471.00",
"description": "Необовʼязковий. Посилання з QR-коду чека — альтернатива чотирьом параметрам вище. Сервіс сам дістане з нього `id`, `fn`, `sm` і склеїть `date` з окремих `date` та `time`. Якщо параметр передано разом із явними — явні мають перевагу.\n\nРозпізнаються обидва варіанти, які трапляються на практиці: числовий `id` з `time=1431` і рядковий `id` з `time=12%3A57%3A37`. Пробіл-роздільник тисяч у сумі (зокрема `%20` та нерозривний) прибирається, кома як дробовий роздільник замінюється крапкою. Зайві параметри на кшталт `mac` ігноруються.",
"disabled": true
},
{
"key": "id",
"value": "2037032",
"description": "Необовʼязковий. Ідентифікатор чека — фіскальний номер документа. У QR-коді чека це параметр `id`. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "date",
"value": "2026-09-10 09:25:00",
"description": "Необовʼязковий. Дата й час чека у форматі `YYYY-MM-DD HH:MM:SS`. Береться з чека; секунди зазвичай нульові. Значення потребує URL-кодування (пробіл → `%20`). Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "fn",
"value": "3001164740",
"description": "Необовʼязковий. Фіскальний номер РРО або ПРРО, на якому видано чек — 10 цифр. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "sm",
"value": "270.0",
"description": "Необовʼязковий. Загальна сума чека в гривнях. Роздільник дробової частини — крапка. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "forced",
"value": "1",
"description": "Необовʼязковий. Передайте `1`, щоб ігнорувати кеш і перезапитати реєстр. Таке звернення завжди списує баланс. Будь-яке інше значення або відсутність параметра означає звичайний режим із кешем.",
"disabled": true
}
]
},
"description": "Повертає чек за його реквізитами. Усі чотири параметри обовʼязкові й мають точно збігатися з даними на чеку або в його QR-коді — реєстр шукає за повним збігом.\n\nЯкщо такий чек уже успішно перевірявся раніше, відповідь віддається з локального кешу (`fromDFS: false`) без списання балансу. Щоб примусово перезапитати реєстр, передайте `forced=1`."
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"fromDFS\": true,\n \"check\": \"ICAgICAgICDQotCe0JIgwqvQnNCY0JTQm8K7DQo...\",\n \"checkXml\": \"...\"\n}"
},
{
"name": "Чек віддано з кешу (баланс не списано)",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/cheque_info",
"host": [
"{{baseUrl}}"
],
"path": [
"cheque_info"
],
"query": [
{
"key": "url",
"value": "https://cabinet.tax.gov.ua/cashregs/check?id=PDgeh4_KHik&date=20260910&time=12%3A57%3A37&fn=4001127837&sm=471.00",
"description": "Необовʼязковий. Посилання з QR-коду чека — альтернатива чотирьом параметрам вище. Сервіс сам дістане з нього `id`, `fn`, `sm` і склеїть `date` з окремих `date` та `time`. Якщо параметр передано разом із явними — явні мають перевагу.\n\nРозпізнаються обидва варіанти, які трапляються на практиці: числовий `id` з `time=1431` і рядковий `id` з `time=12%3A57%3A37`. Пробіл-роздільник тисяч у сумі (зокрема `%20` та нерозривний) прибирається, кома як дробовий роздільник замінюється крапкою. Зайві параметри на кшталт `mac` ігноруються.",
"disabled": true
},
{
"key": "id",
"value": "2037032",
"description": "Необовʼязковий. Ідентифікатор чека — фіскальний номер документа. У QR-коді чека це параметр `id`. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "date",
"value": "2026-09-10 09:25:00",
"description": "Необовʼязковий. Дата й час чека у форматі `YYYY-MM-DD HH:MM:SS`. Береться з чека; секунди зазвичай нульові. Значення потребує URL-кодування (пробіл → `%20`). Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "fn",
"value": "3001164740",
"description": "Необовʼязковий. Фіскальний номер РРО або ПРРО, на якому видано чек — 10 цифр. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "sm",
"value": "270.0",
"description": "Необовʼязковий. Загальна сума чека в гривнях. Роздільник дробової частини — крапка. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "forced",
"value": "1",
"description": "Необовʼязковий. Передайте `1`, щоб ігнорувати кеш і перезапитати реєстр. Таке звернення завжди списує баланс. Будь-яке інше значення або відсутність параметра означає звичайний режим із кешем.",
"disabled": true
}
]
},
"description": "Повертає чек за його реквізитами. Усі чотири параметри обовʼязкові й мають точно збігатися з даними на чеку або в його QR-коді — реєстр шукає за повним збігом.\n\nЯкщо такий чек уже успішно перевірявся раніше, відповідь віддається з локального кешу (`fromDFS: false`) без списання балансу. Щоб примусово перезапитати реєстр, передайте `forced=1`."
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"fromDFS\": false,\n \"check\": \"ICAgICAgICDQotCe0JIgwqvQnNCY0JTQm8K7DQo...\",\n \"checkXml\": \"...\"\n}"
},
{
"name": "Реєстр не знайшов чек",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/cheque_info",
"host": [
"{{baseUrl}}"
],
"path": [
"cheque_info"
],
"query": [
{
"key": "url",
"value": "https://cabinet.tax.gov.ua/cashregs/check?id=PDgeh4_KHik&date=20260910&time=12%3A57%3A37&fn=4001127837&sm=471.00",
"description": "Необовʼязковий. Посилання з QR-коду чека — альтернатива чотирьом параметрам вище. Сервіс сам дістане з нього `id`, `fn`, `sm` і склеїть `date` з окремих `date` та `time`. Якщо параметр передано разом із явними — явні мають перевагу.\n\nРозпізнаються обидва варіанти, які трапляються на практиці: числовий `id` з `time=1431` і рядковий `id` з `time=12%3A57%3A37`. Пробіл-роздільник тисяч у сумі (зокрема `%20` та нерозривний) прибирається, кома як дробовий роздільник замінюється крапкою. Зайві параметри на кшталт `mac` ігноруються.",
"disabled": true
},
{
"key": "id",
"value": "2037032",
"description": "Необовʼязковий. Ідентифікатор чека — фіскальний номер документа. У QR-коді чека це параметр `id`. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "date",
"value": "2026-09-10 09:25:00",
"description": "Необовʼязковий. Дата й час чека у форматі `YYYY-MM-DD HH:MM:SS`. Береться з чека; секунди зазвичай нульові. Значення потребує URL-кодування (пробіл → `%20`). Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "fn",
"value": "3001164740",
"description": "Необовʼязковий. Фіскальний номер РРО або ПРРО, на якому видано чек — 10 цифр. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "sm",
"value": "270.0",
"description": "Необовʼязковий. Загальна сума чека в гривнях. Роздільник дробової частини — крапка. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "forced",
"value": "1",
"description": "Необовʼязковий. Передайте `1`, щоб ігнорувати кеш і перезапитати реєстр. Таке звернення завжди списує баланс. Будь-яке інше значення або відсутність параметра означає звичайний режим із кешем.",
"disabled": true
}
]
},
"description": "Повертає чек за його реквізитами. Усі чотири параметри обовʼязкові й мають точно збігатися з даними на чеку або в його QR-коді — реєстр шукає за повним збігом.\n\nЯкщо такий чек уже успішно перевірявся раніше, відповідь віддається з локального кешу (`fromDFS: false`) без списання балансу. Щоб примусово перезапитати реєстр, передайте `forced=1`."
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"fromDFS\": true,\n \"error\": \"Помилка\",\n \"error_description\": \"Інформація відсутня Не знайдено.\"\n}"
},
{
"name": "Баланс вичерпано",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/cheque_info",
"host": [
"{{baseUrl}}"
],
"path": [
"cheque_info"
],
"query": [
{
"key": "url",
"value": "https://cabinet.tax.gov.ua/cashregs/check?id=PDgeh4_KHik&date=20260910&time=12%3A57%3A37&fn=4001127837&sm=471.00",
"description": "Необовʼязковий. Посилання з QR-коду чека — альтернатива чотирьом параметрам вище. Сервіс сам дістане з нього `id`, `fn`, `sm` і склеїть `date` з окремих `date` та `time`. Якщо параметр передано разом із явними — явні мають перевагу.\n\nРозпізнаються обидва варіанти, які трапляються на практиці: числовий `id` з `time=1431` і рядковий `id` з `time=12%3A57%3A37`. Пробіл-роздільник тисяч у сумі (зокрема `%20` та нерозривний) прибирається, кома як дробовий роздільник замінюється крапкою. Зайві параметри на кшталт `mac` ігноруються.",
"disabled": true
},
{
"key": "id",
"value": "2037032",
"description": "Необовʼязковий. Ідентифікатор чека — фіскальний номер документа. У QR-коді чека це параметр `id`. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "date",
"value": "2026-09-10 09:25:00",
"description": "Необовʼязковий. Дата й час чека у форматі `YYYY-MM-DD HH:MM:SS`. Береться з чека; секунди зазвичай нульові. Значення потребує URL-кодування (пробіл → `%20`). Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "fn",
"value": "3001164740",
"description": "Необовʼязковий. Фіскальний номер РРО або ПРРО, на якому видано чек — 10 цифр. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "sm",
"value": "270.0",
"description": "Необовʼязковий. Загальна сума чека в гривнях. Роздільник дробової частини — крапка. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "forced",
"value": "1",
"description": "Необовʼязковий. Передайте `1`, щоб ігнорувати кеш і перезапитати реєстр. Таке звернення завжди списує баланс. Будь-яке інше значення або відсутність параметра означає звичайний режим із кешем.",
"disabled": true
}
]
},
"description": "Повертає чек за його реквізитами. Усі чотири параметри обовʼязкові й мають точно збігатися з даними на чеку або в його QR-коді — реєстр шукає за повним збігом.\n\nЯкщо такий чек уже успішно перевірявся раніше, відповідь віддається з локального кешу (`fromDFS: false`) без списання балансу. Щоб примусово перезапитати реєстр, передайте `forced=1`."
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"errorMessage\": \"No balance. Current balance left 0.0\"\n}"
},
{
"name": "Не передано обовʼязковий параметр",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/cheque_info",
"host": [
"{{baseUrl}}"
],
"path": [
"cheque_info"
],
"query": [
{
"key": "url",
"value": "https://cabinet.tax.gov.ua/cashregs/check?id=PDgeh4_KHik&date=20260910&time=12%3A57%3A37&fn=4001127837&sm=471.00",
"description": "Необовʼязковий. Посилання з QR-коду чека — альтернатива чотирьом параметрам вище. Сервіс сам дістане з нього `id`, `fn`, `sm` і склеїть `date` з окремих `date` та `time`. Якщо параметр передано разом із явними — явні мають перевагу.\n\nРозпізнаються обидва варіанти, які трапляються на практиці: числовий `id` з `time=1431` і рядковий `id` з `time=12%3A57%3A37`. Пробіл-роздільник тисяч у сумі (зокрема `%20` та нерозривний) прибирається, кома як дробовий роздільник замінюється крапкою. Зайві параметри на кшталт `mac` ігноруються.",
"disabled": true
},
{
"key": "id",
"value": "2037032",
"description": "Необовʼязковий. Ідентифікатор чека — фіскальний номер документа. У QR-коді чека це параметр `id`. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "date",
"value": "2026-09-10 09:25:00",
"description": "Необовʼязковий. Дата й час чека у форматі `YYYY-MM-DD HH:MM:SS`. Береться з чека; секунди зазвичай нульові. Значення потребує URL-кодування (пробіл → `%20`). Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "fn",
"value": "3001164740",
"description": "Необовʼязковий. Фіскальний номер РРО або ПРРО, на якому видано чек — 10 цифр. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "sm",
"value": "270.0",
"description": "Необовʼязковий. Загальна сума чека в гривнях. Роздільник дробової частини — крапка. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "forced",
"value": "1",
"description": "Необовʼязковий. Передайте `1`, щоб ігнорувати кеш і перезапитати реєстр. Таке звернення завжди списує баланс. Будь-яке інше значення або відсутність параметра означає звичайний режим із кешем.",
"disabled": true
}
]
},
"description": "Повертає чек за його реквізитами. Усі чотири параметри обовʼязкові й мають точно збігатися з даними на чеку або в його QR-коді — реєстр шукає за повним збігом.\n\nЯкщо такий чек уже успішно перевірявся раніше, відповідь віддається з локального кешу (`fromDFS: false`) без списання балансу. Щоб примусово перезапитати реєстр, передайте `forced=1`."
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": false,\n \"errorMessage\": \"fn parameter is not set\"\n}"
}
]
},
{
"name": "Чек у структурованому вигляді",
"request": {
"method": "GET",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/cheque_structured",
"host": [
"{{baseUrl}}"
],
"path": [
"cheque_structured"
],
"query": [
{
"key": "url",
"value": "https://cabinet.tax.gov.ua/cashregs/check?id=PDgeh4_KHik&date=20260910&time=12%3A57%3A37&fn=4001127837&sm=471.00",
"description": "Необовʼязковий. Посилання з QR-коду чека — альтернатива чотирьом параметрам вище. Сервіс сам дістане з нього `id`, `fn`, `sm` і склеїть `date` з окремих `date` та `time`. Якщо параметр передано разом із явними — явні мають перевагу.\n\nРозпізнаються обидва варіанти, які трапляються на практиці: числовий `id` з `time=1431` і рядковий `id` з `time=12%3A57%3A37`. Пробіл-роздільник тисяч у сумі (зокрема `%20` та нерозривний) прибирається, кома як дробовий роздільник замінюється крапкою. Зайві параметри на кшталт `mac` ігноруються.",
"disabled": true
},
{
"key": "id",
"value": "2037032",
"description": "Необовʼязковий. Ідентифікатор чека — фіскальний номер документа. У QR-коді чека це параметр `id`. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "date",
"value": "2026-09-10 09:25:00",
"description": "Необовʼязковий. Дата й час чека у форматі `YYYY-MM-DD HH:MM:SS`. Береться з чека; секунди зазвичай нульові. Значення потребує URL-кодування (пробіл → `%20`). Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "fn",
"value": "3001164740",
"description": "Необовʼязковий. Фіскальний номер РРО або ПРРО, на якому видано чек — 10 цифр. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "sm",
"value": "270.0",
"description": "Необовʼязковий. Загальна сума чека в гривнях. Роздільник дробової частини — крапка. Обовʼязковий, якщо не передано `url`.",
"disabled": true
},
{
"key": "forced",
"value": "1",
"description": "Необовʼязковий. Передайте `1`, щоб ігнорувати кеш і перезапитати реєстр. Таке звернення завжди списує баланс. Будь-яке інше значення або відсутність параметра означає звичайний режим із кешем.",
"disabled": true
},
{
"key": "printed",
"value": "0",
"description": "Необовʼязковий. Передайте `0`, щоб не повертати текстове представлення чека.",
"disabled": true
},
{
"key": "raw",
"value": "1",
"description": "Необовʼязковий. Передайте `1`, щоб додати до відповіді сирий payload реєстру — так, як його віддає `/cheque_info`.",
"disabled": true
}
]
},
"description": "Той самий чек, що й `/cheque_info`, але вже розібраний: продавець, позиції, оплати та податки окремими полями.\n\nРеєстр віддає чек у двох різних діалектах XML — компактному `` і розлогому `` — усередині base64, з кодуванням, яке міняється від документа до документа. Цей ендпоінт зводить обидва до однієї структури, тож розбирати нічого не потрібно.\n\n**Тарифікація й кеш ті самі**, що й у `/cheque_info`: той самий запит до реєстру, те саме списання, той самий кеш.\n\nЗверніть увагу на `cheque.seller.source`. Формат `` **не містить** назви продавця, точки й адреси, тому вони беруться: `xml` — зі структури ``; `certificate` — із сертифіката підписувача всередині підпису PKCS#7 (там повна юридична назва, ЄДРПОУ й адреса); `printed` — із шапки друкованої форми, і це вже здогадка за версткою, а не структуровані дані."
},
"response": []
},
{
"name": "Перевірка чека за фотографією",
"request": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/cheque_photo",
"host": [
"{{baseUrl}}"
],
"path": [
"cheque_photo"
]
},
"description": "Приймає фото чека й повертає розібраний документ.\n\n**Як визначаються реквізити.** Спершу беруться ті, що передані явно (`id`, `date`, `fn`, `sm`) — вони мають перевагу над усім іншим. Далі розбирається переданий рядок QR-коду (`url`). Якщо реквізитів усе ще бракує, QR шукається на самій фотографії. І лише коли й це не дало результату, фото читає AI-агент, налаштований у панелі.\n\nКоли QR-код дав повний набір реквізитів, до AI не звертаємося взагалі — посилання на кабінет ДПС саме по собі підтверджує, що чек фіскальний.\n\n**Нефіскальні документи.** Товарного чека чи роздруківки з облікової програми в реєстрі ДПС немає за визначенням. Для них запит до реєстру не виконується, а дані беруться з самої фотографії — відповідь має ту саму структуру, лише `source` дорівнює `photo`, а `cheque.sourceFormat` — `AI`.\n\n**Списання балансу.** Розпізнавання фото безкоштовне; списується лише звернення до реєстру за звичайними правилами (знайдений чек — 1, ненайдений — 0,5, відповідь із кешу — безкоштовно).\n\n**Формати запиту.** `multipart/form-data` з файлом у полі `image`, або будь-який формат із посиланням `image_url`, або тіло JSON із `imageUrl`. Максимальний розмір файлу — 100 МБ. Великий знімок перед надсиланням до AI автоматично зменшується, тож на швидкість і вартість розпізнавання це майже не впливає.",
"body": {
"mode": "formdata",
"formdata": [
{
"key": "image",
"type": "file",
"src": [],
"description": "Фото чека. Потрібне або це поле, або image_url. Приймаються також назви частини photo, file, cheque."
},
{
"key": "image_url",
"type": "text",
"value": "https://storage.example.com/cheques/1.jpg",
"description": "Посилання на фото — замість файлу. Лише http і https, без перенаправлень, не на внутрішні адреси.",
"disabled": true
},
{
"key": "url",
"type": "text",
"value": "https://cabinet.tax.gov.ua/cashregs/check?id=…",
"description": "Уже прочитаний рядок QR-коду, якщо він у вас є.",
"disabled": true
},
{
"key": "id",
"type": "text",
"value": "",
"description": "Фіскальний номер чека, якщо відомий.",
"disabled": true
},
{
"key": "date",
"type": "text",
"value": "",
"description": "Дата й час, YYYY-MM-DD HH:MM:SS.",
"disabled": true
},
{
"key": "fn",
"type": "text",
"value": "",
"description": "Фіскальний номер каси, 10 цифр.",
"disabled": true
},
{
"key": "sm",
"type": "text",
"value": "",
"description": "Сума чека, роздільник — крапка.",
"disabled": true
},
{
"key": "forced",
"type": "text",
"value": "",
"description": "1 — не брати відповідь із кешу.",
"disabled": true
}
]
}
},
"response": []
}
]
},
{
"name": "Баланс",
"description": "Облік витрачених запитів",
"item": [
{
"name": "Залишок запитів",
"request": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/get_balance",
"host": [
"{{baseUrl}}"
],
"path": [
"get_balance"
]
},
"description": "Повертає залишок запитів у поточному відкритому поповненні. Тіло запиту не потрібне."
},
"response": [
{
"name": "Звичайна відповідь",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Accept",
"value": "application/json"
}
],
"url": {
"raw": "{{baseUrl}}/get_balance",
"host": [
"{{baseUrl}}"
],
"path": [
"get_balance"
]
},
"description": "Повертає залишок запитів у поточному відкритому поповненні. Тіло запиту не потрібне."
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json"
}
],
"body": "{\n \"success\": true,\n \"balance\": 99998.5\n}"
}
]
}
]
}
],
"variable": [
{
"key": "baseUrl",
"value": "https://chequechecker.tech",
"type": "string",
"description": "Адреса сервісу"
},
{
"key": "login",
"value": "",
"type": "string",
"description": "Ваш логін"
},
{
"key": "password",
"value": "",
"type": "string",
"description": "Ваш пароль"
}
]
}