06. DueBit.FatturaElettronica

h1. 2bit Fatturazione Elettronica

* [[Aspetti tecnici]]

* [Aspetti funzionali]]

h1. Panoramica

p{font-weight: 400;}. Progetto .Net C# 2017 per la creazione ed invio presso HUB del file XML con i dati delle fatture B2B.

h2. Struttura del progetto - Sezione .NET

p{font-weight: 400;}. Solution: C:\Sorgenti\[DotNet...]\FatturaElettronica\DueFatturaElettronica\DueFatturaElettronica\DueFatturaElettronica.sln

p{font-weight: 400;}. Progetti:

* %{font-weight: 400;}*DueFatturaElettronica*: contiene l'interfaccia a COM per utilizzare i metodi di creazione da ambiente VB6 + contiene i riferimenti al pacchetto FatturaElettronica by Nicola Iarocci, che espone un DTO strutturato per caricare i dati della fattura, eseguire una prevalidazione ed esportare in JSON la struttura dati secondo normativa.%

* %{font-weight: 400;}*DueCSolutionGatewayFAE*: contiene dei servizi per inviare presso HUB "2C Solution" l'XML con i dati della fattura elettronica. Permette di inviare, recuperare o ottenere lo stato di una o piu fatture.%

* %{font-weight: 400;}*Test* : Console di test per provare la solution.%

Il pacchetto NuGet è il seguente:

!{height: 126px; width: 683px;}20190218-120348-510.png!

h2. *Struttura del progetto - Sezione .COM*

Le DLL prodotte in .NET sono distribuite nella cartella "Lib\NET\DueFatturaElettronica"

!{height: 378px; width: 282px;}20190218-120546-176.png!

In ambito vb6 la libreria utilizzata è "DueFatturaElettronica.dll", referenziata da "DueFatturaElettronica.tlb" nei seguenti progetti:

* Due.vbp (C:\Sorgenti\DueBitSLN_trunk\DueApplication\Sorgenti\Due\)

* SchedulerFatturaElettronica.vbp (C:\Sorgenti\DueBitSLN_trunk\DueApplication\Sorgenti\Due_SchedulerFattureElettroniche\)

E' possibile dichiarare un oggetto di tipo ComInterface, che avrà i seguenti metodi:

!{height: 166px; width: 345px;}20190218-121146-191.png!

Sono evidenziati i due piu importanti.

Esiste un altro progetto vb6 chiamato "Scheduler Fattura Elettronica", che è un activeX-exe ed è referenziato in:

* Due.vbp (C:\Sorgenti\DueBitSLN_trunk\DueApplication\Sorgenti\Due\)

* AvvioAutomaticoEasypos.vbp (C:\Sorgenti\DueBitSLN_trunk\DueEasyPos\Sorgenti\avvioAutomaticoEasyPOS\)

h2. Aggiornamento dei binari .Net

E' possibile distribuire i binari .NET aggiornati con il setup di aggiornamento del software, oppure sfruttando 2BitInstaller.

L'applicativo, infatti, al suo avvio da parte di DUE, effettua un check nel server web e recupera uno zip presente in una specifica cartella. 

Se la versione indicata nel nome di questo file è maggiore di quella che è presente nel pc, il pacchetto zip viene scaricato, decompresso in LIB\NET\DueFatturaElettronica, sovrascrivendo le vecchie librerie .NET con quelle nuove.

Ogni zip al suo interno contiene tutto l'occorrente per la gestione delle FE, compreso un file "leggimi.txt" contenente il change-log dei rilasci. 

h2. Come creare il pacchetto ZIP

Il pacchetto ZIP deve essere creato a mano, compattando i binari prodotti dalla compilazione in release della solution .Net DueFatturaElettronica.

Prima di compilare la solution:

* modificare il file "leggimi.txt" aggiungendo cosa è cambiato

* aumentare di 1 la major version del progetto DueFatturaElettronica:

!{height: 424px; width: 1029px;}20190218-122831-344.png!

!{height: 572px; width: 821px;}20190218-122152-077.png!

