Ir al contenido principal

v3 - Integración con la fiscalidad italiana (impresora fiscal y FatturaPA)

Guía completa de la fiscalidad italiana en Golfmanager: impresora fiscal (scontrino, informe Z) y FatturaPA (XML para el SDI). Configuración paso a paso, detalle de cada campo, uso diario, transacciones y preguntas frecuentes.

Índice

Para quién es este artículo: aplica a los clubes que operan en Italia y deben cumplir su normativa fiscal.

¿Qué es esta integración?

La integración con la fiscalidad italiana cubre las dos obligaciones fiscales de Italia desde Golfmanager:

  • Impresora fiscal (scontrino): envía los tickets de venta del TPV a la impresora fiscal italiana, que imprime el scontrino fiscale y gestiona el cierre diario (informe Z).

  • FatturaPA: genera la factura electrónica italiana en formato FatturaPA (XML) para enviarla al SDI (Sistema di Interscambio).

El scontrino es el ticket fiscal que imprime la impresora fiscal (registratore telematico). La FatturaPA es el fichero de factura electrónica que en Italia se remite a la Agenzia delle Entrate a través del SDI. Golfmanager genera el fichero XML; el envío al SDI lo haces tú o tu gestoría.

¿Qué problema resuelve?

  • Cumplir la normativa fiscal italiana del TPV y de la facturación, sin pasos manuales.

  • Imprime el scontrino automáticamente al cobrar y gestiona el cierre diario (Z).

  • Genera la FatturaPA lista para enviar al SDI.

  • Valida los datos fiscales (IVA, exenciones, departamentos) para evitar errores.

¿Qué sistemas conecta y en qué dirección viajan los datos?

  • Impresora fiscal: el TPV envía el ticket a la impresora fiscal por la red local (a su dirección IP), y recibe el número de scontrino y el resultado.

  • FatturaPA: Golfmanager genera el fichero XML de la factura, que después se envía al SDI (a través de tu canal o tu gestoría).

La impresora trabaja en la red local del club; la FatturaPA es un fichero que descargas y entregas al SDI. No hay envío automático al SDI desde Golfmanager.

¿Qué genera la integración?

Elemento

Qué es

Scontrino fiscal

El ticket fiscal del TPV, impreso por la impresora fiscal

Ticket de devolución

Al cancelar una venta con scontrino, referencia el ticket original

Informe Z

El cierre diario que imprime la impresora y pone a cero los contadores

FatturaPA (XML)

La factura electrónica para el SDI (factura TD01 o nota de crédito TD04)

Requisitos previos (antes de activar la integración)

  1. Operar en Italia y estar sujeto a su normativa fiscal.

  2. Tener una impresora fiscal compatible (Epson/compatible) conectada a la red del TPV.

  3. Tener el módulo instalado, junto con los módulos de facturación y TPV.

  4. Tener los datos fiscales de la empresa (Partita IVA, codice fiscale, régimen fiscal, provincia, dirección).

  5. Permisos de gestión de facturación para configurar.

Cómo se configura (paso a paso)

Paso 1 — Instalar el módulo

  1. Instala el módulo de fiscalidad italiana (Italy Fiscal Printer). Después aparece el menú Italy Fiscal Printer con la configuración, las transacciones y los tickets.

Paso 2 — Datos fiscales de la empresa

  1. En la ficha de la empresa, sección Datos fiscales italianos, rellena el Régimen fiscal (RF01–RF19), el Codice fiscale y la Provincia.

  2. Comprueba que están la Partita IVA y la dirección completas.

  3. Guarda los cambios.

Paso 3 — Impresora fiscal en el TPV

  1. En cada TPV, sección Impresora fiscal italiana, introduce la IP de la impresora fiscal y su número de serie (este último se usa en las devoluciones).

  2. Asegúrate de que el TPV está en la misma red que la impresora.

  3. Guarda los cambios.

