PHPackages phpcraft/fatturazione-elettronica - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. phpcraft/fatturazione-elettronica ActiveLibrary[Utility & Helpers](/categories/utility) phpcraft/fatturazione-elettronica ================================= interfaccia di connessione al Sistema di Interscambio per la gestione della fatturazione elettronica Italiana 14PHP Since Dec 15Pushed 7y ago1 watchersCompare [ Source](https://github.com/vukbgit/PHPCraft.FatturazioneElettronica)[ Packagist](https://packagist.org/packages/phpcraft/fatturazione-elettronica)[ RSS](/packages/phpcraft-fatturazione-elettronica/feed)WikiDiscussions master Synced yesterday READMEChangelogDependenciesVersions (1)Used By (0) PHPCraft Fatturazione Elettronica ================================= [](#phpcraft-fatturazione-elettronica) 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](https://sdi.fatturapa.gov.it/SdI2FatturaPAWeb/AccediAlServizioAction.do?pagina=accreditamento_canale) Webservice ---------- [](#webservice) Questa libreria mira a fornire le funzionalità necessario all'[intermediario](https://www.fatturapa.gov.it/export/fatturazione/it/c-3.htm) 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 ----------- [](#xml-fattura) La libreria contiene anche le classi necessarie a generare e fare il parsing della fattura XML Utilizzo -------- [](#utilizzo) ### creazione webservice [](#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 [](#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 ----------- [](#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 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 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](https://www.fatturapa.gov.it/export/fatturazione/it/normativa/f-3.htm) ### Health Score 19 — LowBetter than 10% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity5 Limited adoption so far Community7 Small or concentrated contributor base Maturity39 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/2f9f22ea5c6a917786c6b88349285bd980af48ef3685a2a7ea0d2a1d0074dae9?d=identicon)[vukbgit](/maintainers/vukbgit) --- Top Contributors [![vukbgit](https://avatars.githubusercontent.com/u/7385327?v=4)](https://github.com/vukbgit "vukbgit (15 commits)") ### Embed Badge ![Health badge](/badges/phpcraft-fatturazione-elettronica/health.svg) ``` [![Health](https://phpackages.com/badges/phpcraft-fatturazione-elettronica/health.svg)](https://phpackages.com/packages/phpcraft-fatturazione-elettronica) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)