Italy Invopop Integration — How It Works

Mariia Korostashevych

Updated September 30, 2026 17:03

Invoice Scenarios Overview

When you open the Create Invoice dialog, Cloudbeds automatically detects the invoice scenario based on the payer type. The scenario determines which fields are required and which platform (SDI or Smart Receipts) the invoice is sent to.

Scenario	Payer Type	Required Fields	Platform	Best For
B2B Domestic	Italian company	Company name, Partita IVA, address, Codice Destinatario (optional) or PEC (optional)	SDI	Companies with Italian tax ID
B2B Foreign	Foreign company	Company name, tax ID, address	SDI	International companies
B2C Domestic	Guest with Italian address	Full name, Codice Fiscale, full address	SDI	Guests with Italian Codice Fiscale
B2C Foreign	Guest with foreign address	Full name, address (no Codice Fiscale required)	SDI	International guests
Simplified	Incomplete payer details	Name only (address/tax ID optional)	Smart Receipts	Prepaid OTA reservations, missing data

Note: "Domestic" refers to address, not nationality. A guest with a German passport but Italian address requires a Codice Fiscale and is treated as B2C Domestic.

Creating an Invoice: End-to-End Flow

The steps below explain how the two-step invoice creation process behaves for Italy, including Italy-specific payer requirements and fiscalization routing. For the general Cloudbeds workflow, see Two-Step Invoice Creation Flow (Pilot).

Step 1: Select Items to Invoice

Open a reservation's Folio
Click Create Invoice
On the Items to invoice screen, select the line items to be invoiced
Review the invoice total. This amount is compared against the simplified-invoice threshold
Click Next

Step 2: Select the Payer & Complete Required Fields

On the Bill To screen, set the Payer:
- Select the Billing contact (Guest or Company profile)
- Select the Email to address
- Select the Currency
Cloudbeds automatically detects and displays the scenario as a green badge (e.g., "B2B domestic") with an explanation
Complete the required fields for the detected scenario (marked with asterisks):
- Fields are editable inline. Type directly into them
- No need to navigate away and return
Optionally click Preview to review the document before issuing
Choose your action:
- Create Invoice: Issues a complete invoice sent to the tax authority (SDI)
- Create Simplified Invoice: Issues a simplified receipt-style document (Smart Receipts, if enabled and below threshold)
Click the appropriate button to submit

The following example shows the B2B domestic scenario on the Bill To step, including the payer and company information required before creating the invoice.

Field Requirements by Scenario

B2B Domestic (Italian Company)

Field	Required	Notes
Company Name	✅	Official legal name
Partita IVA (Tax ID)	✅	11-digit Italian VAT number
Codice Destinatario	Optional	7-character SDI recipient code; if not provided, invoice routes via PEC or generic SDI inbox
PEC (Certified Email)	Optional	Alternative to Codice Destinatario; if both supplied, Codice Destinatario is used
Company Address	✅	Street address
Company Address 2	Optional	Additional address line
Company City	✅	City/municipality
Company Province	✅	Italian province/region
Company Country	✅	Should be Italy
Postal Code	✅	ZIP/postal code

Pro tip: Codice Destinatario and PEC are mutually exclusive in practice. If both are supplied, Codice Destinatario takes priority and is printed on the invoice.

B2B Foreign (Non-Italian Company)

Field	Required	Notes
Company Name	✅	Official legal name
Company Tax ID	✅	Foreign tax ID (with country prefix for EU companies, e.g., FR12345678901)
Company Address	✅	Street address
Company City	✅	City
Company Country	✅	Non-Italy
Company Province/State	Optional	State or province if applicable
Postal Code	✅	ZIP/postal code

B2C Domestic (Guest with Italian Address)

Field	Required	Notes
First Name	✅	Guest's first name
Last Name	✅	Guest's surname
Codice Fiscale (Tax ID)	✅	Mandatory: 16-character Italian fiscal code. If guest cannot provide it, use Simplified Invoice instead.
Residence (Address)	✅	Street address
City	✅	City
Province	✅	Italian province
Postal Code	✅	ZIP/postal code
Country	Implicit	Italy

