Alloggiati Web: the complete guide for hotels and B&Bs (and how to stop worrying about it)

If you run a hotel, B&B, or holiday apartment in Italy, Alloggiati Web is almost certainly one of those systems you use every day without having really chosen it. The State Police made it mandatory for everyone, the portal is not exactly intuitive, and the word "WSKEY" keeps appearing every time something stops working.

This guide answers the real questions property managers ask — from initial setup to the most frustrating situations — and explains how to automate almost everything with Hotely.

What Alloggiati Web is and why it's mandatory

Alloggiati Web is the official State Police portal for communicating guest data from accommodation facilities. The obligation stems from Art. 109 of the TULPS (Consolidated Law on Public Safety): every Italian accommodation facility must notify the competent Police Headquarters of the personal and identity document data of each guest within 24 hours of arrival.

For short stays (less than 24 hours) and short-term rentals, the 2025 Security Decree has tightened the rules: the deadline drops to 6 hours from arrival.

This is not optional bureaucracy. Penalties for missing or late submissions reach €206 per individual registration. Systematic non-compliance can result in arrest for up to 3 months.

The real problem: the portal is difficult

Let's be honest. Alloggiati Web was never designed to be simple. Among the most common frustrations we hear from property managers:

• The WSKEY is almost impossible to find — the code is hidden in a non-obvious menu and expires if not used
• Credentials have strange rules — username, password, device code and WSKEY are four different things
• Submission errors aren't clear — the system often returns incomprehensible technical messages
• Each property has separate credentials — managing multiple apartments means a set of credentials for each one
• The portal goes down — and not always at convenient times

The result is that many managers spend minutes every evening entering data manually, or worse, only discover they have unsubmitted registrations when an alert arrives the next day.

Where to find the WSKEY (and how not to lose it)

The WSKEY is the access code for the Alloggiati Web web service — the one that allows external systems like Hotely to submit registrations on your behalf, without having to log in to the portal manually every time.

To find it:

1. Log in to the Alloggiati Web portal with username + password + device code
2. Click on your username in the top right → Profile
3. Find the Web Service Key section
4. Click "Generate New Code"
5. Copy the WSKEY immediately — it is shown only once. If you don't save it right away, you'll need to generate a new one

Warning: you can generate a new WSKEY at most once per day. If you lose it today, you'll have to wait until tomorrow.

How to configure Alloggiati Web on Hotely

Once you have your credentials, setup on Hotely takes less than five minutes.

1. Go to your property dashboard → sidebar → Alloggiati Web
2. Enter your username, password, structure code (WSKEY) and license code
3. Choose the structure type (Hotel/B&B or Apartment Management — depending on how you're registered on the State Police portal)
4. Click Save, then Test connection

The connection test verifies that credentials are correct by authenticating with the State Police web service. If the test succeeds, you'll see a green confirmation. If something is wrong, the system tells you which field is incorrect.

From that point on, Hotely manages the daily authentication token automatically — you don't need to do anything manually each day.

How guest registrations work with Hotely

Online pre check-in changes everything

The most efficient way to collect guest data is the online pre check-in link. Here's how it works:

• The guest books through your Hotely booking engine
• 24 hours before check-in, Hotely automatically sends an email to the guest with the pre check-in link
• The guest fills in their own data directly from their phone — in 14 languages, including Italian, English, German, French, Japanese
• Data arrives automatically in your registration list, already validated and ready for submission

No manual entry. No risk of typos. The system blocks implausible data in advance (impossible dates, special characters in names, etc.) — meaning fewer rejections from the State Police portal.

What about guests from Booking.com, Airbnb or phone?

For bookings coming from OTAs or by phone — where there's no booking in the Hotely booking engine — there's the standalone pre check-in link.

From the Alloggiati section of your property, you can generate an independent link in thirty seconds, entering only the guest's first name, surname and arrival date. The link works exactly like the automatic one: the guest fills it in, digitally signs the privacy consent, and the registration enters the list already completed.

This flow is also useful if you don't use the Hotely booking engine and only want to use the Alloggiati feature to digitise registrations.

Submitting registrations

When registrations are in Ready status, you submit them all at once with a single click. Hotely bundles everything into a file in the official State Police format and transmits it to the web service in a few seconds. The XML receipt archive is automatically retained for 5 years, as required by law.

Situations that waste time (and how to handle them)

The guest didn't fill in the link

You can enter the data manually from the registration, or generate a new link and send it via WhatsApp. The dashboard always shows how many registrations are incomplete or overdue.

Credentials stop working

This usually happens because you changed your password on Alloggiati Web without updating Hotely. Go to Settings → Alloggiati Web, update the password, save. The new token is generated automatically.

I have multiple apartments, each with different credentials

Each property on Hotely has its own Alloggiati Web configuration. You can manage 10 facilities from the same dashboard, each with its own credentials.

The State Police portal is unreachable

Hotely shows the error in the dashboard and sends an email notification. You can retry the submission when the portal comes back online. Meanwhile, registrations remain in Ready status — data is not lost.

Frequently asked questions

Do I still need to access the State Police Alloggiati Web portal? Only for initial setup (to obtain credentials and the WSKEY). For daily management there's no need to open the portal.

What happens if I submit a registration with an error? You can correct the data and resubmit. The portal accepts changes as long as the registration hasn't already been confirmed as final.

Can I use Hotely just for registrations, without using the booking engine? Yes. The Alloggiati Web feature is independent and works for bookings managed with other tools.

Is document collection mandatory? No. A photo of the document is optional — personal data and document data (type, number, place of issue) are mandatory, but the photo is not. Many managers collect it anyway as additional evidence.

---

For full technical details, the complete guide is available in the Hotely Alloggiati Web documentation.

To set it up for your property today, access the dashboard or book a free demo — we're happy to walk you through the configuration step by step.

---

Hotely.ai — Booking engine and operational management for Italian accommodation facilities. Integrated legal compliance: Alloggiati Web, ISTAT and tourist tax without separate software.