Soporte y reporte de incidencias

¿Algo no funciona como esperaba? Esta página le ayuda a resolverlo rápidamente. La mayoría de los problemas se resuelven más rápido cuando el primer mensaje ya contiene todo lo que necesitamos, así que lea la lista de comprobación antes de escribirnos.

💡¿Ya ha abierto un ticket?

Gracias. Responda al correo del ticket con los datos de la lista de comprobación. Mantenga el número de ticket en el asunto para que su respuesta se asocie al caso correcto.

Antes de contactarnos

Compruebe el estado del servicio

Las incidencias conocidas y las ventanas de mantenimiento se publican aquí primero. Si un estado está en rojo, no hace falta abrir un ticket.

Consulte el código de error

La mayoría de los errores de la API están documentados aquí con su causa y solución. Busque por código de error o estado HTTP.

Explore los productos

Cada producto tiene sus propias guías de integración y FAQ. Encuentre el suyo en la vista general de productos.

Elija el canal adecuado

Llegar al equipo correcto a la primera ahorra una vuelta innecesaria.

Su situación	Dónde acudir
Error de API, respuesta inesperada, pregunta de integración	Developer Support: dev-support@fiskaly.com, véase más abajo
Opera una caja registradora y ve un error en el dispositivo	Su proveedor de TPV es su primer punto de contacto. Consulte el Operator Center para saber a quién preguntar.
Contratos, precios o preguntas comerciales	sales@fiskaly.com
Facturas y contabilidad	buchhaltung@fiskaly.com

Reportar una incidencia

Envíe su reporte a dev-support@fiskaly.com. Abra un ticket por incidencia. Si detecta dos problemas no relacionados, envíe dos reportes. Los tickets mixtos tardan más porque pueden requerir la revisión de distintos ingenieros.

Contactar con Developer Support

Qué incluir

1. Describa qué esperaba y qué ocurrió

   Con una o dos frases basta. Incluya el mensaje de error exacto si lo hay.

2. Indíquenos dónde y cuándo

   Entorno (TEST o LIVE), API y versión, y una marca de tiempo con zona horaria. Reporte cuanto antes: los registros se correlacionan mejor cuando el evento es reciente.

3. Adjunte la petición y la respuesta completa

   Incluya el identificador que nos permite rastrear la llamada: la cabecera X-Trace-Identifier en la API unificada (SIGN IT, FR, PT, SE, BE, ES, AT, CZ, E-INVOICE) o el request ID de la cabecera de respuesta X-Request-ID en SIGN DE, DSFinV-K y la Management API. Con él localizamos la llamada en nuestros sistemas en segundos.

4. Añada los ID de los recursos afectados

   Los ID relevantes dependen del producto. Use la tabla siguiente como guía.

⚠️Nunca envíe credenciales

Elimine los secretos de API, tokens bearer y contraseñas de cualquier petición que adjunte. Nunca se los pediremos. Si sospecha que una clave se ha visto comprometida, rótela primero y luego avísenos.

ID de recursos por producto

Producto	ID a incluir
Unified API (SIGN IT, FR, PT, SE, ES, AT, CZ and E-INVOICE)	Organization ID, Taxpayer ID, Location ID, System ID, Subject ID, Record ID
SIGN DE (Specialized API)	Organization ID, TSS ID, Client ID, Transaction ID, Export ID
SIGN AT (Specialized API)	Cash Register ID, Receipt ID, Signature Creation Unit ID
SIGN ES (Specialized API)	Signer ID, Client ID, Invoice ID, Export ID
DSFinV-K	Cash Register ID, Closing ID, Export ID
SAFE	File ID, Export ID, Annotation ID
eReceipt	Receipt ID, Static ID, Revision
Management API	Organization ID, User ID, Key ID (nunca el secreto)

Plantilla de reporte

Copie la plantilla en su correo y complete cada línea que aplique. La plantilla se mantiene en inglés porque nuestro equipo de soporte clasifica todos los tickets en inglés. Puede describir el problema en su idioma debajo de ella.

Subject: [PRODUCT] Short description of the problem

Company / Organization:
Environment: TEST | LIVE
API and version:
First occurrence (date, time, timezone):
Frequency: once | intermittent | permanent

What I expected:
What happened instead (exact error message):

Request (method, URL, body without secrets):
Response (full body and status code):
Request ID / X-Trace-Identifier:

Affected resource IDs:

What we did right before the error:

Si la producción está afectada, indíquelo en el asunto, por ejemplo [LIVE] Signing fails for all clients. Nos ayuda a ver el impacto de un vistazo.

Qué ocurre después

1. Confirmación

   Recibirá un número de ticket por correo. Úselo en todas sus respuestas.

2. Clasificación

   Revisamos el reporte y lo asignamos a la persona adecuada.

3. Investigación

   Es posible que hagamos preguntas adicionales. Cuanto más completo sea su primer mensaje, menos habrá.

4. Resolución

   Le mantenemos informado en el ticket y lo cerramos una vez resuelto el problema.

Enlaces útiles

Estado del servicio

Estado en tiempo real de todos los servicios de fiskaly e historial de incidencias.

Códigos de error

Referencia central de los códigos de error de la API y cómo resolverlos.

Referencia de la API

Endpoints, esquemas y ejemplos de todas las API de fiskaly.