Passare all'ambiente LIVE
Tutte le organizzazioni fiskaly partono di default nell’ambiente TEST. L’ambiente TEST offre la piena funzionalità dell’API con dati sandbox, consentendo di costruire e validare l’integrazione prima di andare in produzione.
Quando sei pronto a elaborare transazioni reali, devi attivare l’ambiente LIVE.
TEST vs. LIVE
Sezione intitolata “TEST vs. LIVE”| Caratteristica | TEST | LIVE |
|---|---|---|
| Endpoint API | URL sandbox (middleware) | URL di produzione |
| Certificati TSS | Certificati di test | Certificati legalmente validi |
| Transazioni | Non legalmente vincolanti | Conformi alla legge e firmate |
| Conservazione dati | Temporanea | Intero periodo di conservazione legale |
| Limiti di velocità | Uguali alla produzione | Limiti di produzione |
| Costo | Gratuito durante lo sviluppo | Secondo i termini del contratto |
I dati non vengono trasferiti tra gli ambienti. Le istanze TSS, i client e le transazioni create in TEST non esistono in LIVE. Sarà necessario creare nuove risorse nell’ambiente LIVE.
Attivare l’accesso LIVE
Sezione intitolata “Attivare l’accesso LIVE”Verificare la preparazione dell'integrazione
Prima di richiedere l’accesso LIVE, verifica che la tua integrazione:
- Crea e inizializza correttamente una TSS in TEST
- Firmi le transazioni end-to-end senza errori
- Gestisca i timeout e i casi di errore in modo appropriato
- Generi dati di ricevuta corretti con codici QR (per SIGN DE)
- Produca esportazioni DSFinV-K valide (se applicabile)
Richiedere l'attivazione LIVE
In fiskaly HUB, viene visualizzato un banner della modalità di test mentre ti trovi nell’ambiente TEST. Come Owner dell’Account, fai clic sul pulsante “Go Live” in questo banner per avviare la richiesta di attivazione. Un breve modulo ti chiederà di confermare i dati aziendali e le informazioni di contatto prima di inviare.
Completare il contratto
Dopo la richiesta, il team di vendita di fiskaly ti contatterà per finalizzare un contratto relativo all’uso in produzione. Di solito include:
- Selezione del livello di volume
- Attivazione del modulo paese
- Configurazione di fatturazione e pagamento
Ricevere l'accesso LIVE
Mentre la richiesta è in elaborazione, il banner mostra un badge “Accesso LIVE in sospeso”. Una volta che il tuo Account è stato approvato e attivato, avrai accesso all’ambiente LIVE.
Creare risorse LIVE
Passa all’ambiente LIVE e crea le tue risorse di produzione:
- Crea una nuova organizzazione LIVE che rispecchia la tua struttura di produzione
- Genera una nuova API Key LIVE — le API Key TEST non funzionano in LIVE
- Crea e inizializza le istanze TSS di produzione
- Registra i client sulla TSS LIVE
Devi creare una nuova API Key nell’ambiente LIVE. La tua API Key TEST non si autenticherà agli endpoint di produzione.
Passare tra gli ambienti
Sezione intitolata “Passare tra gli ambienti”Una volta che LIVE è attivato, puoi passare tra TEST e LIVE in qualsiasi momento. Ogni ambiente è accessibile tramite il proprio URL, quindi puoi averli entrambi aperti simultaneamente. Questo è utile per:
- Continuare lo sviluppo e i test in TEST mentre si esegue la produzione in LIVE
- Eseguire il debug riproducendo i problemi prima in TEST
- Formare nuovi membri del team senza influire sui dati di produzione
Conserva le credenziali API di TEST e LIVE separatamente. Usa variabili d’ambiente nella tua applicazione per passare tra di esse — non codificare mai le credenziali di produzione.
Problemi comuni
Sezione intitolata “Problemi comuni”| Problema | Causa | Soluzione |
|---|---|---|
| Pulsante “Go Live” non visibile | Solo l’Owner dell’Account può richiedere LIVE | Accedere come Owner dell’Account e completare tutti i passaggi di onboarding |
| Errori 401 in LIVE | Si stanno usando le credenziali API TEST | Generare nuove credenziali API nell’ambiente LIVE |
| TSS non trovata in LIVE | La TSS esiste solo in TEST | Creare nuove istanze TSS nell’ambiente LIVE |
| Dati mancanti dopo il cambio | Gli ambienti sono isolati | Le risorse devono essere ricreate in ogni ambiente |
Prossimi passi
Sezione intitolata “Prossimi passi”Was this page helpful?