Alemania (SIGN DE)

📘API especializada

SIGN DE es una API especializada — diseñada específicamente para el cumplimiento alemán de KassenSichV, certificada por BSI y el producto más maduro de fiskaly. Utiliza una superficie de API dedicada con tus propios endpoints y modelo de recursos. Para la arquitectura de API Unificada multi-país (que cubre Francia, Italia, Suecia), consulta La API Unificada.

Lo que necesitas saber

Alemania tiene los requisitos de cumplimiento fiscal más exhaustivos de todos los países compatibles con fiskaly. Una integración alemana completa requiere tres productos que trabajen juntos:

Producto	Función	¿Obligatorio?
SIGN DE	Firma criptográficamente cada transacción mediante una Cloud-TSS certificada por BSI	Sí — KassenSichV
DSFINVK DE	Genera exportaciones de datos fiscales listas para auditoría desde los cierres de caja	Sí — para auditorías fiscales
SUBMIT DE	Presenta declaraciones electrónicas a ELSTER (interfaz de la autoridad fiscal alemana)	Sí — desde 2025
SAFE	Archiva datos fiscales 10–30 años en centros de datos certificados	Recomendado

💡¿Nuevo en fiskaly?

Comienza con el Inicio rápido para obtener una transacción firmada en 5 minutos. Vuelve aquí para el panorama completo.

¿Qué es KassenSichV?

La Kassensicherungsverordnung (KassenSichV) exige que todos los sistemas electrónicos de registro (ERS) en Alemania:

• Utilizan un sistema de seguridad técnica (TSS) certificado para firmar cada transacción
• Manténn rastros de auditoría a prueba de manipulaciones con firmas criptográficas
• Generan exportaciones DSFinV-K para los auditores fiscales
• Impriman códigos QR en los recibos con los datos de firma

La Cloud-TSS de fiskaly es la primera TSS basada en la nube en obtener la certificación BSI, actualmente válida hasta 2033. Sin hardware, sin módulos criptográficos locales — solo llamadas a la API.

Esfuerzo de integración

Para PMs que estiman el trabajo:

Fase	Duración	Qué ocurre
Configuración sandbox	1–2 días	Creación de cuenta, claves de API, primera transacción firmada
Integración SIGN DE	3–5 semanas	Aprovisionamiento TSS, firma de transacciones, códigos QR en recibos, manejo de errores
Integración DSFINVK DE	2–3 semanas	Mapear el modelo de datos POS a la taxonomía DSFINVK DE, implementar cierres de caja
Integración SUBMIT DE	1–2 semanas	Registro de contribuyente, presentación de declaraciones
Pruebas de extremo a extremo	1–2 semanas	Validación completa del flujo en sandbox
Go-live	1 semana	Aprovisionamiento LIVE, lanzamiento por etapas, configuración de monitoreo
Total	8–13 semanas	1–2 desarrolladores backend con experiencia en dominio POS

Consulta la Guía de planificación de integración para requisitos de equipo, mapas de dependencias y una plantilla de cronograma de lanzamiento.

Descripción general de la arquitectura

Tu sistema de caja
  |
  |-- POST /auth (clave de API + secreto) --> Token Bearer (24h)
  |
  |-- PUT /tss/{id} -----------------> Crear + inicializar TSS (una vez por ubicación)
  |-- PUT /tss/{id}/client/{id} -----> Crear cliente (uno por terminal POS)
  |
  |-- PUT /tss/{id}/tx/{id} ---------> Iniciar transacción (estado: ACTIVE)
  |-- PUT /tss/{id}/tx/{id} ---------> Finalizar transacción (estado: FINISHED)
  |                                     La respuesta incluye firma + datos de código QR
  |
  |-- POST /dsfinvk/closings --------> Enviar datos de cierre de caja
  |-- GET  /dsfinvk/exports  --------> Generar archivo de exportación DSFinV-K
  |
  |-- POST /submission/submit -------> Presentar declaración a ELSTER

