Introduzione a fiskaly

fiskaly fornisce API cloud per la conformità fiscale destinate ai sistemi POS europei. Se il tuo software gestisce transazioni in contanti o con carta in un paese con leggi di firma fiscale, fiskaly si occupa della complessità normativa al posto tuo.

Questa pagina risponde alle tre domande che ogni nuovo cliente si pone: cosa fa fiskaly, quali prodotti mi servono e quanto lavoro richiede l’integrazione.

💡Vuoi subito scrivere codice?

Salta all’Avvio rapido — accesso alla sandbox e prima transazione firmata in meno di 5 minuti.

Cosa fa fiskaly

I paesi europei richiedono che i registratori di cassa elettronici firmino crittograficamente le transazioni, generino esportazioni pronte per l’audit e, in alcuni casi, trasmettano dati alle autorità fiscali in tempo reale. Le normative, i formati e i requisiti di certificazione variano da paese a paese.

fiskaly sostituisce tutto ciò con una singola API REST:

1. Tu invii i dati della transazione (importi, aliquote IVA, tipo di pagamento)
2. fiskaly la firma con un modulo crittografico certificato (TSS, SCU, ecc.)
3. Ricevi una firma da stampare sulla ricevuta (spesso come codice QR)
4. fiskaly conserva il registro di controllo e genera esportazioni conformi su richiesta

Nessun hardware. Nessun modulo crittografico locale. Nessuna presentazione manuale. L’infrastruttura di firma opera in data center cloud certificati ed è sempre aggiornata con le modifiche normative.

Di quali prodotti hai bisogno?

Dipende dai paesi in cui operi e dai tuoi obblighi. Ecco il framework decisionale:

Domanda	Prodotto	Obbligatorio?
Processi transazioni POS in DE, AT, FR, ES, IT o SE?	Sign DE / AT / FR / ES / IT / SE (firma digitale, per paese)	Sì — obbligatorio per legge
Operi in Germania?	DSFinV-K (export fiscale)	Sì — obbligatorio per gli audit
Operi in Germania?	SUBMIT DE (dichiarazione ELSTER)	Sì — obbligatorio dal 2025
Operi in Germania?	Management API (gestione org)	Opzionale
Devi archiviare dati fiscali per 10-30 anni?	SAFE	Consigliato
Emetti fatture B2B in Belgio (o presto DE/FR/IT/PL)?	E-Invoice	Sì (BE), in arrivo per gli altri
Vuoi sostituire le ricevute cartacee?	eReceipt	Opzionale

Punto di partenza più comune: SIGN DE + DSFINVK DE + SUBMIT DE per un’integrazione POS solo in Germania. Copre l’obbligo legale completo.

📘Per i Product Manager

Consulta la Guida alla pianificazione dell’integrazione per stime dello sforzo, requisiti del team, mappe delle dipendenze e un modello di timeline di rollout che puoi adattare alla tua roadmap.

Come funziona l’API (tutti i prodotti)

Ogni prodotto fiskaly segue lo stesso schema di integrazione:

1. Autenticarsi

   POST /auth con la tua chiave e il tuo segreto API. Ricevi un token Bearer valido per 24 ore e un token di aggiornamento valido per 48 ore.

2. Provisioning delle risorse (una tantum)

   Crea la risorsa di firma per il tuo paese: un TSS in Germania, una SCU in Austria, un’unità di firma in Francia/Italia/Spagna. Ogni risorsa corrisponde a una sede fisica o a un terminale POS.

3. Firmare le transazioni

   Per ogni transazione, usa PUT per inviare i dati della transazione (stato, importi, aliquote IVA) alla risorsa di firma. La risposta include una firma crittografica.

4. Generare le esportazioni

   Su richiesta o in modo pianificato, avvia esportazioni di dati conformi (DSFINVK DE, esportazione TSS, archivio) tramite l’API.

Due architetture API

fiskaly fornisce due architetture API, entrambe supportate attivamente:

API Specializzate (SIGN DE, SIGN AT, SIGN ES) — costruite appositamente per le normative di un singolo paese. Endpoint approfonditi, ottimizzati e specifici per paese con modelli di risorse specifici.

API Unificata (SIGN FR, SIGN IT, SIGN SE in arrivo) — un modello di risorse condiviso tra paesi. Integra una volta, aggiungi un altro paese cambiando lo schema del payload.

	API Specializzate	API Unificata
Paesi	Germania, Austria, Spagna	Francia, Italia, Svezia (in arrivo)
Gestione org	Management API separata	Integrata nell’API del prodotto
Aggiungere un paese	Integrare un’API separata	Cambiare lo schema del payload
Ideale per	Profondità in un singolo paese	Espansione multi-paese

Consulta L’API Unificata per il confronto completo, il modello di risorse e la guida all’integrazione.

Espansione multi-paese

Il percorso di espansione dipende dai paesi che stai aggiungendo:

• Aggiungere un altro paese dell’API Unificata (es. FR + IT): ~1 settimana. Stessi URL base, stessi header, stesso modello di risorse — cambia solo la sezione fiscalization del Taxpayer e lo schema del payload del Record.
• Aggiungere un’altra API Specializzata (es. DE + AT): 1-3 settimane. Schema simile ma superfici e endpoint API diversi.
• Combinare architetture (es. DE + FR): Integri entrambe. Condividono lo stesso schema di autenticazione Bearer ma hanno modelli di risorse e URL base diversi.

Ambienti

fiskaly fornisce due ambienti per ogni prodotto:

Ambiente	Scopo	Dati	Fatturazione
TEST (Sandbox)	Sviluppo e test di integrazione	Effimeri — possono essere resettati	Gratuito
LIVE (Produzione)	Transazioni reali con firme reali	Permanenti — rilevanti per gli audit	Fatturate per contratto

Tutte le nuove organizzazioni iniziano in TEST. Passi a LIVE attraverso lo HUB dopo aver completato la tua integrazione.

⚠️TEST e LIVE sono separati

Le risorse create in TEST non esistono in LIVE. Pianifica un passaggio di provisioning nella tua checklist di go-live.

I nostri prodotti

SIGN DE (Germania)

KassenSichV — Cloud-TSS certificato BSI, valido fino al 2033

SIGN AT (Austria)

RKSV — firma cloud con integrazione FinanzOnline

SIGN FR (Francia)

NF525 — firma certificata con modalità replay offline

SIGN ES (Spagna)

TicketBAI e Verifactu — invio XML in tempo reale

SIGN IT (Italia)

Corrispettivi telematici — RT cloud con lotteria degli scontrini

SIGN SE (Svezia)

InfraSec TCS — firma basata su certificati X.509

Prossimi passi

Avvio rapido (Sviluppatori)

Prima chiamata API in meno di 5 minuti. Sandbox, cURL ed esempi in più linguaggi.

Pianificazione dell'integrazione (PM)

Stime dello sforzo, requisiti del team, mappe delle dipendenze e modelli di rollout.

Riferimento API

Tutti gli endpoint dei prodotti, URL base, autenticazione e limiti di frequenza.

Integrazione AI e agenti

Server MCP, endpoint leggibili dalle macchine e best practice per le integrazioni basate su IA.