Интеграция tetyafanya.online с WEB API ПРРО Cashälot: автоматическая фискализация чеков и отправка
27 000 UAHОписание задачи
Нужно подключить сайт tetyafanya.online к WEB API ПРРО Cashälot, чтобы после успешной онлайн-оплаты автоматически формировался фискальный чек и отправлялся в ДПС, а фискальные реквизиты сохранялись в заказе и отправлялись клиенту (ссылка/QR/PDF).
Исполнителю необходимо реализовать полный цикл: открытие/закрытие смены, регистрация чеков (в т.ч. сторно при возвратах), Z-отчёты, обработка офлайн-режима, логирование и безопасное хранение ключей КЭП/SmartID/PIN.
Требуемый результат (что должно работать)
Авто-фискализация при оплате
После webhook «успешная оплата» от платёжного провайдера сайт вызываетRegisterCheckв Cashälot:с AutoOpenShift=true (если смена не открыта — открыть автоматически),
получить Url/QR чека (для вкладки заказа и письма клиенту),
сохранить NumFiscal (фискальный №), дату/время и статус (онлайн/офлайн).
Возвраты / сторно
По событию «refund/отмена» — регистрировать сторнирующий чек черезRegisterCheck(DOCSUBTYPE=CheckStorno) с передачей реквизитов исходного чека (StornedCheck).Смена и Z-отчёт
Авто-закрытие смены через
CloseShiftс параметром ZRepAuto=true (если Z ещё не сформирован).Возможность вручную вызвать
RegisterZRepиз админки.Просмотр итогов текущей смены via
LastShiftTotals.
Офлайн-режим
При недоступности ФСКО работать в офлайн: аккумулировать документы, затем автоматически перейти онлайн и дозарегистрировать офлайн-чеки; при рассинхронизации —Cleanup.Получение чека/Z
Возможность подтянуть готовый чек/Z с сервера по фискальному номеру (GetCheck/GetZRep) для отображения/повторной отправки клиенту.Безопасность ключей и настроек
Добавить экран настройки: загрузка сертификата/ключа (или SmartID/KeyPin), привязка к нужному NumFiscal ПРРО.
Хранение секретов вне web-root, в
.env/защищённых конфиг-хранилищах.Поддержка облегчённого режима KeyPin (если включён в бек-офисе), где в командах не передаются Certificate/PrivateKey/Password.
Админ-интерфейс
В карточке заказа: статус фискализации, NumFiscal, ссылка на чек (Url), QR (img), offline/online флаг, лог последних попыток.
Кнопки: «Переотправить чек», «Сформировать Z-отчёт», «Закрыть смену», «Очистка/синхронизация (Cleanup)».
Уведомления клиенту
После успешной оплаты отправить e-mail с ссылкой/QR на чек (и/или вложение HTML/PDF визуализации, если используется
Visualization/VisAsHtml).
Логи и устойчивость
Журнал запросов/ответов API (безопасное маскирование персональных и ключевых данных).
Ретраи при временных сбоях; очередь на переотправку.
Алерты в админке при
ErrorCode/ErrorMessage.Технические детали реализации (что именно делать разработчику)
1) Подключение к Cashälot
Настроить
Setupдля хранения параметров КЭП/SmartID (Certificate/PrivateKey/Password/UseSmartId) или использовать KeyPin согласно включённой интеграции в бек-офисе
При старте проверять доступность сервера (ServerState) и состояние ПРРО (TransactionsRegistrarState).2) Поток «Оплата → чек»
Слушать webhook платёжной системы «успешно оплачено».
Сформировать структуру чека (услуга, сумма, налоги/без НДС), вызвать
RegisterCheckc: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/GetZRepc опциейVisualizationиGetQrCode(для повторной отправки клиенту).
Приложения 1
-
Здравствуйте, есть опыт привязки кашалота к сайту, могу проконсультировать вас
-
Актуальные фриланс-проекты в категории CMS
Посадочная страница для Shopify-магазина по готовому макетуНужно разработать landing page для интернет-магазина на Shopify. Магазин уже работает на купленной теме, поэтому задача — адаптировать готовый визуальный макет и структуру под возможности текущей темы, без полной разработки с нуля. Страница нужна под рекламный трафик из Facebook… CMS, HTML и CSS верстка ∙ 5 часов 32 минуты назад ∙ 20 ставок |
Разработка многостраничного сайта на WordPress по готовому дизайну
18 000 UAH
Ищу WordPress-разработчика для верстки и запуска многостраничного сайта. Есть готовый дизайн. Нужно качественно перенести его на WordPress, адаптировать под мобильные устройства и подготовить сайт к запуску. Пожалуйста, присылайте примеры реализованных сайтов и стоимость. CMS ∙ 15 часов 48 минут назад ∙ 76 ставок |
Настройка Cookie Consent и Consent Mode v2 на сайте ХорошопДобрый день! Необходимо внедрить на сайте (платформа Хорошоп) полноценный баннер управления согласием на использование файлов cookie и выполнить все необходимые настройки для корректной передачи данных между Google Ads, Google Analytics 4, Google Tag Manager и другими… CMS, Веб-программирование ∙ 16 часов 31 минута назад ∙ 13 ставок |
Доопрацювання существующего проекта на Laravel (PHP)Необходимо доработка существующего проекта на Laravel (PHP). Проект включает в себя готовую админ-панель, которая имеет внутри себя билдер, который выступает для создания страниц через него с версткой (html+css+js) на php кодом для вывода данных. В проекте нужно реализовать 2-3… CMS, PHP ∙ 1 день 8 часов назад ∙ 38 ставок |
Настройка интернет-магазина тканей на WordPress + WooCommerce по шаблону Astra
14 790 UAH
Необходимо настроить и подготовить к работе интернет-магазин мебельных тканей для рынка Норвегии. Домен, хостинг и WordPress уже установлены: eximtextilnordiq.com Сайт нужно сделать не с нуля и без индивидуального программирования, а на готовом бесплатном шаблоне Astra,… CMS, HTML и CSS верстка ∙ 1 день 10 часов назад ∙ 63 ставки |