Aller au contenu

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.

📄

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.

NomDescription
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 loterieCode 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.
AdEAgenzia delle Entrate — Agence fiscale italienne.
Numéro progressifNuméro unique attribué par l’AdE à chaque Record TRANSACTION transmis avec succès. Inclus dans les compliance.data retournés dans la réponse.

Was this page helpful?