Registro degli interventi umani

Questo registro documenta ogni azione di integrazione su tutti i prodotti fiskaly, categorizzando ciascuna come completamente automatizzabile, parzialmente automatizzabile o che richiede intervento umano. Usalo per pianificare il flusso di integrazione e identificare i passaggi che necessitano di intervento umano.

12 azioni possono essere completate interamente tramite chiamate API senza alcun coinvolgimento umano.

2 azioni richiedono dati forniti da esseri umani ma possono essere eseguite da un agente.

8 azioni devono essere eseguite da un essere umano attraverso la dashboard o processi esterni.

Registro completo

Azione	Prodotto	Automatizzabile	Motivo	Cosa fare
Creare account fiskaly	Tutti	No	Richiede verifica email e accettazione dei termini	L’utente deve registrarsi su hub.fiskaly.com o dashboard.fiskaly.com
Creare organizzazione	Tutti	No	Richiede sessione autenticata sulla dashboard	L’utente crea tramite HUB o Dashboard
Generare chiave API	Tutti	No	Richiede sessione dashboard; il segreto viene mostrato una sola volta	L’utente genera nell’HUB o Dashboard
Autenticarsi (ottenere token)	Tutti	Sì	Chiamata API standard	POST /auth con api_key + api_secret
Creare TSS	SIGN DE	Sì	Chiamata API	PUT /tss/{uuid}
Inizializzare TSS	SIGN DE	Sì	Sequenza di chiamate API	Impostare PIN amministratore → Auth → Stato INITIALIZED
Creare client	SIGN DE	Sì	Chiamata API	PUT /tss/{id}/client/{uuid}
Creare transazione	SIGN DE	Sì	Chiamata API	PUT con ACTIVE poi FINISHED
Creare UNIT organizzazione	SIGN FR, SIGN IT	Sì	Chiamata API	POST /organizations
Creare chiave API soggetto	SIGN FR, SIGN IT	Sì	Chiamata API	POST /subjects
Inserire dati contribuente	SIGN FR, SIGN IT	Parziale	Necessita credenziali fiscali reali	L’essere umano fornisce il codice fiscale; l’agente effettua la chiamata API
Mettere in servizio risorse	SIGN FR, SIGN IT	Sì	Cambio di stato	PATCH con stato COMMISSIONED
Creare ubicazione	SIGN FR, SIGN IT	Sì	Chiamata API	POST /locations
Creare sistema	SIGN FR, SIGN IT	Sì	Chiamata API	POST /systems
Creare record	SIGN FR, SIGN IT	Sì	Chiamata API in due passaggi	Intenzione → Transazione
Passare da TEST a LIVE	Tutti	No	Richiede contratto	Contattare il reparto vendite o usare il go-live dell’HUB
Ottenere certificazione	Tutti	No	Processo normativo	Presentare domanda tramite l’autorità competente
Inserire informazioni di fatturazione	Tutti	No	Dati finanziari sensibili	L’utente inserisce nell’HUB/Dashboard
Gestire accesso utenti	Tutti	No	Sensibile per la sicurezza	L’amministratore gestisce tramite HUB/Dashboard
Registrazione ELSTER	SUBMIT DE	Parziale	Necessita dati reali del contribuente	L’essere umano fornisce il Steuernummer; l’agente chiama l’API

Suddivisione per categoria

Richiede intervento umano

Queste azioni riguardano la sicurezza dell’account, accordi legali, dati finanziari o processi normativi che non possono essere delegati all’automazione:

• Creazione account — verifica email e accettazione dei termini
• Creazione organizzazione — richiede sessione autenticata sulla dashboard
• Generazione chiave API — il segreto viene mostrato una volta, richiede la dashboard
• Passaggio da TEST a LIVE — richiede un contratto firmato con fiskaly
• Ottenere certificazione — processo normativo tramite l’autorità competente
• Inserire informazioni di fatturazione — dati finanziari sensibili, inseriti tramite dashboard
• Gestire accesso utenti — sensibile per la sicurezza, solo per amministratori tramite dashboard

Parzialmente automatizzabile

Queste azioni necessitano di dati forniti da esseri umani ma la chiamata API stessa può essere automatizzata:

• Inserire dati contribuente (SIGN FR, SIGN IT) — l’essere umano fornisce il codice fiscale, l’agente effettua la chiamata API
• Registrazione ELSTER (SUBMIT DE) — l’essere umano fornisce il Steuernummer, l’agente chiama l’API

Completamente automatizzabile

Tutte le operazioni API standard dopo la configurazione iniziale:

• Recupero del token di autenticazione
• Ciclo di vita del TSS (creazione, inizializzazione, client, transazione) per SIGN DE
• Unità organizzative, soggetti, ubicazioni, sistemi e record per SIGN FR / SIGN IT
• Messa in servizio delle risorse tramite cambi di stato

💡Tip

Per gli sviluppatori di agenti IA: Quando si creano integrazioni automatizzate, pianificare i passaggi di intervento umano all’inizio (configurazione account, chiavi API) e al go-live (contratto, fatturazione). Il flusso principale di integrazione tra questi passaggi è completamente automatizzabile tramite API. Progetta il tuo agente per mettere in pausa e richiedere all’utente questi passaggi specifici, poi riprendere l’automazione.

API leggibile da macchina

Questo registro è disponibile anche come endpoint JSON per accesso programmatico:

GET /human-interventions.json

La risposta JSON include la lista completa degli interventi con conteggi riassuntivi, adatta per agenti IA e strumenti di automazione da interrogare in fase di runtime.

📘Note

Per una guida completa alla creazione di integrazioni fiskaly potenziate dall’IA — incluso il server MCP, tutti gli endpoint leggibili da macchina e le best practice per gli agenti — consulta la sezione AI e Agenti.