Skynet.WebServices 1.0.3-PreRelease

SKYNET WebServices

SKYNET WebServices - Integrazione con i gestionali .NET con la piattaforma contabile SKYNET

Caratteristiche

La libreria permette al software gestionale di utilizzare la piattaforma SKYNET per la veicolazione allo SdI dei documenti contabili, nonché per l'immediata loro messa a disposizione al proprio commercialista.

Gestione del ciclo attivo (VENDITE)

• Invio dei documenti contabili al SdI (Sistema di interscambio) di tutte le tipologie di fattura elettronica (B2G, B2B e B2C)
• Controllo dello stato di invio e recupero delle notifiche dello SdI (ricevuta consegna, notifica esito, etc.)
• Recupero dell'elenco documenti contabili inviati

Gestione del ciclo passivo (ACQUISTO)

• Recupero dell'elenco dei documenti ricevuti tramite il canale SdI
• Recupero dei dati del singolo documento ricevuto ivi incluse lle notifiche di ricezione
• Gestione dell'accettazione/rifiuto delle fatture

Installazione

SKYNET web services è su NuGet.

Dalla Package Console, in Visual Studio:

PM> Install-Package Skynet.WebServices

Oppure usare il comando equivalente nella UI di Visual Studio.

Documentazione

Specifiche

La libreria è compatibile con la versione 3.0 delle specifiche di integrazione disponibili di SKYNET

Configurazione

Tutte le chiamate devono essere eseguite creando un oggetto di tipo SkynetSso come segue. La classe SkynetSso richiede un oggetto SkynetSsoConfig ed i parametri necessari per la creazione sono l'indirizzo del server (host), la username e la password di accesso.

var config = new SkynetSsoConfig
    {
        Host = "https://sso.sediva.it",
        Username = "utente-test",
        Password = "password-test"
    };
var skynetSso = new SkynetSso(config);

Gestione errori

In caso di errore i metodi ritornano un'eccezione di tipo SkynetSsoException che riporta il messaggio con la motivazione dell'errore (es. file XML non conforme alle spcifiche). Di seguito un esempio per l'invio di una fattua attiva con la gestione degli errori.

try {
    // Invio della fattura
    var esitoCaricamento = skynetSso.InviaFatturaAttiva("c:\\temp\\IT00000000000_00000.xml");

    // Recupero dell'id fattura generato dal server
    var idFatturaCaricata = fatturaCaricata.Data[0].Id;

    // Visualizzo l'id della fattura caricata
    Console.WriteLine($"Fattura caricata con id = '{idFatturaCaricata}'");
}
catch (SkynetSsoException ex)
{
    // In caso di errore visualizzo il messaggio di errore
    Console.WriteLine($"Fattura NON caricata. Errore ritornato dal server {ex.Message}");
}

Ciclo attivo

Invio di una fattura elettronica XML

// Invio di una fattura da file esterno (percorso completo)
var esitoCaricamento = skynetSso.InviaFatturaAttiva("c:\\temp\\IT00000000000_00000.xml");

// Invio di una fattura da array di bytes
var esitoCaricamento = skynetSso.InviaFatturaAttiva("IT00000000000_00000.xml", xmlBytes);

Recupero di una fattura attiva

var idFattura = "2d4ef"; // Codice alfanumerico della fattura attiva da recuperare
var notifiche = false;   // true per includere le notifiche nella risposta dal server
var fattturaAttiva = skynetSso.GetFatturaAttiva(
    new GetFatturaAttivaRequest { Id = idFattura, Notifiche = notifiche });

Elenco delle fatture attive

var year = 2018;    // Anno di filtro
var month = 5;      // Mese di filtro (da 1 a 12)
var elencoFattureAttive = skynetSso.ElencoFattureAttive(
    new ElencoFattureAttiveRequest { Year = year, Month = month });

Ciclo passivo

Nuove fatture passive

Recupero dell'elenco delle fatture passive all'interno di un periodo di riferimento per le quali non è stato mai invocato il metodo di recupero.

var from = new DateTime(2018, 11, 1); // Data di inizio del periodo di filtro
var to = new DateTime(2018, 11, 30);  // Data di fine del periodo di filtro
var nuoveFatturePassive = skynetSso.NuoveFatturePassive(
    new FatturePassiveNuoveRequest { From = from, To = to });

Elenco fatture passive

Recupero dell'elenco delle fatture passive all'interno di un periodo di riferimento.

var from = new DateTime(2018, 11, 1); // Data di inizio del periodo di filtro
var to = new DateTime(2018, 11, 30);  // Data di fine del periodo di filtro
var elencoFatturePassive = skynetSso.ElencoFatturePassive(
    new ElencoFatturePassiveRequest { From = from, To = to });

Recupero fattura passiva

Recupero dei dati di dettaglio di una fattura passiva

var idFatturaPassiva = "13dw";
var getFatturaPassiva = skynetSso.GetFatturaPassiva(
    new GetFatturaPassivaRequest { Id = idFatturaPassiva });