Paso 4 — Departamentos fiscales por familia

  1. En cada familia de productos, rellena el ID de departamento fiscal, que indica a la impresora qué tipo de IVA aplicar.

  2. Guarda.

Paso 5 — Productos exentos (motivo de exención)

  1. En cada producto exento (IVA 0%), indica el motivo de exención (Natura IVA, N1–N7).

  2. Guarda. El sistema lo exige al guardar un producto al 0% sin motivo.

Paso 6 — Formas de pago (modalidad FatturaPA)

  1. En cada forma de pago, asigna la modalidad de pago FatturaPA: MP01 efectivo, MP02 cheque, MP05 transferencia, MP08 tarjeta o MP09 domiciliación.

  2. Guarda.

Paso 7 — Datos fiscales de los clientes

  1. En la ficha de cada cliente que reciba factura electrónica, rellena, según corresponda, el codice fiscale/Partita IVA, el código SDI y el código destinatario (7 caracteres).

  2. Guarda.

⚠️ Si falta algún dato obligatorio (IP de la impresora, departamento fiscal de una familia, motivo de exención de un producto al 0%, o el régimen fiscal de la empresa para la FatturaPA), la operación correspondiente dará error. Conviene configurarlo todo antes de empezar.

Detalle de cada campo de configuración

A continuación se explica cada campo: qué es, cómo afecta al sistema, cómo se comporta y un ejemplo de uso. Se agrupan por pantalla.

Ajustes generales (Configuración > Italy Fiscal Printer)

IP de la impresora (por defecto)

  • Nombre del campo: IP de la impresora (Printer IP address).

  • Descripción: una IP de impresora de reserva, que se usa si un TPV no tiene IP propia.

  • Impacto en el sistema: permite que un TPV sin IP propia use esta.

  • Comportamiento del sistema: tiene prioridad la IP configurada en el TPV; esta es solo el respaldo.

  • Ejemplo de uso / qué ocurre: la usas si todos los TPV comparten la misma impresora.

Número de serie fiscal (por defecto)

  • Nombre del campo: Número de serie fiscal (Fiscal Serial Number).

  • Descripción: el número de serie de la impresora, de reserva, si el TPV no lo tiene.

  • Impacto en el sistema: se usa en la referencia de las devoluciones cuando el TPV no tiene número propio.

  • Comportamiento del sistema: tiene prioridad el del TPV; este es el respaldo.

  • Ejemplo de uso / qué ocurre: lo dejas relleno como valor común si compartís impresora.

Datos de la empresa

Régimen fiscal

  • Nombre del campo: Régimen fiscal (Fiscal Regime).

  • Descripción: el régimen fiscal del club (RF01 ordinario, RF02 mínimos, etc.).

  • Impacto en el sistema: es obligatorio para generar la FatturaPA; figura en el XML.

  • Comportamiento del sistema: si falta, al descargar la FatturaPA el sistema avisa de que "configura el régimen fiscal de la empresa".

  • Ejemplo de uso / qué ocurre: seleccionas RF01 (ordinario) si es tu caso.

Codice fiscale

  • Nombre del campo: Codice fiscale (Fiscal Code) de la empresa.

  • Descripción: el identificador fiscal de la empresa.

  • Impacto en el sistema: se incluye en la FatturaPA como dato del emisor.

  • Comportamiento del sistema: es necesario para la factura electrónica.

  • Ejemplo de uso / qué ocurre: lo rellenas con el codice fiscale del club.

Provincia

  • Nombre del campo: Provincia (Province).

  • Descripción: la sigla de la provincia (por ejemplo, RM para Roma, MI para Milán).

  • Impacto en el sistema: forma parte de la dirección fiscal en la FatturaPA.

  • Comportamiento del sistema: se incluye en los datos del emisor.

  • Ejemplo de uso / qué ocurre: pones la sigla de la provincia del club.

