La Unified API de fiskaly es una arquitectura de integración única que cubre múltiples países. Intégrala una vez. Cada nuevo país solo requiere pequeños ajustes de cumplimiento específicos del país, no una reescritura de tu integración.
| País | Producto | Grupo |
|---|---|---|
| 🇫🇷 Francia | SIGN FR | SIGN |
| 🇮🇹 Italia | SIGN IT | SIGN |
| 🇵🇹 Portugal | SIGN PT | SIGN |
| 🇸🇪 Suecia | SIGN SE | SIGN |
| 🇪🇸 España | SIGN ES Vista previa | SIGN |
| 🇦🇹 Austria | SIGN AT Vista previa | SIGN |
| 🇧🇪 Bélgica | E-INVOICE BE | E-INVOICE |
| 🇩🇪 Alemania | E-INVOICE DE | E-INVOICE |
| 🇮🇹 Italia | E-INVOICE IT | E-INVOICE |
Documentación específica por país
Sección titulada «Documentación específica por país»La especificación de la API se adapta a tu selección de mercado. Usa el selector de país en la parte superior de las páginas de la spec para elegir los mercados que integras — la documentación entonces muestra exactamente lo que aplica a tu selección:
- El texto sin bandera es la base compartida que aplica a todos los países seleccionados.
- Los bloques marcados con una bandera de país (por ejemplo 🇮🇹 o 🇫🇷) proporcionan información adicional específica de ese país — campos adicionales, comportamiento diferente o requisitos adicionales para ese mercado.
- El botón Download exporta un archivo OpenAPI adaptado a tu selección actual.
La misma guía específica por país aparece en las guías de esta sección — cada grupo de países en la barra lateral cubre las particularidades de su mercado.
URLs base
Sección titulada «URLs base»| Entorno | URL |
|---|---|
| Test | test.api.fiskaly.com |
| Live | live.api.fiskaly.com |
Encabezados requeridos
Sección titulada «Encabezados requeridos»| Encabezado | Descripción |
|---|---|
X-Api-Version | Fecha de versión de la API, p. ej. 2026-06-01 |
X-Scope-Identifier | ID de la Organization |
X-Idempotency-Key | UUIDv4 — requerido en cada POST y PATCH |
Authorization | Bearer <access_token> |
Versionado
Sección titulada «Versionado»La Unified API utiliza un versionado basado en calendario (YYYY-MM-DD). La última versión es 2026-06-01.
| Versión | 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 |
Comparación con las APIs Especializadas
Sección titulada «Comparación con las APIs Especializadas»| Unified API | APIs Especializadas | |
|---|---|---|
| Países | FR, IT, PT, SE, ES1, AT1, BE2, DE2 | DE, AT, ES |
| URL base | Compartida entre países | Específica del producto |
| IDs de recursos | Generados por el servidor | UUIDs generados por el cliente |
| Gestión de la organización | Integrada en la API | API de gestión separada |
| Añadir un país | Ajustes menores de esquema | Requiere una nueva integración |
1 disponible a través de ambas APIs · 2 solo e-invoice
SIGN DE es una API Especializada. La integración con la Unified API ya está en desarrollo. La facturación electrónica para Alemania ya es parte de la Unified API.