Índice
Para quién es este artículo: aplica a los clubes que operan en Portugal y deben cumplir la normativa de facturación de la AT (Autoridade Tributária).
¿Qué es esta integración?
Es el módulo de facturación certificada de Portugal (originalmente "Eticadata"). Hace que sea Golfmanager el que actúa como programa certificado y emite facturas que cumplen la normativa fiscal portuguesa: cada documento se encadena con el anterior mediante una firma (hash), lleva su código ATCUD y un código QR, e indica que ha sido procesado por programa certificado.
Además, genera el fichero oficial SAF-T (PT), el archivo que se entrega a la Autoridade Tributária con todos los documentos de un periodo.
SAF-T es el fichero estándar que la AT portuguesa exige para auditar la facturación. El ATCUD y el QR son códigos obligatorios que deben figurar en cada factura. El hash encadena los documentos para garantizar que no se altera ninguno. No es una conexión con un ERP externo: Golfmanager genera todo esto por sí mismo, sin enviar datos a otro sistema.
¿Qué problema resuelve?
Cumplir la normativa portuguesa de facturación con software certificado, sin programas externos.
Genera automáticamente el hash, el ATCUD y el QR de cada factura.
Produce el fichero SAF-T para entregarlo a la AT.
Garantiza la integridad de la facturación: los documentos no se pueden borrar ni alterar.
¿Qué sistemas conecta y en qué dirección viajan los datos?
A diferencia de otras integraciones, esta funciona dentro de Golfmanager: no hay conexión con ningún servicio externo. Golfmanager actúa como programa certificado y produce los documentos y ficheros que exige la AT.
Al emitir una factura, Golfmanager le añade el hash, el ATCUD y el QR.
Cuando lo necesites, exportas el fichero SAF-T y lo entregas a la Autoridade Tributária (o a tu contabilidad).
¿Qué se genera en cada factura?
Elemento | Qué es |
Hash (firma encadenada) | Enlaza cada factura con la anterior de la serie |
ATCUD | Código único de la serie + número del documento |
Código QR | Resumen fiscal de la factura, obligatorio en el documento |
"Processado por programa certificado" | Texto con el número de certificado del software |
Fichero SAF-T (PT) | Archivo con todos los documentos de un periodo para la AT |
Requisitos previos (antes de activar la integración)
Operar en Portugal y estar sujeto a la normativa de la AT.
Tener el módulo de facturación certificada de Portugal instalado.
Tener los datos fiscales de la empresa correctos (NIF, matrícula, dirección, código postal, país).
Tener configuradas las series con su ATCUD (proporcionado por la AT) antes de empezar a facturar.
Tener mapeados los tipos de documento, los códigos SAF-T de las formas de pago, los impuestos y los motivos de exención.
Permisos de administrador de sistema para la configuración fiscal.
Cómo se configura (paso a paso)
Paso 1 — Instalar el módulo
Pide a tu consultor de Golfmanager que instale el módulo de facturación certificada de Portugal.
Paso 2 — Ajustes SAF-T
Ve a Configuración > Ajustes SAF-T.
Revisa los datos del software certificado (versión de SAF-T, identificador y versión del producto, número de certificado, NIF de la empresa del producto, base contable, moneda, identificador de consumidor final). Normalmente vienen preconfigurados.
Activa Usar series manuales solo si vas a emitir facturas manuales o de recuperación.
Guarda los cambios.
Paso 3 — Datos fiscales de la empresa
En la ficha de la empresa, rellena el NIF, la matrícula (Registration nº) y, si procede, CAE, CRC, capital social y RNAAT.
Comprueba la dirección y el código postal (formato portugués
0000-000).Guarda los cambios.
⚠️ Importante: una vez emitida la primera factura, los datos fiscales de la empresa quedan bloqueados y no se pueden cambiar. Revísalos bien antes de empezar.
Paso 4 — Series con ATCUD
En cada serie de facturación, introduce su ATCUD (código de 8 caracteres que asigna la AT), márcala como activa, elige el tipo de serie y el número de copias a imprimir (Original / Duplicado / Triplicado), y las fechas de inicio y fin.
Guarda los cambios.
Paso 5 — Tipos de documento
En cada tipo de factura, indica el tipo de documento portugués: Fatura (FT), Fatura Recibo (FR) o Nota de crédito (NC).
Marca, si procede, si es factura manual o de recuperación.
Guarda los cambios.
Paso 6 — Impuestos y motivos de exención
En cada impuesto, indica su descripción (exento, reducido, intermedio o normal); el código SAF-T (ISE/RED/INT/NOR) se asigna solo.
En cada producto exento (IVA 0%), indica el motivo de exención (M01–M99) y su descripción.
Guarda los cambios.
Paso 7 — Formas de pago y productos
En cada forma de pago, asigna su código SAF-T (Numerário/efectivo, Tarjeta, Transferencia bancaria…).
En cada producto, indica su categoría (producto o servicio).
Guarda los cambios.
⚠️ Importante: la normativa portuguesa es estricta. Si falta el ATCUD de una serie, el código SAF-T de una forma de pago o el motivo de exención de un producto sin IVA, el sistema impedirá facturar hasta que lo completes.
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 SAF-T (Configuración > Ajustes SAF-T)
Estos valores describen el software certificado y, normalmente, ya vienen preconfigurados. No los cambies sin indicación de soporte.
Versión de SAF-T
Nombre del campo: Versión de SAF-T.
Descripción: la versión del esquema oficial SAF-T (PT).
Impacto en el sistema: determina el formato del fichero que se entrega a la AT.
Comportamiento del sistema: el fichero SAF-T se genera con esta versión.
Ejemplo de uso / qué ocurre: viene con el valor oficial vigente; no se modifica salvo cambio normativo.
Identificador y versión del producto
Nombre del campo: Identificador del producto / Versión del producto.
Descripción: el nombre y la versión del software certificado (Golfmanager).
Impacto en el sistema: figuran en la cabecera del SAF-T.
Comportamiento del sistema: se incluyen automáticamente en el fichero.
Ejemplo de uso / qué ocurre: vienen preconfigurados; identifican al programa ante la AT.
Número de certificado del software
Nombre del campo: Número de certificado del software.
Descripción: el número de certificación que la AT ha asignado al programa.
Impacto en el sistema: aparece en el QR y en el texto "Processado por programa certificado" de cada factura.
Comportamiento del sistema: se imprime en todos los documentos.
Ejemplo de uso / qué ocurre: viene preconfigurado con el número oficial del certificado.
Identificador de consumidor final
Nombre del campo: Identificador de consumidor final.
Descripción: el identificador que se usa cuando la factura no tiene cliente concreto.
Impacto en el sistema: permite emitir facturas a "consumidor final" sin NIF.
Comportamiento del sistema: se aplica automáticamente en esas facturas.
Ejemplo de uso / qué ocurre: una venta de mostrador sin datos del cliente sale como consumidor final.
NIF de la empresa del producto
Nombre del campo: NIF de la empresa del producto.
Descripción: el NIF del titular fiscal que se declara en el SAF-T.
Impacto en el sistema: debe coincidir con el NIF de la empresa una vez se factura.
Comportamiento del sistema: ningún cliente puede tener este mismo NIF.
Ejemplo de uso / qué ocurre: se rellena con el NIF del club; identifica al emisor en el fichero fiscal.
Base contable, moneda y entidad fiscal
Nombre del campo: Base contable fiscal / Moneda / Entidad fiscal.
Descripción: la base de la contabilidad (por ejemplo, facturación), la moneda (EUR) y el nombre de la entidad en el SAF-T.
Impacto en el sistema: definen parámetros de la cabecera del fichero.
Comportamiento del sistema: se vuelcan en el SAF-T.
Ejemplo de uso / qué ocurre: vienen preconfigurados con los valores estándar.
Usar series manuales
Nombre del campo: Usar series manuales. Es un interruptor (activado/desactivado).
Descripción: habilita las series de facturas manuales (FTM) y de recuperación (FTD).
Impacto en el sistema: sin activarlo, no se pueden usar esos tipos de serie.
Comportamiento del sistema: si intentas usar una serie manual o de recuperación sin esta opción, el sistema avisa de que "la serie manual no está activada y es necesaria para este tipo de serie".
Ejemplo de uso / qué ocurre: lo activas si vas a introducir documentos emitidos en contingencia.
Datos de la empresa (ficha de la empresa)
Matrícula (Registration nº)
Nombre del campo: Matrícula (Registration nº). Obligatorio.
Descripción: el número de registro de la empresa en la autoridad fiscal.
Impacto en el sistema: debe coincidir con el NIF de la empresa; figura en el SAF-T.
Comportamiento del sistema: queda bloqueado tras emitir la primera factura.
Ejemplo de uso / qué ocurre: lo rellenas al dar de alta la empresa, antes de facturar.
CAE, CRC, capital social y RNAAT
Nombre del campo: CAE, CRC, Capital social, RNAAT (opcionales).
Descripción: datos registrales y de clasificación de la empresa (código de actividad, conservatoria de registro, capital social, registro RNAAT).
Impacto en el sistema: completan la información fiscal del emisor.
Comportamiento del sistema: se incluyen donde corresponde en el SAF-T y los documentos.
Ejemplo de uso / qué ocurre: los rellenas según los datos registrales del club.
Texto del pie de la nota de crédito
Nombre del campo: Texto del pie de la factura rectificativa (nota de crédito).
Descripción: un texto personalizado que aparece al pie de las notas de crédito.
Impacto en el sistema: solo afecta a la impresión de las notas de crédito.
Comportamiento del sistema: se muestra en el documento de la nota de crédito.
Ejemplo de uso / qué ocurre: pones el motivo o la mención legal que deba figurar en las rectificativas.
Series (en cada serie de facturación)
ATCUD
Nombre del campo: ATCUD.
Descripción: el código de validación de la serie (8 caracteres) que asigna la AT.
Impacto en el sistema: es obligatorio; forma parte del ATCUD-número que aparece en cada factura y en el QR.
Comportamiento del sistema: si falta o tiene un formato incorrecto, el sistema avisa ("no hay ATCUD en el tipo de factura" / "el formato del ATCUD no es correcto") y no deja facturar.
Ejemplo de uso / qué ocurre: introduces el código que te ha dado la AT para esa serie.
Activa
Nombre del campo: Activa.
Descripción: indica si la serie está en uso.
Impacto en el sistema: solo las series activas pueden emitir.
Comportamiento del sistema: si no está activa, al facturar el sistema avisa de que "la serie no está activa".
Ejemplo de uso / qué ocurre: activas la serie en vigor.
Número de copias (impresiones)
Nombre del campo: Número de impresiones / copias.
Descripción: cuántas copias se imprimen del documento (Original, Duplicado, Triplicado).
Impacto en el sistema: determina las copias y su rotulación.
Comportamiento del sistema: al imprimir, salen tantas copias como se indique; las reimpresiones se marcan como copia.
Ejemplo de uso / qué ocurre: pones "2" para emitir Original y Duplicado.
Tipo de serie
Nombre del campo: Tipo de serie.
Descripción: si la serie es de facturación normal, manual (FTM) o de recuperación (FTD).
Impacto en el sistema: condiciona cómo se numeran y validan los documentos de esa serie.
Comportamiento del sistema: las manuales y de recuperación requieren tener activada la opción "Usar series manuales".
Ejemplo de uso / qué ocurre: usas una serie de recuperación para introducir documentos emitidos en contingencia.
Fecha de inicio y fin
Nombre del campo: Fecha de inicio / Fecha de fin.
Descripción: el periodo de validez del ATCUD de la serie.
Impacto en el sistema: delimita cuándo puede usarse la serie.
Comportamiento del sistema: fuera de ese periodo, la serie no debe emitir.
Ejemplo de uso / qué ocurre: pones las fechas que correspondan al ATCUD comunicado.
Tipos de documento (en cada tipo de factura)
Tipo de documento
Nombre del campo: Tipo de documento.
Descripción: asocia el tipo de factura de Golfmanager al tipo portugués: Fatura (FT), Fatura Recibo (FR) o Nota de crédito (NC).
Impacto en el sistema: define la naturaleza fiscal del documento.
Comportamiento del sistema: es obligatorio; el código (FT/FR/NC) se asigna automáticamente.
Ejemplo de uso / qué ocurre: a un tipo de factura de cobro inmediato le asignas "Fatura Recibo".
Factura manual / Factura de recuperación
Nombre del campo: Factura manual / Factura de recuperación (interruptores).
Descripción: marcan si el tipo de factura es para documentos manuales o de recuperación.
Impacto en el sistema: esos documentos exigen un número de documento manual (formato
AAAA/NN).Comportamiento del sistema: si falta el número manual, el sistema avisa de que "el número de documento manual es obligatorio"; si se repite, de que está "repetido".
Ejemplo de uso / qué ocurre: los usas para introducir facturas emitidas a mano durante una contingencia.
Impuestos, formas de pago y productos
Descripción del impuesto
Nombre del campo: Descripción (en cada impuesto).
Descripción: clasifica el impuesto como exento, reducido, intermedio o normal.
Impacto en el sistema: determina el código SAF-T (ISE / RED / INT / NOR), que se asigna solo.
Comportamiento del sistema: solo se admiten tipos de IVA válidos en Portugal (0, 5, 6, 12, 13, 22, 23%); otros dan "porcentaje no válido".
Ejemplo de uso / qué ocurre: al 23% le pones "Normal"; al 6%, "Reducido".
Código SAF-T de la forma de pago
Nombre del campo: Código SAF-T (en cada forma de pago).
Descripción: el código portugués del medio de pago (Numerário/efectivo, Tarjeta de crédito/débito, Cheque, Transferencia bancaria…).
Impacto en el sistema: clasifica el cobro en la factura y el SAF-T.
Comportamiento del sistema: si una forma de pago usada no tiene código, el sistema avisa de que "la forma de pago no tiene código SAF-T" y no deja registrar el pago.
Ejemplo de uso / qué ocurre: a "Efectivo" le asignas el código de Numerário.
Categoría del producto
Nombre del campo: Categoría (en cada producto).
Descripción: indica si es un producto o un servicio.
Impacto en el sistema: se declara así en el SAF-T.
Comportamiento del sistema: es obligatorio para poder facturar el producto.
Ejemplo de uso / qué ocurre: a un green fee le pones "Servicio"; a una caja de bolas, "Producto".
Motivo y descripción de exención
Nombre del campo: Motivo de exención / Descripción de exención (en cada producto exento).
Descripción: el código de exención de IVA (M01–M99) y su descripción, para productos al 0%.
Impacto en el sistema: es obligatorio si el único impuesto del producto es 0%.
Comportamiento del sistema: sin él, no se puede confirmar la factura con ese producto.
Ejemplo de uso / qué ocurre: a un producto exento le asignas el código M correspondiente a su exención.
Datos del cliente (NIF, país, caracteres)
Nombre del campo: NIF, país, dirección, código postal (en la ficha del cliente).
Descripción: los datos fiscales del cliente.
Impacto en el sistema: el NIF se valida (dígito de control), el país es obligatorio si hay NIF y el código postal debe tener formato portugués.
Comportamiento del sistema: tras la primera factura con NIF, los datos del cliente quedan protegidos; los caracteres deben ser compatibles con el formato fiscal.
Ejemplo de uso / qué ocurre: introduces un NIF portugués válido y su país; si el NIF es incorrecto, el sistema avisa.
Cómo se usa en el día a día
Una vez configurado, facturas con normalidad y el módulo se encarga del cumplimiento fiscal:
Cada factura emitida lleva automáticamente su hash, su ATCUD y su QR, y el texto "Processado por programa certificado" con el número de certificado.
El documento se imprime con las copias configuradas (Original / Duplicado / Triplicado) y, en reimpresiones, indica que es una copia.
Las facturas no se pueden dejar en borrador, borrar ni editar una vez emitidas; las correcciones se hacen con notas de crédito. Con el módulo activo, quedan deshabilitadas las acciones de volver a borrador, borrar facturas, edición directa e importación.
Para casos especiales existen las series manuales y de recuperación (por ejemplo, para introducir documentos emitidos en contingencia), que requieren un número de documento manual (AAAA/NN).
Los tipos de documento
Fatura (FT): factura estándar, con fecha de vencimiento configurable.
Fatura Recibo (FR): factura con cobro en el momento de la emisión (vencimiento el mismo día, "pronto pago").
Nota de crédito (NC): rectifica una factura; hereda los datos fiscales (NIF, dirección, etc.) de la factura de origen y no se pueden cambiar.
Factura manual (FTM): para documentos introducidos a mano; requiere número de documento manual y la opción de series manuales.
Factura de recuperación (FTD): para introducir retroactivamente documentos; las fechas deben ser correlativas dentro de la serie.
Exportar el fichero SAF-T
Cuando la AT o tu contabilidad necesiten el fichero SAF-T, en las acciones de Facturas tienes "SAF-T" (por periodo) y "SAF-T anual":
Usa la opción de exportar SAF-T.
Indica el periodo (rango de fechas o año) y la empresa.
Golfmanager genera el fichero XML con todos los documentos del periodo, listo para entregar.
El fichero SAF-T usa la codificación oficial portuguesa (ISO-8859-1 / Windows-1252). Por eso, los datos de clientes y productos no pueden contener caracteres no compatibles; si los hay, el sistema avisa de que el fichero "contiene caracteres no compatibles con el formato fiscal portugués".
Limitaciones a tener en cuenta
Los documentos no se pueden borrar ni editar una vez emitidos: se corrigen con notas de crédito.
No se permiten borradores ni líneas con importe negativo (salvo en notas de crédito).
Los datos fiscales de la empresa no se pueden cambiar si ya hay facturas emitidas.
Validaciones estrictas: NIF (con dígito de control), país, código postal portugués (
0000-000), tipos de IVA permitidos (0, 5, 6, 12, 13, 22, 23%), un solo impuesto por producto y motivo de exención en los exentos.La fecha de la factura no puede ser futura y el vencimiento no se puede cambiar tras confirmar.
El NIF del cliente no puede coincidir con el de la empresa.
Solo caracteres compatibles (ISO-8859-1 / Windows-1252) en clientes, productos y empresa.
Una serie, una vez con facturas, no se puede modificar (formato, tipo, ATCUD, etc.).
Es específica de Portugal: no aplica a otros países.
Preguntas frecuentes
¿Esta integración envía datos a un sistema externo (Eticadata u otro ERP)?
No. Es Golfmanager el que actúa como programa certificado y genera por sí mismo el hash, el ATCUD, el QR y el fichero SAF-T. No hay conexión con ningún servicio externo ni envío de datos a otro sistema.
¿Qué es el ATCUD y de dónde lo saco?
Es un código de validación de la serie (8 caracteres) que asigna la Autoridade Tributária cuando comunicas la serie. Se introduce en cada serie y aparece, junto al número, en cada factura y en el QR.
Sale "no hay ATCUD en el tipo de factura" o "el formato del ATCUD no es correcto". ¿Qué hago?
La serie no tiene su ATCUD o está mal escrito. Edita la serie e introduce el ATCUD exactamente como te lo dio la AT (8 caracteres válidos).
Sale "la serie no está activa". ¿Qué reviso?
La serie está marcada como inactiva. Edítala y márcala como activa (o usa otra que sí lo esté).
No me deja confirmar una factura con un producto sin IVA. ¿Por qué?
A los productos exentos (IVA 0%) les falta el motivo de exención (M01–M99) y su descripción. Asígnalos en el producto y vuelve a intentarlo.
Sale "la forma de pago no tiene código SAF-T". ¿Qué reviso?
Esa forma de pago no tiene asignado su código SAF-T. Ve a Formas de pago, asígnale el código (Numerário, Tarjeta, Transferencia…) y vuelve a cobrar.
Sale "NIF no válido". ¿Qué pasa?
El NIF introducido no supera la validación (dígito de control portugués). Revísalo y corrígelo. Recuerda que si hay NIF, el país es obligatorio.
Sale que el cliente no puede tener el mismo NIF que la empresa. ¿Qué hago?
Un cliente no puede tener el mismo NIF que el de la empresa emisora. Corrige el NIF del cliente.
Sale "el código postal no es válido". ¿Qué reviso?
El código postal debe tener el formato portugués 0000-000 (cuatro dígitos, guion, tres dígitos). Corrígelo en la ficha del cliente o de la empresa.
¿Por qué no puedo cambiar los datos fiscales de la empresa?
Porque ya hay facturas emitidas. Por normativa, el NIF, la matrícula y otros datos fiscales quedan bloqueados tras la primera factura. Hay que revisarlos antes de empezar a facturar.
¿Puedo borrar o editar una factura ya emitida?
No. Una vez emitida, no se puede borrar ni editar. Las correcciones se hacen con una nota de crédito. Con el módulo activo, también están deshabilitadas las acciones de volver a borrador, borrar e importar facturas.
¿Cómo corrijo o anulo una factura?
Emitiendo una nota de crédito (NC) sobre la factura original. La nota de crédito hereda los datos fiscales de la factura de origen.
¿Qué diferencia hay entre Fatura (FT) y Fatura Recibo (FR)?
La Fatura (FT) es una factura estándar con vencimiento configurable. La Fatura Recibo (FR) es factura con cobro en el momento de emitirla (vencimiento el mismo día, pronto pago).
Sale "porcentaje no válido" al configurar un impuesto. ¿Qué pasa?
En Portugal solo se admiten los tipos de IVA 0, 5, 6, 12, 13, 22 y 23%. Usa uno de esos. Además, cada producto debe tener un único impuesto.
¿Qué son las series manuales y de recuperación?
Sirven para casos especiales: las manuales (FTM) para introducir documentos hechos a mano y las de recuperación (FTD) para introducir retroactivamente documentos. Requieren activar "Usar series manuales" y un número de documento manual (AAAA/NN).
Sale "el número de documento manual es obligatorio" o "repetido". ¿Qué hago?
Las facturas manuales o de recuperación necesitan un número de documento manual único. Introdúcelo en el formato AAAA/NN y asegúrate de que no se repite.
Sale "la serie manual no está activada y es necesaria para este tipo de serie". ¿Qué reviso?
Vas a usar una serie manual o de recuperación sin haber activado la opción. Ve a Configuración > Ajustes SAF-T y activa Usar series manuales.
Sale "las fechas deben ser correlativas". ¿Qué pasa?
En una serie de recuperación, las fechas de los documentos deben ir en orden. Revisa que la fecha que introduces no sea anterior a la del último documento de esa serie.
¿Cómo facturo a un consumidor final sin NIF?
Se emite sin cliente concreto y Golfmanager usa el identificador de consumidor final configurado en los Ajustes SAF-T. El QR sale con los datos de la empresa y la factura.
¿Cómo genero el fichero SAF-T para la AT?
En las acciones de Facturas, usa "SAF-T" (por periodo) o "SAF-T anual", indica el periodo y la empresa, y Golfmanager genera el fichero XML listo para entregar.
El SAF-T da un error de caracteres. ¿Qué hago?
Hay caracteres no compatibles en algún cliente o producto. El fichero usa la codificación oficial portuguesa (ISO-8859-1 / Windows-1252); revisa y corrige los caracteres especiales no permitidos en nombres y direcciones.
Sale "no se puede cambiar la fecha de vencimiento" o "la fecha no puede ser futura". ¿Qué pasa?
El vencimiento no se puede cambiar una vez confirmada la factura, y la fecha de la factura no puede ser futura. Son validaciones de la normativa.
¿Qué aparece impreso en cada factura?
El número con su ATCUD, el QR, el texto "Processado por programa certificado" con el número de certificado, y las copias configuradas (Original / Duplicado / Triplicado).
¿Puedo reutilizar o cambiar una serie que ya tiene facturas?
No. Una vez una serie tiene documentos, no se pueden modificar su formato, tipo, ATCUD ni otros datos. Para cambios, se crea una serie nueva.
¿Necesito un certificado digital o un programa externo?
No para esta integración: Golfmanager está certificado y genera los documentos por sí mismo. Lo que sí necesitas es comunicar tus series y ATCUD a la AT y configurarlos en Golfmanager.
Buenas prácticas recomendadas
Revisa los datos fiscales de la empresa al inicio: una vez hay facturas, no se pueden cambiar.
Configura las series con su ATCUD y los códigos SAF-T de las formas de pago antes de empezar a facturar.
Asigna el motivo de exención a los productos sin IVA y la categoría (producto/servicio) a todos los productos desde el principio.
Evita caracteres especiales no compatibles en nombres y direcciones de clientes y productos.
Usa notas de crédito para cualquier corrección; no intentes borrar o editar facturas.
Exporta el SAF-T por periodos cerrados y guárdalo de forma ordenada.