Questa documentazione presenta una panoramica completa dello schema di fatturazione Universal Business Language (UBL) 2.4, appositamente personalizzato per semplificare lo scambio elettronico dei dati delle fatture tra Google e i fornitori di fatturazione elettronica. Facilita la trasmissione standardizzata dei dati delle fatture, fondamentali per la loro elaborazione e successiva invio ai portali delle autorità fiscali statali.
Elementi dello schema della richiesta di fattura:
- Intestazione della fattura
- Informazioni sul fornitore
- Informazioni sull'acquirente
- Informazioni sulla consegna
- Elementi pubblicitari
- Tasse totali
- Ritenute fiscali
- Termini e modalità di pagamento
- Totale monetario legale
1. Intestazione della fattura
L'intestazione della fattura contiene informazioni di alto livello sulla fattura, tra cui numeri di identificazione, data e ora di emissione, tipo di fattura, valute e tassi di cambio.
| Elemento | Descrizione | Esempio |
|---|---|---|
| cbc:UBLVersionID | Standard di fattura UBL in uso | 2,4 |
| cbc:ID | Numero fattura | GCEMEAD0000000001 |
| cbc:UUID | ID richiesta fornitore Google: il valore deve essere presente nel messaggio di risposta per questa richiesta di fattura | 123e4567-e89b-12d3-a456-426614174000 |
| cbc:IssueDate | Data di emissione della fattura | 2023-06-01 |
| cbc:IssueTime | Ora di emissione della fattura (nel fuso orario del Pacifico degli Stati Uniti) | 08:20:00-08:00 |
| cbc:InvoiceTypeCode | Tipo di fattura. Valori supportati: 380 per Fattura | 380 |
| cbc:DocumentCurrencyCode | Valuta in cui viene presentata la fattura | USD |
| cbc:TaxCurrencyCode | Valuta per la quale è richiesta la conversione di TaxAmount | EUR |
| cac:TaxExchangeRate | ||
| └ cbc:SourceCurrencyCode | Valuta di origine per il tasso di cambio | USD |
| └ cbc:TargetCurrencyCode | Valuta di destinazione per il tasso di cambio | EUR |
| └ cbc:CalculationRate | Tasso di cambio per il calcolo delle imposte con una precisione di 2 decimali | 0,84 |
| cac:InvoicePeriod | ||
| └ cbc:StartDate | Data di inizio del periodo di fatturazione | 2023-05-01 |
| └ cbc:EndDate | Data di fine del periodo di fatturazione | 2023-05-31 |
| cbc:Note | Note o commenti aggiuntivi relativi alla fattura | Questa è una nota di esempio per la fattura. |
Esempio
<Invoice>
<cbc:UBLVersionID>2.4</cbc:UBLVersionID>
<cbc:ID schemeID="Google">GCEMEAD0000000001</cbc:ID>
<cbc:UUID>123e4567-e89b-12d3-a456-426614174000</cbc:UUID>
<cbc:IssueDate>2023-06-01</cbc:IssueDate>
<cbc:IssueTime>08:20:00-08:00</cbc:IssueTime>
<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<cbc:DocumentCurrencyCode>USD</cbc:DocumentCurrencyCode>
<cbc:TaxCurrencyCode>EUR</cbc:TaxCurrencyCode>
<cac:TaxExchangeRate>
<cbc:SourceCurrencyCode>USD</cbc:SourceCurrencyCode>
<cbc:TargetCurrencyCode>EUR</cbc:TargetCurrencyCode>
<cbc:CalculationRate>0.84</cbc:CalculationRate>
</cac:TaxExchangeRate>
<cac:InvoicePeriod>
<cbc:StartDate>2023-05-01</cbc:StartDate>
<cbc:EndDate>2023-05-31</cbc:EndDate>
</cac:InvoicePeriod>
<cbc:Note>This is a sample note for the invoice.</cbc:Note>
</Invoice>
2. Informazioni sul fornitore
Questa sezione contiene i dettagli del venditore, tra cui ID fiscale, nome, indirizzo e dati di contatto.
2.1 cac:AccountingSupplierParty/cac:Party
Questo elemento rappresenta il venditore (Google).
| Percorso | Descrizione | Esempio |
|---|---|---|
| cac:PartyTaxScheme | ||
| └ cbc:CompanyID | Numero di identificazione fiscale del venditore | IE 9999999X |
| └ cbc:CompanyID/@schemeID | Identificatore dello schema fiscale | IVA |
| cac:PartyName | ||
| └ cbc:Name | Nome del venditore | Google Ireland Limited |
| cac:PostalAddress | ||
| └ cbc:AddressLine1 | Riga 1 dell'indirizzo del venditore | Gordon House |
| └ cbc:AddressLine2 | Riga indirizzo 2 del venditore | Barrow Street |
| └ cbc:CityName | Città del venditore | Dublino |
| └ cbc:PostalZone | Codice postale del venditore | D04 V4X7 |
| └ cac:Country/cbc:IdentificationCode | Codice paese del venditore | IE |
| cac:Contact | ||
| └ cac:Contact/cbc:Telephone | Numero di telefono del venditore | 545-123-4567 |
| └ cac:Contact/cbc:ElectronicMail | Indirizzo email di contatto del venditore | invoice@google.com |
Esempio
<Invoice>
...
<cac:AccountingSupplierParty>
<cac:Party>
<cac:PartyTaxScheme>
<cbc:CompanyID schemeID="VAT">IE 9999999X</cbc:CompanyID>
</cac:PartyTaxScheme>
<cac:PartyName>
<cbc:Name>Google Ireland Limited</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:AddressLine>Gordon House</cbc:AddressLine>
<cbc:AddressLine>Barrow Street</cbc:AddressLine>
<cbc:CityName>Dublin</cbc:CityName>
<cbc:PostalZone>D04 V4X7</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>IE</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:Contact>
<cbc:Telephone>545-123-4567</cbc:Telephone>
<cbc:ElectronicMail>invoice@google.com</cbc:ElectronicMail>
</cac:Contact>
</cac:Party>
</cac:AccountingSupplierParty>
...
</Invoice>
3. Informazioni sull'acquirente
Questa sezione contiene i dettagli dell'acquirente, tra cui ID fiscale, nome, indirizzo e dati di contatto. Se è necessario includere sia le informazioni dell'agenzia sia quelle dell'acquirente finale, cac:AccountingCustomerParty verrà utilizzato per rappresentare le informazioni dell'agenzia (acquirente principale) e cac:BuyerCustomerParty per le informazioni dell'acquirente finale (acquirente secondario).
3.1 cac:AccountingCustomerParty/cac:Party
Questo elemento rappresenta la parte cliente contabile. In caso di agenzia, questo elemento verrà utilizzato per inviare le informazioni dell'agenzia.
| Percorso | Descrizione | Esempio |
|---|---|---|
| cac:PartyTaxScheme/cbc:CompanyID | Numero di identificazione fiscale dell'acquirente | 0987654321 |
| cac:PartyTaxScheme/cbc:CompanyID/@schemeID | Identificatore dello schema fiscale, ripetibile se sono presenti più ID fiscali | TIN, NIP, SIREN, SIRET |
| cac:PartyLegalEntity/cbc:CompanyLegalFormCode | Codice che specifica la forma giuridica della società (valori possibili: 1 per Privato, 2 per Organizzazione) | 1 |
| cac:PartyLegalEntity/cbc:CompanyLegalForm | Una descrizione della forma giuridica della società (valori possibili: "Privato" o "Organizzazione") | Privato |
| cac:PartyName | ||
| └ cbc:Name | Nome dell'acquirente | Impresa edile di Jane |
| cac:PostalAddress | ||
| └ cbc:AddressLine1 | Riga indirizzo 1 dell'acquirente | 456 Market St |
| └ cbc:AddressLine2 | Riga indirizzo 2 dell'acquirente | Piano 4 |
| └ cbc:CityName | Città dell'acquirente | New York |
| └ cbc:PostalZone | Codice postale dell'acquirente | 10001 |
| └ cac:Country/cbc:IdentificationCode | Codice paese dell'acquirente | US |
| cac:Contact | ||
| └ cbc:Telephone | Numero di telefono di contatto dell'acquirente | 987-654-3210 |
| └ cbc:ElectronicMail | Indirizzo email di contatto dell'acquirente | j@construction.com |
3.2 cac:BuyerCustomerParty/cac:Party
Questo elemento viene utilizzato solo quando cac:AccountingCustomerParty viene utilizzato per inviare le informazioni sull'agenzia. Tutti gli elementi secondari sono identici in questi due elementi.
Esempio
<Invoice>
...
<cac:AccountingCustomerParty>
<cac:Party>
<cac:PartyTaxScheme>
<cbc:CompanyID schemeID="VAT">0987654321</cbc:CompanyID>
<cbc:CompanyID schemeID="SIREN">123456789</cbc:CompanyID>
<cbc:CompanyID schemeID="SIRET">98765432100015</cbc:CompanyID>
</cac:PartyTaxScheme>
<cac:PartyLegalEntity>
<cbc:CompanyLegalFormCode>2</cbc:CompanyLegalFormCode>
<cbc:CompanyLegalForm>Organization</cbc:CompanyLegalForm>
</cac:PartyLegalEntity>
<cac:PartyName>
<cbc:Name>Jane's Construction Company</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:AddressLine>99 pembroke square</cbc:AddressLine>
<cbc:CityName>Dublin</cbc:CityName>
<cbc:PostalZone>D04 P043</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>IE</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:Contact>
<cbc:Telephone>0439843234</cbc:Telephone>
<cbc:ElectronicMail>advert@ads.com</cbc:ElectronicMail>
</cac:Contact>
</cac:Party>
</cac:AccountingCustomerParty>
<cac:BuyerCustomerParty>
<cac:Party>
<cac:PartyTaxScheme>
<cbc:CompanyID schemeID="VAT">0987654321</cbc:CompanyID>
<cbc:CompanyID schemeID="SIREN">123456789</cbc:CompanyID>
</cac:PartyTaxScheme>
<cac:PartyName>
<cbc:Name>Jane's Construction Company</cbc:Name>
</cac:PartyName>
<cac:PostalAddress>
<cbc:AddressLine>456 Market St</cbc:AddressLine>
<cbc:AddressLine>Floor 4</cbc:AddressLine>
<cbc:CityName>New York</cbc:CityName>
<cbc:PostalZone>10001</cbc:PostalZone>
<cac:Country>
<cbc:IdentificationCode>US</cbc:IdentificationCode>
</cac:Country>
</cac:PostalAddress>
<cac:Contact>
<cbc:Telephone>987-654-3210</cbc:Telephone>
<cbc:ElectronicMail>j@construction.com</cbc:ElectronicMail>
</cac:Contact>
</cac:Party>
</cac:BuyerCustomerParty>
...
</Invoice>
4. Informazioni sulla consegna
Questa sezione contiene informazioni sulla fornitura di beni e servizi.
| Percorso | Descrizione | Esempio |
|---|---|---|
| cbc:ActualDeliveryDate | La data di fornitura del bene/servizio | 2023-05-17 |
5. Elementi pubblicitari
Le voci sono i singoli prodotti o servizi elencati nella fattura. Lo schema supporta uno o più elementi pubblicitari per fattura.
5.1 cac:InvoiceLine
Questa sezione descrive in dettaglio ogni articolo di una fattura, inclusi identificatori univoci, quantità, prezzi unitari e importi totali prima e dopo le imposte. Fornisce una suddivisione completa dei costi associati a ogni articolo fatturato.
| Percorso | Descrizione | Esempio |
|---|---|---|
| cbc:ID | Identificatore di questo elemento pubblicitario. Per una fattura di elementi pubblicitari aggregati, il valore è 1 | 1 |
| cbc:InvoicedQuantity | Quantità dell'articolo fatturato; per una fattura di elemento pubblicitario aggregato, il valore è 1 | 1 |
| cbc:LineExtensionAmount @currencyID | Importo totale dell'elemento pubblicitario nella valuta originale, escluse le imposte | 1000 |
| cac:Item/cbc:Name | Nome dell'articolo | Google Cloud |
| cac:Price/cbc:PriceAmount @currencyID | Prezzo unitario dell'articolo nella valuta originale | 1000 |
| cac:TaxTotal | ||
| └ cbc:TaxAmount @currencyID | Importo totale delle imposte nella valuta originale dell'elemento pubblicitario | 70 |
| └ cac:TaxSubtotal/cbc:TaxableAmount @currencyID | Importo imponibile nella valuta originale dell'elemento pubblicitario | 1000 |
| └ cac:TaxSubtotal/cbc:TaxAmount @currencyID | Importo delle imposte nella valuta originale dell'elemento pubblicitario | 70 |
| └ cac:TaxSubtotal/cac:TaxCategory/cbc:Percent | Aliquota fiscale applicata all'elemento pubblicitario | 7,00 |
| └ cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID | Tipo di imposta per questo totale parziale | IVA |
Esempio
<Invoice>
...
<cac:InvoiceLine>
<cbc:ID>1</cbc:ID>
<cbc:InvoicedQuantity>1</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID="USD">1000</cbc:LineExtensionAmount>
<cac:Item>
<cbc:Name>Google Cloud</cbc:Name>
</cac:Item>
<cac:Price>
<cbc:PriceAmount currencyID="USD">1000</cbc:PriceAmount>
</cac:Price>
<cac:TaxTotal>
<cbc:TaxAmount currencyID="USD">230</cbc:TaxAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="USD">1000</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="USD">230</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:Percent>23.00</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
</cac:InvoiceLine>
...
</Invoice>
6. Imposte totali
Questa sezione contiene le imposte totali applicabili alla fattura.
6.1 cac:TaxTotal
Questo elemento rappresenta l'imposta totale applicabile alla fattura. Questo elemento viene ripetuto quando è necessario presentare sia la valuta originale che quella locale.
| Percorso | Descrizione | Esempio |
|---|---|---|
| cac:TaxTotal/cbc:TaxAmount | Imposte totali applicabili alla fattura | 70,00 |
| cac:TaxTotal/cbc:TaxAmount/@currencyID | ID valuta dell'importo dell'imposta | USD |
6.2 cac:TaxSubtotal
Questo elemento fornisce una suddivisione per una singola categoria fiscale. Questo elemento è ripetibile per rappresentare diversi tipi di imposte.
| Percorso | Descrizione | Esempio |
|---|---|---|
| cac:TaxTotal/cac:TaxSubtotal/cbc:TaxableAmount @currencyID | Importo totale soggetto a tasse nella valuta originale | 1000.00 |
| cac:TaxTotal/cac:TaxSubtotal/cbc:TaxAmount @currencyID | Importo dell'imposta sull'importo imponibile nella valuta originale | 70,00 |
| cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:Percent | Percentuale di imposta applicabile all'importo imponibile | 7 |
| cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID | Nome dello schema fiscale, enum che supporta l'elenco dei codici fiscali specifici per paese | IVA |
Esempio
<Invoice>
...
<cac:TaxTotal>
<cbc:TaxAmount currencyID="USD">230</cbc:TaxAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="USD">1000</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="USD">230</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:Percent>23.00</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
<cac:TaxTotal>
<cac:TaxSubtotal>
<cbc:TaxAmount currencyID="PLN">920</cbc:TaxAmount>
<cbc:TaxableAmount currencyID="PLN">4000</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="PLN">920</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:Percent>23.00</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
...
</Invoice>
7. Ritenute fiscali
Ritenute fiscali applicate alla fattura. La ritenuta fiscale è un obbligo imposto dal governo al pagatore di un elemento di reddito di trattenere o detrarre l'imposta dal pagamento e di versarla al governo.
7.1 cac:WithholdingTaxTotal
Questo elemento rappresenta la ritenuta fiscale totale applicabile alla fattura.
Deve essere la somma di tutti gli elementi cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:TaxAmount.
| Percorso | Descrizione | Esempio |
|---|---|---|
| cac:WithholdingTaxTotal/cbc:TaxAmount @currencyID | L'importo totale della ritenuta fiscale | 6,5 |
7.2 cac:TaxSubtotal
Questo elemento fornisce una suddivisione per una singola categoria di ritenute.
| Percorso | Descrizione | Esempio |
|---|---|---|
| cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:TaxableAmount @currencyID | Importo imponibile (al netto delle imposte) per la categoria della ritenuta fiscale | 1000 |
| cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:TaxAmount @currencyID | L'importo dell'imposta per la categoria della ritenuta fiscale | 6,5 |
| cac:WithholdingTaxTotal/cac:TaxSubtotal/cbc:Percent | La percentuale di imposta per la categoria della ritenuta fiscale | 0,65 |
| cac:WithholdingTaxTotal/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID | Tipo di imposta per la categoria della ritenuta fiscale | PIS_WTH |
Esempio
<Invoice>
...
<cac:WithholdingTaxTotal>
<cbc:TaxAmount currencyID="USD">6.5</cbc:TaxAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="USD">1000</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="USD">6.5</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:Percent>6.5</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>PIS_WTH</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:WithholdingTaxTotal>
...
</Invoice>
8. Termini e modalità di pagamento
La sezione Termini e modalità di pagamento illustra le aspettative relative al pagamento, tra cui il metodo di pagamento, il canale di pagamento e la data di scadenza previsti.
8.1 cac:PaymentMeans/cbc:PaymentMeansCode
Questo elemento descrive il metodo di pagamento. Il codice PaymentMeansCode segue l'elenco di codici UN/ECE 4461. Nota: il codice PaymentMeansCode segue l'elenco di codici UN/ECE 4461, dove 31 indica il bonifico bancario.
| Percorso | Descrizione | Esempio |
|---|---|---|
| cbc:PaymentMeansCode | Metodo di pagamento | 30 per trasferimento credito, 31 per trasferimento debito |
| cbc:PaymentDueDate | Data di scadenza del pagamento | 2023-08-01 |
| cac:PayeeFinancialAccount/cbc:ID | ID conto finanziario di Google (utilizzato nello schema della fattura) | GB99DEMO12345678901 |
| cac:PayerFinancialAccount | ||
| └ cbc:ID | ID conto finanziario di Google (utilizzato nello schema CreditNote) | GB99DEMO12345678901 |
| └ cbc:Name | Il nome del conto bancario di Google | Banca Google |
| └ cbc:AccountTypeCode | Un codice che indica il tipo di conto bancario Google | UNKNOWN_ACCOUNT_TYPE = 0; CHECKING = 1; SAVINGS = 2; CURRENT = 3 |
8.2 cac:PaymentTerms/cbc:Note
Questo elemento fornisce eventuali informazioni aggiuntive sui termini di pagamento in formato di testo.
| Percorso | Descrizione | Esempio |
|---|---|---|
| cac:PaymentTerms/cbc:Note | Eventuali informazioni aggiuntive sui termini di pagamento | Termini di pagamento netto a 30 giorni |
Esempio
<Invoice>
...
<cac:PaymentMeans>
<cbc:PaymentMeansCode>30</cbc:PaymentMeansCode>
<cbc:PaymentDueDate>2023-08-01</cbc:PaymentDueDate>
<cac:PayerFinancialAccount>
<cbc:ID>GB99DEMO12345678901</cbc:ID>
</cac:PayerFinancialAccount>
</cac:PaymentMeans>
<cac:PaymentTerms>
<cbc:Note>Net 30 terms</cbc:Note>
</cac:PaymentTerms>
...
</Invoice>
9. Totale monetario legale
La sezione Totale monetario legale riassume l'importo totale dovuto sulla fattura, inclusi eventuali acconti o addebiti applicati, imposte, ritenute fiscali e l'importo finale pagabile.
9.1 cac:LegalMonetaryTotal
| Percorso | Descrizione | Esempio |
|---|---|---|
| cbc:LineExtensionAmount @currencyID | L'importo totale di tutte le righe di fattura prima dell'applicazione di eventuali tolleranze o addebiti. | 1000.00 |
| cbc:AllowanceTotalAmount @currencyID | Toleratenze totali per la fattura | 0,00 |
| cbc:TaxExclusiveAmount @currencyID | L'importo totale di tutte le righe di fattura dopo l'applicazione di eventuali tolleranze o addebiti, ma prima dell'applicazione delle imposte | 950,00 |
| cbc:TaxInclusiveAmount @currencyID | L'importo totale di tutte le righe di fattura dopo l'applicazione di eventuali tolleranze, addebiti e imposte | 1071,50 |
| cbc:PayableAmount @currencyID | L'importo totale da pagare dall'acquirente | 1065,00 |
Esempio
<Invoice>
...
<cac:LegalMonetaryTotal>
<cbc:LineExtensionAmount currencyID="USD">1000.00</cbc:LineExtensionAmount>
<cbc:AllowanceTotalAmount currencyID="USD">0.00</cbc:AllowanceTotalAmount>
<cbc:TaxExclusiveAmount currencyID="USD">1000.00</cbc:TaxExclusiveAmount>
<cbc:TaxInclusiveAmount currencyID="USD">1230.00</cbc:TaxInclusiveAmount>
<cbc:PayableAmount currencyID="USD">1230.00</cbc:PayableAmount>
</cac:LegalMonetaryTotal>
...
</Invoice>