Human Intervention Registry

This registry documents every integration action across fiskaly products, categorizing each as fully automatable, partially automatable, or requiring human intervention. Use it to plan your integration workflow and identify where human-in-the-loop steps are needed.

12 actions can be completed entirely via API calls with no human involvement.

2 actions require human-provided data but can be executed by an agent.

8 actions must be performed by a human through the dashboard or external processes.

Complete Registry

Action	Product	Automatable	Reason	What to Do
Create fiskaly account	All	No	Requires email verification and terms acceptance	User must register at hub.fiskaly.com or dashboard.fiskaly.com
Create organization	All	No	Requires authenticated dashboard session	User creates via HUB or Dashboard
Generate API key	All	No	Requires dashboard session; secret shown once	User generates in HUB or Dashboard
Authenticate (get token)	All	Yes	Standard API call	POST /auth with api_key + api_secret
Create TSS	SIGN DE	Yes	API call	PUT /tss/{uuid}
Initialize TSS	SIGN DE	Yes	Sequence of API calls	Set Admin PIN → Auth → State INITIALIZED
Create Client	SIGN DE	Yes	API call	PUT /tss/{id}/client/{uuid}
Create Transaction	SIGN DE	Yes	API call	PUT with ACTIVE then FINISHED
Create Organization UNIT	SIGN FR, SIGN IT	Yes	API call	POST /organizations
Create Subject API Key	SIGN FR, SIGN IT	Yes	API call	POST /subjects
Enter taxpayer data	SIGN FR, SIGN IT	Partial	Needs real tax credentials	Human provides tax ID; agent makes API call
Commission resources	SIGN FR, SIGN IT	Yes	State change	PATCH with state COMMISSIONED
Create Location	SIGN FR, SIGN IT	Yes	API call	POST /locations
Create System	SIGN FR, SIGN IT	Yes	API call	POST /systems
Create Record	SIGN FR, SIGN IT	Yes	Two-step API call	Intention → Transaction
Switch TEST to LIVE	All	No	Requires contract	Contact sales or use HUB go-live
Obtain certification	All	No	Regulatory process	Apply through relevant authority
Enter billing info	All	No	Sensitive financial data	User enters in HUB/Dashboard
Manage user access	All	No	Security-sensitive	Admin manages via HUB/Dashboard
ELSTER registration	SUBMIT DE	Partial	Needs real taxpayer data	Human provides Steuernummer; agent calls API

Breakdown by Category

Requires Human Intervention

These actions involve account security, legal agreements, financial data, or regulatory processes that cannot be delegated to automation:

• Account creation — email verification and terms acceptance
• Organization creation — requires authenticated dashboard session
• API key generation — secret is shown once, requires dashboard
• Switch TEST to LIVE — requires a signed contract with fiskaly
• Obtain certification — regulatory process through relevant authority
• Enter billing info — sensitive financial data, entered via dashboard
• Manage user access — security-sensitive, admin-only via dashboard

Partially Automatable

These actions need human-provided data but the API call itself can be automated:

• Enter taxpayer data (SIGN FR, SIGN IT) — human provides tax ID, agent makes the API call
• ELSTER registration (SUBMIT DE) — human provides Steuernummer, agent calls the API

Fully Automatable

All standard API operations after initial setup:

• Authentication token retrieval
• TSS lifecycle (create, initialize, client, transaction) for SIGN DE
• Organization units, subjects, locations, systems, and records for SIGN FR / SIGN IT
• Commissioning resources via state changes

💡Tip

For AI agent developers: When building automated integrations, plan for human-in-the-loop steps at the beginning (account setup, API keys) and at go-live (contract, billing). The core integration workflow between these steps is fully automatable via API. Design your agent to pause and prompt the user for these specific steps, then resume automation.

Machine-Readable API

This registry is also available as a JSON endpoint for programmatic access:

GET /human-interventions.json

The JSON response includes the full interventions list with summary counts, suitable for AI agents and automation tools to query at runtime.

📘Note

For a complete guide to building AI-powered fiskaly integrations — including the MCP server, all machine-readable endpoints, and agent best practices — see the AI & Agents section.