Tabella dei contenuti
Finalità (Purpose)
Questa sezione illustra i concetti e le operazioni relative alla finalità nell’ambito delle API di PDND Interoperabilità. Per l’inquadramento funzionale e il ciclo di vita della finalità nella piattaforma, consultare la sezione dedicata.
Versioni della finalità e gestione della stima di carico
Una Purpose può comprendere più versioni:
- currentVersion: se presente, è ACTIVE oppure SUSPENDED;
- waitingForApprovalVersion: se presente, è WAITING_FOR_APPROVAL;
- rejectedVersion: se presente, è l’ultima versione REJECTED.
Possono inoltre esistere altre versioni:
- ARCHIVED: contiene una stima di carico precedente;
- REJECTED: versione la cui stima è stata rifiutata dall’erogatore.
La modifica della stima di carico genera sempre una nuova versione della Purpose.
Se la stima è inferiore alle soglie previste dalla versione dell’e-service (EServiceDescriptor), oppure viene approvata dall’erogatore, la versione precedente della Purpose viene archiviata.
Se la stima è inferiore alle soglie previste dalla versione dell’e-service (EServiceDescriptor), oppure viene approvata dall’erogatore, la versione precedente della Purpose viene archiviata.
Stati e transizioni — Quadro di insieme
| Stato | Descrizione | Transizioni in uscita |
|---|---|---|
| DRAFT | Stato iniziale della prima versione di una Purpose creata. | → ACTIVE (stima ≤ soglie dell’EServiceDescriptor); → WAITING_FOR_APPROVAL (stima > soglie dell’EServiceDescriptor); → cancellazione. |
| WAITING_FOR_APPROVAL | Stima di carico sopra soglie e in attesa di approvazione dell’erogatore. La currentVersion (se ACTIVE) resta utilizzabile per il voucher; l’attivazione archivia la versione corrente; cancellazione e rifiuto non incidono sulla versione corrente. | → ACTIVE (stima approvata dall’erogatore); → REJECTED (stima rifiutata; eventuale versione corrente invariata); → cancellazione. |
| ACTIVE | Purpose operativa; unico stato che consente la generazione del voucher. | → ACTIVE (aggiornamento stima ≤ soglie: si crea nuova versione e la precedente viene archiviata); → WAITING_FOR_APPROVAL (aggiornamento stima > soglie: si crea nuova versione, la precedente resta invariata); → SUSPENDED (sospensione manuale); → ARCHIVED (archiviazione manuale o automatica dopo attivazione nuova stima). |
| SUSPENDED | Sospensione temporanea (manuale del fruitore o dell’erogatore). Stato reversibile. | → ACTIVE (se non sospesa dall’erogatore e riattivata dal fruitore con stima ≤ soglie; oppure se riattivata dall’erogatore indipendentemente dalla stima); → WAITING_FOR_APPROVAL (non sospesa dall’erogatore, riattivata dal fruitore con stima > soglie: si crea nuova versione, la precedente resta invariata); → SUSPENDED (permane la sospensione, o riattivazione da un solo lato); → ARCHIVED (archiviazione manuale o automatica dopo attivazione nuova stima). |
| ARCHIVED | Versione non più in uso; stato non reversibile. Se non esiste una currentVersion, la Purpose è definitivamente archiviata. | — (nessuna transizione). |
| REJECTED | Stima di carico rifiutata dall’erogatore; lo stato è non reversibile. Il fruitore può richiedere nuovamente una modifica della stima. | — (nessuna transizione). |
Dettaglio degli stati
DRAFT
Caratteristiche
- Stato iniziale della prima versione della Purpose.
Transizioni possibili
- ACTIVE: la stima di carico è inferiore o uguale alle soglie dell’EServiceDescriptor.
- WAITING_FOR_APPROVAL: la stima è superiore alle soglie.
- Cancellazione.
WAITING_FOR_APPROVAL
Caratteristiche
- La stima supera le soglie dell’EServiceDescriptor ed è in attesa di approvazione dell’erogatore.
- Se la versione corrente è ACTIVE, la Purpose resta utilizzabile per la generazione del voucher.
- L’attivazione della versione approvata archivia la versione corrente.
- Cancellazione e rifiuto non incidono sulla versione corrente.
Transizioni possibili
- ACTIVE: stima approvata dall’erogatore.
- REJECTED: stima rifiutata dall’erogatore (eventuale versione corrente invariata).
- Cancellazione.
ACTIVE
Caratteristiche
- Purpose operativa.
- Unico stato che consente la generazione del voucher.
Transizioni possibili
- ACTIVE: la stima viene modificata e resta ≤ soglie; si crea una nuova versione e la precedente viene archiviata.
- WAITING_FOR_APPROVAL: la stima aggiornata è > soglie; si crea una nuova versione, la precedente rimane inalterata.
- SUSPENDED: sospensione manuale.
- ARCHIVED: archiviazione manuale del fruitore oppure automatica dopo l’attivazione di una nuova stima.
SUSPENDED
Condizioni di accesso
- Sospensione manuale del fruitore.
- Sospensione manuale dell’erogatore.
Caratteristiche
- Purpose temporaneamente non operativa.
- Stato reversibile.
Transizioni possibili
- ACTIVE:
- se non sospesa dall’erogatore e riattivata dal fruitore con stima ≤ soglie, oppure
- se riattivata dall’erogatore, indipendentemente dalla stima.
- WAITING_FOR_APPROVAL: non sospesa dall’erogatore, riattivata dal fruitore con stima > soglie; si crea nuova versione, la precedente resta invariata.
- SUSPENDED: permane la sospensione (manuale o riattivazione asimmetrica).
- ARCHIVED: archiviazione manuale oppure automatica a seguito dell’attivazione di una nuova stima.
ARCHIVED
Caratteristiche
- Versione non più in uso.
- Stato non reversibile; se non esiste una versione corrente (currentVersion), la Purpose è definitivamente archiviata.
Transizioni possibili
- Nessuna.
REJECTED
Caratteristiche
- La stima di carico della versione è stata rifiutata dall’erogatore.
- Stato non reversibile; il fruitore può proporre nuovamente una modifica della stima.
Transizioni possibili
- Nessuna.
Pagina successiva → E-service
Hai bisogno di aiuto?
Apri un ticket utilizzando l’apposita funzione all’interno della tua Area Riservata
