Fatturazione elettronica - Manuale di programmazione ¶

Documentazione web 2CSolution: https://confluence.namirial.com/pages/viewpage.action?pageId=60004170

Panoramica¶

Progetto .Net C# 2017 per la creazione ed invio presso HUB del file XML con i dati delle fatture B2B.

Edit this section

Struttura del progetto - Sezione .NET¶

Solution: C:\Sorgenti\[DotNet...]\FatturaElettronica\DueFatturaElettronica\DueFatturaElettronica\DueFatturaElettronica.sln

Progetti:

• 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.
• 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.
• Test : Console di test per provare la solution.

Il pacchetto NuGet è il seguente:

Edit this section

Struttura del progetto - Sezione .COM¶

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

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:

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\)

Edit this section

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. 

Edit this section

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:

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.