Glossaire

Voici ce que vous allez configurer :

🏢

Organization

---

• AccountHUB-generated

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

• GroupHUB-generated

  Couche intermédiaire organisant les Units en clusters logiques (par exemple, une par pays).

• UnitAPI-generated

  Marchand / contribuable opérant sous le Group.

🔑

API key & secret

---

• Group levelHUB-generated

  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 clés API.

• Unit levelAPI-generated

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

🧾

Taxpayer

---

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

• COMPANY

  Personne morale (“Società”)

• INDIVIDUAL

  Personne physique (“Persona fisica”)

📍

Location

---

• HEAD_OFFICE

  Créé automatiquement lors de la création du Taxpayer, partage le même UUID. Coïncide avec l’adresse légale.

• BRANCH

  Chaque magasin, boutique ou autre lieu d’affaires opérationnel où des opérations fiscales ont lieu.

💻

System

---

• FISCAL_DEVICE

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

• E_INVOICE_SERVICE

  Abstraction d’un service utilisé pour émettre des factures électroniques B2B via le SDI. Utilisé uniquement avec E-INVOICE IT.

📄

Record

---

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

• INTENTION

  Identifie l’intention d’enregistrer une transaction dans le System.

• TRANSACTION

  Identifie un reçu fiscal émis par le System.

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 transaction peuvent être transmises électroniquement à l’AdE via : Une caisse enregistreuse télématique (appareil RT) La procédure web « Documento Commerciale Online » sur le portail « Fatture e Corrispettivi » de l’Agence fiscale SIGN IT lite Des solutions logicielles agréées conformes aux spécifications techniques du 7 mars 2025 SIGN IT
Code de loterie	Code alphanumérique à 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 marchand au moment du paiement électronique pour associer l’achat à la loterie.
AdE	Agenzia delle Entrate — Agence fiscale italienne.
Numéro progressif	Numéro unique attribué par l’AdE à chaque Record TRANSACTION transmis avec succès. Inclus dans les compliance.data retournés dans la réponse.