[GPD] Dettagli per 400 su API gestione caricamento massivo PD

[pperliti]

Ciao, segnalo una potenziale miglioria riguardante la API per il recupero del report relativo all’inserimento massivo di posizioni debitorie su GPD:

In caso di errore 400 (Bad Request), dovuto a richieste malformate (es. incongruenza su parametri), il campo statusMessage è sempre valorizzato a "Bad request":

"responses": [
        {
            "statusCode": 400,
            "statusMessage": "Bad request",
            "requestIDs": [
                "7ce30b64-f012-47ad-cb1d-a384f4d92b51"
            ]
        },
        {
            "statusCode": 201,
            "statusMessage": "Debt position CREATED",
            "requestIDs": [
                "d47a4f1f-60d9-4a65-8175-21fbcf71d1d2"
            ]
        }
    ],

Il messaggio generico "Bad request" è superfluo (implicito nello status code 400) e costringe a re-inviare la pendenza tramite la API per l'inserimento della singola posizione debitoria per avere esplicitato il reale problema (es. dueDate < a validityDate). In caso di parecchie posizioni debitorie malformate, questo approccio non è sostenibile. Meglio sarebbe usare il campo "statusMessage" (o un apposito campo "errorDetails") per indicare il problema legato alla validazione fallita. Poiché, a fronte dello stesso statusCode 400, la validazione può fallire per motivi diversi a seconda dello IUPD, l'ideare sarebbe prevedere un campo "errorDetails" per ciascuna pendenza.

[cristianosticca-pagopa]

Buongiorno, grazie prendiamo in carico la richiesta e ne valutiamo la fattibilità.

Saluti

[angelotome]

Buongiorno, segnalo che la stessa richiesta sarebbe utile anche per l'operazione "paCreatePosition" utilizzata per l'ACA.

grazie

[cap-ang]

Buongiorno,

a partire da questa release, del 02/10/2025 alle 16:50, è stata rilasciata la feature che implementa la miglioria riguardante la API per il recupero del report relativo all’inserimento massivo di posizioni debitorie su GPD.

L'aggiornamento consente di avere i dettagli dell'errore nel report. In particolare, questi saranno valorizzati nel campo statusMessage del report di una operazione massiva.

Saluti.