Skip to content

docs(it): explain how to set LoginMode on a cloud-hosted cashbox #83

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
accodev wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(it): explain how to set LoginMode on a cloud-hosted cashbox #83

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions ...are-doc/middleware-it-registratore-telematico/operation-modes/scu/ivaservizi.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,20 @@ Regardless of `LoginMode`, delegation is always resolved by matching `VATNumber`

A login failure due to wrong credentials or an undelegated `VATNumber` is never retried automatically (regardless of `LoginMode`) — retrying the exact same rejected login would only risk AdE temporarily locking the account after repeated failed attempts.

**Setting LoginMode on a cloud-hosted cashbox**

For cloud-hosted cashboxes the SCU runs in a fiskaltrust service rather than in your launcher, so the value is read from the Signature Creation Unit's configuration in the Portal. Set `LoginMode` there, on the SCU itself.

Three steps are needed before the value takes effect, and skipping either of the last two leaves the setting saved but inactive:

1. Set `LoginMode` in the SCU configuration in the Portal.
2. Make sure that the SCU is linked to the cashbox. Configuring an SCU does not attach it. An unlinked SCU is left out of the configuration the service receives.
3. Rebuild the cashbox. The service is served a built configuration, so a Portal change is not visible until a rebuild regenerates it.

If an SCU sets no `LoginMode`, the hosting service applies its own default. Different cashboxes on the same service can therefore run different login modes.

### Troubleshooting

- **Receipts fail immediately with an authentication error, with no retries observed in the logs**: this is expected — a rejected login (wrong `UserName`/`Password`/`Pin`, or `VATNumber` not delegated to `UserName`) is treated as non-retryable so the same bad login attempt isn't repeated against AdE. Verify the credentials and the delegation on the AdE portal directly.
- **Receipts fail with "no delega found for P.IVA ..."**: `VATNumber` is not among the account's current AdE delegations. Check the delegations under the professional account's AdE portal.
- **`LoginMode` saved in the Portal has no effect on a cloud-hosted cashbox**: the value is saved on the SCU, but the service never receives it. Check that the SCU is linked to the cashbox, then rebuild the cashbox. Both steps are separate from saving the configuration.
Loading