Specifiche tecniche dei servizi di versamento, aggiornamento, recupero e annullamento

Le Specifiche Tecniche dei Servizi descrivono le regole a cui deve attenersi un sistema client che voglia colloquiare con i moduli di SacER che lo prevedono; normalmente i client sono automi sviluppati dagli Enti produttori o da loro fornitori, che eseguono job di versamento o di recupero di documenti, utilizzando come strumento di colloquio i Web Service messi a disposizione da ParER.

Il colloquio, che è sottoposto a regole di autenticazione rigorose, produce come risultato un’operazione in SacER e restituisce al chiamante l’esito dell’operazione, in base al quale il client chiamante può innescare le opportune operazioni sul sistema dell’Ente produttore, quale ad esempio il re-invio nel caso di esito negativo. 

Sono attualmente disponibili le seguenti Specifiche:

• Specifiche tecniche dei servizi di versamento di unità documentarie 1.5   (PDF - 2,3 MB) e relativi allegati (ZIP - 9,3 KB).
  Il documento ricomprende i servizi relativi a:

  • versamento unità documentarie in modalità sincrona
  • aggiunta di documenti in modalità sincrona
  • versamento unità documentarie in modalità asincrona.

• Specifiche tecniche dei servizi di aggiornamento dei metadati UD 1.4 (PDF - 487,6 KB) e relativi allegati (ZIP - 42,5 KB).
• Specifiche tecniche dei servizi di versamento dei fascicoli 3.0   (PDF - 787,9 KB) e relativi allegati (ZIP - 6,4 KB).

• Specifiche tecniche dei servizi di recupero 3.0   (PDF - 482,1 KB) e relativi allegati (ZIP - 3,7 KB).
• Specifiche tecniche dei servizi di recupero dell'AIP di un fascicolo 1.0 (PDF - 232,5 KB) e relativi allegati (ZIP - 5,5 KB)
• Specifiche tecniche dei servizi di annullamento 1.4 (PDF - 292,2 KB) e relativi allegati (ZIP - 2,4 KB).
• Specifiche tecniche per l'autenticazione tramite protocollo OAUTH2 1.2 (PDF - 275,3 KB)

E’ inoltre disponibile l’elenco dei messaggi di errore o di avvertimento (PDF - 1,7 MB)(warning) che i servizi possono restituire alla chiamata, con l’illustrazione dei motivi che hanno determinato l’errore o l’avvertimento

Si riportano, inoltre, le versioni precedenti dei servizi non ancora deprecate:

• Versamento unità documentarie:

  • Versione 1.4 (ZIP - 1,6 MB)

• Annullamento
  

  • Versione 1.3 (PDF - 291,9 KB)  e relativi allegati

• Versamento Fascicoli

  • Versione 2.0 (PDF - 741,4 KB) e relativi allegati (ZIP - 6,2 KB)
  • Versione 2.1 (PDF - 772,6 KB) e relativi allegati (ZIP - 62,9 KB)
• Specifiche tecniche dei Servizi di Recupero
• Versione 2.4 (PDF - 411,6 KB)  e relativi allegati (ZIP - 5,9 KB)