Partita IVA

  • Nombre del campo: Partita IVA (NIF/IVA de la empresa).

  • Descripción: el número de IVA del club.

  • Impacto en el sistema: identifica al emisor en la FatturaPA y da nombre al fichero XML.

  • Comportamiento del sistema: es un dato fiscal clave del emisor.

  • Ejemplo de uso / qué ocurre: lo rellenas con la Partita IVA del club.

TPV (impresora fiscal)

IP de la impresora fiscal

  • Nombre del campo: IP de la impresora fiscal (Fiscal Printer IP).

  • Descripción: la dirección de la impresora fiscal de ese TPV en la red local.

  • Impacto en el sistema: es por donde el TPV envía los tickets a imprimir.

  • Comportamiento del sistema: sin ella (ni la de reserva), no se puede imprimir; el sistema avisa de que "la IP de la impresora fiscal debe estar configurada en el TPV o en los ajustes".

  • Ejemplo de uso / qué ocurre: pones la IP de la impresora conectada a ese mostrador.

Número de serie fiscal (del TPV)

  • Nombre del campo: Número de serie fiscal (Fiscal Serial Number), en el TPV.

  • Descripción: el número de serie de la impresora de ese TPV.

  • Impacto en el sistema: se usa en la referencia de las devoluciones (junto al nº de scontrino y el informe Z).

  • Comportamiento del sistema: recomendable para que las devoluciones queden bien identificadas.

  • Ejemplo de uso / qué ocurre: lo rellenas con el número de serie de la impresora.

Familias, productos, formas de pago y clientes

ID de departamento fiscal (familia)

  • Nombre del campo: ID de departamento fiscal (Fiscal Department ID), en cada familia.

  • Descripción: el número de departamento de la impresora que define el IVA de esa familia.

  • Impacto en el sistema: es lo que indica a la impresora qué IVA aplicar a esos productos.

  • Comportamiento del sistema: si una familia no lo tiene, el IVA puede salir mal en el ticket.

  • Ejemplo de uso / qué ocurre: asignas a cada familia el departamento que tenga configurado su tipo de IVA en la impresora.

Motivo de exención (producto)

  • Nombre del campo: Motivo de exención (Tax exemption reason), en cada producto exento.

  • Descripción: el código de naturaleza del IVA (N1–N7) para productos al 0%.

  • Impacto en el sistema: es obligatorio si el producto está al 0%; aparece en la FatturaPA.

  • Comportamiento del sistema: al guardar un producto al 0% sin motivo, el sistema avisa de que "el motivo de exención es obligatorio para productos con 0% de IVA".

  • Ejemplo de uso / qué ocurre: a un producto exento le pones su código N correspondiente.

Modalidad de pago FatturaPA (forma de pago)

  • Nombre del campo: Modalidad de pago FatturaPA (FatturaPA Payment Mode), en cada forma de pago.

  • Descripción: el código de pago de la FatturaPA (MP01 efectivo, MP02 cheque, MP05 transferencia, MP08 tarjeta, MP09 domiciliación).

  • Impacto en el sistema: se incluye en el XML de la factura electrónica (es independiente del tipo de pago del scontrino).

  • Comportamiento del sistema: clasifica el medio de pago en la FatturaPA.

  • Ejemplo de uso / qué ocurre: a "Tarjeta" le pones MP08.

Datos fiscales del cliente

  • Nombre del campo: Codice fiscale/Partita IVA, Código SDI y Código destinatario (en la ficha del cliente).

  • Descripción: los datos del destinatario para la factura electrónica.

  • Impacto en el sistema: identifican al cliente en la FatturaPA. El código destinatario tiene 7 caracteres.

  • Comportamiento del sistema: si no hay código destinatario, se usa por defecto 0000000 (clientes italianos) o XXXXXXX (extranjeros).

  • Ejemplo de uso / qué ocurre: a una empresa cliente le pones su Partita IVA y su código destinatario o código SDI.

Cómo se usa en el día a día

