Invio della fattura
Per l’invio della fattura l’applicativo mittente deve utilizzare:
Una URL così composta:
http://<host-govway>/govway/sdi/out/xml2soap/<SoggettoSDI>/CentroServiziFatturaPA/SdIRiceviFile/v1?Versione=<VersioneFatturaPA>&TipoFile=<TipoFile>&IdPaese=<IdPaese>&IdCodice=<IdCodice>
dove:
host-govway: è l’hostname con cui è raggiungibile l’istanza di Govway.
SoggettoSDI: il soggetto interno al dominio come configurato durante l’esecuzione del govlet di fatturazione passiva.
Versione: versione della fattura che si sta inviando: FPA12 (Fattura 1.2 per Pubbliche Amministrazione), FPR12 (Fattura 1.2 per Privati), SDI11 e SDI10 (Fattura per Pubblica amministrazione versione 1.1. e 1.0).
TipoFile: tipo di fattura: XML (Fattura firmata XADES), P7M (Fattura firmata CADES) o ZIP (archivio di fatture).
IdPaese e IdCodice: dati del trasmittente della fattura.
L’invocazione deve essere corredata dalle credenziali che sono state indicate durante la configurazione tramite il relativo govlet.
A seconda del tipo di fattura deve essere utilizzato il corretto header http Content-Type:
XML: è possibile utilizzare text/xml o application/xml
P7M: application/pkcs7-mime
XML: application/zip
Un esempio di invio di una fattura viene fornito tramite il seguente comando curl:
Soggetto Interno al Dominio
In questo esempio si suppone che il nome del soggetto (riferito precedentemente come SoggettoSDI) fornito durante la fase di installazione di GovWay sia Ente.
curl -X POST -basic --user SdIRiceviFile:123456 \
--data-binary @IT01234567890_11111.xml.p7m \
-H "Content-Type: application/pkcs7-mime" \
"http://127.0.0.1:8080/govway/sdi/out/xml2soap/Ente/CentroServiziFatturaPA/SdIRiceviFile/v1?Versione=SDI10&TipoFile=P7M&IdPaese=IT&IdCodice=01629370097"
Nota
La generazione di un nome di file univoco da associare alla fattura viene gestita da GovWay.
È possibile disabilitare tale gestione disabilitando la proprietà “org.openspcoop2.protocol.sdi.fatturazioneAttiva.nomeFile.gestione” nel file “/etc/govway/sdi_local.properties”. Se viene disabilitata la funzionalità (attiva per default), la gestione dei nomi dei file (correttezza sintattica, univocità, …) è demandata all’Applicativo Client che deve obbligatoriamente fornire il nome del file da associare alla fattura attraverso uno dei seguenti modi:
query parameter “NomeFile”
header http “SDI-NomeFile”
header http “GovWay-SDI-NomeFile”