URL di base e ambienti

Tutti i prodotti fiskaly forniscono ambienti TEST e LIVE separati. Le chiavi API generate in un ambiente funzionano solo con le risorse di quell’ambiente.

Prodotti SIGN

Prodotto	URL di base test	URL di base live	Percorso API
SIGN DE	https://kassensichv-middleware.fiskaly.com/api/v2	https://kassensichv.fiskaly.com/api/v2	/api/v2
SIGN AT	https://rksv.fiskaly.com/api/v1	https://rksv.fiskaly.com/api/v1	/api/v1
SIGN ES	https://test.es.sign.fiskaly.com/api/v1	https://live.es.sign.fiskaly.com/api/v1	/api/v1
SIGN IT	https://test.api.fiskaly.com	https://live.api.fiskaly.com	Percorsi con versione
SIGN FR	https://test.api.fiskaly.com	https://live.api.fiskaly.com	Percorsi con versione

Altri prodotti

Prodotto	URL di base test	URL di base live	Percorso API
DSFINVK DE	https://dsfinvk.fiskaly.com/api/v1	https://dsfinvk.fiskaly.com/api/v1	/api/v1
RECEIPT	https://receipt.fiskaly.com/api/v1	https://receipt.fiskaly.com/api/v1	/api/v1
E-INVOICE	https://test.api.fiskaly.com	https://live.api.fiskaly.com	Percorsi con versione
HUB	https://hub.fiskaly.com/api/v0	https://hub.fiskaly.com/api/v0	/api/v0

Header obbligatori

Tutti i prodotti

Header	Valore	Obbligatorio
Authorization	Bearer <access_token>	Tutte le richieste autenticate
Content-Type	application/json	Tutte le richieste con body

API più recenti (SIGN IT, SIGN FR, E-INVOICE)

Queste API condividono una piattaforma comune e richiedono header aggiuntivi:

Header	Valore	Obbligatorio
X-Api-Version	2026-02-03 (attuale)	Tutte le richieste
X-Idempotency-Key	UUIDv4	Tutte le richieste POST e PATCH
X-Scope-Identifier	UUID organizzazione	Quando si limita a una UNIT specifica

SIGN ES

Header	Valore	Obbligatorio
Content-Type	application/json	Tutte le richieste

📘Note

SIGN ES include tutti i body delle richieste in un envelope content: {"content": {...}}. Questo si applica all’autenticazione e a tutte le chiamate API.

Comportamento dell’ambiente

⚠️LIVE è permanente

I record creati nell’ambiente LIVE hanno valore legale. Le transazioni in SIGN DE sono firmate dal TSS certificato BSI. I record in SIGN IT e SIGN FR vengono trasmessi alla rispettiva autorità fiscale. Sviluppa e testa sempre in TEST prima.

Comportamento	TEST	LIVE
Invio all’autorità fiscale	No	Sì
Validazione certificazione	Simulata	Reale
Conservazione dati	Standard	Secondo i requisiti legali
Limiti di frequenza	Standard	Standard

💡Passaggio degli ambienti

Quando sei pronto per andare in produzione, genera nuove chiavi API nell’ambiente LIVE tramite l’HUB. Consulta la guida Passaggio a LIVE per le istruzioni passo per passo.

Stato del servizio

Monitora tutti gli endpoint del servizio fiskaly su status.fiskaly.com.