Critical: Without a Codice Fiscale, the tax authority rejects the transaction. If the guest cannot provide one, the Create Invoice button will remain disabled. Use Create Simplified Invoice instead.

B2C Foreign (Guest with Foreign Address)

Field	Required	Notes
First Name	✅	Guest's first name
Last Name	✅	Guest's surname
Street Address	✅	Full address
City	✅	City
Country	✅	Non-Italy
Postal Code	✅	ZIP/postal code

Simplified Invoice (Incomplete Payer Details)

Field	Required	Notes
Name	✅	Guest name or company name
Address details	Optional	May not be required depending on configuration
Tax ID	Optional	Not required for simplified route

Simplified invoices are ideal for prepaid OTA reservations where guest details are incomplete. The document is issued to Smart Receipts, not SDI.

The Rendered Fiscal Document

Once processing completes, Invopop renders the fiscal document. The layout reflects exactly what was transmitted to the tax authority:

Section	Displays
Issuer details	Your company name, address, Partita IVA
Payer details	Company or guest details as entered
Codice Destinatario or PEC	Printed for B2B invoices where supplied
Codice Fiscale	Printed for B2C domestic invoices
Line items	Description, VAT rate, taxable amount per line
VAT summary	Total VAT by rate (22%, 10%, 5%, 4%)
Tourist tax	Shown at 0% with exemption code N1 (if applicable)
Payment method	Recorded payment method; defaults to bank transfer if unpaid
Document number	Cloudbeds internal number for reference
ADE Reference (Simplified only)	Official number assigned by Agenzia delle Entrate

Download Options

Two versions are available:

Invoice PDF: The official fiscal document sent to the authority
Non-official copy (PDF): For internal or guest-facing use

The following example shows SDI invoice A-143-Z with Paid and Registered statuses. The document includes VAT details and tourist tax reported at 0% with exemption code N1.

Tracking Invoice Status on the Folio

Every issued document appears in the reservation's Documents tab with its amount, balance, payment status, and fiscalization status.

Fiscalization Status Meanings

Status	Meaning	Action Required
Registered	Accepted by the authority. The document is officially fiscalized	None, document is complete
Processing	Submitted to authority, awaiting confirmation	Wait (can take several hours for SDI)
Failed	Submission was rejected by the authority	See Troubleshooting section
Voided	Reversed by a credit note or corrective	None, document is cancelled

Payment Status (Independent of Fiscalization)

Payment status (Open, Paid, Partial) is separate from fiscalization status. An invoice can be:

Registered + Paid = Fiscalized and payment received
Registered + Open = Fiscalized but unpaid
Failed + Open = Not fiscalized, payment pending correction

Simplified Invoice Workflow

Use this flow when the guest's details are incomplete (common for prepaid OTA reservations).

Select posted charges to be invoiced
On the Bill To screen, set the payer (even if details are incomplete)
Review the scenario displayed. It will show "Simplified" if required fields are missing and the amount is below the threshold
If required payer fields are missing:
- Create Invoice button is grayed out (expected, indicates insufficient data for SDI)
- Create Simplified Invoice button remains available
Click Create Simplified Invoice
The transaction is sent to Smart Receipts (Fisconline), not SDI

Simplified Invoice Document Numbers

The simplified document carries two numbers:

Number	Assigned By	Use For
Document number	Cloudbeds	Internal reference within Cloudbeds
ADE Reference	Agenzia delle Entrate	Official document number for tracing in tax authority portal

Important: When a guest, accountant, or auditor needs to trace a simplified invoice in the AdE portal, provide the ADE Reference, not the Cloudbeds number.

The following example shows simplified invoice A-149-Z for Test SR. The AdE reference appears separately from the Cloudbeds invoice number and is the reference used for tracing the document with the Agenzia delle Entrate.

Processing Times

SDI (Full Invoices)

Submission: Immediate (submitted as soon as you click Create)
Authority processing: Several hours (Agenzia delle Entrate processes on its own schedule)
Status: Typically shows "Processing" for 2–4 hours, then updates to "Registered"

A pending status is normal and expected. Do not escalate unless the status has not changed after a full business day.