Versione corrente dello schema XML

Il valore è definito (codificato in modo fisso) nella versione di release di RetailForce

Impostazione condizionale nella configurazione:

• se il sistema supporta sia le fatture che le ricevute, viene indicata la lettera «F» sia per «[0] = Ricevuta» che per «[1] = Fattura»
• se il sistema emette SOLO ricevute (NESSUNA fattura), viene indicata la lettera “R” sia per “[0] = Ricevuta”
  • in questo caso "[1] = Fattura" non deve essere emessa

IndirizzoAzienda.Via

+

IndirizzoAzienda.StreetNumber

Deve contenere

• nome della via,
• numero civico e
• piano

se applicabile

Data di inizio del periodo di riferimento del file (StartDate)

Esporta "fromDate"

Data di fine del periodo di validità del file (EndDate)

Esportazione di "UntilDate"

Nome dell’applicazione che genera il file SAF-T (PT).

Il nome commerciale del software e quello dell’azienda produttrice nel formato «Nome dell’applicazione/Nome dell’azienda produttrice del software».

Se Partner.IsBusiness: true

• Partner.ID"

Se Partner.IsBusiness: false

• Si impiega la stringa "Consumidor final" (per consumatore finale).

Identificativo univoco del cliente (CustomerID)

Non può esistere più di un record con lo stesso CustomerID nell’elenco dei clienti.

Nel caso dei consumatori finali, occorre creare un cliente generico con la denominazione «Consumidor final» («Consumatore finale»).

Poiché non vengono presentati dati contabili (generalLedger), si utilizzi il valore «Sconosciuto»

«Desconhecido»

Codice conto (AccountID)

È necessario indicare il conto corrente del cliente nel piano dei conti, se definito. In caso contrario, deve essere compilato con la dicitura «Sconosciuto» («Desconhecido»).

Se IsBusiness: true:

• Partner.VatNumber

Se IsBusiness: false:

• viene utilizzato '999999990' (per il consumatore finale)

Codice fiscale del cliente (CustomerTaxID)

Tale codice deve essere indicato senza il prefisso del Paese.

Il cliente generico, corrispondente al «consumatore finale» («Consumidor final») designato, deve essere identificato con il numero di identificazione fiscale «999999990».

Se IsBusiness: true:

• Partner.Caption

Se IsBusiness: false:

• Viene utilizzato il termine «Consumidor final» (Consumatore finale)

Nome dell’azienda (CompanyName)

Il cliente generico deve essere identificato come “Consumatore finale” (“Consumidor final”).

Indirizzo di fatturazione (BillingAddress)

Corrisponde all’indirizzo della sede legale o della stabile organizzazione sul territorio nazionale.

Partner.Via

+

Partner.StreetNumber

Si impiega il valore "Desconocido" qualora IsBusiness sia falso e non sia specificato alcun indirizzo.

Indirizzo dettagliato (AddressDetail)

Deve includere il nome della via, il numero civico e il piano, se applicabile.

Deve essere valorizzato con la stringa «Sconosciuto» («Desconhecido») nelle seguenti situazioni:

• Sistemi non integrati, qualora le informazioni non siano note;
• Transazioni effettuate con il «Consumatore finale» («Consumidor final»).

Partner.Città

Si impiega il valore “Desconoscito” qualora IsBusiness sia false e non venga fornito alcun indirizzo.

Località (Città)

Deve essere valorizzato con la stringa “Sconosciuto” (“Desconhecido”) nelle seguenti situazioni:

• Sistemi non integrati, qualora le informazioni non siano note;
• Transazioni effettuate con il «Consumatore finale» («Consumidor final»).

PostalCode

Si impiega il valore “Desconoscito” qualora IsBusiness sia false e non venga fornito alcun indirizzo.

Codice postale (PostalCode)

Deve essere valorizzato con la stringa “Sconosciuto” (“Desconhecido”) nelle seguenti situazioni:

• Sistemi non integrati, qualora le informazioni non siano note;
• Transazioni effettuate con il «Consumatore finale» («Consumidor final»).

Se indicato:

• Partner.Community

Partner.CountryCode convertito in ISO 3166 ALPHA-2

