Stati e Modi dei Record

⚠️ Stai visualizzando la documentazione per la versione API 2024-10-31. La versione più recente è 2026-05-04. Le modifiche principali includono una terminologia aggiornata (Asset → Organization, Entity → Taxpayer/Location).

Questa sezione descrive le possibili fasi di state e mode e le transizioni associate al ciclo di vita di una risorsa Record. Il diagramma illustra le transizioni di stati e modi, evidenziando se vengono attivate tramite chiamate API o automaticamente tramite processi interni del sistema.

Stati

• Accepted: Il record è stato ricevuto, validato con successo ed è pronto per l’elaborazione.
• Rejected: Il record è stato ricevuto ma non ha superato le nostre verifiche di validazione interne. I dettagli sono disponibili nei messaggi di log.
• Completed: Il record è stato elaborato con successo.
• Failed: Il record non è stato elaborato a causa di un errore di trasmissione esterno. I dettagli sono disponibili nei messaggi di log.

Modi

• Processing: Il record è in fase di elaborazione.
• Finished: Il record è stato elaborato, con un esito positivo o negativo.

Transizioni di Stato

• POST → Accepted: Il record viene creato tramite una chiamata API e passa temporaneamente allo stato Accepted se validato con successo.
• POST → Rejected: Se il record non supera la validazione interna durante la creazione, passa automaticamente allo stato Rejected, fornendo messaggi di log aggiuntivi 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 messaggi di log aggiuntivi per il debug.

Transizioni di Modo

• Processing → Finished: Una volta che il record è stato elaborato, indipendentemente dall’esito positivo o negativo, passa automaticamente al modo Finished.