Operazioni disponibili
Tutte le operazioni indicate sono segregate per codice fiscale dell'ente creditore (organizationfiscalcode
). Il dato è recuperato in autonomia dal servizio partendo dalla subscription key utilizzata.
Per questo motivo, non sarà necessario definire /organizations/{organizationfiscalcode}
nelle chiamate verso il servizio.
Le chiamate sono quindi da considerasi valide al netto di:
base path (dipenderà dall'ambiente UAT/ PROD e maggiori dettagli si troveranno nel dev portal)
identificazione dell'EC (eseguita in autonomia da parte del servizio tramite api key)
Gestione posizioni debitorie
Nei seguenti sequence diagram si identifica con l'acronimo GPD il servizio di Gestione Posizioni Debitorie e con APD l'Archivio delle Posizioni Debitorie (base dati)
Creazione di una posizione debitoria
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252FO9nsMx7pAQMK6yUk5ugK%252FcreatePD.png%3Falt%3Dmedia%26token%3D5cf21e1f-a0a8-4874-aea2-bdfd2f57186f&width=768&dpr=4&quality=100&sign=db4f4df3&sv=1)
In fase di creazione della posizione debitoria il servizio effettuerà controlli sui dati in input e controlli di eventuali duplicati.
Tra i controlli dei dati in input si rilevano:
obbligatorietà dei dati
coerenza date (ad esempio
due_date
≥validity_date)
coerenza importi (ad esempio la somma degli importi dei versamenti deve essere uguale all'importo totale)
validità della tassonomia
validità degli IBAN (devono essere censiti sulla piattaforma pagoPA)
Tra i controlli dei duplicati ci si basa sugli identificativi di pagamento (IUPD e IUV)
Lettura di una lista di posizioni debitorie e di una singola posizione debitoria
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252Fs1pDGI8uzJHNMlNQXQUW%252FreadPDList.png%3Falt%3Dmedia%26token%3D9cc48985-51fd-4266-98a8-4c1a284d619e&width=768&dpr=4&quality=100&sign=7c3d98e6&sv=1)
La lettura di una lista di posizioni debitorie prevede sempre una paginazione. E' inoltre possibile filtrare per due_date
in modo da limitare i risultati.
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252FQdnFjPHvnEE5eFwcSVCg%252FreadPD.png%3Falt%3Dmedia%26token%3Dff63c9bd-1c50-4dc0-8470-4a72a87f24fa&width=768&dpr=4&quality=100&sign=28cedefa&sv=1)
La lettura di una posizione debitoria si basa sull'identificativo in input (IUPD). In caso lo IUPD non sia esistente verrà emesso un errore.
Aggiornamento di una posizione debitoria
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252FzRE1t3oYTtrmeJ5pxOWj%252FupdatePD.png%3Falt%3Dmedia%26token%3Da89c5132-eb3d-4d8f-97c2-43028b6876d1&width=768&dpr=4&quality=100&sign=3bcab96a&sv=1)
In fase di aggiornamento, oltre ai già citati controlli in fase di creazione , si verifica che la posizione sia esistente ed aggiornabile.
In particolare l'aggiornabilità della posizione debitoria dipende dallo stato della posizione stessa (ad esempio se una posizione è già stata pagata non sarà possibile aggiornarla)
Cancellazione di una Posizione Debitoria
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252FFaHr2gt79NJBt9xEKNAC%252FdeletePD.png%3Falt%3Dmedia%26token%3Dcd8edd36-ad60-44b1-b9f5-b564a236cc42&width=768&dpr=4&quality=100&sign=93df4357&sv=1)
La cancellazione di una posizione debitoria prevede controlli sia sull'esistenza (IUPD) che sullo stato (ad esempio, una posizione debitoria non sarà cancellabile se è già stata pagata)
Pubblicazione di una posizione debitoria
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252FqftJ2nn89LW2A3KfR72k%252FpublishPD.png%3Falt%3Dmedia%26token%3D0324cb78-babe-417d-8213-ab3bb8a6850a&width=768&dpr=4&quality=100&sign=b6f11ea&sv=1)
La pubblicazione della posizione debitoria permette il passaggio dallo stato DRAFT
allo stato PUBLISHED.
Una posizione in stato DRAFT
(bozza) infatti non permette la normale operatività con la piattaforma pagoPA. Solo quando l'Ente Creditore pubblica la posizione, in coerenza con le date di validità e di scadenza, questa risulta pagabile sulla piattaforma.
Invalidazione di una posizione debitoria
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252Fk6t4XLt77sHM1MsLVucG%252FinvalidatePD.png%3Falt%3Dmedia%26token%3D225ff2d3-50cd-4157-8b75-2f43cdbfa7ae&width=768&dpr=4&quality=100&sign=17302a&sv=1)
L'invalidazione di una posizione debitore consiste di fatto in una cancellazione logica. E' possibile solo partendo dagli stati PUBLISHED
e VALID
.
La funzionalità è utile quando si vuole dare evidenza all'utente, in fase di pagamento, della invalidazione della posizione debitoria.
Gestione pagamenti spontanei
Nei seguenti sequence diagram si identifica con l'acronimo GPS il servizio di Gestione Pagamenti Spontanei.
Si identificano 2 entità:
Ente Creditore (adesione al servizio di pagamenti spontanei)
Servizio (sottoscrizione ad uno specifico servizio)
Aggiunta di un ente creditore con eventuali sottoscrizioni a servizi
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252FoOfPJ2XbnBPozOeHENhU%252FcreateEC.png%3Falt%3Dmedia%26token%3D9aad3565-b8cc-4fec-841b-b35f687d486f&width=768&dpr=4&quality=100&sign=be2fcdea&sv=1)
Con questa operazione è possibile aderire tecnicamente al servizio di gestione dei pagamenti spontanei. E' inoltre possibile, già in fase di adesione, definire l'iscrizione ai vari servizi.
Vengono effettuati controlli sintattici e semantici sui campi in input. In particolare, si segnalano controlli sulla bontà delle iscrizioni ai servizi (che devono essere presenti nell'elenco servizi)
Cancellazione di un ente creditore e relative sottoscrizioni
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252Fftce19mM3a1LRHdtp7Am%252FdeleteEC.png%3Falt%3Dmedia%26token%3Df3ae6bc3-3273-438a-8ad2-17a09620a904&width=768&dpr=4&quality=100&sign=5a00396f&sv=1)
Questa funzionalità permette la cancellazione di un adesione di un Ente Creditore al servizio di gestione dei pagamenti spontanei. Contestualmente vengono cancellate tutte le sottoscrizioni.
Questa operazione, per potere essere effettuata, deve essere preceduta da un adesione.
Aggiornamento di un Ente Creditore
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252FEz1ugVs98yRr32jy848Y%252FupdateEC.png%3Falt%3Dmedia%26token%3Dfe70aeb0-f9b7-49f1-9238-9e98390dc459&width=768&dpr=4&quality=100&sign=e79e3c14&sv=1)
Con questa funzionalità è possibili aggiornare le proprietà dell'Ente Creditore in merito all'adesione al servizio.
Valgono gli stessi controlli definiti per la creazione dell' adesione, oltre ai controlli legati alla presenza di una precedente adesione.
Lettura dei dati di un ente creditore e sottoscrizioni a servizi
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252Fkk8VN000fxyFViF6Avvz%252FreadEC.png%3Falt%3Dmedia%26token%3Df5a91c68-70f5-4e57-bb8e-8064265dcdc4&width=768&dpr=4&quality=100&sign=8dee6770&sv=1)
Questa funzionalità permette di recuperare, oltre alle proprietà dell'ente creditore, tutte le sottoscrizioni ai servizi.
Sottoscrizione a un servizio
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252F4eAvMUDCwf7J8pedYaMM%252FcreateService.png%3Falt%3Dmedia%26token%3Dddd17a6d-d0a2-4cf8-b8a2-7c85ce6d47a1&width=768&dpr=4&quality=100&sign=b6e23216&sv=1)
Con questa operazione è possibile aggiungere una sottoscrizione ad un servizio.
Vengono effettuati controlli in merito all'identificativo del servizio aggiunto (deve essere esistente e non deve essere già presente un sottoscrizione) oltre ai controlli sintattici e semantici sulle proprietà dell'adesione (IBAN, causale versamento, etc).
Lettura di una sottoscrizione a un servizio
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252FFrQ4fVY6dL0mQMhox9FT%252FreadService.png%3Falt%3Dmedia%26token%3D5d11dc6d-9081-4410-871c-e0ea74583808&width=768&dpr=4&quality=100&sign=37cf582d&sv=1)
Con questa operazione è possibile recuperare le proprietà di una determinata sottoscrizione ad un servizio.
Aggiornamento di una sottoscrizione a un servizio
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252FVcr8PS4hGBYeEOOfmrWT%252FupdateService.png%3Falt%3Dmedia%26token%3D7c8d588c-3f1f-409b-8268-db2053606a1e&width=768&dpr=4&quality=100&sign=382a10e7&sv=1)
Con questa operazione è possibile aggiornare le proprietà di una sottoscrizione precedentemente aggiunta.
Non è possibile cambiare il servizio con questa operazione.
Cancellazione di una sottoscrizione a un servizio
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252FFtvpt4Ue9P59yc5CWMDd%252FdeleteService.png%3Falt%3Dmedia%26token%3D84df39a1-888a-4bda-86ad-ea40bf88a8df&width=768&dpr=4&quality=100&sign=7c1b5198&sv=1)
Con questa operazione è possibile cancellare la sottoscrizione ad un servizio precedentemente aggiunto.
Flussi di rendicontazione
Sono messe a disposizione delle funzionalità di lettura dei flussi di rendicontazione:
Lista di flussi di rendicontazione per un Ente Creditore
Dettaglio del flusso di rendicontazione
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252FRapfocSjNrcQV0H4KQ76%252FreadFdRList.png%3Falt%3Dmedia%26token%3Dbc784548-4ccf-491b-a5e5-67ca83f2fc24&width=768&dpr=4&quality=100&sign=bcf4f668&sv=1)
![](https://docs.pagopa.it/~gitbook/image?url=https%3A%2F%2F2730923366-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fv7eFccIIRcGfOIG6IHkT%252Fuploads%252FoHZFWIjZJvUSjBLR343w%252FreadFdR.png%3Falt%3Dmedia%26token%3De0248108-4641-48a2-bc02-d206d3be3542&width=768&dpr=4&quality=100&sign=85e07ba0&sv=1)
Last updated