Si impiega il valore "Desconocido" se IsBusiness è falso e non è specificato alcun indirizzo

Se noto, deve essere compilato in conformità con la norma ISO 3166 – 1-alpha-2.

Deve essere valorizzato con la stringa «Sconosciuto» («Desconhecido») nelle seguenti situazioni:

• Sistemi non integrati, qualora le informazioni non siano note;
• Transazioni effettuate con il «Consumatore finale» («Consumidor final»).

Indirizzo di spedizione (ShipToAddress)

Qualora siano richiesti più riferimenti, tale struttura può essere replicata tutte le volte che è necessario.

via

+

numero civico

Indirizzo dettagliato (AddressDetail)

Deve includere il nome della via, il numero civico e il piano, se applicabile.

Deve essere valorizzato con la stringa «Sconosciuto» («Desconhecido») nelle seguenti situazioni:

• Sistemi non integrati, qualora le informazioni non siano note;
• Transazioni effettuate con il «Consumatore finale» («Consumidor final»).

Località (Città)

Deve essere valorizzato con la stringa «Sconosciuto» («Desconhecido») nelle seguenti casistiche:

• Sistemi non integrati, qualora le informazioni non siano note;
• Transazioni effettuate con il «Consumatore finale» («Consumidor final»).

Codice postale (PostalCode)

Deve essere valorizzato con la stringa «Sconosciuto» («Desconhecido») nelle seguenti situazioni:

• Sistemi non integrati, qualora l’informazione non sia nota;
• Transazioni effettuate con il «Consumatore finale» («Consumidor final»).

Se noto, deve essere compilato in conformità alla norma ISO 3166 – 1-alpha-2.

Deve essere valorizzato con la stringa «Sconosciuto» («Desconhecido») nelle seguenti situazioni:

• Sistemi non integrati, qualora le informazioni non siano note;
• Transazioni effettuate con il «Consumatore finale» («Consumidor final»).

Indicatore di autofatturazione (SelfBillingIndicator)

Indicatore della presenza di un accordo di autofatturazione tra il cliente e il fornitore.

Deve essere valorizzato con “1” in presenza di un accordo e con “0” (zero) in assenza di accordo.

positions.ItemType

In caso di imposta aggiuntiva:

• AdditionalTaxType

In caso di depositi:

• BusinessTransactionType

Mappatura:

• P - [0] = Articolo (ItemType)
• S - [1] = Servizio (ItemType)
• O - se Tipo: 3 / [3] = Prenotazione
  E BusinessTransactionType: 7 / [7] = Deposito
  OPPURE
  2 / [2] = Deposito su vuoti
• E - “alcol”, “tabacco”, “veicolo a motore”, “benzina”, “fonti energetiche”, “elettricità”, “beni di lusso” (AdditionalTaxType)
• I - “altri“ (AdditionalTaxType)

Attualmente sono supportate le spese di spedizione

Indicatore del prodotto o del servizio (ProductType)

Deve essere compilato con:

«P» – Prodotti;

«S» – Servizi;

«O» – Altri (ad es. spese di spedizione, acconti ricevuti o cessione di beni);

«E» – Imposte speciali sui consumi – (ad es. IABA, ISP, IT);

«I» – Imposte, tasse e oneri parafiscali – ad eccezione del Vat e dell’IS, che devono essere riportate nella tabella 2.5 – Tabella delle imposte (TaxTable) e delle imposte speciali sui consumi, che devono essere indicate con il codice «E».

Identificativo del prodotto o del servizio (ProductCode)

Codice univoco del prodotto nell’elenco dei prodotti.

Descrizione del prodotto o del servizio (ProductDescription)

Tale descrizione deve corrispondere alla denominazione usuale dei beni o dei servizi forniti, specificando gli elementi necessari per determinare l’aliquota fiscale applicabile.

posizioni.GTIN, se specificato

altrimenti

positions.ItemId

Codice prodotto (ProductNumberCode)

È necessario utilizzare il codice EAN (Barcode) del prodotto.

Qualora non fosse presente, si inserisca il valore del campo 2.4.2. – Identificatore del prodotto o del servizio (ProductCode).

Codice della Nomenclatura Combinata (Codice NC)

