search

pagopa / pagopa-api

Tutti gli schemi XSD e WSDL che seguono release diverse dalle SANP
22 stars 15 forks source link

API Organization Receipts #1024

Open pperliti opened 2 months ago

pperliti commented 2 months ago

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 (frome 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 commented 2 months ago

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