# Turn Alloggiati Web into an API

> Read your Ricevute (receipts), today's Analisi (schedine sent today) and your Appartamenti (apartments) from Alloggiati Web with one API call each. A workflow can then post each day's protocol number to your own records the next morning.

Page: https://fous.com/automate/alloggiati-web
Updated: 2026-11-12

Works with your own Alloggiati Web account. Fous is an independent product.

## What you can build on Alloggiati Web

### Get receipts

Reads the table in the Ricevute section: one row per day the property sent schedine (guest records), for the last 30 days.

- Takes: From date (optional), to date (optional)
- Returns: Reference date, schedine sent, protocol number

### Check today's sent guests

Reads the Analisi section, which lists the schedine sent today, with each guest's name and the time it was sent.

- Takes: Nothing
- Returns: Surname, first name, time sent, count

### List your apartments

Reads Elenco under Appartamenti: the enabled apartments that a Gestione Appartamenti user-id sends schedine for.

- Takes: Search text (optional)
- Returns: Apartment, address

### Send a guest's schedina

Fills in a schedina on the Inserimento page with the guest's Tipo Alloggiato, Data di Arrivo, Permanenza and document, and sends it.

- Takes: Tipo Alloggiato, arrival date, days of stay, guest details, document type and number, apartment (if any)
- Returns: Schedine sent, errors shown, time sent

## Automate Alloggiati Web with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Yesterday's receipt, posted to your own records

Starts: Every day at 9:00, once yesterday's row is in Ricevute

1. Get the receipts row for yesterday from the Ricevute section.
2. Stop when there is no row for that date.
3. Post the reference date, schedine sent and protocol number to your property system's webhook.

### Evening check of the guests sent today

Starts: Every day at 21:00