Inserisca il codice della nomenclatura combinata delle merci dell’Unione europea.

Qualora fosse necessario inserire più di un riferimento, è possibile generare questo campo tutte le volte che sia necessario.

Numero UN (UNNumber)

Inserisca il numero UN relativo alle merci pericolose.

Qualora sia necessario inserire più di un riferimento, il campo può essere replicato per il numero di volte richiesto.

Codice del tipo di imposta (TaxType)

In questo campo deve essere indicato il tipo di imposta.

Deve essere compilato con:

«IVA» – Imposta sul Valore Aggiunto;

«IS» – Imposta di bollo;

“NS” – Non soggetto a IVA né a imposta di bollo.

derivato da FiscalRegions (del negozio)

• Portogallo
• Azzorre
• Madeira

Mappatura:

• Portogallo - «PT»
• Azzorre - «PT-AC»
• Madeira - «PT-MA»

Paese o regione fiscale (TaxCountryRegion)

Il campo deve essere compilato in conformità alla norma ISO 3166-1-alpha-2.

Nel caso delle Regioni Autonome di Madeira e delle Azzorre, deve essere compilato con:

«PT-AC» - Area fiscale della Regione Autonoma delle Azzorre; e

«PT-MA» - Area fiscale della Regione Autonoma di Madeira.

VatIdentification

In Portogallo si applicano le seguenti aliquote VAT:

Portogallo:

Aliquota ordinaria: 23%

Aliquota ridotta: 6%

Aliquota intermedia: 13%

Azzorre:

Aliquota ordinaria: 16%

Ala,

Aliquota intermedia: 9%

Madeira:

Aliquota ordinaria: 22%

Aliquota ridotta: 4% (in vigore dal: 01/10/2024)

Aliquota intermedia: 12%

Codice fiscale (TaxCode)

Nel caso in cui il campo 2.5.1.1 – Codice tipo d’imposta (TaxType) sia pari a Vat, deve essere compilato con:

• «RED» - Aliquota ridotta;
• «INT» - Aliquota intermedia;
• «NOR» - Aliquota normale;
• «ISE» – Esente; e
• «OUT» – Altri, applicabile a regimi speciali.

Nel caso in cui il campo 2.5.1.1 – Codice del tipo di imposta (TaxType) assuma il valore IS, tale campo deve essere compilato indicando:

• Il rispettivo codice articolo;
• «ISE» – Esente.

In caso di non assoggettabilità, deve essere compilato con “NS”.

Sulle ricevute emesse senza specificazione delle imposte, deve essere indicato “NA”.

generato in base a VatIdentification

• Normale
• Ridotta
• Esente
• Intermedia

L'imposta di bollo non è attualmente supportata

Data di scadenza (TaxExpirationDate)

Ultima data legale di applicazione dell’aliquota fiscale, in caso di modifica della stessa, nel corso del periodo d’imposta.

Percentuale dell’aliquota fiscale (TaxPercentage)

Il campo deve essere valorizzato qualora si tratti di un'aliquota fiscale.

In caso di esenzione o non imponibilità, si utilizzi questo campo con il valore “0” (zero).

Importo dell’imposta (TaxAmount)

Il campo deve essere valorizzato qualora si tratti di un importo fisso di imposta di bollo.

DocumentType:

• 0 / [0] = Ricevuta
• 1 / [1] = Fattura

Identificativo univoco del documento di vendita (InvoiceNo)

Tale identificativo è composto in ordine sequenziale dai seguenti elementi: il codice interno del tipo di documento assegnato dall’applicazione, uno spazio, l’identificativo della serie del documento, una barra (/) e il numero progressivo di tale documento all’interno di quella serie.

Non possono esistere registrazioni con lo stesso identificativo.

Lo stesso codice interno del tipo di documento non può essere utilizzato in tipi di documento diversi.

fiscalResponse.AdditionalFields.AtCud

SOLO in caso di SAF-T export: 

Il sistema a monte invia ATCUD in fiscalisationAdditionalFields.AtCudPortugal

Codice univoco del documento (ATCUD)

Il campo deve contenere il codice univoco del documento. Fino a quando non sarà regolamentato, il campo deve essere valorizzato con “0” (zero).

