API Interrogazione stato di un documento emesso

Controllo dello stato di un documento emesso (ciclo attivo)

Restituisce lo stato di un documento emesso.

Il WS può essere richiamato a seguito dell’invio di una fattura emessa (o nota di credito) per conoscere l’esito della verificare formale da parte dell’hub. Il WS può essere richiamato successivamente per conoscere lo stato della fattura a seguito dell’invio a SDI.

Se il formato di non è corretto e non supera i controlli formali le/le fatture vengono scartate ed è necessario rimandarle.

Endpoint WS: [base url]/webservices/DownloadStatoDocumento. svc

WSDL: [base url]/webservices/DownloadStatoDocumento.svc?wsdl

Metodo: DownloadStato

Username		username di accesso dell’azienda
Password		password di accesso dell’azienda
numeroFattura		numero del documento per il quale si richiede lo stato (es 1 o 1/b)
esercizioContabile		esercizio contabile (es. 2019, corrisponde all’anno della data documento)
tipoDocumentoSdi		tipo documento come da specifica SDI, es. TD01, TD02

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:tem="http://tempuri.org/">
   <soap:Header xmlns:wsa="http://www.w3.org/2005/08/addressing"><wsa:Action>http://tempuri.org/IDownloadStatoDocumento/DownloadStato</wsa:Action><wsa:To>https://hubfatturazione.it/webservices/DownloadStatoDocumento.svc</wsa:To></soap:Header>
   <soap:Body>
      <tem:DownloadStato>
         <tem:username>zzzzzz</tem:username>
         <tem:password>aaaaaaa</tem:password>
         <tem:numeroFattura>100</tem:numeroFattura>
         <tem:esercizioContabile>2019</tem:esercizioContabile>
         <tem:tipoDocumentoSdi>TD01</tem:tipoDocumentoSdi>
      </tem:DownloadStato>
   </soap:Body>
</soap:Envelope>

Esempio risposta

<s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:a="http://www.w3.org/2005/08/addressing">
   <s:Header>
      <a:Action s:mustUnderstand="1">http://tempuri.org/IDownloadStatoDocumento/DownloadStatoResponse</a:Action>
   </s:Header>
   <s:Body>
      <DownloadStatoResponse xmlns="http://tempuri.org/">
         <DownloadStatoResult xmlns:b="http://schemas.datacontract.org/2004/07/WT.FEHub.Business.Models" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <b:Documenti>
               <b:Documento>
                  <b:DenominazioneCedente>Rossi Spa</b:DenominazioneCedente>
                  <b:DenominazioneCessionario>Verdi srl</b:DenominazioneCessionario>
                  <b:DenominazioneFile i:nil="true"/>
                  <b:EsercizioContabile>2019</b:EsercizioContabile>
                  <b:IDStatoCorrente>11</b:IDStatoCorrente>
                  <b:IdentificativoFiscaleCedente>12345678912</b:IdentificativoFiscaleCedente>
                  <b:IdentificativoFiscaleCessionario>10111213141516</b:IdentificativoFiscaleCessionario>
                  <b:IdentificativoInternoDocumento>1939-839829</b:IdentificativoInternoDocumento>
                  <b:Note/>
                  <b:NotificheXML i:nil="true" xmlns:c="http://schemas.microsoft.com/2003/10/Serialization/Arrays"/>
                  <b:NumeroDocumento>100</b:NumeroDocumento>
                  <b:XML i:nil="true"/>
               </b:Documento>
            </b:Documenti>
            <b:Message>OK</b:Message>
            <b:ResultCode>200</b:ResultCode>
            <b:Success>true</b:Success>
         </DownloadStatoResult>
      </DownloadStatoResponse>
   </s:Body>
</s:Envelope>

Parametri risposta

Success: True Richiesta eseguita con successo / False Richiesta fallita

ResultCode

200 Eseguita con successo

300 Eseguita con successo ma il documento non è stato trovato

403 Autenticazione fallita

500 Errore generico (vedere il valore della parametro Message)

Il nodo “StatoCorrenteDocumento” rappresenta lo stato del documento, che può assumere i seguenti valori:

1	da elaborare
2	scartato per errori in fase di validazione
3	validato e pronto per l’invio a SDI
4	inviato a SDI
5	in attesa esito SDI
6	SDI consegnato (nel caso di cessionario azienda è uno stato definitivo. Nel caso di cessionario pubblica amministrazione lo stato può diventare ACCETTATO o RIFIUTATO)
7	SDI Scartato
8	SDI decorrenza termini (solo fatture destinate a PA)
9	SDI accettato ( solo fatture destinate alla PA)
10	SDI respinto (solo fatture destinate alla PA)
11	SDI consegnato con mancato recapito (in genere le fatture inviate a cessionario con solo codice fiscale
12	Scartato in post elaborazione
13	Importato per invio manuale da web
14	Errore durante l'invio a SDI
15	Eliminato/Presa visione dello scarto interno piattaforma
16	In corso di eliminazione a seguito scarto interno piattaforma
17	In corso eliminazione a seguito scarto SDI o rifiuto PA
18	Eliminato/Presa visione dello scarto PA