Italy Invopop Integration — How to Set Up

Prerequisites Checklist

Before beginning setup, gather the following information:

• Partita IVA (Italian VAT number)
• Company legal name (as registered in Italy)
• Full company address (street, city, province, country, postal code)
• Fiscal regime (your Italian tax classification)
• All VAT rates used (22%, 10%, 5%, 4%, and any others)
• Tourist tax (imposta di soggiorno) rate if applicable
• All payment methods the property accepts
• AdE credentials (for Smart Receipts only):
  • Fiscal ID (from Agenzia delle Entrate portal)
  • Codice Fiscale
  • Password
  • PIN
  • Notification email (optional)
• Confirmation of AdE commercial-receipt issuer registration (for Smart Receipts)

Step 1: Access Fiscalization Settings

1. Open the Account menu
2. Click Settings
3. Select Fiscalization
4. Click Add Provider

Two providers are available for Italy:

• Invopop · SDI Invoicing: Handles B2B and B2C complete invoices routed through Sistema di Interscambio
• Invopop · Scontrino Elettronico: Handles simplified invoices via Fisconline/Entratel

Add both providers for full coverage. Each provider tile shows which document types it supports.

Step 2: Configure Invopop SDI Invoicing

This provider handles all standard invoices (B2B domestic, B2B foreign, B2C domestic, B2C foreign).

Registration Tab

1. Select Invopop SDI Invoicing from the provider dropdown
2. Fill in Company Details:
   • Legal name
   • Street address
   • City
   • Province
   • Country
   • Postal code
   • Partita IVA (VAT number)
3. Select your Fiscal Regime (your Italian tax classification)
4. Click Save

Tax Codes Tab

Map each VAT rate used at your property to the correct Italian fiscal category:

• Click each rate and select the corresponding Italian category
• Click Save

Payment Methods Tab

Map each payment method your property accepts to its Italian fiscal code:

Examples:

• Bank Transfer → Bollettino Bancario (MP07)
• Credit Card → Carta di Pagamento (MP08)
• Cash → Contanti (MP01)
• Select each payment method from your Cloudbeds list
• Assign the corresponding Italian fiscal code
• Click Save

The following example shows the Invopop · SDI provider with Payment methods selected and all five payment methods mapped.

Currencies & Customization Tabs

Review and complete as needed:

• Currencies: Confirm the currency configuration (typically EUR for Italian properties)
• Customization: Leave as default unless instructed otherwise

Completion indicator: The provider tile will show a progress indicator. Every section must be complete before the provider is active.

Step 3: Configure Invopop Scontrino Elettronico (Smart Receipts)

This provider enables simplified invoices for incomplete payer details.

Registration Tab

1. Click Invopop · Scontrino Elettronico and select it from the dropdown
2. Fill in Company Details:
   • Legal name
   • Street address
   • City
   • Province
   • Country
   • Postal code
   • Codice Fiscale (your company's fiscal code)
3. Click Save

The following example shows the Registration tab for the Invopop · SR provider and the company information used for setup.

Authentication Tab

This tab is unique to Scontrino Elettronico and holds your Agenzia delle Entrate credentials.

Important: Credentials must come from the official Agenzia delle Entrate portal and must be fully working before entry.

1. Enter Fiscal ID (your AdE user ID)
2. Enter Codice Fiscale (your company's fiscal code)
3. Enter Password (AdE portal password)
4. Enter PIN (AdE portal PIN)
5. Optionally enter Notification Email for AdE alerts
6. Confirm AdE Issuer Attestation: Check the box confirming your property is registered with the Agenzia delle Entrate as a commercial-receipt issuer
7. Click Save

Note: Passwords and PINs are not stored for display. Saving new values replaces the existing credentials.

The Authentication tab below shows where the Agenzia delle Entrate credentials are entered and indicates when credentials are already on file.

Tax Codes Tab

Map tax codes again: This is a separate system from SDI.

• Click Save

Payment Methods Tab

Map payment methods again: Configuration does not carry over from SDI.

• Select each payment method
• Assign the corresponding Italian fiscal code
• Click Save

AdE Authorization

After completing the Authentication tab, Cloudbeds surfaces a link to Invopop's hosted Agenzia delle Entrate authorization page.

1. Click the authorization link
2. Complete the external authorization process (you'll be directed to the AdE portal)
3. Return to Cloudbeds
4. The Scontrino Elettronico provider will activate

During authorization, you are directed to the Agenzia delle Entrate Access the reserved area page and use the Fisconline/Entratel sign-in option.

Credentials expire every ~90 days. Set a calendar reminder to refresh them before expiry, otherwise simplified invoices will stop being issued.

Step 4: Enable Simplified Invoices (Optional)

If you want to offer simplified invoices for amounts below a threshold:

1. Go to Settings > Finance > Invoices and Documents
2. Scroll to Simplified Invoices section
3. Toggle Enable simplified invoices to ON
4. Enter Maximum Amount (e.g., €500 or €1,000 depending on your accountant's guidance)
5. Select When threshold is exceeded:
   • Show notice only: Agent sees a notice but can still issue a simplified invoice
   • Warn agent to switch to full invoice: Agent receives a warning; simplified button becomes blocked
6. Click Save

The following example shows Enable simplified invoices turned on, with a threshold amount and the action to take when the threshold is exceeded.

Note: Simplified invoices can only be issued for posted transactions. Charges must be posted to the folio before the option appears.

Step 5: Classify Taxes and Fees

Tax classification determines how charges are reported to the Italian authority and cannot be corrected retroactively once submitted.

1. Go to Settings > Finance > Taxes and Fees
2. Review the Classification column for every tax and fee:

3. For each tax/fee, click to edit and set the correct classification:
   • Standard VAT rates → Select VAT
   • Tourist tax → Select Municipal Tax
4. Click Save

The following example shows the configured VAT classifications and the Tourist tax classified as Municipal Tax.

Critical: If tourist tax is left classified as VAT, it will be reported as taxable revenue to the Agenzia delle Entrate. Verify this before issuing any invoices.

Step 6: Confirm Setup is Active

After completing all configuration steps:

1. Return to Settings > Fiscalization
2. Look at the status panel. It should show:

✅ "Your fiscal setup is active"

The panel displays both channels (SDI and Smart Receipts) with a Registered status.

If setup is not active:

• Check that both provider tabs are fully completed (Registration, Tax Codes, Payment Methods)
• Confirm the AdE authorization step was finished for Scontrino Elettronico
• Verify all required fields are filled in
• Ensure the Simplified Invoices setting is enabled (if using that feature)

Once active, new invoices will be transmitted to the appropriate platform automatically.

Configuration Summary Table

Troubleshooting Setup Issues

Next Steps

Once setup is active, use the resource that matches what you need to do next:

1. Understand Italy invoice behavior: Review Italy Invopop Integration: How It Works.
2. Create an invoice: Follow Two-Step Invoice Creation Flow (Pilot) for payer selection, scenario-based validation, and simplified-invoice behavior.
3. Monitor your first invoices: Check the Documents tab to confirm invoices are being transmitted and registered as expected.
4. Troubleshoot: Review Italy Invopop Integration: Troubleshooting and FAQ.