Il codice ATCUD è obbligatorio a partire dal 2023.

"N" per tutte le transazioni (vendite e resi), ma non per l'annullamento (cancellazione)

"A" se 

• Document.documentReference.ReturnReasonType: userMistake

“S” – non supportato

“R“ - non supportato

“F” - non utilizzato in RF

Stato attuale del documento (InvoiceStatus)

Deve essere valorizzato con:

• “N” – Normale;
• «S» – Autofatturazione;
• «A» – Documento annullato;
• «R» – Documento riepilogativo di altri documenti generati da applicazioni terze e prodotti da questa applicazione;
• «F» – Documento fatturato.

Data e ora dello stato attuale del documento (InvoiceStatusDate)

Data dell’ultima registrazione dello stato del documento, con precisione al secondo. Tipo di data e ora: “AAAA-MM-GGThh:mm:ss”.

Motivo della modifica dello stato (Reason)

È necessario indicare il motivo della modifica dello stato del documento.

Codice utente (SourceID)

Utente responsabile dello stato corrente del documento.

Origine del documento (SourceBilling)

Deve essere valorizzato con:

• “P” – Documento generato nell’applicazione;
• “I” – Documento integrato e generato in un’altra applicazione;
• «M» – Documento proveniente da recupero o emissione manuale;

fiscalResponse.signature

SOLO in caso di SAF-T export: 

Il sistema a monte invia l’Hash in FiscalAdditionalFields.HashPortugal

Chiave del documento (Hash)

Firma conforme all’Ordinanza n. 363/2010, del 23 giugno.

Il campo deve essere valorizzato con «0» (zero) qualora la certificazione non sia obbligatoria.

fiscalResponse.AdditionalFields.HashControlValue

SOLO in caso di SAF-T export: 

Il sistema a monte invia HashControl in FiscalAdditionalFields.HashControlPortugal

Chiave di controllo (HashControl)

Versione della chiave privata utilizzata per generare la firma nel campo 4.1.4.4. - Chiave del documento (Hash).

Il campo deve essere valorizzato con “0” (zero) qualora il documento sia generato da un applicativo non certificato.

Calcolato in base a FiscalYearStartMonth

se il valore è, ad esempio, 3 (= marzo) e l’esportazione è stata effettuata per aprile, il valore di <periodo> è “2”.</periodo>

Periodo contabile (Periodo)

Il mese del periodo d’imposta deve essere indicato con un numero compreso tra “1” e “12”, a partire dalla data di inizio dello stesso.

Data del documento di vendita (InvoiceDate)

Data di emissione del documento di vendita.

Mappatura:

FT: documentType": 1 / "[1] = Fattura

FS: documentType": 0 / "[0] = Ricevuta

FR: documentType: 0 / "[0] = Ricevuta se Document.Partner è impostato (contiene dati).

ND: non supportato

NC: "DocumentType": 0 / "[0] = Ricevuta" OPPURE "DocumentType": 1 / "[1] = Fattura" se:

• CancellationDocument: true

VD, TV, TD, AA, DA obsoleti

Settore assicurativo (RP, RE, CS, LD, RA) non supportato

Tipo di documento (InvoiceType)

Deve essere compilato con:

• «FT» – Fattura, emessa ai sensi dell’articolo 36 del Codice del Vat;
• «FS» – Fattura semplificata, emessa ai sensi dell’articolo 40 del Codice del Vat;
• «FR» – Fattura-ricevuta;
• «ND» – Nota di addebito;
• «NC» – Nota di credito;
• «VD» – Vendita in contanti con fattura/ricevuta; (a)
• «TV» – Scontrino di vendita; (a)
• «TD» – Ricevuta di reso; (a)
• «AA» – Cessione di beni; (a)
• “DA” – Restituzione di beni. (a)

Per il settore assicurativo, qualora non siano inclusi nella tabella 4.3. – Documenti per la verifica di beni o servizi (Documenti di lavoro), è possibile compilare anche con:

• «RP» – Premio o ricevuta di premio;
• «RE» – Storno o ricevuta di storno;
• «CS» – Ripartizione tra i coassicuratori;
• «LD» – Ripartizione al coassicuratore capofila;
• «RA» – Riassicurazione accettata.

