Glosario

⚠️Warning

Está viendo la documentación de la versión de API 2026-05-04. La versión más reciente es 2026-06-01.

Esto es lo que va a configurar:

🏢

Organization

---

• AccountHUB-generated

  Entidad de nivel superior en fiskaly HUB. No puede anidarse dentro de otro Account.

• GroupHUB-generated

  Capa intermedia que organiza las Units en clústeres lógicos (p. ej., uno por país).

• UnitAPI-generated

  Comerciante / contribuyente que opera bajo el Group.

🔑

API key & secret

---

• Group levelHUB-generated

  Generado en HUB para la Organization GROUP. Utilizado para autenticarse en la API SIGN IT y crear Organization Units y sus claves API.

• Unit levelAPI-generated

  Generado a través de la API (endpoint createSubject) para la Organization UNIT. Utilizado para autenticarse en todas las llamadas operativas a nivel de Unit.

🧾

Taxpayer

---

Información de la entidad registrada ante la Agencia Tributaria italiana (AdE) y sujeta a las normativas fiscales en Italia.

• COMPANY

  Persona jurídica (“Società”)

• INDIVIDUAL

  Persona física (“Persona fisica”)

📍

Location

---

• HEAD_OFFICE

  Se crea automáticamente al crear el Taxpayer y comparte el mismo UUID. Coincide con la dirección legal.

• BRANCH

  Cada tienda, local u otra ubicación operativa donde tienen lugar las operaciones fiscales.

💻

System

---

• FISCAL_DEVICE

  Abstracción de una caja registradora utilizada para registrar datos de transacciones en conformidad con las normativas fiscales italianas.

📄

Record

---

Cada operación comercial realizada en el System. Requiere dos llamadas sucesivas:

• INTENTION

  Identifica la intención de registrar una transacción en el System.

• TRANSACTION

  Identifica un recibo fiscal emitido por el System.

Glosario

Nombre	Descripción
Documento comercial	Recibo fiscal italiano. Desde 2020, se utiliza para certificar las transacciones B2C, sustituyendo al recibo fiscal tradicional. Los datos de la transacción se pueden transmitir electrónicamente a la AdE a través de: Una caja registradora telemática (dispositivo RT) El procedimiento web «Documento Commerciale Online» en el portal «Fatture e Corrispettivi» de la Agencia Tributaria SIGN IT lite Soluciones de software aprobadas conformes con las especificaciones técnicas del 7 de marzo de 2025 SIGN IT
Código de lotería	Código alfanumérico de 8 caracteres, vinculado de forma única al código fiscal del comprador, requerido para participar en la lotería de recibos («Lotteria degli Scontrini»). Generado en el portal oficial y presentado al comerciante en el momento del pago electrónico para vincular la compra a la lotería.
AdE	Agenzia delle Entrate — Agencia Tributaria italiana.
Número progresivo	Número único asignado por la AdE a cada Record TRANSACTION transmitido con éxito. Incluido en los compliance.data devueltos en la respuesta.