Roraima Vendor Guide
Set up accommodation structures
What this page is for
A structure is a physical place managed by an Owner. Mark it as accommodation when guests stay overnight; leave it non-accommodation for places such as sports facilities or meeting rooms.
Menu path
Vendor Back Office → Listings and structures → Structures
The list shows totals for accommodation and non-accommodation structures. Each card includes its name, address, type, available region and CIN/ROSS1000, Sandbox or Disabled badges, and activity counters.
Add or edit a structure
Use Add structure for a new place or Edit on an existing card.
| Label | Purpose | Instruction | Condition |
|---|---|---|---|
| Property address | Stores the guest-facing location. | Select the address suggestion. | The region is derived from an Italian address. |
| Country * | Sets the country used by booking and accommodation rules. | Check the country selected from the address or choose it manually. | Required for every structure. |
| Structure name * | Identifies the place in your Back Office. | Enter a clear internal name. | Required. |
| Structure active | Controls whether connected offers remain for sale. | Keep enabled while the structure should accept bookings. | Disabling removes its public page and connected offers from sale. |
| House rules text | Provides rules accepted by the Buyer and shown to the guest. | Write clear practical rules. | Optional; one version per content language; up to 10,000 characters. |
| Offer the assistant to guests of this property | Enables the structure's guest assistant. | Enable it only when you want to fund guest replies. | Each completed reply costs 1 credit; up to 30 replies per booking per day. |
| Information text | Gives the assistant its structure-specific knowledge. | Add opening times, local recommendations and practical information. | Optional; the assistant needs this text or house rules to appear. |
| This structure hosts overnight stays | Defines accommodation status. | Enable for hotels, B&Bs, holiday homes and similar stays. | Controls accommodation-only sections. |
| Accommodation type | Records the accommodation category. | Choose Hotel, Bed and breakfast, Short-term rental, Agriturismo or Other accommodation. | Shown for accommodation structures. |
| Amenities and rules: Amenities | Tells guests which services the whole structure offers. | Turn on Wi-Fi, Parking, Breakfast, Pool, Lift, Beach, Airport shuttle or Gym when the structure has it. For Wi-Fi and Parking choose free or paid, for Breakfast included or paid, for Pool indoor or outdoor, for Beach direct access or private beach. | Optional. The choice under a service appears once you turn it on. |
| Amenities and rules: Rules | Tells guests the house rules that apply to every unit. | Choose an answer for Pets (yes, no, on request), Smoking (yes, no, outdoors only), Parties (yes, no), Children (yes, no) and Arrival (in person, self check-in, both). | Optional; one answer per row. |
| Amenities and rules: Languages spoken | Tells guests which languages you can welcome them in. | Turn on each language you speak with guests. | Optional; several languages can be on. |
| Report to Alloggiati Web also the stays that arrive from external calendars (Booking.com, Airbnb, Vrbo) | Extends reporting to stays imported from your external calendars. | Enable it when Roraima should report those guests too. | Roraima and manual bookings remain included independently. |
| Collect tourist tax for this structure | Turns tourist-tax collection on or off for this structure. | Enable it only if your municipality charges a tourist tax, then set the rules in the section below. | Shown for structures in Italy that host overnight stays. |
| Structure code (CIN/ROSS1000) * | Stores the official accommodation code. | Enter or later update the code issued by the competent authority. | An Italian accommodation structure can be saved without it, but connected offers cannot be published. |
| Alloggiati Web credentials: Username | Stores the Alloggiati Web account that the Questura issued for this property. Roraima uses it to report guests and to download the receipts. | Enter the issued username. | Leave the whole section empty to use the Alloggiati Web credentials saved on the Italian Compliance page. |
| Alloggiati Web credentials: Password | Stores the Alloggiati Web password. | Enter a new value only when changing it. | A blank field keeps the saved password. |
| Alloggiati Web credentials: Web service key | Stores the web service key generated on the Alloggiati Web portal. | Enter a new key only when changing it; it is different from the password. | The key is not shown again. A blank field keeps the saved key. Needed together with the username and password. |
| Regional portal for statistics (ISTAT): Portal username | Stores the account for the regional portal that collects guest arrivals and departures for ISTAT statistics. | Enter the issued value. | Different from the Alloggiati Web credentials. |
| Regional portal for statistics (ISTAT): Portal password | Stores the regional portal password. | Enter a new value only when changing it. | A blank field keeps the saved password. |
| Regional portal for statistics (ISTAT): SPID identifier (optional) | Stores the identifier used by supported regional portals. | Enter it only when required. | Optional. |
| Test mode (sandbox) | Keeps reporting in the test environment. | Leave enabled until the credentials have been verified. | Enabled by default. |
| Linked products | Assigns bookable units to the structure. | Select one product for each distinct physical unit. | A product belongs to only one structure. |
| QR at the entrance: Text above the QR, Text below the QR | Adds a short title and a short instruction printed with the QR code. | Write them if you want them on the printed sheet; the preview changes as you type. | Optional. The QR, its preview, Download for printing and Copy the link appear after the first save. |
| QR at the entrance: Booking arrivals | Lets the guests of bookings scan the QR on arrival. | Turn it on when the QR is up at the entrance. | Shown as On or Off. It does not affect purchases of equipment and spaces, which always work with the QR: the line Purchases of equipment and spaces — Always on appears when the structure has products of that category. |
| Notes | Stores private structure notes. | Add internal information when useful. | Optional. |
Describe the structure's amenities and rules
The Amenities and rules section sits right below the accommodation type and appears only when This structure hosts overnight stays is turned on. It holds 14 questions about the whole place, answered with buttons: there is nothing to type, and none of the questions is required.
Every answer you give appears to guests on the page of each unit linked to the structure, in its Amenities tab, on stay.roraima.io and in the AI assistants that look up Roraima listings. A button left off means "no answer", not "no": if the structure has no pool, leave Pool off and the pages simply say nothing about it.
Questions about a single unit, such as beds, bathrooms or air conditioning, are answered in the product's Bookings tab: see Booking configuration. A unit's page shows its own answers together with those of its structure.
Keep in mind:
- Saving the structure with This structure hosts overnight stays turned off deletes all its amenity answers. Turning it back on means answering again.
- Duplicate, on the structure page, creates a copy without the answers.
- Guests see only the town and province of the structure, never the street address, which stays reserved for guests who have booked.
Set up the tourist tax for an Italian structure
This section applies to structures in Italy only. The Tourist tax block appears once Country is set to Italy and This structure hosts overnight stays is turned on. A structure in any other country never shows it, and no tourist tax is calculated for it.
You are responsible for keeping these rules accurate for your municipality. Only the age exemption is applied automatically. Describe every other exemption, such as those for carers or school groups, in the legal text.
Each completed tourist-tax payment costs 3 credits. The cost is shown at the top of the block, before you decide whether to turn collection on.
| Label | Purpose | Instruction | Condition |
|---|---|---|---|
| Calculation method | Sets how each stay's tax is worked out. | Choose Fixed amount per person and night, or Percentage of accommodation total. | Percentage of accommodation total also reveals the amount cap below. |
| Rates and validity periods | Sets the amount or percentage charged, and the dates it applies to. | Use Add rate once for each period. Leave both dates blank for a rate that applies all year. | Periods cannot overlap, and Valid to cannot be earlier than Valid from. A row left completely empty is discarded. Saving with collection turned on needs at least one rate. |
| Maximum amount per person and night | Caps what the percentage method can charge for one guest for one night. | Enter the ceiling your municipality sets, or leave it empty if there is none. | Shown only when the calculation method is Percentage of accommodation total. |
| Maximum taxable nights | Limits how many nights of a single stay are taxed. | Enter the number of nights your municipality stops charging after. | Accepts 0 to 365. Set to 10 until you change it. |
| Exempt guests under age | Waives the tax for guests below the age you set. | Enter the age your municipality uses. Leave the field empty if it exempts nobody by age. | Accepts 0 to 120. Age is counted in whole years on the arrival day, so a guest who reaches that age on the day the stay begins still pays. An empty field turns the age exemption off. Entering 0 leaves it on, exempts nobody, and still asks every guest for a date of birth. |
| Legal text shown to guests | Explains the tax to the guest before they pay. | Write the rules your municipality applies, and describe every exemption other than the age one. | Saved separately for each language, and needed in at least one language when you save with collection turned on. The language chooser appears once the structure has been saved. |
| Official source URL | Points the guest to the rules your municipality publishes. | Enter the address of the municipality's own page for this tax. | Must be a complete web address. Roraima checks its format, not whether the page opens. Required together with the legal text: saving with only one of the two fails. |
What the age exemption needs from your guests
The age exemption can only be applied to a guest whose date of birth is known.
If your account does not have Alloggiati Web or ISTAT reporting turned on, guests are not asked for a date of birth anywhere else. Roraima asks for it on the guest's own booking page, and works out the tax once it has been entered. Until every guest has a date of birth on file, the booking page shows no amount and no way to pay it. Roraima shows no estimate in its place, because it cannot yet tell which guests are exempt. A missing date of birth holds back the tax only: it never stops the guest reaching the property.
If your account already has Alloggiati Web or ISTAT reporting turned on, the guest's date of birth is collected with their identity details, so no separate request appears. See Use Italy guest reporting for those two configurations.
Calendars of the connected listings
The structure shows the external calendars of each connected listing, read-only: their state and a link to the listing. You connect, pause and remove calendars in the External calendars tab of each listing, one unit at a time.
Delete or disable
Delete is refused while active bookings or pending reporting work still depend on the structure.
Disabling a structure stops sales and its public page. Automatic reporting already due for received stays continues; manual-file preparation resumes when the structure is enabled again.
Related guidance
Use Booking configuration to connect a bookable product. Use Use Italy guest reporting for the separate Italy credentials and receipts page.