(a) Per i dati fino al 31 dicembre 2012.

Indicatore di autofatturazione (SelfBillingIndicator)

Deve essere valorizzato con “1” se si applica l’autofatturazione e con “0” (zero) in caso contrario.

Impostazione nella configurazione

• Regime standard (Indicatore = 0)
• Regime di contabilità di cassa (Indicatore = 1)

Indicatore del regime Vat in contanti (CashVATSchemeIndicator)

Indicatore di adesione al regime IVA in contanti.

Deve essere valorizzato con «1» in caso di adesione e con «0» (zero) in caso contrario.

Indicatore di fatturazione emessa a nome e per conto di terzi (ThirdPartiesBillingIndicator)

Deve essere valorizzato con «1» qualora si tratti di fatture emesse a nome e per conto di terzi e con «0» (zero) in caso contrario.

Codice utente (SourceID)

Utente che ha generato il documento.

Codice CAE (EACCode)

È necessario indicare il codice CAE relativo all’attività connessa all’emissione del presente documento.

Data di registrazione del documento (SystemEntryDate)

Data di registrazione del documento al secondo, al momento della firma. Formato data e ora: «AAAA-MM-GGThh:mm:ss».

Identificativo della transazione (TransactionID)

Il campo deve essere valorizzato quando il sistema di contabilità e fatturazione è integrato, anche se il tipo di file (TaxAccountingBasis) non è tenuto a includere le tabelle contabili.

È necessario indicare la chiave univoca della tabella 3. Movimenti contabili (GeneralLedgerEntries) della transazione in cui è stato registrato il presente documento, in conformità con la regola ivi definita per il campo 3.4.3.1 - Chiave univoca del movimento contabile (TransactionID).

Identificativo del cliente (CustomerID)

Chiave univoca per la tabella 2.2. – Tabella clienti (Customer), conforme alla regola ivi definita per il campo 2.2.1. – Identificativo univoco del cliente (CustomerID).

Luogo di scarico (ShipTo)

Informazioni relative al luogo e alla data di scarico in cui gli articoli venduti vengono messi a disposizione del cliente, o di chi da questi indicato nel caso di operazioni triangolari.

Identificativo della consegna (DeliveryID)

In caso di operazioni triangolari, devono essere indicati il luogo di consegna e il numero di Vat del destinatario.

Data di consegna (DeliveryDate)

Nel settore assicurativo, in questo campo deve essere inserita la data di scadenza del periodo di copertura del rischio.

partner.via

+

partner.streetNumber

partner.CountryCode

convertito in ISO 3166 ALPHA-2

Luogo di carico (ShipFrom)

Informazioni relative al punto di carico e alla data di inizio della spedizione degli articoli venduti al cliente.

Identificativo della consegna (DeliveryID)

È necessario indicare il numero di immatricolazione del veicolo di trasporto o del mezzo di spedizione utilizzato, ad esempio corriere espresso, ecc.

Data di ricezione (DeliveryDate)

Nel settore assicurativo, tale campo deve essere compilato con la data di inizio del periodo di copertura del rischio.

storeAddress.street

+

storeAddress.streetNumber (da Configurazione)

Data e ora di fine del trasporto (MovementEndTime)

Formato data e ora: «AAAA-MM-GGThh:mm:ss», dove «ss» può essere «00» in assenza di informazioni specifiche.

Data e ora di inizio del trasporto (MovementStartTime)

Formato data e ora: «AAAA-MM-GGThh:mm:ss», dove «ss» può essere «00» in assenza di informazioni specifiche.

Tale campo deve essere compilato qualora il documento assolva anche la funzione di documento di trasporto, in conformità alle disposizioni del Regime per le merci in circolazione, approvato con Decreto-Legge n. 147/2003 dell’11 luglio.

Numero di riga (LineNumber)

Le righe devono essere esportate nello stesso ordine in cui compaiono nel documento originale.

Riferimento al documento di origine (OrderReferences)

Qualora fossero necessari più riferimenti, questa struttura può essere generata tutte le volte che sia necessario.

Numero del documento di origine (OriginatingON)

È necessario indicare il tipo, la serie e il numero del documento a supporto dell’emissione del presente documento.

