Registro de intervención humana

Este registro documenta cada acción de integración en todos los productos fiskaly, categorizando cada una como completamente automatizable, parcialmente automatizable o que requiere intervención humana. Úsalo para planificar tu flujo de integración e identificar los pasos que necesitan intervención humana.

12 acciones pueden completarse íntegramente mediante llamadas a la API sin ninguna intervención humana.

2 acciones requieren datos proporcionados por humanos pero pueden ser ejecutadas por un agente.

8 acciones deben ser realizadas por una persona a través del panel de control o procesos externos.

Registro completo

Acción	Producto	Automatizable	Motivo	Qué hacer
Crear cuenta fiskaly	Todos	No	Requiere verificación de correo y aceptación de términos	El usuario debe registrarse en hub.fiskaly.com o dashboard.fiskaly.com
Crear organización	Todos	No	Requiere sesión autenticada en el panel	El usuario crea a través del HUB o el Panel
Generar clave API	Todos	No	Requiere sesión en el panel; el secreto se muestra una sola vez	El usuario genera en el HUB o el Panel
Autenticarse (obtener token)	Todos	Sí	Llamada API estándar	POST /auth con api_key + api_secret
Crear TSS	SIGN DE	Sí	Llamada API	PUT /tss/{uuid}
Inicializar TSS	SIGN DE	Sí	Secuencia de llamadas API	Establecer PIN de administrador → Auth → Estado INITIALIZED
Crear cliente	SIGN DE	Sí	Llamada API	PUT /tss/{id}/client/{uuid}
Crear transacción	SIGN DE	Sí	Llamada API	PUT con ACTIVE y luego FINISHED
Crear UNIT de organización	SIGN FR, SIGN IT	Sí	Llamada API	POST /organizations
Crear clave API de sujeto	SIGN FR, SIGN IT	Sí	Llamada API	POST /subjects
Ingresar datos del contribuyente	SIGN FR, SIGN IT	Parcial	Necesita credenciales fiscales reales	El humano proporciona el NIF; el agente realiza la llamada API
Poner en servicio recursos	SIGN FR, SIGN IT	Sí	Cambio de estado	PATCH con estado COMMISSIONED
Crear ubicación	SIGN FR, SIGN IT	Sí	Llamada API	POST /locations
Crear sistema	SIGN FR, SIGN IT	Sí	Llamada API	POST /systems
Crear registro	SIGN FR, SIGN IT	Sí	Llamada API en dos pasos	Intención → Transacción
Cambiar de TEST a LIVE	Todos	No	Requiere contrato	Contactar con ventas o usar el go-live del HUB
Obtener certificación	Todos	No	Proceso regulatorio	Solicitar a través de la autoridad correspondiente
Ingresar información de facturación	Todos	No	Datos financieros sensibles	El usuario introduce en el HUB/Panel
Gestionar acceso de usuarios	Todos	No	Sensible en materia de seguridad	El administrador gestiona a través del HUB/Panel
Registro ELSTER	SUBMIT DE	Parcial	Necesita datos reales del contribuyente	El humano proporciona el Steuernummer; el agente llama a la API

Desglose por categoría

Requiere intervención humana

Estas acciones implican seguridad de cuentas, acuerdos legales, datos financieros o procesos regulatorios que no pueden delegarse a la automatización:

• Creación de cuenta — verificación de correo electrónico y aceptación de términos
• Creación de organización — requiere sesión autenticada en el panel
• Generación de clave API — el secreto se muestra una vez, requiere el panel
• Cambio de TEST a LIVE — requiere un contrato firmado con fiskaly
• Obtener certificación — proceso regulatorio a través de la autoridad correspondiente
• Ingresar información de facturación — datos financieros sensibles, introducidos a través del panel
• Gestionar acceso de usuarios — sensible en materia de seguridad, solo para administradores a través del panel

Parcialmente automatizable

Estas acciones necesitan datos proporcionados por humanos, pero la propia llamada API puede automatizarse:

• Ingresar datos del contribuyente (SIGN FR, SIGN IT) — el humano proporciona el NIF, el agente realiza la llamada API
• Registro ELSTER (SUBMIT DE) — el humano proporciona el Steuernummer, el agente llama a la API

Completamente automatizable

Todas las operaciones API estándar después de la configuración inicial:

• Recuperación de tokens de autenticación
• Ciclo de vida del TSS (crear, inicializar, cliente, transacción) para SIGN DE
• Unidades de organización, sujetos, ubicaciones, sistemas y registros para SIGN FR / SIGN IT
• Puesta en servicio de recursos mediante cambios de estado

💡Tip

Para desarrolladores de agentes IA: Al crear integraciones automatizadas, planifica los pasos de intervención humana al principio (configuración de cuenta, claves API) y en el go-live (contrato, facturación). El flujo principal de integración entre estos pasos es completamente automatizable mediante API. Diseña tu agente para pausarse y solicitar al usuario estos pasos específicos y luego reanudar la automatización.

API legible por máquina

Este registro también está disponible como endpoint JSON para acceso programático:

GET /human-interventions.json

La respuesta JSON incluye la lista completa de intervenciones con recuentos resumidos, adecuada para que agentes IA y herramientas de automatización consultan en tiempo de ejecución.

📘Note

Para una guía completa sobre la creación de integraciones fiskaly impulsadas por IA — incluyendo el servidor MCP, todos los endpoints legibles por máquina y las mejores prácticas para agentes — consulta la sección IA y agentes.