Опис завдання

Потрібно підключити сайт tetyafanya.online до WEB API ПРРО Cashälot, щоб після успішної онлайн-оплати автоматично формувався фіскальний чек і відправлявся в ДПС, а фіскальні реквізити зберігалися в замовленні і відправлялися клієнту (посилання/QR/PDF).

Виконавцю необхідно реалізувати повний цикл: відкриття/закриття зміни, реєстрація чеків (в т.ч. сторно при поверненнях), Z-звіти, обробка офлайн-режиму, логування і безпечне зберігання ключів КЕП/SmartID/PIN.

Вимаганий результат (що повинно працювати)

1. Авто-фіскалізація при оплаті
   Після webhook «успішна оплата» від платіжного провайдера сайт викликає RegisterCheck в Cashälot:

   • з AutoOpenShift=true (якщо зміна не відкрита — відкрити автоматично),

   • отримати Url/QR чека (для вкладки замовлення і листа клієнту),

   • зберегти NumFiscal (фіскальний №), дату/час і статус (онлайн/офлайн).

     
     

2. Повернення / сторно
   По події «refund/скасування» — реєструвати сторнуючий чек через RegisterCheck (DOCSUBTYPE=CheckStorno) з передачею реквізитів вихідного чека (StornedCheck).

   
   

3. Зміна і Z-звіт

   • Авто-закриття зміни через CloseShift з параметром ZRepAuto=true (якщо Z ще не сформований).

   • Можливість вручну викликати RegisterZRep з адмінки.

   • Перегляд підсумків поточної зміни через LastShiftTotals.

     
     

4. Офлайн-режим
   При недоступності ФСКО працювати в офлайн: акумулювати документи, потім автоматично перейти онлайн і дозареєструвати офлайн-чек; при розсинхронізації — Cleanup.

   
   

5. Отримання чека/Z
   Можливість підтягнути готовий чек/Z з сервера по фіскальному номеру (GetCheck/GetZRep) для відображення/повторної відправки клієнту.

   
   

6. Безпека ключів і налаштувань

   • Додати екран налаштування: завантаження сертифіката/ключа (або SmartID/KeyPin), прив'язка до потрібного NumFiscal ПРРО.

   • Зберігання секретів поза web-root, в .env/захищених конфігураційних сховищах.

   • Підтримка полегшеного режиму KeyPin (якщо включено в бек-офісі), де в командах не передаються Certificate/PrivateKey/Password.

     
     

7. Адмін-інтерфейс

   • В картці замовлення: статус фіскалізації, NumFiscal, посилання на чек (Url), QR (img), offline/online прапор, лог останніх спроб.

   • Кнопки: «Переослати чек», «Сформувати Z-звіт», «Закрити зміну», «Очищення/синхронізація (Cleanup)».

     
     

8. Сповіщення клієнту

   • Після успішної оплати відправити e-mail з посиланням/QR на чек (і/або вкладення HTML/PDF візуалізації, якщо використовується Visualization/VisAsHtml).

     
     

9. Логи і стійкість

   • Журнал запитів/відповідей API (безпечне маскування персональних і ключових даних).

   • Ретраї при тимчасових збоях; черга на переосилку.

   • Алерти в адмінці при ErrorCode/ErrorMessage. 

   • Технічні деталі реалізації (що саме робити розробнику)

     1) Підключення до Cashälot

     • Налаштувати Setup для зберігання параметрів КЕП/SmartID (Certificate/PrivateKey/Password/UseSmartId) або використовувати KeyPin відповідно до включеної інтеграції в бек-офісі
       При старті перевіряти доступність сервера (ServerState) і стан ПРРО (TransactionsRegistrarState).
       
       

     • 2) Потік «Оплата → чек»

       • Слухати webhook платіжної системи «успішно оплачено».

       • Сформувати структуру чека (послуга, сума, податки/без ПДВ), викликати RegisterCheck з:

         • NumFiscal = фіскальний номер ПРРО;

         • Check = дані чека (послуга/позиція/підсумок/оплата);

         • AutoOpenShift=true (якщо зміна не відкрита, відкрити автоматично);

         • GetQrCode=true, за необхідності Visualization/VisAsHtml.

           
           

       • Відповідь API: зберегти NumFiscal, NumLocal, OrderDateTime, прапор Offline, Url і QrCode в замовленні.

         
         

     • 3) Повернення/скасування

       • На подію повернення — RegisterCheck з типом CheckStorno, передавши StornedCheck (або StornedCheckToConvert), щоб коректно порахувалися підсумки зміни.

         
         

     • 4) Зміна і Z-звіт

       • При закритті дня — CloseShift (ZRepAuto=true);

       • Альтернатива: окрема кнопка RegisterZRep (якщо потрібно до закриття).

       • Перегляд підсумків зміни — LastShiftTotals (для адмін-екрану).

         
         

     • 5) Офлайн / розсинхронізація

       • При OfflineDocumentsPresent → періодично намагатися авто-регистрацію;

       • При InconsistentRegistrarState → запускати Cleanup (з інформуванням адміна), де потрібно.

         
         

     • 6) Отримання документів

       • За вимогою адміна — GetCheck/GetZRep з опцією Visualization і GetQrCode (для повторної відправки клієнту).

         
         

   •