API REST/JSON per scarico fatture passive

API REST download delle fatture passive (ciclo passivo)

Questo API restituisce le fatture passive filtrate per un dato intervallo di date.

 

Endpoint REST: [base url]/api/ FatturePassive

Parametri richiesta

 

Username

 

String

Username del’azienda per l’autenticazione

Password

 

String

Password dell’azienda per l’autenticazione

Da

 

Data

La data di inizio del periodo da ricercare

A

 

Data

La data di fine del periodo da ricercare

 

Esempio richiesta

 

{

                "username": "azienda",

                "password": "pwd123",

                "da": "2019-01-01",

                "a": "2019-01-31"

}

 

Parametri risposta

 

Success

 

True

Richiesta eseguita con successo

False

Richiesta fallita

 

ResultCode

 

200

Eseguita con successo

300

Eseguita con successo ma non c’è nessun documento disponibile

403

Autenticazione fallita

500

Errore generico (vedere il valore della parametro Message)

 

La risposta restituisce degli elementi “Documento”. Ogni documenti rappresenta una fattura passiva e ne riporta i dati di base. La voce XML contiene i byte del file XML codificati Base64.

La voce “IDStatoCorrente” rappresenta lo stato del documento, che nel caso di una fattura passiva assume sempre il valore  9 = SDI Accettato.

La voce “IdentificativoInternoDocumento” rappresente l’indentificato univoco del documento sulla piattaforma.

Esempio di risposta

 

{

    "Documenti": [

        {

            "IDStatoCorrente": 9,

            "NumeroDocumento": "3859-ATOKA",

            "EsercizioContabile": 2019,

            "IdentificativoInternoDocumento": "93-499216",

            "IdentificativoFiscaleCedente": "02241890xxx",

            "IdentificativoFiscaleCessionario": "03357400831",

            "DenominazioneCedente": "ACME  srl",

            "DenominazioneCessionario": "WT SRLS",

            "DenominazioneFile": "IT01641790702_adxl0.xml",

            "Note": "",

            "XML": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48bnMzOkZhdHR1cmFFbGV0dHJvbmljYSB4bWxuczpuczM9Imh0dHA6Ly9pdmFzZXJ2aXppLmFnZW56aWFlbnRyYXRlLmdvdi5pdC9kb2NzL3hzZC9mYXR0dXJlL3YxLjIiIHhtbG5zOm5zMj0iaHR0cDovL3d3dy53My5vcmcvMjAwMC8wOS94bWxkc2lnIyIgdmVyc2lvbmU9IkZQUjEyIj4KICAgIDxGYXR0dXJhRWxldHRyb25pY2FIZWFkZXI... "

            "NotificheXML": null

        },

        {

            "IDStatoCorrente": 9,

            "NumeroDocumento": "2",

            "EsercizioContabile": 2019,

            "IdentificativoInternoDocumento": "864-510097",

            "IdentificativoFiscaleCedente": "03000640xxx",

            "IdentificativoFiscaleCessionario": "03357400831",

            "DenominazioneCedente": "Ditta 2",

            "DenominazioneCessionario": "WT SRLS",

            "DenominazioneFile": "IT12281740154_16T4I.xml.p7m",

            "Note": "",

            "XML": "MIAGCSqGSIb3DQEHAqCAMIACAQExDzANBglghkgBZQMEAgEFADCABgkqhkiG9w0BBwGggCSABIID6Dw/eG1sIHZlcnNpb249IjEuMCIgZW5jb2Rpbmc9IlVURi04Ij8+DQo8YjpGYXR0dXJhRWxldHRyb25pY2EgeG1sbnM6Yj0iaHR0cDovL2l2YXNlcnZpemkuYWdlbnppYWVudHJhdGUuZ292Lml0L2RvY3MveHNkL2ZhdHR1cmUvdjEuMiIgdmVyc2lvbmU9IkZQUjEyIj4NCiAgPEZhdHR1cmFFbGV0dHJvbml... "

            "NotificheXML": null

        }       

    ],

    "Message": "OK",

    "ResultCode": 200,

    "Success": true

}