En el TPV (scontrino)

  • Al cobrar una venta, el ticket se envía automáticamente a la impresora fiscal, que imprime el scontrino.

  • Devoluciones: al cancelar una venta con scontrino, se imprime un ticket de devolución que referencia el original. No se permiten cancelaciones parciales: hay que cancelar la venta completa.

  • Reimpresión: si un ticket ya se imprimió, se genera una reimpresión en lugar de un nuevo scontrino.

  • Cierre diario: pulsa el botón "Informe Z" en el TPV para el cierre del día. Verás "Informe Z enviado correctamente".

FatturaPA (facturas)

  • Una factura: en el detalle de la factura, usa la acción "FatturaPA" para descargar su XML (con nombre tipo IT[PartitaIVA]_[nº].xml).

  • Varias facturas: en el listado de facturas, usa la acción "FatturaPA", elige el periodo (y la empresa) y descarga un ZIP con todos los XML.

  • Después, envías esos ficheros al SDI por tu canal o gestoría. Golfmanager genera el fichero, pero no lo envía al SDI.

ℹ️ No se envían a la impresora fiscal las ventas que ya tienen factura, las pagadas solo con bono, ni los cargos a habitación de Opera (si el módulo de Opera está instalado).

Consultar transacciones y tickets fiscales

El menú Italy Fiscal Printer incluye:

  • Transacciones fiscales: cada comunicación con la impresora (lo enviado y la respuesta, correcto o fallido), con el TPV y la venta.

  • Tickets fiscales: los scontrini emitidos, con su número, importe, fecha, hora e informe Z asociado.

Es la primera información a revisar cuando un ticket no se ha emitido correctamente.

Limitaciones a tener en cuenta

  • La impresora fiscal debe estar en la red local y accesible desde el TPV.

  • No se permiten cancelaciones parciales: hay que cancelar la venta completa.

  • No pasan por la impresora las ventas ya facturadas, las pagadas solo con bono ni los cargos a habitación de Opera.

  • Los productos exentos necesitan su motivo de exención; las familias, su departamento fiscal.

  • La FatturaPA se descarga y se envía al SDI por tu canal o gestoría; el módulo genera el fichero pero no lo transmite.

  • Solo se exportan a FatturaPA las facturas confirmadas y con cliente.

  • Es específica de Italia.

Preguntas frecuentes

¿Qué dos cosas hace esta integración?

Dos: (1) envía los tickets del TPV a la impresora fiscal para imprimir el scontrino y hacer el cierre diario (informe Z), y (2) genera la FatturaPA (factura electrónica XML) para enviarla al SDI.

¿Golfmanager envía la FatturaPA al SDI automáticamente?

No. Golfmanager genera el fichero XML; tú lo descargas y lo envías al SDI por tu canal o tu gestoría. No hay transmisión automática.

No se imprime el scontrino. ¿Qué reviso?

Casi siempre es la red o la IP: que la IP de la impresora esté configurada en el TPV (o en los ajustes), que la impresora esté encendida y accesible. Si falta la IP, el sistema avisa de que "la IP de la impresora fiscal debe estar configurada en el TPV o en los ajustes".

Sale "Error al comunicar con la impresora fiscal". ¿Qué hago?

El TPV no ha podido contactar con la impresora. Comprueba que está encendida y en la misma red, y que la IP es correcta; después reintenta.

Sale "Error de impresión: …" con un código. ¿Qué significa?

La impresora ha devuelto un error al procesar el ticket (por ejemplo, falta papel o un dato del documento). Revisa el detalle en Transacciones fiscales y, si no se resuelve, contacta con el soporte de la impresora.

No me deja guardar un producto sin IVA. ¿Por qué?

A los productos exentos (0%) les falta el motivo de exención (N1–N7). Asígnalo en el producto; el sistema avisa de que "el motivo de exención es obligatorio para productos con 0% de IVA".

El IVA sale mal en el ticket. ¿Qué reviso?

