README

Libreria per interfacciarsi al Sistema di Interscambio Italiano al fine di gestire la fatturazione elettronica.

NOTA: la libreria è in corso di sviluppo e non ancora utilizzabile al momento

NOTA: per interfacciarsi realmente a SdI è necesario essere un soggetto accreditato

Webservice

Questa libreria mira a fornire le funzionalità necessario all'intermediario per inviare e ricevere fatture elettroniche al/dal SdI, e cioè:

esporre i webservice SOAP RicezioneFatture e TrasmissioneFatture
connettersi tramite client SOAP ai webservice del ministero SdIRiceviFile e SdIRiceviNotifica

Ai fini di permettere di effettuare test prima di interfacciarsi con SdI, la libreria offre anche le funzionalità inverse e cioè:

esporre i webservice SOAP SdIRiceviFile e SdIRiceviNotifica in modo da potersi connettere tramite il client SOAP generati dalla libreria stessa
connettersi tramite client SOAP ai webservice RicezioneFatture e TrasmissioneFatture esposti dalla libreria stessa

Ecco lo schema completo dei webservices e delle relative operazioni:

Servizio SdICoop RICEZIONE:
- ws RicezioneFatture (esposto dall'intermediario):
  - op. RiceviFatture
  - op. NotificaDecorrenzaTermini
- ws SdIRiceviNotifica (esposto dal SdI):
  - op. NotificaEsito
Servizio SdICoop TRASMISSIONE:
- ws SdIRiceviFile (esposto dal SdI):
  - op. RiceviFile
- ws TrasmissioneFatture (esposto dall'intermediario):
  - op. RicevutaConsegna
  - op. NotificaMancataConsegna
  - op. NotificaScarto
  - op. NotificaEsito
  - op. NotificaDecorrenzaTermini
  - op. AttestazioneTrasmissioneFattura
Servizio SDIDati:
- ws SdITrasmissioneFile:
  - op. Trasmetti
  - op. Esito

XML fattura

La libreria contiene anche le classi necessarie a generare e fare il parsing della fattura XML

Utilizzo

creazione webservice

Per ogni webservice che si vuole esporre è necessario utilizzare una classe che implementi l'interfaccia corrispondente al webservice fra quelle contenute in \PHPCraft\FatturazioneElettronica\ServerSOAP\InterfacceWebservice e che quindi esponga tutti i metodi corrispondenti alle varie operazioni del webservice, per esempio:

class MiaClassePerWebserviceRicezioneFatture implements \PHPCraft\FatturazioneElettronica\ServerSOAP\InterfacceWebservice\RicezioneFatture
{
    public function RiceviFatture($fileSdIConMetadati)
    {
        //eseguire le operazioni necessarie per l'operazione RiceviFatture
        ....
        //ritornare l'oggetto corretto per la risposta
        return new \PHPCraft\FatturazioneElettronica\TipiDati\RispostaRiceviFatture('ER01');
    }

    public function NotificaDecorrenzaTermini($fileSdI)
    {
        //eseguire le operazioni necessarie per l'operazione NotificaDecorrenzaTermini
        ...
        //ritornare nullo per questa operazione
        return null;
    }
}

È quindi possibile creare l'istanza del webservice:

//disabilitare la cache wsdl se si stanno utilizzando dei wsdl non ancora definitivi
ini_set("soap.wsdl_cache_enabled", "0");
//istanziare SOAP server Zend, il wsdl e le opzioni SOAP vengono impostate successivamente
$zendSOAPServer = new Zend\Soap\Server;
//istanziare la classe appropriata al server SOAP che si intende esporre fra RicezioneFatture, TrasmissioneFatture, SdIRiceviFile e SdIRiceviNotifica, per esempio RicezioneFatture
$server = new \PHPCraft\FatturazioneElettronica\ServerSOAP\RicezioneFatture(
    $opzioniSOAP    //array di opzioni SOAP come accettate dal SOAP server Zend
);
//iniettare l'istanza del SOAP server Zend
$server->injectServerSOAP($zendSOAPServer);
//iniettare l'istanze della classe che gestisce le operazioni del webservice
$miaClassePerWebserviceRicezioneFatture = new MiaClassePerWebserviceRicezioneFatture;
$server->injectIstanzaGestoreWebservice($miaClassePerWebserviceRicezioneFatture);
//porre il server SOAP in ascolto
$server->listen();

chiamata operazioni tramite client

//disabilitare la cache wsdl se si stanno utilizzando dei wsdl non ancora definitivi
ini_set("soap.wsdl_cache_enabled", "0");
//istanziare il client SOAP Zend
$zendSOAPClient = new Zend\Soap\Client;
//istanziare il client SOAP PHPCraft in base al webservice da chiamare, per esempio RicezioneFatture
$client = new $\PHPCraft\FatturazioneElettronica\ClientSOAP\RicezioneFatture();
//inietta il SOAP client Zend
$client->injectClientSOAP($zendSOAPClient);
//impostare location SE diversa da quella ufficiale contenuta nei wsdl, per esempio se si stanno testando i webservice sul proprio dominio
$client->setLocation('https://fatturazione-elettronica.mio.dominio/nome-webservice');


//preparare i parametri in input a seconda dell'operazione del webservice che si desidera chiamare, verificandoli nelle interfacce disponibili in \PHPCraft\FatturazioneElettronica\ServerSOAP\InterfacceWebservice, per esempio per RicezioneFatture -> RiceviFatture
$fileFattura = base64_encode(file_get_contents('percorso/alla/fattura.xml'));
$fileMetadati = base64_encode(file_get_contents('percorso/al/file/metadati.xml'));
$fileSdIConMetadati = new \PHPCraft\FatturazioneElettronica\TipiDati\FileSdIConMetadati(
    123,    //identificatiovo bumerico file
    'nome del file',
    $fileFattura,
    'nome del file metadati',
    $fileMetadati
);
//la classe del client espone i metodi con i nomi delle operazioni (in questo caso RiceviFatture)
$return = $client->RiceviFatture($fileSdIConMetadati);

certificati

Panoramica dei documenti crittografici (chiavi, richieste di certificati, certificati) coinvolti; i blocchi di codice contengono i comandi openssl utilizzati, le frasi in corsivo sono riportate dalla documentazine e dai messaggi forniti dal SdI:

chiave privata + pubblica client: client-private-public.pem
- openssl genrsa –out client-private-public.pem 2048
chiave pubblica client: client-public.pem
- estratta dalla chiave privata + pubblica con:
openssl rsa -in client-private-public.pem -out client-public.pem -outform PEM -pubout
CSR client: client.csr
- openssl req -new -key client-private-public.pem -out client.csr
- per la CSR client è richiesto che nel "cn" (Common Name) della richiesta sia indicato il Codice Fiscale del Sottoscrittore preceduto da 'SDI-' (SDI-03084840168)
chiave privata + pubblica server: server-private-public.pem
- openssl genrsa –out server-private-public.pem 2048
CSR client: client.csr
- openssl req -new -key server-private-public.pem -out server.csr
- per la CSR server si può scegliere se procedere come per la CSR client oppure se inserire all'interno del "cn" l'hostname del server che ospita il servizio (inserito hostname).
certificati legati alle CSR: scaricabili da https://sdi.fatturapa.gov.it in Strumenti > Gestire il canale > Test interoperabilità > Download File dopo aver inviato via pec RichiestaAccreditamento.zip.p7m (la richiesta firmata digitalmente)
- i certificati necessari per la configurazione SSL dei propri ambienti, in base alle CSR inviate in fase di accreditamento
- certificato client: SDI-[codice-fiscale-inserito-nella-CSR-clien].cer
- certificato server: [valore-del-campo-CN-inserito-nella-CSR-server].cer
Kit di Test: scaricabile da https://sdi.fatturapa.gov.it in Strumenti > Gestire il canale > Test interoperabilità > Download File dopo aver inviato via pec RichiestaAccreditamento.zip.p7m (la richiesta firmata digitalmente)
- certificati di CA (Certification Authority):
  - caentrate.cer: certificato di CA per ambiente di produzione
  - CAEntratetest.cer: certificato di CA per validare il certificato SdI di test
- CERTIFICATI DI TEST:
  - testservizi.fatturapa.it.cer: Certificato SERVER esposto dai servizi di test del Sistema di Interscambio
  - SistemaInterscambioFatturaPATest.cer: Parte pubblica del certificato CLIENT utilizzato dal Sistema di Interscambio per invocare i servizi di test da voi esposti
- CERTIFICATI DI PRODUZIONE:
  - servizi.fatturapa.it.cer: Certificato SERVER esposto dai servizi del Sistema di Interscambio
  - SistemaInterscambioFatturaPA.cer: Parte pubblica del certificato CLIENT utilizzato dal Sistema di Interscambio per invocare i servizi da voi esposti

Documentazione SdI

phpcraft / fatturazione-elettronica

Maintainers

Details