Qualora il documento sia incluso nel file SAF-T (PT), è necessario adottare la struttura di numerazione definita nel campo di origine.

Identificativo del prodotto o del servizio (ProductCode)

Chiave del record nella tabella 2.4. – Tabella dei prodotti/servizi (Product), nel campo 2.4.2. – Identificativo del prodotto o del servizio (ProductCode).

Descrizione del prodotto o del servizio (ProductDescription)

Descrizione della riga della fattura, collegata alla tabella 2.4. – Tabella prodotti/servizi (Product), nel campo 2.4.4. – Descrizione del prodotto o del servizio (ProductDescription).

Posizioni.UnitàDiQuantità.isoCode

Utilizzare i codici ISO/UCUM

Prezzo unitario (UnitPrice)

Prezzo unitario al netto degli sconti di riga e di header, al netto delle imposte.

Deve essere compilato con «0,00» se il campo 4.1.4.19.8 deve essere compilato. - Valore unitario imponibile (TaxBase).

Utilizzato esclusivamente per gli articoli gratuiti,

se GrossValue: 0 e BaseGrossValue > 0

Valore imponibile unitario (TaxBase)

Valore imponibile unitario che non concorre al totale del documento al netto delle imposte (NetTotal). Tale valore viene impiegato come base per il calcolo delle imposte relative alla riga. Il segno (debito o credito) con cui l’imposta così determinata concorre all’importo dell’imposta dovuta (TaxPayable) deriva dalla presenza di DebitAmount o CreditAmount nella riga.

per "DocumentType": 0 / "[0] = Ricevuta

• = BookDate

per documentType": 1 / "[1] = Fattura

• = ServicePeriodEnd

Data di spedizione delle merci o di prestazione dei servizi (TaxPointDate)

Data di spedizione delle merci o di prestazione dei servizi.

Tale campo deve essere valorizzato con la data della bolla di consegna associata, qualora disponibile.

Qualora siano presenti più DDT, deve essere riportata la data del documento più risalente.

Riferimenti alle fatture (Riferimenti)

Riferimenti alle fatture nei relativi documenti correttivi.

Qualora fossero necessari più riferimenti, questa struttura può essere generata tutte le volte che sia necessario.

Numero di serie

Deve includere il numero di serie del prodotto indicato nel documento. Ad esempio: VIN, IMEI, ISSN, ISAN.

Qualora fosse necessario indicare più di un riferimento, questo campo può essere generato tutte le volte che è necessario.

Importo di addebito (DebitAmount)

Importo della riga, al netto delle imposte, dei documenti da registrare nel conto vendite.

Tale importo viene dedotto dagli sconti applicati a livello di riga e di intestazione.

Importo a credito

Importo della riga, al netto delle imposte, dei documenti da registrare come accredito sul conto vendite.

Tale importo viene detratto dagli sconti di riga e di header.

Codice tipo di imposta (TaxType)

In questo campo deve essere indicato il tipo di imposta.

Deve essere compilato con:

• “IVA” – Imposta sul Valore Aggiunto;
• “IS” – Imposta di bollo.
• “NS” – Non soggetto a IVA né a imposta di bollo.

derivato da FiscalRegions (del negozio)

• Portogallo
• Azzorre
• Madeira

Mappatura:

• Portogallo - «PT»
• Azzorre - «PT-AC»
• Madeira - «PT-MA»

Paese o regione fiscale (TaxCountryRegion)

Il campo deve essere compilato in conformità alla norma ISO 3166-1-alpha-2.

Nel caso delle regioni autonome di Madeira e delle Azzorre, deve essere compilato con:

• «PT-AC» - Area fiscale della Regione Autonoma delle Azzorre;
• «PT-MA» - Area fiscale della Regione Autonoma di Madeira.

VatIdentification

In Portogallo si applicano le seguenti aliquote VAT:

Portogallo:

Aliquota ordinaria: 23%

Aliquota ridotta: 6%

Aliquota intermedia: 13%

Azzorre:

Aliquota ordinaria: 16%

Ala,

Aliquota intermedia: 9%

Madeira:

Aliquota ordinaria: 22%

