Registre des interventions humaines
Ce registre documente chaque action d’intégration sur tous les produits fiskaly, en catégorisant chacune comme entièrement automatisable, partiellement automatisable ou nécessitant une intervention humaine. Utilisez-le pour planifier votre flux d’intégration et identifier les étapes nécessitant une intervention humaine.
12 actions peuvent être réalisées entièrement via des appels API sans aucune intervention humaine.
2 actions nécessitent des données fournies par des humains mais peuvent être exécutées par un agent.
8 actions doivent être effectuées par un humain via le tableau de bord ou des processus externes.
Registre complet
Section intitulée « Registre complet »| Action | Produit | Automatisable | Raison | Que faire |
|---|---|---|---|---|
| Créer un compte fiskaly | Tous | Non | Nécessite une vérification email et l’acceptation des conditions | L’utilisateur doit s’inscrire sur hub.fiskaly.com ou dashboard.fiskaly.com |
| Créer une organisation | Tous | Non | Nécessite une session authentifiée sur le tableau de bord | L’utilisateur crée via HUB ou Dashboard |
| Générer une clé API | Tous | Non | Nécessite une session tableau de bord ; le secret est affiché une seule fois | L’utilisateur génère dans HUB ou Dashboard |
| S’authentifier (obtenir un token) | Tous | Oui | Appel API standard | POST /auth avec api_key + api_secret |
| Créer un TSS | SIGN DE | Oui | Appel API | PUT /tss/{uuid} |
| Initialiser le TSS | SIGN DE | Oui | Séquence d’appels API | Définir le PIN administrateur → Auth → État INITIALIZED |
| Créer un client | SIGN DE | Oui | Appel API | PUT /tss/{id}/client/{uuid} |
| Créer une transaction | SIGN DE | Oui | Appel API | PUT avec ACTIVE puis FINISHED |
| Créer une UNIT d’organisation | SIGN FR, SIGN IT | Oui | Appel API | POST /organizations |
| Créer une clé API sujet | SIGN FR, SIGN IT | Oui | Appel API | POST /subjects |
| Saisir les données du contribuable | SIGN FR, SIGN IT | Partiel | Nécessite de vraies informations fiscales | L’humain fournit l’identifiant fiscal ; l’agent effectue l’appel API |
| Mettre en service les ressources | SIGN FR, SIGN IT | Oui | Changement d’état | PATCH avec état COMMISSIONED |
| Créer un emplacement | SIGN FR, SIGN IT | Oui | Appel API | POST /locations |
| Créer un système | SIGN FR, SIGN IT | Oui | Appel API | POST /systems |
| Créer un enregistrement | SIGN FR, SIGN IT | Oui | Appel API en deux étapes | Intention → Transaction |
| Passer de TEST à LIVE | Tous | Non | Nécessite un contrat | Contacter les ventes ou utiliser le go-live HUB |
| Obtenir la certification | Tous | Non | Processus réglementaire | Faire une demande auprès de l’autorité compétente |
| Saisir les informations de facturation | Tous | Non | Données financières sensibles | L’utilisateur saisit dans HUB/Dashboard |
| Gérer les accès utilisateurs | Tous | Non | Sensible en matière de sécurité | L’administrateur gère via HUB/Dashboard |
| Enregistrement ELSTER | SUBMIT DE | Partiel | Nécessite de vraies données du contribuable | L’humain fournit le Steuernummer ; l’agent appelle l’API |
Répartition par catégorie
Section intitulée « Répartition par catégorie »Nécessite une intervention humaine
Section intitulée « Nécessite une intervention humaine »Ces actions impliquent la sécurité des comptes, des accords légaux, des données financières ou des processus réglementaires qui ne peuvent pas être délégués à l’automatisation :
- Création de compte — vérification email et acceptation des conditions
- Création d’organisation — nécessite une session authentifiée sur le tableau de bord
- Génération de clé API — le secret est affiché une fois, nécessite le tableau de bord
- Passage de TEST à LIVE — nécessite un contrat signé avec fiskaly
- Obtenir la certification — processus réglementaire via l’autorité compétente
- Saisir les informations de facturation — données financières sensibles, saisies via le tableau de bord
- Gérer les accès utilisateurs — sensible en matière de sécurité, réservé aux administrateurs via le tableau de bord
Partiellement automatisable
Section intitulée « Partiellement automatisable »Ces actions nécessitent des données fournies par des humains mais l’appel API lui-même peut être automatisé :
- Saisir les données du contribuable (SIGN FR, SIGN IT) — l’humain fournit l’identifiant fiscal, l’agent effectue l’appel API
- Enregistrement ELSTER (SUBMIT DE) — l’humain fournit le Steuernummer, l’agent appelle l’API
Entièrement automatisable
Section intitulée « Entièrement automatisable »Toutes les opérations API standard après la configuration initiale :
- Récupération du token d’authentification
- Cycle de vie du TSS (création, initialisation, client, transaction) pour SIGN DE
- Unités d’organisation, sujets, emplacements, systèmes et enregistrements pour SIGN FR / SIGN IT
- Mise en service des ressources via des changements d’état
Pour les développeurs d’agents IA : Lors de la création d’intégrations automatisées, prévoyez des étapes d’intervention humaine au début (configuration du compte, clés API) et au moment du go-live (contrat, facturation). Le flux principal d’intégration entre ces étapes est entièrement automatisable via API. Concevez votre agent pour qu’il marque une pause et sollicite l’utilisateur pour ces étapes spécifiques, puis reprenne l’automatisation.
API lisible par machine
Section intitulée « API lisible par machine »Ce registre est également disponible sous forme d’endpoint JSON pour un accès programmatique :
GET /human-interventions.jsonLa réponse JSON inclut la liste complète des interventions avec les comptes résumés, adaptée aux agents IA et aux outils d’automatisation pour être interrogée à l’exécution.
Pour un guide complet sur la création d’intégrations fiskaly propulsées par l’IA — incluant le serveur MCP, tous les endpoints lisibles par machine et les meilleures pratiques pour les agents — consultez la section IA et Agents.
Was this page helpful?