URLs base y entornos

Todos los productos de fiskaly ofrecen entornos TEST y LIVE separados. Las API keys generadas en un entorno solo funcionan con los recursos de ese entorno.

Productos SIGN

Producto	URL base de prueba	URL base LIVE	Ruta de API
SIGN DE	https://kassensichv-middleware.fiskaly.com/api/v2	https://kassensichv.fiskaly.com/api/v2	/api/v2
SIGN AT	https://rksv.fiskaly.com/api/v1	https://rksv.fiskaly.com/api/v1	/api/v1
SIGN ES	https://test.es.sign.fiskaly.com/api/v1	https://live.es.sign.fiskaly.com/api/v1	/api/v1
SIGN IT	https://test.api.fiskaly.com	https://live.api.fiskaly.com	Rutas con versión
SIGN FR	https://test.api.fiskaly.com	https://live.api.fiskaly.com	Rutas con versión

Otros productos

Producto	URL base de prueba	URL base LIVE	Ruta de API
DSFINVK DE	https://dsfinvk.fiskaly.com/api/v1	https://dsfinvk.fiskaly.com/api/v1	/api/v1
RECEIPT	https://receipt.fiskaly.com/api/v1	https://receipt.fiskaly.com/api/v1	/api/v1
E-INVOICE	https://test.api.fiskaly.com	https://live.api.fiskaly.com	Rutas con versión
HUB	https://hub.fiskaly.com/api/v0	https://hub.fiskaly.com/api/v0	/api/v0

Encabezados requeridos

Todos los productos

Encabezado	Valor	Requerido
Authorization	Bearer <access_token>	Todas las solicitudes autenticadas
Content-Type	application/json	Todas las solicitudes con cuerpo

APIs más recientes (SIGN IT, SIGN FR, E-INVOICE)

Estas APIs comparten una plataforma común y requieren encabezados adicionales:

Encabezado	Valor	Requerido
X-Api-Version	2026-02-03 (actual)	Todas las solicitudes
X-Idempotency-Key	UUIDv4	Todas las solicitudes POST y PATCH
X-Scope-Identifier	UUID de la organización	Al limitar el alcance a una UNIT específica

SIGN ES

Encabezado	Valor	Requerido
Content-Type	application/json	Todas las solicitudes

📘Note

SIGN ES envuelve todos los cuerpos de solicitud en un sobre content: {"content": {...}}. Esto aplica a la autenticación y a todas las llamadas a la API.

Comportamiento del entorno

⚠️LIVE es permanente

Los registros creados en el entorno LIVE son legalmente vinculantes. Las transacciones en SIGN DE son firmadas por el TSS certificado por BSI. Los registros en SIGN IT y SIGN FR se transmiten a la autoridad fiscal correspondiente. Desarrolle y prueba siempre en TEST primero.

Comportamiento	TEST	LIVE
Envío a la autoridad fiscal	No	Sí
Validación de certificados	Simulada	Real
Retención de datos	Estándar	Según requisitos legales
Límites de velocidad	Estándar	Estándar

💡Cambiar de entorno

Cuando esté listo para pasar a LIVE, genera nuevas API keys en el entorno LIVE a través del HUB. Consulta la guía Cambiar a LIVE para instrucciones paso a paso.

Estado del servicio

Monitoree todos los endpoints del servicio de fiskaly en status.fiskaly.com.