Acquisizione delle rendicontazioni

I flussi di rendicontazione acquisiti da GovPay possono essere recuperati tramite le API di Rendicontazione.

Per l’acquisizione dei flussi di rendicontazione si procede in prima istanza a individuare i flussi presenti, eventualmente filtrando per dominio o data di emissione. L’operazione di ricerca si effettua tramite invocazione della GET /flussiRendicontazione, fornendo i parametri di ricerca richiesti.

Ad esempio:

GET /flussiRendicontazione?idDominio=01234567890&dataDa=2017-11-21&dataA=2017-12-31&pagina=2
HTTP 200 OK
{
    "numRisultati": "30",
    "numPagine": "2",
    "risultatiPerPagina": "25",
    "pagina": "1",
    "prossimiRisultati": "/rendicontazioni?idDominio=01234567890&dataDa=2017-11-21&dataA=2017-12-31&pagina=2",
    "risultati":
    [
        {
            "idFlusso": "2017-11-21ABI12345-10:27:27.903",
            "dataFlusso": "2020-12-31",
            "trn": "TRN123445",
            "dataRegolamento": "2020-12-31",
            "idPsp": "ABI-12345",
            "bicRiversamento": "BIC-12345",
            "idDominio": "01234567890",
            "numeroPagamenti": 1,
            "importoTotale": 100.01
        },
        {
            …
        },
    ]
}

Dalla lista dei risultati forniti si estraggono gli identificativi dei flussi che interessano e si procede all’acquisizione del dettaglio tramite l’invocazione dell’operazione GET /flussiRendicontazione/{idFlusso}.

Ad esempio:

GET /flussiRendicontazione/2017-11-21ABI12345-10:27:27.903
Accept: application/json
HTTP 200 OK
{
    "idFlusso": "2017-11-21GovPAYPsp1-10:27:27.903",
    "dataFlusso": "2020-12-31",
    "trn": "idriversamento123445",
    "dataRegolamento": "2020-12-31",
    "idPsp": "ABI-12345",
    "bicRiversamento": "BIC-12345",
    "idDominio": "01234567890",
    "numeroPagamenti": 1,
    "importoTotale": 10.01
    "rendicontazioni":
    [
        {
            "iuv": "RF23567483937849450550875",
            "iur": "1234acdc",
            "indice": 1,
            "importo": 10.01,
            "esito": 0,
            "data": "2018-12-31",
            "riscossione":
            {
                "pendenza": "/pendenze/A2A_ENTE/abcdef12345",
                "idVocePendenza": "abcdef12345_1",
                "rpt": "/rpt/01234567890/RF23567483937849450550875/n%2Fa",
                "importo": 10.01,
                "ibanAccredito": "IT02L1234512345123456789012",
                "data": "2018-12-29",
                "commissioni": 1.5,
                "allegato":
                {
                    "tipo": "Esito pagamento",
                    "testo": "...."
                }
            }
        }
    ]
}

È possibile anche acquisire il tracciato del flusso in formato originale impostando l’header http Accept ad application/xml.