La familia del producto no tiene su ID de departamento fiscal, o está mal. Revísalo en la familia: ese departamento es el que define el IVA en la impresora.

¿Cómo hago una devolución en el TPV?

Cancela la venta: se imprime un ticket de devolución que referencia el scontrino original (con su número, fecha, informe Z y número de serie). No se puede devolver una parte: hay que cancelar la venta completa.

No me deja cancelar solo una parte de la venta. ¿Es normal?

Sí. Las cancelaciones parciales no están permitidas: el sistema avisa de que "no se permite la cancelación parcial del ticket; hay que cancelar el ticket completo". Cancela la venta entera.

Reimprimí un ticket y no salió un scontrino nuevo. ¿Por qué?

Es lo correcto: si el ticket ya se había impreso, se genera una reimpresión, no un scontrino fiscal nuevo (que duplicaría el documento).

¿Cómo hago el cierre diario?

Pulsa el botón "Informe Z" en el TPV. La impresora imprime el cierre del día y pone a cero los contadores. Verás "Informe Z enviado correctamente".

¿Qué ventas no se envían a la impresora fiscal?

Las que ya tienen factura, las pagadas solo con bono y los cargos a habitación de Opera (si el módulo de Opera está instalado). El resto sí pasa por la impresora.

¿Cómo descargo la FatturaPA de una factura?

En el detalle de la factura, usa la acción "FatturaPA" y se descarga el XML. Para varias, usa la acción "FatturaPA" del listado, elige el periodo y descarga un ZIP.

Sale "Se necesita un cliente para generar la FatturaPA". ¿Qué hago?

La factura no tiene cliente. La FatturaPA necesita un destinatario; asígnale el cliente y vuelve a descargar.

Sale "Configura el régimen fiscal de la empresa". ¿Qué reviso?

Falta el régimen fiscal (RF01–RF19) de la empresa. Rellénalo en la ficha de la empresa, junto con el codice fiscale y la Partita IVA.

¿Qué es el "código destinatario" y qué pongo si no lo tengo?

Es un código de 7 caracteres del destinatario para la factura electrónica. Si no consta, se usa por defecto 0000000 (clientes italianos) o XXXXXXX (extranjeros). Si el cliente tiene código SDI o destinatario, ponlo en su ficha.

¿Qué diferencia hay entre TD01 y TD04?

En la FatturaPA, TD01 es una factura y TD04 una nota de crédito. Golfmanager lo asigna automáticamente según el documento.

¿La modalidad de pago FatturaPA es lo mismo que el pago del scontrino?

No. La modalidad de pago FatturaPA (MP01–MP09) es solo para el XML de la factura electrónica; el tipo de pago del scontrino lo gestiona la impresora aparte.

¿Hay algún proceso automático en segundo plano (cron)?

No. Todo ocurre en el momento: el scontrino al cobrar, la devolución al cancelar, el informe Z al pulsarlo y la FatturaPA al descargarla. No hay envíos programados.

¿Qué permisos necesito para configurar la integración?

Permisos de gestión de facturación, que dan acceso a la configuración, las transacciones y los tickets fiscales.

¿Qué hago al implantarlo para asegurarme de que funciona?

Configura todos los datos fiscales (empresa, departamentos por familia, exenciones, formas de pago, clientes), haz un ticket de prueba y un informe Z, y valida una FatturaPA de prueba con tu gestoría antes de operar.

Buenas prácticas recomendadas

  • Configura todos los datos fiscales (empresa, departamentos por familia, exenciones, formas de pago, clientes) antes de operar.

  • Comprueba la impresora con un ticket de prueba y un informe Z.

  • Mantén estable la red local entre el TPV y la impresora fiscal.

  • Valida una FatturaPA de prueba con tu gestoría antes de empezar a enviarlas al SDI.

  • Ante un fallo, revisa primero Transacciones fiscales: ahí está lo enviado y la respuesta de la impresora.

¿Ha quedado contestada tu pregunta?