Aliquota ridotta: 4% (in vigore dal: 01/10/2024)

Aliquota intermedia: 12%

Codice fiscale (TaxCode)

Codice fiscale nella tabella fiscale.

Nel caso del campo 4.1.4.19.15.1. – Codice del tipo di imposta (TaxType) = Vat, deve essere compilato con:

• “RED” - Aliquota ridotta;
• «INT» – Aliquota intermedia;
• «NOR» – Aliquota normale;
• «ISE» – Esente;
• «OUT» – Altri, applicabile a regimi speciali IVA.

Nel caso del campo 4.1.4.19.15.1 – Codice del tipo di imposta (TaxType) = IS, deve essere compilato con:

• Il rispettivo codice di bilancio;
• «ISE» – Esente.

In caso di non assoggettabilità, deve essere compilato con «NS».

Aliquota fiscale (TaxPercentage)

Il campo deve essere valorizzato qualora si tratti di un’aliquota d’imposta.

La percentuale d’imposta corrisponde all’aliquota applicabile al campo 4.1.4.19.13. - Importo a debito (DebitAmount) o al campo 4.1.4.19.14. - Importo a credito (CreditAmount).

In caso di esenzione o non imponibilità, si imposti questo campo al valore “0” (zero).

Importo dell’imposta (TaxAmount)

Questo campo deve essere compilato qualora si tratti di un importo unitario fisso di imposta di bollo. Tale importo, moltiplicato per la quantità (Quantity), concorre alla determinazione dell’imposta dovuta (TaxPayable).

Codici di motivo di esenzione M01-M99

fiscalResponse.printingFields

Motivo dell’esenzione fiscale (TaxExemptionReason)

Questo campo deve essere compilato quando i campi 4.1.4.19.15.4 - Percentuale d’imposta (TaxPercentage) o 4.1.4.19.15.5 -

Importo dell’imposta (TaxAmount) sono pari a zero.

È necessario fare riferimento alla disposizione di legge applicabile.

Questo campo deve essere compilato anche nei casi di esenzione dalle imposte di cui alla Tabella 2.5. - Tabella delle imposte (TaxTable).

Codice motivo di esenzione fiscale (TaxExemptionCode)

Deve essere compilato con il codice del motivo di esenzione o di non accertamento, reperibile nel Manuale di integrazione software – Comunicazione delle fatture all’AT.

Il campo deve essere compilato quando i campi 4.1.4.19.15.4 - Aliquota fiscale (TaxPercentage) o 4.1.4.19.15.5 - Importo dell’imposta (TaxAmount) sono pari a zero.

Questo campo deve essere compilato anche nei casi di non assoggettabilità alle imposte di cui alla tabella 2.5. – Tabella delle imposte (TaxTable).

Importo di liquidazione della riga (SettlementAmount)

Deve riflettere tutti gli sconti concessi (la quota degli sconti globali relativi a questa riga e quelli specifici della stessa riga) che incidono sul valore del campo 4.1.4.20.3. – Totale del documento con imposte (GrossTotal).

Codice di riferimento amministrativo (ARCNo)

Inserisca il codice assegnato dopo la convalida del documento amministrativo elettronico e-DA.

Qualora fossero necessari più riferimenti, questo campo può essere generato tutte le volte che è necessario.

Importo dell’accisa per la riga (IECAmount)

Importo dell’accisa incluso nella base imponibile della riga del documento, qualora non sia specificato in una riga separata del documento, con l’«Indicatore del prodotto o del servizio (ProductType)» = E.

Importo totale del documento al netto delle imposte (NetTotal)

Questo campo non deve includere gli importi relativi alle imposte elencate nella Tabella 2.5. – Tabella delle imposte (TaxTable).

Importo totale del documento, imposte incluse (GrossTotal)

Questo campo non deve includere eventuali ritenute fiscali presenti nella struttura 4.1.4.21. – Ritenuta fiscale (WithholdingTax)

Codice valuta (CurrencyCode)

Nel caso di valuta estera, questo campo deve essere compilato in conformità con la norma ISO 4217.

Importo totale in valuta estera (CurrencyAmount)

Valore del campo 4.1.4.20. 3. – Totale del documento, tasse incluse (GrossTotal), nella valuta originale del documento.

