Ambienti TEST e LIVE

Tutti gli Account fiskaly iniziano nell’ambiente TEST per impostazione predefinita. L’ambiente TEST offre funzionalità API complete con dati sandbox, consentendo di sviluppare e validare l’integrazione prima di passare in produzione. Qualsiasi API Key generata in questa configurazione permette la creazione di risorse esclusivamente a scopo di test.

Quando si è pronti a elaborare transazioni reali, è necessario attivare l’ambiente LIVE.

Nota: TEST e LIVE sono completamente separati: le organizzazioni e le risorse create in TEST non esistono in LIVE. È necessario creare nuove organizzazioni e risorse nell’ambiente LIVE, inclusa una nuova API Key, poiché le API Key TEST non autenticano sugli endpoint di produzione.

Attivazione dell’ambiente LIVE nel HUB

Per abilitare l’ambiente LIVE, fare clic sull’opzione “Go LIVE” nella parte superiore della pagina nel HUB.

Il HUB richiede di confermare i dati aziendali e le informazioni di contatto prima di inviare la richiesta di attivazione. Il team Sales si metterà poi in contatto per completare il processo contrattuale.

Durante l’elaborazione della richiesta, il banner mostra un badge “LIVE access pending”. Inoltre, nell’ambiente di test viene visualizzato un gruppo denominato “AccountName-LIVE”. Questa sarà la futura organizzazione LIVE e non è richiesta alcuna azione da parte dell’utente. Una volta approvato e attivato l’account, si otterrà l’accesso all’ambiente LIVE.

Passaggio tra gli ambienti

Una volta attivato il LIVE, è possibile passare da TEST a LIVE in qualsiasi momento direttamente nel HUB.

Ogni ambiente è accessibile separatamente, quindi è possibile averli entrambi aperti contemporaneamente. Questo è utile per continuare lo sviluppo in TEST mentre si opera in produzione in LIVE, per riprodurre problemi prima in TEST per il debug, o per formare nuovi membri del team senza influire sui dati di produzione.

Nota: Una volta che la propria Organization opera in ambiente LIVE, non è necessario disattivare le risorse di test. L’ambiente TEST resta completamente accessibile. Il passo successivo è passare all’ambiente LIVE e creare le risorse di produzione:

Accedere al nuovo Group “AccountName-LIVE” che rispecchia la struttura di produzione
Generare una nuova API Key LIVE — le API Key TEST non funzionano in LIVE

Importante: I Record inviati nell’ambiente LIVE devono sempre riflettere transazioni commerciali reali.

Se si utilizza ancora la fiskaly Dashboard

Le istruzioni seguenti si applicano all’interfaccia legacy della Dashboard.

La prima organizzazione creata nella Dashboard dispone unicamente dell’ambiente TEST. È possibile abilitare l’ambiente LIVE, come indicato dal pulsante posizionato in alto a sinistra sotto il nome dell’organizzazione:

Generando una API Key in questa configurazione, è possibile creare risorse esclusivamente per testare la nostra API.

Per impostare la prima Organization in LIVE, è necessario fornire l’Organization ID e completare l’accordo contrattuale. Una volta attivato l’ambiente LIVE, il pulsante “ENABLE LIVE” si trasforma in un toggle, che consente di passare tra l’ambiente TEST e LIVE:

Una volta che l’organizzazione dispone di un ambiente LIVE, il passo successivo consiste nel creare una API Key LIVE. Questa API Key LIVE verrà quindi utilizzata per generare risorse LIVE.

È importante sottolineare che, una volta che l’organizzazione opera in ambiente LIVE, non è necessario disattivare le risorse di test. L’ambiente TEST resta accessibile. Le risorse TEST e LIVE sono supportate in modo integrato, consentendo una transizione fluida senza la necessità di disattivare alcuna risorsa.

Nota: Se non è ancora stata effettuata la migrazione al HUB, è possibile seguire questi passaggi. La migrazione al HUB non richiede la ricreazione delle risorse esistenti: la configurazione TEST e LIVE attuale viene trasferita automaticamente.

Was this page helpful?