Skip to content
API фіскального сервера
  • Pages
    • Основні положення
    • Порядок взаємодії
    • Зауваження щодо реалізації
    • Сценарії роботи
    • Офлайн сесія
    • Команди
    • Запит стану сервера
    • Запит XSD схем
    • Запит доступних господарських одиниць
    • Запит переліку операторів (касирів)
    • Запит стану ПРРО
    • Запит чека
    • Запит Z-звіту
    • Запит переліку змін за період
    • Запит переліку документів зміни
    • Запит підсумків останньої зміни
    • Запит відомостей про документ за локальним номером
    • Запит надсилання документа
    • Запит надсилання пакета офлайн документів
    • Закріплення ПРРО за пристроєм
API фіскального сервера
/
Основні положення
Share
Explore

Основні положення

Перевірка доступності -
https://cabinet.tax.gov.ua/prro-stat
⁠
⁠

Загальні положення

Фіскальний Сервер контролюючого органу, через який реалізується фіскальна функція програмних реєстраторів розрахункових операцій, забезпечує:
Одержання документів (чеків, Z-звітів, повідомлень тощо) від програмних реєстраторів розрахункових операцій;
Перевірку коректності структури і складу одержаних документів;
Призначення документам фіскальних номерів;
Надсилання відправнику документа відповіді, що містить результат обробки документа і призначений документу фіскальний номер;
Зберігання документів для подальшого використання в інформаційно-аналітичних системах;
Обробку запитів щодо надання документів (чеків покупцям, даних розрахункових операцій для формування ПРРО, Z-звітів тощо).
Збереження сертифікатів електронних підписів та/або печаток, що використовуються ПРРО;
Збереження даних про зареєстровані ПРРО та господарські одиниці, на яких ПРРО застосовується (реєстр ПРРО).
Реєстрація документів (чеків, Z-звітів, повідомлень тощо) здійснюється:
в режимі оперативного («онлайн») надсилання документів на Фіскальний Сервер;
в режимі відкладеного («офлайн») надсилання документів на Фіскальний Сервер.
Документи в системі засвідчуються кваліфікованим електронним підписом (КЕП) фізичної особи або електронною печаткою суб’єкта господарювання, на якого зареєстровано ПРРО. Час засвідчення документа фіксується накладанням на КЕП позначки часу (за виключенням документів, створених в режимі офлайн).
Джерелом позначки часу може виступати від будь-який кваліфікований надавач електронних довірчих послуг.

Поняття і визначення

ПРРО – Програмний реєстратор розрахункових операцій. Система виписки електронних касових чеків, що використовується продавцем.
Сервер – Фіскальний Сервер реєстрації розрахункових операцій.
Локальний номер документа – Номер, призначений документу (чеку, Z-звіту) системою виписки електронних касових чеків, що використовується продавцем.
Фіскальний номер документа – Номер, призначений документу (чеку, Z-звіту) Фіскальним Сервером.
Офлайн сесія – Сукупність документів, створених в режимі офлайн, між припиненням і відновленням зв’язку ПРРО з Фіскальним Сервером.
Локальний номер реєстратора – Номер, призначений ПРРО організацією продавця і зареєстрований формою 1-ПРРО «Заява про реєстрацію програмного реєстратора розрахункових операцій».
Фіскальний номер реєстратора – Номер, призначений ПРРО Фіскальним Сервером в процесі реєстрації форми 1-ПРРО.

Порядок локальної нумерації документів

Локальна нумерація документів ведеться окремо кожним ПРРО. Нумерація здійснюється в межах:
юридичної/фізичної особи продавця;
господарської одиниці;
фіскального номера ПРРО.
Локальна нумерація документів ведеться наскрізь, незалежно від класу документа (чек, Z-звіт).

Порядок фіскальної нумерації онлайн документів

Фіскальна нумерація документів ведеться Сервером.
Фіскальна нумерація документів ведеться наскрізь, незалежно від джерела і класу документа.

Тестові документи

Необхідність тестових документів обумовлена задачами тестування програмного забезпечення під час розробки ПРРО.
Документ (чек, Z-звіт) є тестовим, якщо містить елемент <TESTING>true</TESTING>.
Примітка. Елемент «TESTING» не дозволяється для документів «Початок офлайн сесії» і «Завершення офлайн сесії».
Тестові документи не є фіскальними, попри те, що їм призначаються фіскальні номери. Для тестових документів у візуальній формі виводиться текст «ТЕСТОВИЙ НЕФІСКАЛЬНИЙ ДОКУМЕНТ».
В межах однієї зміни можуть знаходитись лише документи одного типу – або фіскальні, або тестові.

Порядок засвідчення повідомлень кваліфікованим електронним підписом

Повідомлення повинне бути засвідчене кваліфікованим електронним підписом відповідно до вимог Закону України «Про електронні довірчі послуги» (див.
https://zakon.rada.gov.ua/laws/show/2155-19
⁠
).
Алгоритм підпису – криптографічний алгоритм, визначений ДСТУ 4145-2002, затвердженим наказом Державного комітету України з питань технічного регулювання та споживчої політики від 28 грудня 2002 № 31 (див.
http://online.budstandart.com/ua/catalog/doc-page.html?id_doc=68769
⁠
).
Формат підписаних даних - CAdES-E-T відповідно до вимог ДСТУ ETSI EN 319 122-2:2016 (ETSI EN 319 122-2:2016, IDT) "Електронні підписи й інфраструктури (ESI). Цифрові підписи CAdES. Частина 2. Розширені підписи CAdES", затвердженого наказом державного підприємства "Український науково-дослідний і навчальний центр проблем стандартизації, сертифікації та якості" від 21 червня 2016 № 183 (див.
http://www.leonorm.com.ua/p/NL_DOC/UA/2016/Nak_183.htm
⁠
).
Підписаний документ повинен містити сертифікат підписувача (поле "certificates" підписаного повідомлення повинно бути присутнім та містити сертифікат підписувача, необхідний для перевірки підпису).
Підписаний документ не може містити:
сертифікати видавця
списки відкликаних сертифікатів
результати онлайн перевірки сертифікатів
Дані, що підписані, зберігаються всередині підписаного повідомлення (поле "eContent" підписаного повідомлення повинно бути присутнім та містити дані, що були підписані).

Позначка часу

Час засвідчення повідомлення кваліфікованим електронним підписом фіксується накладанням на КЕП кваліфікованої позначки часу (атрибут signature-time-stamp відповідно до вимог ДСТУ ETSI EN 319 122-2:2016, IDT).
Позначка часу контенту (атрибут content-time-stamp відповідно до вимог ДСТУ ETSI EN 319 122-2:2016, IDT) не дозволяється.
Позначка часу не обов’язкова для КЕП документів, створених в режимі офлайн.

Обмеження

Розмір пакету даних, що надсилається, не може перевищувати 200 Kb. Якщо пакет даних передано з використанням компресії, перевіряється розмір оригінальних (не компресованих) даних.

Адреси Фіскального Сервера

⁠
https://fs.tax.gov.ua:8643/fs
⁠
⁠
http://fs.tax.gov.ua:8609/fs
⁠
⁠
Gallery
 
Want to print your doc?
This is not the way.
Try clicking the ··· in the right corner or using a keyboard shortcut (
CtrlP
) instead.