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)