Turn Alloggiati Web into an API

What you can build on Alloggiati Web

• Get receipts

  Build this

  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

  Build this

  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

  Build this

  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

  Build this

  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 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

  Build this

  Starts

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

  Step 1

  Get the receipts row for yesterday from the Ricevute section.

  Step 2

  Stop when there is no row for that date.

  Step 3

  Post the reference date, schedine sent and protocol number to your property system's webhook.

• Evening check of the guests sent today

  Build this

  Starts

  Every day at 21:00

  Step 1

  Read the Analisi section for the schedine sent today.

  Step 2

  Keep each guest's surname, first name and time sent.

  Step 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, 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.

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"
    }
  }'

{
  "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.

Read on November 12, 2026: Servizi Alloggiati: web service manual, Guida Servizio Alloggiati Web, Questura FAQ on Alloggiati Web.

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
• My ARC
• Amadeus Selling Platform Connect
• Travelport Smartpoint
• SES.Hospedajes
• Cvent Supplier Network
• Agoda YCS
• Booking.com Extranet
• Expedia Partner Central
• Trip.com eBooking
• Tripadvisor Management Centre
• Airbnb hosting dashboard
• GetYourGuide Supplier Portal
• Viator Supplier Center

Other industries: Portal Empresarial INFONAVIT, Rev360, Cégkapu, FCA RegData, DOB NOW, Loan Product Advisor.