API Organization Receipts

[pperliti]

Segnalo alcune discrepanze presenti nella API GPD per scaricare l'elenco delle ricevute (GET https://api.uat.platform.pagopa.it/gpd/payments-receipts-service/v1/payments/{organizationfiscalcode}/receipts):

1. Le chiamate effettuate alle API sono paginate (vengono ritornati alcuni metadati relativi alla paginazione) ma nel file di specifiche OpenAPI (gpd_payments.json) non c'è traccia dei metadati di paginazione (pertanto il codice generato a partire dalle specifiche non è coerente).
2. Le date di filtro (from e to) sono stringhe (in realtà supportano il formato YYYY-MM-DDTHH:MM:SS), sarebbe meglio usare dei datetime.
3. La lista delle ricevute nel file delle specifiche è indicato come receipts_list mentre le API in UAT indicano il nome results.
4. I dati ritornati nell'elenco delle receipts dovrebbero riportare almeno l'id ricevuta (idReceipt) e l'importo pagato (amount). E' vero che questi dati si possono estrarre chiedendo il dettaglio della receipt, tuttavia il formato XML potrebbe variare in base alla primitiva invocata dal PSP (SendRT, SendRTV2, ...), rendendo il tutto più macchinoso. Tra l'altro, potendo contare su idReceipt già nell'elenco, si potrebbe evitare la chiamata di dettaglio del file XML qualora non fosse necessario.
5. Lo stato (status) di ReceiptModelResponse dovrebbe essere definito come enum, non come semplice stringa.

[cristianosticca-pagopa]

Grazie @pperliti per la segnalazione. Prendiamo in carico l'analisi e verifichiamo la fattibilità degli interventi. Cordiali saluti.

[cristianosticca-pagopa]

Buongiorno @pperliti rispondiamo ai vari punti:

1. come già indicato in https://github.com/pagopa/pagopa-api/issues/1092 stiamo applicando una correzione che verrà rilasciata nelle prossime settimane con le SANP3.11.0
2. non possiamo implementare questo requisito anche per lasciare più libertà di interrogazione
3. come per il punto 1)
4. non possiamo implementare questo requisito
5. non possiamo implementare questo requisito poichè vi sarebbero sia dei forti impatti tecnici che anche di breaking change su altre primitive del Nodo dei Pagamenti.

Grazie. Buone feste