Responsabilidades

Tu responsabilidad (proveedor de sistema de caja)

• Integrar la TSS de fiskaly en tu ERS
• Asegurarte de que cada transacción esté firmada antes de generar el recibo
• Imprimir códigos QR con datos de firma en los recibos
• Generar cierres de caja DSFINVK DE al final del día
• Presentar declaraciones mediante SUBMIT DE
• Gestionar los tiempos de espera correctamente (consulta manejo de errores)

Responsabilidad de tu cliente (contribuyente)

• Tener un ERS con TSS integrada vinculada a tu cuenta
• Entregar exportaciones TSS y exportaciones DSFinV-K a los auditores dentro de los plazos requeridos
• Mantener copias de seguridad de los datos fiscales (retención de 10–30 años, se recomiendan dos ubicaciones físicas)

Responsabilidad de fiskaly

• Operar y mantener la Cloud-TSS certificada (SLA de disponibilidad del 99,9 %)
• Proporcionar actualizaciones de software y parches de seguridad (sin coste)
• Gestionar las renovaciones de certificación
• Mantener la disponibilidad y el rendimiento de la API

Lista de verificación de cumplimiento para go-live

Antes de lanzar en producción, verifica:

• Para cada ubicación/tienda, asegúrate de tener una TSS individual creada, configurada en UNINITIALIZED, PIN de administrador establecido y TSS configurada en INITIALIZED
• Cliente creado para cada terminal POS
• Cada transacción está firmada (ciclo de vida de inicio + finalización)
• El recibo incluye el código QR de KassenSichV (referencia de formato)
• El código QR se valida correctamente (herramienta de validación)
• Los cierres de caja DSFINVK DE se generan correctamente
• La declaración SUBMIT DE es aceptada por ELSTER
• El tiempo de espera de firma es de 3–5 segundos y no bloquea el proceso de pago
• La lógica de reintento maneja errores 5xx con retroceso exponencial
• El administrador ha cerrado sesión después del aprovisionamiento
• El entorno LIVE está aprovisionado por separado del de PRUEBA

⚠️Una firma faltante no invalida un recibo

Si la TSS no está disponible, emite el recibo con una nota como “TSS no disponible” e incluye la transacción no firmada en tu exportación DSFinV-K. Consulta manejo de errores para más detalles.

Documentación

Primeros pasos

Introducción

Contexto de KassenSichV, adquisición de Deutsche Fiskal, detalles de certificación

Guía para nuevos clientes

Paso a paso: configuración de cuenta hasta la primera transacción firmada con ejemplos de código

Detalles técnicos

Arquitectura TSS, flujo de datos de transacciones y proceso de firma criptográfica

Guías

Manejo de errores

Estrategia de tiempo de espera, lógica de reintento y qué hacer cuando la TSS no está disponible

Tutorial de Postman

Exploración interactiva de la API — sin necesidad de código

Manual del dashboard

Gestionar organizaciones, claves de API y TSS a través de la interfaz web

Cumplimiento

Datos del recibo

Campos obligatorios del recibo y especificación del contenido del código QR

Validación de código QR

Valida que tus códigos QR cumplan con KassenSichV

Certificación

Documentos de certificación BSI y períodos de validez

Productos relacionados

DSFINVK DE

Exportación de datos fiscales — obligatorio para Alemania, referencia los datos de SIGN DE

SUBMIT DE

Declaración ELSTER — obligatorio para Alemania desde 2025

SAFE

Archivo a largo plazo de exportaciones fiscales (recomendado)

Referencia

Referencia de API (SIGN DE v2)

Documentación interactiva de endpoints con todos los esquemas

Glosario

Términos de KassenSichV: TSS, ERS, DSFinV-K y más

Soporte

Cómo obtener ayuda, colecciones de ejemplo y canales de contacto