Webkassa iikoFront adapter 0.11.52-beta

Webkassa iikoFront adapter 0.11.52-beta

This beta combines the Webkassa reliability, protected-settings, receipt UI,
and update-notification work completed after 0.11.50-beta.

Added

• A complete deadline covering Webkassa response headers and response body.
• Controlled Code 505 failover to validated HTTPS domains returned through
  AlternativeDomainNames, without blind fiscal retries.
• Serialized unknown-result recovery before another fiscal write can overtake
  an unresolved operation.
• Configured/masked state, temporary reveal, and explicit edit actions for
  protected API key and password values.
• Authentication-mode Base URL defaults while retaining a validated editable
  Webkassa HTTPS origin.
• Печать фискального чека and QR фискального чека actions for closed and
  past orders.
• Current version and update status in Webkassa settings.
• One non-blocking update-manifest check per iikoFront process startup.

Fixed

• Unknown fiscal results are reconciled inside the per-cashbox queue before
  subsequent writes continue.
• Offline synchronization can recover a successful operation whose response
  was lost and stops the batch when the result remains uncertain.
• Existing DPAPI-protected values are preserved when the operator does not
  explicitly edit a secret.
• Manual receipt reprint no longer interrupts the operator with a modal success
  message. Failures remain visible.

Operator-visible changes

• Settings show whether Webkassa secrets are configured without exposing them.
• Closed and historical orders expose separate print and external-ticket QR
  actions under iikoFront additions.
• When a newer approved beta is available, iikoFront shows one non-blocking
  notification. Network or manifest errors never block cash operations.

Configuration and migration

• No database migration is required.
• Existing DPAPI configuration is retained.
• requestPolicy supports bounded recovery attempts/delay and a bounded number
  of Code 505 alternative hosts. Blind fiscal retries remain disabled.
• loginPasswordOnly is not confirmed for Webkassa API v4 production; use
  apiKeyAndLoginPassword for the supported pilot configuration.

Validation

• Gateway contract tests passed.
• Windows Release build/package and controlled test-terminal installation
  passed.
• Installed plugin version, healthy sidecar, protected settings UI, closed and
  past order print/QR actions, and non-blocking update behavior were checked.
• ZIP CRC, required files, safe paths, VERSION, Manifest.xml identity, package
  size, and SHA256 were independently rechecked before publication.

Package

Resto.Front.Api.Webkassa.V9-0.11.52-beta-20260715-083814.zip
size: 401983 bytes
sha256: 99e3e0e45ef062f39fa8bf1b79113057dec9f1b918d10d3d5185821e35f67bc7
minimum iikoFront: 9.5
iikoFront API: V9

Known issues

• The iiko-plugin.kz beta manifest can remain behind this GitHub pilot
  release until it is separately validated and explicitly published.
• Stable unattended update remains blocked: the stable manifest and end-to-end
  detached-signature verification are not available.
• loginPasswordOnly is not confirmed for Webkassa API v4 production.

Rollback

Stop iikoFront and use the separate updater/installer rollback path to restore
the previous plugin-folder backup or reinstall 0.11.50-beta. Preserve
%ProgramData% configuration, DPAPI secrets, fiscal stores, and queues; do not
delete operational data as part of rollback.

This is a beta prerelease for demo/pilot terminals. It is not a stable-channel
release and does not change the live iiko-plugin.kz manifests.