Stati e modalità dei Record

⚠️Warning

Stai visualizzando la documentazione per la versione API 2026-02-03. La versione più recente è 2026-06-01.

Questa sezione descrive il ciclo di vita di un Record — i possibili valori di state e mode e le transizioni tra di essi, tutte attivate automaticamente dal sistema.

Stati

• Accepted: Il Record è stato ricevuto e ha superato la validazione iniziale, ma nessun esito finale è ancora stato persistito. Questo è uno stato temporaneo.
• 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 inviato con successo all’Agenzia delle Entrate ed è stato accettato. Questo è uno stato finale.
• Failed: Si è verificato un errore durante l’elaborazione. Il Record non ha superato i controlli di validazione dell’Agenzia delle Entrate, oppure un errore ha impedito al sistema di confermare l’esito della trasmissione. I dettagli sono disponibili nei messaggi di log. Questo è uno stato finale.

💡Suggerimento: consulta la nostra Guida alla gestione degli errori

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. Lo stato corrispondente è Accepted.
• Finished: Il Record è stato elaborato, con un esito di successo o non. Lo stato corrispondente è Rejected, Completed o Failed.

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.

⚠️Importante

Lo stato finale di un record TRANSACTION viene restituito direttamente nella risposta sincrona POST — non sono necessari polling o webhook.

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.

📘Nota

Processing è la modalità predefinita per ogni INTENTION al momento della creazione. Una volta che l’INTENTION viene referenziata in una TRANSACTION, acquisisce lo stato e la modalità di quella TRANSACTION.

Per i record TRANSACTION, Processing è normalmente temporaneo e dovrebbe risolversi in modalità Finished entro pochi secondi. Se una TRANSACTION rimane in modalità Processing per più di qualche minuto, considerala una transizione bloccata e contattaci con l’ID del record in modo che possiamo investigare.