1. Read the Analisi section for the schedine sent today.
2. Keep each guest's surname, first name and time sent.
3. Email you the list with its total, so it can be checked against today's arrivals.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get receipts” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "alloggiatiweb.poliziadistato.it/get_receipts",
    "input": {
      "from_date": "2026-11-08",
      "to_date": "2026-11-11"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "receipts": [
      {
        "reference_date": "2026-11-11",
        "schedine_sent": 7,
        "protocol_number": "202600004812-VE"
      },
      {
        "reference_date": "2026-11-10",
        "schedine_sent": 3,
        "protocol_number": "202600004655-VE"
      },
      {
        "reference_date": "2026-11-08",
        "schedine_sent": 12,
        "protocol_number": "202600004390-VE"
      }
    ],
    "count": 3
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## Alloggiati Web’s own options

Alloggiati Web has a SOAP web service for property management systems. It sends schedine, checks them without sending, downloads a day's receipt PDF and the code tables, and manages apartments. You switch it on with a WSKEY generated in the portal. Credentials and the portal are free. The service has no method that lists the names sent.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Web service (SOAP) | Send and Test for schedine, Ricevuta for a receipt PDF from the last 30 days, Tabella for code tables, and apartment management. | Your user, password and a WSKEY from Chiave Web Service. One new key a day, and a new one after every password change. |
| Invio File | Upload of a UTF-8 .txt file with one 168-character line per guest, up to 1000 lines, checked with Elabora before sending. | A file built to the portal's record layout, with codes from the Comuni, Stati and Documenti tables. |
| Alloggiati Web by hand | Inserimento, File, Ricevute, Analisi and Appartamenti, signed in with one user-id. | Your user-id, password and scheda codici (code card). No cost. |

Read on November 12, 2026: [Servizi Alloggiati: web service manual](https://questure.poliziadistato.it/statics/13/manualewebsercices_alloggiatiweb.pdf?lang=it), [Guida Servizio Alloggiati Web](https://alloggiatiweb.poliziadistato.it/PortaleAlloggiati/Download/Manuali/MANUALEALBERGHI.pdf), [Questura FAQ on Alloggiati Web](https://questure.poliziadistato.it/statics/24/domande-frequenti-faq-2023.pdf?lang=it).

## Signing in to Alloggiati Web

Alloggiati Web asks for a user name and password, then digits from your scheda codici (code card), a card of 16 groups of 4 numbers from which the portal picks positions at random. Three wrong attempts send you back to the password. With Fous you sign in through the site's own sign-in with your own account, the login is sealed with AES-256, and a method reads and does only what that account can.

## Worth knowing

- **24 hours from arrival**: Schedine must reach the Questura within 24 hours of arrival, or within 6 hours for stays of no more than 24 hours. Data di Arrivo accepts only today or yesterday.
- **A sent schedina cannot be corrected**: Once the system has accepted a schedina, its data cannot be changed. You send that guest again, and that day's receipt then counts one guest more than you hosted.
- **Receipts are online for 30 days**: Ricevute covers the last 30 days, not today. Each receipt is a PDF signed with a Polizia di Stato QR code, to be kept for 5 years, and the Questura cannot download older ones for you.
- **Apartments need Gestione Appartamenti**: One user-id for several apartments comes with Gestione Appartamenti (modello B). A disabled apartment cannot be enabled again, only added anew.

## More in Travel and hospitality

- [IATA BSPlink](https://fous.com/automate/iata-bsplink.md)
- [My ARC](https://fous.com/automate/my-arc.md)
- [Amadeus Selling Platform Connect](https://fous.com/automate/amadeus-selling-platform-connect.md)
- [Travelport Smartpoint](https://fous.com/automate/travelport-smartpoint.md)
- [SES.Hospedajes](https://fous.com/automate/ses-hospedajes.md)
- [Cvent Supplier Network](https://fous.com/automate/cvent-supplier-network.md)
- [Agoda YCS](https://fous.com/automate/agoda-ycs.md)
- [Booking.com Extranet](https://fous.com/automate/booking-com-extranet.md)
- [Expedia Partner Central](https://fous.com/automate/expedia-partner-central.md)
- [Trip.com eBooking](https://fous.com/automate/trip-com-ebooking.md)
- [Tripadvisor Management Centre](https://fous.com/automate/tripadvisor-management-centre.md)
- [Airbnb hosting dashboard](https://fous.com/automate/airbnb-hosting-dashboard.md)
- [GetYourGuide Supplier Portal](https://fous.com/automate/getyourguide-supplier-portal.md)
- [Viator Supplier Center](https://fous.com/automate/viator-supplier-center.md)

Other industries: [Portal Empresarial INFONAVIT](/automate/portal-empresarial-infonavit), [Rev360](/automate/rev360), [Cégkapu](/automate/cegkapu), [FCA RegData](/automate/fca-regdata), [DOB NOW](/automate/dob-now), [Loan Product Advisor](/automate/loan-product-advisor).

## Frequently asked questions

### Does Alloggiati Web have an API?

Yes, a SOAP web service. It sends and checks schedine, downloads a day's receipt PDF and the code tables, and manages apartments. You generate a WSKEY under Chiave Web Service and use it with your user and password to get a token. It has no method that lists the guests you sent.

### How long can I download Alloggiati Web receipts?

For the last 30 days, not counting today. Each row in Ricevute has the reference date, the number of schedine and a protocol number. Receipts must be kept for 5 years, so save each PDF while it is still online.

### How do I correct a schedina I already sent?

You cannot. Once accepted, a schedina stays as sent. Send the guest again with the right data within the legal deadline, and keep a note, because that day's receipt will count one guest more.

### Can I send many guests at once?

Yes, with Invio File under the File menu. You upload a UTF-8 .txt file with one 168-character line per guest, up to 1000 lines. Elabora shows which lines are correct and which are rejected, and you can send the correct ones and fix the rest.

### Is Fous affiliated with Polizia di Stato?

No. Fous is an independent product. You use it with your own Alloggiati Web account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Alloggiati Web (Polizia di Stato (Italy)). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.