Il pacchetto zip deve poi essere copiato manualmente nella macchina su web, cartella D:\InetPub\vHosts\ApplicationInstaller.duebit.com\updates\Repository\FE

dove sono presenti due cartelle, una per versione beta (es: 20), e una per la stabile (es 19).

Rispettare il nome del file che dovrà essere simile a "FatturaElettronica18_v013.zip", dove con 18 si indica la versione di riferimento (18, 19, 20), e con "v0xx" il numero di versione della libreria, che dovrà aumentare di 1 alla volta.

h1. PRINCIPI DI FUNZIONAMENTO

h2. *Configurazione base*

p{font-weight: 400;}. Nella sezione impostazioni azienda è disponibile una sezione per la configurazione della FE:

p{font-weight: 400;}. !{height: 375px; width: 612px;}20190218-123144-197.png! 

*Codice regime fiscale*<notextile></notextile>: è necessario indicare il codice secondo una codifica specifica:

table{background-color: transparent; border-collapse: collapse; border-spacing: 0px; border-style: none; border-width: 0px; font-family: Tahoma;}.

{background-color: #e7ebf7; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF01 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Ordinario |

{background-color: #f2f3f4; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF02 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Contribuenti minimi (art.1, c.96-117, L. 244/07) |

{background-color: #e7ebf7; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF03 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Nuove iniziative produttive (art.13, L. 388/00)  |

{background-color: #f2f3f4; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF04 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Agricoltura e attività connesse e pesca (artt.34 e 34-bis, DPR 633/72) |

{background-color: #e7ebf7; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF05 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Vendita sali e tabacchi (art.74, c.1, DPR. 633/72) |

{background-color: #f2f3f4; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF06 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Commercio fiammiferi (art.74, c.1, DPR 633/72) |

{background-color: #e7ebf7; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF07 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Editoria (art.74, c.1, DPR 633/72) |

{background-color: #f2f3f4; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF08 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Gestione servizi telefonia pubblica (art.74, c.1, DPR 633/72) |

{background-color: #e7ebf7; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF09 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Rivendita documenti di trasporto pubblico e di sosta (art.74, c.1, DPR 633/72) |

{background-color: #f2f3f4; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF10 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Intrattenimenti, giochi e altre attività di cui alla tariffa allegata al DPR 640/72 (art.74, c.6, DPR 633/72) |

{background-color: #e7ebf7; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF11 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Agenzie viaggi e turismo (art.74-ter, DPR 633/72)  |

{background-color: #f2f3f4; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF12 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Agriturismo (art.5, c.2, L. 413/91) |

{background-color: #e7ebf7; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF13 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Vendite a domicilio (art.25-bis, c.6, DPR 600/73) |

{background-color: #f2f3f4; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF14 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Rivendita beni usati, oggetti d'arte, d'antiquariato o da collezione (art.36, DL 41/95) |

{background-color: #e7ebf7; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF15 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Agenzie di vendite all'asta di oggetti d'arte, antiquariato o da collezione (art.40-bis, DL 41/95) |

{background-color: #f2f3f4; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF16 |\8{color: inherit; font-family: inherit; font-size: inherit;}. IVA per cassa P.A. (art.6, c.5, DPR 633/72) |

{background-color: #e7ebf7; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF17 |\8{color: inherit; font-family: inherit; font-size: inherit;}. IVA per cassa (art. 32-bis, DL 83/2012) |

{background-color: #f2f3f4; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF18 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Altro |

{background-color: #e7ebf7; color: #666666; font-size: 10pt;}. |\2{color: inherit; font-family: inherit; font-size: inherit;}. RF19 |\8{color: inherit; font-family: inherit; font-size: inherit;}. Regime forfettario (art.1, c.54-89, L. 190/2014) |

*Percorso esportazione XML fatture attive:* indica dove verrà generato il file XML se alle fatture verrà utilizzata la funzione "Genera XML"

*[ ] Controlla esito invio fatture attive da questa opstazione ogni x min:* abilita un monitoraggio dell'esito invio fatture all'HUB convenzionato con 2bit ed aggiorna automaticamente l'esito nella testata della fattura.

*[ ] Invio automatico fatture attive ad Hub da questa postazione ogni x min*<notextile></notextile>: abilita l'invio automatico ad hub delle fatture almeno stampate, esportate in pdf o inviate via mail dalla postazione corrente

*[ ] Download delle fatture passive da questa postazione degli ultimi x giorni:* effettua un check su HUB per scaricare un file XSL ed inviare a pc una notifica in presenza di nuove fatture da fornitori. Indicare il percorso in "Percorso download fatture passive".

*Testo da stampare su fatture cartacee:* Dalla versione 19.515 in poi di DUE è possibile indicare in tutti i formati di stampa (report a4, misuratore fiscale, tm88) un testo e i dati SDI/PEC relativi al cliente per la gestione della fattura elettronica, in termini di notifica di documento copia conforme. 

In Impostazioni azienda -- > Documenti è possibile determinare per quali sezionali abilitare l'invio ad hub delle fatture. Serve uno username ed una password che identifichi l'accesso al portale HUB 2C Solution. 

E' inoltre possibile specificare un "cedente prestatore", ovvero un cliente che associo ad un bollettario e che servirà al tool di invio dell'XML per recuperarne i suoi dati (SDI e PEC) inviando le fatture a quei riferimenti. Il codice destinatario è di fatto il codice hub che identifica il cliente nell'HUB 2C. 

h2. *Calcolo degli arrotondamenti*

p{font-weight: 400;}(wiki-class-MsoNormal). La dinamica che ha richiesto una rifattorizzazione "pesante" sulla logica della FE è legato al fatto che allo SDI non interessa minimamente il totale del documento fattura Emesso. Ai clienti SI.

p{font-weight: 400;}(wiki-class-MsoNormal). Quindi alla seconda o terza chiamata di clienti che hanno chiesto motivazione del fatto che il loro cliente gli contestasse il pagamento della fattura perche' di importo diverso da quella cartacea è stato necessario intervenire sull'arrotondamento prezzi.

p{font-weight: 400;}(wiki-class-MsoNormal). La fatturazione elettronica lavora sui prezzi imponibili, su cui calcola quindi l'iva. 2bit ha clienti che lavorano sulle fatture con prezzi ivati nel corpo. Inizialmente si era implementato il campo "arrotondamento fattura", previsto nel totale del documento, non trovando alcuna direttiva ministeriale. Tutto ha funzionato, il portale accettava le fatture.. il validatore della fattura elettronica pure. Purtroppo i clienti che ricevono le fatture emesse, il piu' delle volte NON vedono il campo arrotondamento nei documenti ricevuti. A questo punto, per arrotondare il documento, si è preso spunto da questo articolo:

p{font-weight: 400;}(wiki-class-MsoNormal). https://forum.italia.it/t/risolto-arrotondamenti-imposta-su-e-fattura/6504/21

p{font-weight: 400;}. Alla versione 13 della libreria, l'algoritmo risulta implementato e funzionante, garantendo uno scostamento di 1 centesimo al massimo tra il calcolo dell'imponibile o dell'iva: se la somma dei due è superiore di 1 centesimo rispetto al totale del documento, viene abbassato l'imponibile di 1 cent. Se è inferiore di 1 cent, viene aumentata l'iva di 1 cent.

p{font-weight: 400;}. Sopra 1 cent, non viene arrotondato nulla.

h2. Note fattura

Eventuali note indicate in testata della fattura saranno esportate nel nodo "DatiGenerali.DatiGeneraliDocumento.Causale". 

h2. Cendente prestatore

Nel caso si voglia indicare, come emettitore della fattura elettronica, un ente diverso dalla ragione sociale dell'azienda, è possibile indicare, nella sezione bollettari, un cliente registrato nell'anagrafica clienti come "cedente prestatore":

!{height: 324px; width: 530px;}20200121-112220-572.png! 

Nell'esempio sopra riportato, la fattura esportata in XML con sezionale "BIS" verrà emessa con emettitore *pari al cliente indicato come cedente prestatore (es: "Allevamento avicolo").*<notextile></notextile> Diversamente, l'xml generato avrà i dati anagrafici dell'azienda.

E' possibile esportare anche il dato di "Riferimento Amministrazione". E' sufficiente attivare la gestione dei *dati ulteriori* nella scheda del cliente, creare un gruppo di dati ulteriori per i clienti con la descrizione "Fattura Elettronica", ed un dato ulteriore di tipo testo con descrizione "<notextile></notextile>*RiferimentoAmministrazione".*<notextile></notextile> Il valore di questo dato nella scheda del cliente sarà usato per popolare il nodo "FatturaElettronicaHeader.CedentePrestatore.RiferimentoAmministrazione". 

h2. Cliente intermediario

Nel caso si voglia indicare, nel nodo "FatturaElettronicaHeader.TerzoIntermediarioOSoggettoEmittente", un soggetto intermediario, è necessario creare la chiave sulla tabImpostazioni, con descrizione "idClienteIntermediario", e valore pari all'id cliente da utilizzare per l'emissione dell'intermediario in tutte le fatture attive generate in XML. Per la costruzione del nodo, verranno recuperati dalla scheda del cliente:

* Ragione sociale

* partita iva

* codice fiscale

Per i dati extra relativi al cliente intermediario:

* *Anagrafica.CodEORI*

** Serve per l'indicazione del codice eventualmente attribuito al cedente/prestatore in base al Regolamento CE n. 312 del 16 aprile 2009

*** Creare una chiave su tabImpostazioni, descrizione "idClienteIntermediario_CodEORI", ed indicare nel campo "valore" il codice del cedente prestatore. 

* *FatturaElettronicaHeader.SoggettoEmittente*

** Formato alfanumerico; lunghezza di 2 caratteri; i valori ammessi sono i seguenti:

*** "CC" --> cessionario/committente.

*** "TZ" --> soggetto terzo.

*** Creare una chiave su tabImpostazioni, descrizione "FE_SoggettoEmittente". Indicare uno dei due valori descritti precedentemente. 

h2. Cessionario committente

Affinchè il destinatario della fattura sia valido, deve avere una nazione con il codice iso correttamente impostato. Verificare quindi l'anagrafica nazioni in Backoffice --> Anagrafiche -->  Profili --> Nazioni:

!{height: 313px; width: 249px;}20200121-114151-945.png!

!{height: 235px; width: 467px;}20200121-114320-754.png!

h2. Conai

E' possibile esportare, nella sezione DatiDocumento.Causali, una dicitura per indicare l'assolvimento del Conai.

E' sufficiente attivare la gestione dei dati ulteriori nella scheda del cliente, creare un gruppo di dati ulteriori per i clienti con la descrizione "Fattura Elettronica", e creare un dato ulteriore di tipo combobox (valore si/no) con descrizione "<notextile></notextile>*Conai*<notextile></notextile>".

!20200121-120128-945.png!

Nel caso il cliente presenti questo valore a "SI", l'xml generato avrà, nella sezione "DatiGenerali.DatiGeneraliDocumento.Causale", la riga descrittiva che indica il contributo conai:

!{height: 179px; width: 411px;}20200121-120318-002.png!

"CORRISPETTIVO COMPRENSIVO DEL CONTRIBUTO CONAI GIA' ASSOLTO DAL FORNITORE OVE DOVUTO"

La descrizione può essere variata inserendo una chiave nella tabImpostazioni (Descrizione chiave: "FE_RigaDescrittivaConai"). Il valore di questa chiave verrà utilizzato al posto del valore di default.

h2. Dati ordine di acquisto (CIG, CUP)

Per valorizzare i dati di ordine acquisto, è sufficiente indicare CIP e/o CUP nella testata della fattura da backoffice:

!20200121-114543-543.png!

Per indicare anche il riferimento del documento di acquisto, popolare i campi nella sezione Note:

!20200121-114659-547.png!

h2. Dichiarazione intento

p{font-size: 14px; font-weight: 400;}. La dichiarazione di intento viene automaticamente esportata nell'XML se è attiva nella fattura. Viene recuperata la registrazione più recente,ed espressa nel nodo "DatiDocumento.Causali", con questa dicitura:

p{font-size: 14px; font-weight: 400;}. "LETTERA D'INTENTO N. xxxx DEL yyyyyyyy"

p{font-size: 14px; font-weight: 400;}. Se è attivo un dato ulteriore specifico nel cliente, è possibile indicare nel nodo "DatiDocumento.Causali" una riga descrittiva aggiuntiva prima della dichiarazione di intento. E' sufficiente attivare la gestione dei dati ulteriori nella scheda del cliente, creare un gruppo di dati ulteriori per i clienti con la descrizione "Fattura Elettronica", e creare un dato ulteriore di tipo testo con descrizione "<notextile></notextile>*Causale*<notextile></notextile>". Nel caso il cliente presenti questo campo valorizzato, l'xml generato avrà, nella sezione "DatiGenerali.DatiGeneraliDocumento.Causale", questo valore.

h2. Numero di protocollo della ricevuta di dichiarazione d'intento

%{font-size: 14px; font-weight: 400;}Dal 1 gennaio 2020, le fatture elettroniche con dichiarazione di intento devono riportare il +numero di protocollo+ della ricevuta della dichiarazione di intento.%

Il fornitore dovrà quindi indicare nella fattura elettronica il numero di protocollo della ricevuta telematica fornito dall'esportatore abituale, rilevando che il suddetto numero di protocollo (e.g.  12345678901234567-000001) è composto da due parti:

* la prima, formata da 17 cifre (e.g. 12345678901234567)

* la seconda (progressivo), di 6 cifre, separata dalla prima dal segno "-" oppure "/" (e.g. 000001).

%{font-size: 14px; font-weight: 400;}Questo dato va inserito in ogni cliente previa creazione di un dato ulteriore specifico. %<notextile></notextile>E' sufficiente attivare la gestione dei dati ulteriori nella scheda del cliente, creare un gruppo di dati ulteriori per i clienti con la descrizione "Fattura Elettronica", e creare un dato ulteriore di tipo testo con descrizione "<notextile></notextile>*Numero Protocollo Ricevuta Dichiarazione Intento*<notextile></notextile>".

!20200121-120203-452.png!

!20200121-120501-929.png!

Nel caso il cliente presenti questo campo valorizzato, l'xml generato avrà, nella sezione "DatiGenerali.DatiGeneraliDocumento.Causale", una dicitura di questo tipo:

"Ricevuta dichiarazione di intento numero 12345678901234567-000001"

dove "Ricevuta dichiarazione di intento numero " è la parte fissa e non va indicata nei dati ulteriori.

La dicitura "Ricevuta dichiarazione di intento numero " può essere comunque variata, inserendo una chiave nella tabImpostazioni (Descrizione chiave: "<notextile></notextile>*FE_RigaDescrittivaRicevDichIntento*<notextile></notextile>"). Il valore di questa chiave verrà utilizzato al posto del valore di default.

h2. REA

Il REA o Repertorio Economico Amministrativo è un archivio delle informazioni delle attività iscritte e non al Registro delle Imprese.

Per indicare il numero REA in una fattura elettronica, devono essere creati questi record nella tabImpostazioni:

* Per il numero REA (richiesto valore di tipo stringa)

** Descrizione: REA_NumeroREA

** Valore: indicare il numero

* Per il capitale sociale (richiesto valore di tipo numerico)

** Descrizione: REA_CapitaleSociale

** Valore: indicare il valore del capitale sociale

* Per il socio unico (richiesto valore di tipo stringa)

** Descrizione: REA_SocioUnico

** Valore: indicare la stringa

* Per lo stato liquidazione (richiesto valore di tipo stringa)

** Descrizione: REA_StatoLiquidazione

** Valore: indicare la stringa

* Per l'ufficio di iscrizione (richiesto valore di tipo stringa)

** Descrizione: REA_Ufficio

** Valore: indicare la stringa