Tasso di cambio (ExchangeRate)

È necessario specificare il tasso di cambio impiegato per la conversione in EUR.

Accordi o modalità di pagamento.

Qualora fosse necessario più di un riferimento, questa struttura può essere generata tutte le volte che è necessario.

Accordi di sconto futuri (SettlementDiscount)

Deve essere compilato con gli accordi di sconto da applicare in futuro sul valore attuale.

Importo di regolamento (SettlementAmount)

Indica l’importo concordato per lo sconto futuro senza incidere sul valore attuale del documento indicato nel campo 4.1.4.20.3. — Totale del documento comprensivo di imposte (GrossTotal).

Data di regolamento concordata (SettlementDate)

L’informazione da includere è la data concordata per il pagamento con sconto

Condizioni di pagamento

Le informazioni da includere sono le condizioni concordate o il termine di pagamento.

In caso di pagamenti misti, gli importi devono essere indicati per tipologia di strumento di pagamento e data di pagamento.

Qualora sia necessario inserire più di un riferimento, tale struttura può essere replicata tutte le volte che è necessario.

payments.PaymentType

Mappatura:

• CC - 2 / CreditCard
• CD - 1 / EcCard
• CH - 14 / Assegno
• CI - non mappato
• CO - 4 / MultiPurposeVoucher
• CS
  • 6 / Deposito
  • 15 / CreditNote
• DE
  • 12 / CartaCliente
  • 13 / Fidelizzazione
• LC - non mappato
• MB - Mappatura:
• CC - 2 / CreditCard
• CD - 1 / EcCard
• CH - 14 / Assegno
• CI - non mappato
• CO - 4 / MultiPurposeVoucher
• CS6 / Deposito
• 15 / CreditNote
• DE12 / Carta cliente
• 13 / Fidelizzazione
• LC - non mappato
• MB - 5 / Fornitore di servizi di pagamento 
• NU - 0 / Contanti
• OU9 / Criptovaluta
• 10 / Applicazione per telefoni cellulari
• PR - non mappato
• TB - 11 / BankAccount
• TR - non mappato
• NU - 0 / Contanti
• OU
  • 9 / Criptovalute
  • 10 / Applicazioni per telefoni cellulari
• PR - non mappato
• TB - 11 / BankAccount
• TR - non mappato

Mezzi di pagamento (PaymentMechanism)

Deve essere compilato con:

• “CC” – Carta di credito;
• «CD» – Carta di debito;
• «CH» – Assegno bancario;
• «CI» – Credito documentario internazionale;
• “CO” – Assegno o carta regalo;
• «CS» – Compensazione del saldo del conto corrente;
• «DE» – Moneta elettronica, ad esempio quella memorizzata su carte loyalty o carte a punti;
• «LC» – Lettera di credito commerciale;
• «MB» – Riferimenti di pagamento per Multibanco;
• «NU» – Contanti;
• «OU» – Altri mezzi non elencati nel presente documento;
• «PR» – Scambio di beni;
• «TB» – Bonifico bancario o addebito diretto autorizzato;
• «TR» – Buoni di compensazione non salariali, indipendentemente dal loro supporto, ad esempio buoni pasto, buoni di istruzione, ecc.

Importo del pagamento (PaymentAmount)

È necessario specificare l’importo per ciascun metodo di pagamento.

Ritenuta alla fonte

Qualora fossero necessari più riferimenti, questa struttura può essere generata tutte le volte che è necessario.

Codice del tipo di ritenuta alla fonte (WithholdingTaxType)

In questo campo è necessario indicare il tipo di ritenuta d’acconto inserendo:

• “IRS” – Imposta sul reddito delle persone fisiche;
• “IRC” – Imposta sul reddito delle società;
• “IS” – Imposta di bollo.

Motivo della ritenuta alla fonte (WithholdingTaxDescription)

È necessario indicare la disposizione di legge applicabile.

Se il codice del tipo di imposta (WithholdingTaxType) è pari a IS, è necessario inserire il codice fiscale corrispondente.

Importo della ritenuta alla fonte (WithholdingTaxAmount)

È necessario indicare l’importo dell’imposta trattenuta.