GuestAdmin Integration

GuestAdmin is SuiteOp’s integration for automated authority reporting and guest registration compliance. It handles submitting guest information to local government authorities — a legal requirement in many European countries.

Once connected, GuestAdmin automatically receives guest check-in data from SuiteOp and submits the required reports to the appropriate local authority on your behalf.

---

What GuestAdmin does in SuiteOp

• Authority reporting — Automatically submits guest registration data to local authorities when guests complete check-in
• Booking synchronization — Creates and manages GuestAdmin bookings linked to SuiteOp reservations
• Government compliance — Supports multiple government reporting systems (SES for Italy, SIBA/SEF for Portugal, and more)
• Guest check-in — Collects additional guest information (such as number of children) as part of the check-in flow

---

Prerequisites

Before setting up GuestAdmin, make sure you have:

• Admin or Owner role in SuiteOp (the manage_properties permission is required)
• Your government reporting credentials from your local tourism or police authority
• The property address details for each property you want to connect

---

Connecting GuestAdmin to your properties

1. Settings
2. Integrations
3. GuestAdmin

1. Open the GuestAdmin page

   Navigate to Settings > Integrations and select GuestAdmin. You will see a table showing all GuestAdmin properties, their active status, and the linked SuiteOp property.

2. Create a GuestAdmin property

   Click Connect Property to open the multi-step property creation form:

   Step 1 — Basic Info

   • Enter the property name and display name (the public-facing name guests may see)

   Step 2 — Location

   • Enter the full address: country, state/region, city, postal code, and street address
   • Country, state, and city use cascading dropdown selects — pick the country first, then state, then city

   Note

   If you link a SuiteOp property, the name, address, city, and postal code will auto-fill from the property’s existing details.

   Step 3 — Emergency & Access Codes

   • Add emergency contact information (name, phone number)
   • Enter access codes: door code, alarm code, and gate code

   Step 4 — Government Reporting

   • Select your government type (e.g., SES, SIBA/SEF)
   • Enter your housing code, payment method, and renter code
   • For SES (Italy): enter your fiscal code and SES credentials (username and password)
   • For SIBA/SEF (Portugal): enter your housing unit identifier

3. Link to a SuiteOp property

   After creating the GuestAdmin property, use the SuiteOp Property dropdown in the table to link it to the corresponding SuiteOp property. This link is required for reservations at that property to trigger authority reporting.

4. Verify the connection

   The property row should now show the linked SuiteOp property name and an active status.

   The GuestAdmin property is connected and will automatically receive guest check-in data when guests complete the authority reporting step.

---

Importing existing properties

If you already have properties configured in your GuestAdmin account, you can import them in bulk:

• Click Import Properties on the GuestAdmin page
• Select the properties you want to import
• Link each imported property to its corresponding SuiteOp property

---

Editing a property

To update a GuestAdmin property:

• Find the property in the table on the GuestAdmin integration page
• Click the Edit button
• Modify any of the four sections (basic info, location, emergency & access, government reporting)
• Click Save

---

How authority reporting works for guests

When a guest reaches the Authority Reporting step in their check-in flow on the guest portal:

1. The guest provides the number of children in their party (if applicable)
2. SuiteOp creates a booking in GuestAdmin with the reservation details
3. The guest’s information is submitted to GuestAdmin via the check-in API
4. GuestAdmin processes the data and submits the report to the local authority
5. SuiteOp receives a webhook confirmation and marks the step as Completed

If the submission fails, the step shows as Failed and the guest (or a manager) can retry. Managers can also reset the step from the reservation panel — see Override Verification.

---

Troubleshooting

Authority reporting step shows “Failed”

• Verify that the GuestAdmin property has the correct government reporting credentials
• Check that the property is linked to the correct SuiteOp property
• Try resetting the step from the reservation panel and have the guest retry

Property is not appearing in the table

• Make sure you have the manage_properties permission
• Refresh the page — the property list is fetched from GuestAdmin and may take a moment to load

Guest data is not being sent to GuestAdmin

• Confirm the Authority Reporting verification step is assigned to the property’s portal
• Verify the GuestAdmin property is linked to the correct SuiteOp property
• Check that the property is marked as Active in the GuestAdmin table

---

Related articles

• Authority Reporting with GuestAdmin — How authority reporting works in the verification flow
• Setting Up Guest Verification — Configure verification steps for your properties
• PMS Integrations — Connect your property management system