Stati e modalità dei Record

⚠️ Stai visualizzando la documentazione per la versione API 2026-02-03. La versione più recente è 2026-05-04. La nuova versione API non apporta modifiche all’integrazione italiana. Tuttavia, aggiunge il supporto SIGN PT, consentendo ai team che pianificano di espandersi in Portogallo di riutilizzare la stessa integrazione già in uso per l’Italia.

Questa sezione illustra i possibili stadi di state e mode, e le transizioni associate al ciclo di vita di una risorsa Record. Il diagramma illustra le transizioni di stati e modalità, evidenziando se sono attivate tramite chiamate API o automaticamente attraverso i processi interni del sistema.

Stati

• Accepted: Il Record è stato ricevuto e validato con successo ed è pronto per l’elaborazione.
• Rejected: Il Record è stato ricevuto ma non ha superato i nostri controlli di validazione interni. I dettagli sono disponibili nei messaggi di log. Questo è uno stato finale.
• Completed: Il Record è stato elaborato con successo. Questo è uno stato finale.
• Failed: Il Record non ha potuto essere elaborato a causa di un errore di trasmissione esterno. I dettagli sono disponibili nei messaggi di log. Questo è uno stato finale.

📘Nota

Il seguente articolo fornisce una panoramica degli errori più comuni durante l’invio di Record tramite SIGN IT lite, con indicazioni su come risolverli: SIGN IT - Guida alla gestione degli errori

Modalità

• Processing: Il Record è in fase di elaborazione.
• Finished: Il Record è stato elaborato, con un esito di successo o non.

Transizioni di stato

• POST → Accepted: Il Record viene creato tramite una chiamata API ed entra temporaneamente nello stato Accepted se la validazione ha successo.
• POST → Rejected: Se il Record non supera la validazione interna durante la creazione, passa automaticamente allo stato Rejected, fornendo ulteriori messaggi di log sull’errore.
• Accepted → Completed: Questa transizione avviene automaticamente una volta che il Record è stato elaborato con successo.
• Accepted → Failed: Se si verifica un errore durante l’elaborazione, il Record passa automaticamente allo stato Failed, fornendo ulteriori messaggi di log per il debug.

Transizioni di modalità

• Processing → Finished: Una volta che il Record è stato elaborato, indipendentemente dal fatto che il risultato sia positivo o negativo, passa automaticamente alla modalità Finished.