Introducción a fiskaly

fiskaly proporciona APIs de cumplimiento fiscal basadas en la nube para sistemas POS europeos. Si su software gestiona transacciones en efectivo o con tarjeta en un país con leyes de firma fiscal, fiskaly gestiona la complejidad regulatoria para que tu equipo no tenga que hacerlo.

Esta página responde a las tres preguntas que hace todo nuevo cliente: qué hace fiskaly, qué productos necesito y cuánto trabajo supone la integración.

💡¿Solo quiere escribir código?

Vaya directamente al Quick Start — acceso a sandbox y tu primera transacción firmada en menos de 5 minutos.

Qué hace fiskaly

Los países europeos exigen que los sistemas de caja electrónicos firmen criptográficamente las transacciones, generan exportaciones listas para auditoría y, en algunos casos, transmitan datos a las autoridades tributarias en tiempo real. Las regulaciones, formatos y requisitos de certificación difieren por país.

fiskaly reemplaza todo eso con una sola API REST:

1. Envías los datos de la transacción (importes, tipos de IVA, tipo de pago)
2. fiskaly los firma con un módulo criptográfico certificado (TSS, SCU, etc.)
3. Recibes una firma para imprimir en el recibo (a menudo como código QR)
4. fiskaly almacena la pista de auditoría y genera exportaciones conformes bajo demanda

Sin hardware. Sin módulos criptográficos locales. Sin presentaciones manuales. La infraestructura de firma funciona en centros de datos en la nube certificados y siempre está actualizada con los cambios regulatorios.

¿Qué productos necesita?

Depende de en qué países opera y cuáles son sus obligaciones. Aquí está el marco de decisión:

Pregunta	Producto	¿Obligatorio?
¿Procesa transacciones POS en DE, AT, FR, ES, IT o SE?	Sign DE / AT / FR / ES / IT / SE (firma digital, por país)	Sí — legalmente obligatorio
¿Opera en Alemania?	DSFinV-K (exportación fiscal)	Sí — obligatorio para auditorías
¿Opera en Alemania?	SUBMIT DE (presentación ELSTER)	Sí — obligatorio desde 2025
¿Opera en Alemania?	Management API (gestión de org.)	Opcional
¿Necesita archivar datos fiscales durante 10-30 años?	SAFE	Recomendado
¿Emite facturas B2B en Bélgica (o pronto DE/FR/IT/PL)?	E-Invoice	Sí (BE), próximamente para otros
¿Quiere reemplazar los recibos en papel?	eReceipt	Opcional

Punto de partida más común: SIGN DE + DSFINVK DE + SUBMIT DE para una integración POS solo para Alemania. Esto cubre la obligación legal completa.

📘Para Product Managers

Consulta la guía de planificación de integración para estimaciones de esfuerzo, requisitos de equipo, mapas de dependencias y una plantilla de cronograma de despliegue que puede adaptar para su hoja de ruta.

Cómo funciona la API (todos los productos)

Cada producto de fiskaly sigue el mismo patrón de integración:

1. Autenticar

   POST /auth con tu API Key y secret. Recibe un token Bearer válido por 24 horas y un token de actualización válido por 48 horas.

2. Aprovisionar recursos (una vez)

   Crea el recurso de firma para su país: un TSS en Alemania, una SCU en Austria, una unidad de firma en Francia/Italia/España. Cada recurso corresponde a una ubicación física o terminal POS.

3. Firmar transacciones

   Para cada transacción, PUT los datos de la transacción (estado, importes, tipos de IVA) contra el recurso de firma. La respuesta incluye una firma criptográfica.

4. Generar exportaciones

   A demanda o de forma programada, active exportaciones de datos conformes (DSFINVK DE, exportación TSS, archivo) a través de la API.

Dos arquitecturas de API

fiskaly proporciona dos arquitecturas de API, ambas activamente respaldadas:

APIs Especializadas (SIGN DE, SIGN AT, SIGN ES) — creadas específicamente para las regulaciones de un solo país. Endpoints y modelos de recursos profundos, optimizados y específicos por país.

API Unificada (SIGN FR, SIGN IT, SIGN SE próximamente) — un modelo de recursos compartido entre países. Integra una vez, añade otro país cambiando el esquema del payload.

	APIs Especializadas	API Unificada
Países	Alemania, Austria, España	Francia, Italia, Suecia (próximo)
Gestión de org.	Management API separada	Integrada en la API del producto
Añadir un país	Integrar una API separada	Cambiar el esquema del payload
Ideal para	Profundidad en un solo país	Expansión multi-país

Consulta La API Unificada para la comparación completa, el modelo de recursos y la guía de integración.

Expansión multi-país

La ruta de expansión depende de los países que añade:

• Añadir otro país de la API Unificada (p. ej., FR + IT): ~1 semana. Mismas URLs base, mismos encabezados, mismo modelo de recursos — solo cambia la sección fiscalization del contribuyente y el esquema del payload del registro.
• Añadir otra API Especializada (p. ej., DE + AT): 1-3 semanas. Patrones similares pero diferentes superficies de API y endpoints.
• Mezclar arquitecturas (p. ej., DE + FR): Integra ambas. Comparten el mismo patrón de autenticación con token Bearer pero tienen diferentes modelos de recursos y URLs base.

Entornos

fiskaly proporciona dos entornos para cada producto:

Entorno	Propósito	Datos	Facturación
TEST (Sandbox)	Desarrollo y pruebas de integración	Efímeros — se pueden restablecer	Gratuito
LIVE (Producción)	Transacciones reales con firmas reales	Permanentes — relevantes para auditoría	Facturado por contrato

Todas las nuevas organizaciones comienzan en TEST. Cambia a LIVE a través del HUB tras completar tu integración.

⚠️TEST y LIVE están separados

Los recursos creados en TEST no existen en LIVE. Planifique un paso de aprovisionamiento en su lista de verificación de entrada en producción.

Nuestros productos

SIGN DE (Alemania)

KassenSichV — Cloud-TSS certificado por BSI, válido hasta 2033

SIGN AT (Austria)

RKSV — firma basada en la nube con integración de FinanzOnline

SIGN FR (Francia)

NF525 — firma certificada con modo de reproducción sin conexión

SIGN ES (España)

TicketBAI y Verifactu — envío XML en tiempo real

SIGN IT (Italia)

Corrispettivi telematici — RT en la nube con lotería de recibos

SIGN SE (Suecia)

InfraSec TCS — firma basada en certificados X.509

Próximos pasos

Quick Start (Desarrolladores)

Primera llamada a la API en menos de 5 minutos. Sandbox, cURL y ejemplos en varios idiomas.

Planificación de integración (PMs)

Estimaciones de esfuerzo, requisitos de equipo, mapas de dependencias y plantillas de despliegue.

Referencia de API

Todos los endpoints de productos, URLs base, autenticación y límites de velocidad.

Integración con IA y agentes

Servidor MCP, endpoints legibles por máquina y mejores prácticas para integraciones impulsadas por IA.