La Unified API di fiskaly è un’unica architettura di integrazione che copre più paesi. Integrala una volta. Ogni nuovo paese richiede solo piccoli adattamenti di conformità specifici per paese, non una riscrittura dell’integrazione.
| Paese | Prodotto | Gruppo |
|---|---|---|
| 🇫🇷 Francia | SIGN FR | SIGN |
| 🇮🇹 Italia | SIGN IT | SIGN |
| 🇵🇹 Portogallo | SIGN PT | SIGN |
| 🇸🇪 Svezia | SIGN SE | SIGN |
| 🇪🇸 Spagna | SIGN ES Anteprima | SIGN |
| 🇦🇹 Austria | SIGN AT Anteprima | SIGN |
| 🇧🇪 Belgio | E-INVOICE BE | E-INVOICE |
| 🇩🇪 Germania | E-INVOICE DE | E-INVOICE |
| 🇮🇹 Italia | E-INVOICE IT | E-INVOICE |
Documentazione specifica per paese
Sezione intitolata “Documentazione specifica per paese”La specifica API si adatta alla tua selezione di mercato. Usa il selettore di paese in cima alle pagine della spec per scegliere i mercati che integri — la documentazione mostra quindi esattamente ciò che si applica alla tua selezione:
- Il testo senza bandiera è la base condivisa che si applica a tutti i paesi selezionati.
- I blocchi contrassegnati con una bandiera di paese (ad esempio 🇮🇹 o 🇫🇷) forniscono informazioni aggiuntive specifiche per quel paese — campi extra, comportamenti diversi o requisiti aggiuntivi per quel mercato.
- Il pulsante Download esporta un file OpenAPI su misura per la tua selezione attuale.
La stessa logica specifica per paese si ritrova nelle guide di questa sezione — ogni gruppo di paesi nella sidebar copre le specificità del proprio mercato.
URL di base
Sezione intitolata “URL di base”| Ambiente | URL |
|---|---|
| Test | test.api.fiskaly.com |
| Live | live.api.fiskaly.com |
Header richiesti
Sezione intitolata “Header richiesti”| Header | Descrizione |
|---|---|
X-Api-Version | Data della versione API, es. 2026-06-01 |
X-Scope-Identifier | ID dell’Organization |
X-Idempotency-Key | UUIDv4 — obbligatorio su ogni POST e PATCH |
Authorization | Bearer <access_token> |
Versionamento
Sezione intitolata “Versionamento”La Unified API utilizza un versionamento basato su calendario (YYYY-MM-DD). L’ultima versione è 2026-06-01.
| Versione | SIGN | E-INVOICE |
|---|---|---|
2026-06-01 | FR, IT, PT, SE, ES, AT | BE, DE, IT |
2026-05-04 | FR, IT, PT | BE, DE |
2026-02-03 | FR, IT | BE, DE |
Confronto con le API Specializzate
Sezione intitolata “Confronto con le API Specializzate”| Unified API | API Specializzate | |
|---|---|---|
| Paesi | FR, IT, PT, SE, ES1, AT1, BE2, DE2 | DE, AT, ES |
| URL di base | Condiviso tra i paesi | Specifico per prodotto |
| ID delle risorse | Generati dal server | UUID generati dal client |
| Gestione dell’organizzazione | Integrata nell’API | API di gestione separata |
| Aggiungere un paese | Piccoli adattamenti dello schema | Richiede una nuova integrazione |
1 disponibile tramite entrambe le API · 2 solo e-invoice
SIGN DE è un’API Specializzata. L’integrazione con la Unified API è già in lavorazione. La fatturazione elettronica per la Germania fa già parte della Unified API.