Glosario

⚠️ Está viendo la documentación de la versión de API 2026-02-03. La versión más reciente es 2026-05-04. La nueva versión de la API no trae cambios en la integración italiana. Sin embargo, añade soporte para SIGN PT, lo que permite a los equipos que planean expandirse a Portugal reutilizar la misma integración ya existente para Italia.

Esto es lo que configurará:

🏢

Organización

---

• AccountGenerado por HUB

  Entidad de nivel superior en fiskaly HUB. No puede anidarse dentro de otra Cuenta.

• GroupGenerado por HUB

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

• UnitGenerado por API

  Comerciante / contribuyente que opera bajo el Group.

🔑

Clave API y Secret

---

• Nivel de GroupGenerado por HUB

  Generado en HUB para la Organización GROUP. Se utiliza para autenticarte en la API SIGN IT y crear Units de Organización y tus API Keys.

• Nivel de UnitGenerado por API

  Generado mediante API (endpoint createSubject) para la UNIT de Organización. Se utiliza para autenticarte en todas las llamadas operativas a nivel de unit.

🧾

Contribuyente

---

Información de la entidad registrada en la Agencia Tributaria italiana (AdE) y sujeta a la normativa fiscal en Italia.

• COMPANY

  Persona jurídica (“Società”)

• INDIVIDUAL

  Persona física (“Persona fisica”)

📍

Ubicación

---

• HEAD_OFFICE

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

• BRANCH

  Cada tienda, establecimiento u otra ubicación comercial operativa donde se realizan operaciones fiscales.

💻

Sistema

---

• FISCAL_DEVICE

  Abstracción de una caja registradora utilizada para registrar datos de transacciones de conformidad con la normativa fiscal italiana.

📄

Registro

---

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

• INTENTION

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

• TRANSACTION

  Identifica un recibo fiscal emitido por el Sistema.

Glosario

Nombre	Descripción
Documento comercial	Recibo fiscal italiano. Desde 2020 se utiliza para certificar transacciones B2C, sustituyendo al recibo fiscal tradicional. Los datos de las transacciones pueden transmitirse 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, necesario para participar en la lotería del recibo (“Lotteria degli Scontrini”). Se genera en el portal oficial y se presenta 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 registro de tipo TRANSACTION transmitido correctamente. Incluido en el campo compliance.data devuelto en la respuesta.