Glossaire

⚠️ Vous consultez la documentation pour la version API 2026-02-03. La dernière version est 2026-05-04. La nouvelle version de l’API n’apporte aucun changement à l’intégration italienne. Elle ajoute cependant le support SIGN PT, permettant aux équipes qui prévoient de s’étendre au Portugal de réutiliser la même intégration déjà en place pour l’Italie.

Voici ce que vous allez configurer :

🏢

Organisation

---

• AccountGénéré par HUB

  Entité de niveau supérieur dans fiskaly HUB. Ne peut pas être imbriquée dans un autre Account.

• GroupGénéré par HUB

  Couche intermédiaire organisant les Units en clusters logiques (par ex. un par pays).

• UnitGénéré par API

  Commerçant / contribuable opérant sous le Group.

🔑

Clé et secret API

---

• Niveau GroupGénéré par HUB

  Généré dans HUB pour l’Organization GROUP. Utilisé pour s’authentifier dans l’API SIGN IT afin de créer des Organization Units et leurs API Keys.

• Niveau UnitGénéré par API

  Généré via l’API (endpoint createSubject) pour l’Organization UNIT. Utilisé pour s’authentifier pour tous les appels opérationnels au niveau unit.

🧾

Contribuable

---

Informations sur l’entité enregistrée auprès de l’Agence des impôts italienne (AdE) et soumise aux réglementations fiscales en Italie.

• COMPANY

  Personne morale (“Società”)

• INDIVIDUAL

  Personne physique (“Persona fisica”)

📍

Emplacement

---

• HEAD_OFFICE

  Créé automatiquement lors de la création du Contribuable, partage le même UUID. Correspond à l’adresse légale.

• BRANCH

  Chaque boutique, magasin ou autre emplacement commercial opérationnel où des opérations fiscales ont lieu.

💻

Système

---

• FISCAL_DEVICE

  Abstraction d’une caisse enregistreuse utilisée pour enregistrer les données de transactions conformément aux réglementations fiscales italiennes.

📄

Enregistrement

---

Chaque opération commerciale effectuée dans le Système. Nécessite deux appels successifs :

• INTENTION

  Identifie l’intention d’enregistrer une transaction dans le Système.

• TRANSACTION

  Identifie un reçu fiscal émis par le Système.

Glossaire

Nom	Description
Document commercial	Reçu fiscal italien. Depuis 2020, utilisé pour certifier les transactions B2C, remplaçant le reçu fiscal traditionnel. Les données de transactions peuvent être transmises électroniquement à l’AdE via : Un registre télématique (dispositif RT) La procédure web “Documento Commerciale Online” sur le portail “Fatture e Corrispettivi” de l’Agence des impôts SIGN IT lite Des solutions logicielles approuvées conformes aux spécifications techniques du 7 mars 2025 SIGN IT
Code loterie	Code alphanumérique de 8 caractères, lié de manière unique au code fiscal de l’acheteur, requis pour participer à la loterie des reçus (“Lotteria degli Scontrini”). Généré sur le portail officiel et présenté au commerçant au moment du paiement électronique pour lier l’achat à la loterie.
AdE	Agenzia delle Entrate — Agence des impôts italienne.
Numéro progressif	Numéro unique attribué par l’AdE à chaque enregistrement TRANSACTION transmis avec succès. Inclus dans le champ compliance.data retourné dans la réponse.