Salta ai contenuti

Manutenzione programmata

Aggiornamento posticipato

L’aggiornamento precedentemente annunciato dell’API SIGN DE domenica 5 giugno 2022 è stato posticipato. Pertanto, la manutenzione programmata non è più necessaria e viene annullata. Ulteriori informazioni sono disponibili nel nostro articolo correlato Aggiornamento posticipato

Qui trovi maggiori informazioni sulla nostra manutenzione programmata del 5 giugno 2022. Aggiorneremo il nostro sistema per renderlo ancora migliore.

Nota: Manutenzione programmata domenica 5 giugno 2022, dalle 08:00 alle 16:00 CET L’API SIGN DE sarà sottoposta a una manutenzione programmata domenica 5.6.2022, tra le 08:00 e le 16:00 (CET).

La manutenzione prevede un aggiornamento progressivo delle istanze TSS LIVE dalla versione 1.0.5-1.2.0 alla versione 1.0.6-1.3.0 (dove la prima è la versione SMAERS e la seconda è la versione CSPL).

Durante la finestra di manutenzione si applicano le seguenti restrizioni:

  • Le esportazioni di dati sono disabilitate.
  • Le transizioni di stato TSS verso DISABLED non sono possibili.
  • Le chiamate API potrebbero richiedere più tempo del solito o andare in timeout.
  • Potrebbero verificarsi interruzioni del servizio.

Nota: Come conseguenza dell’aggiornamento TSS, il 6 giugno 2022 tra le 05:00 e le 08:00 (CET), la prima richiesta a un TSS potrebbe richiedere fino a 15 secondi.

Di seguito trovi le risposte ad alcune domande che potresti avere sull’aggiornamento TSS del 5 giugno 2022.

L’aggiornamento riguarda il rilascio delle nuove versioni certificate per il SMAERS (dalla versione 1.0.5 alla 1.0.6) e il CSPL (dalla versione 1.2.0 alla 1.3.0), che insieme rappresentano un aggiornamento dell’intero TSS alla versione 1.0.6-1.3.0.

L’aggiornamento TSS rappresenterà anche il rilascio della versione 2.1.0 dell’API SIGN DE.

I documenti di certificazione per le nuove versioni sono disponibili su Certification | fiskaly.developer.

Le nuove versioni di SMAERS e CSPL includono correzioni di bug e miglioramenti alla stabilità. Le operazioni dei clienti non dovrebbero essere influenzate, in quanto non vi sono modifiche all’API. Le uniche differenze visibili riguardano le esportazioni generate dopo l’aggiornamento: le esportazioni includeranno i log di aggiornamento e la versione TSS nel file info.csv verrà incrementata a 1.0.6-1.3.0. Le esportazioni precedenti, ovvero quelle generate prima dell’aggiornamento, non ne saranno influenzate.

Verranno aggiornate solo le istanze TSS negli stati UNINITIALIZED o INITIALIZED. Tutte le istanze TSS esistenti e nuove nello stato CREATED saranno nella nuova versione una volta che passeranno allo stato UNINITIALIZED. L’aggiornamento delle istanze DEFECTIVE e DISABLED non è possibile per ragioni tecniche.

I clienti potrebbero riscontrare una latenza temporaneamente aumentata nella gestione delle prime richieste successive all’aggiornamento, a causa della necessità di ristabilire la comunicazione tra SMAERS e CSPL e sincronizzare i log di aggiornamento tra tutti i componenti.

I clienti non devono fare nulla dalla loro parte. Come menzionato sopra, non vi sono effetti sulle operazioni dei clienti, a parte alcune restrizioni e le inevitabili interruzioni durante il processo di aggiornamento.

Si consiglia di seguire la nostra guida su come gestire le interruzioni del servizio e i timeout in Gestione degli errori e dei timeout.

Al termine dell’aggiornamento, puoi verificarlo controllando i tuoi file info.csv nelle esportazioni di dati delle istanze TSS INITIALIZED per la versione TSS corretta.

Posso continuare a utilizzare l’API SIGN DE durante il periodo di aggiornamento?

Sezione intitolata “Posso continuare a utilizzare l’API SIGN DE durante il periodo di aggiornamento?”

In linea di principio, sì. Durante la finestra di manutenzione, le singole chiamate potrebbero fallire, andare in timeout o richiedere più tempo del solito.

Le esportazioni di dati e la transizione di stato TSS verso lo stato DISABLED saranno anch’esse temporaneamente disabilitate durante la finestra di manutenzione. Gli endpoint HTTP relativi a queste operazioni risponderanno con il codice di stato HTTP 503.

In caso contrario, l’API SIGN DE rimarrà disponibile e funzionante per tutta la durata della finestra di manutenzione.

L’aggiornamento si svolgerà come aggiornamento progressivo in periodi di tempo più lunghi durante la finestra di manutenzione annunciata. Ciò non significa che inizierà esattamente alle 8:00 o durerà fino esattamente alle 16:00, ma che durante quel periodo diverse parti dell’API SIGN DE verranno aggiornate in momenti diversi.

Cosa significa che le esportazioni di dati sono disabilitate?

Sezione intitolata “Cosa significa che le esportazioni di dati sono disabilitate?”

Durante la finestra di manutenzione, gli endpoint di esportazione restituiranno lo stato HTTP 503.

Per quanto tempo le esportazioni di dati saranno disabilitate?

Sezione intitolata “Per quanto tempo le esportazioni di dati saranno disabilitate?”

Le esportazioni di dati potrebbero essere disabilitate e riabilitate per periodi di tempo più lunghi in vari momenti durante la finestra di manutenzione annunciata. Si consiglia di evitare completamente le esportazioni di dati durante la finestra di manutenzione.

Per quanto tempo la funzionalità di disabilitazione TSS sarà disabilitata?

Sezione intitolata “Per quanto tempo la funzionalità di disabilitazione TSS sarà disabilitata?”

La funzionalità di disabilitazione TSS potrebbe essere disabilitata e riabilitata per periodi di tempo più lunghi in vari momenti durante la finestra di manutenzione annunciata. Si consiglia di evitare completamente di impostare le istanze TSS sullo stato DISABLED durante la finestra di manutenzione.

Cosa significa che possono verificarsi interruzioni del servizio?

Sezione intitolata “Cosa significa che possono verificarsi interruzioni del servizio?”

Oltre alla funzionalità disabilitata, durante il processo di aggiornamento progressivo, le singole istanze TSS potrebbero essere temporaneamente irraggiungibili o occupate mentre i loro componenti vengono aggiornati.

Alcune istanze TSS potrebbero mostrare temporaneamente una latenza aumentata nella gestione delle prime richieste successive all’aggiornamento, a causa della necessità di ristabilire la comunicazione tra SMAERS e CSPL e sincronizzare i log di aggiornamento tra tutti i componenti.

Buon aggiornamento, il team fiskaly SIGN DE

Was this page helpful?