Índice
Para quién es este artículo: Aplica a los clubes que operan en el País Vasco (Álava, Bizkaia y Gipuzkoa).
¿Qué es esta integración?
La integración con TicketBAI permite cumplir el sistema de facturación electrónica obligatorio del País Vasco. Cada vez que se emite una factura, Golfmanager la firma electrónicamente y la envía a la Hacienda Foral correspondiente a través del servicio intermediario KubiBAI. La factura queda con su firma y su código QR.
TicketBAI es la normativa de facturación de las Haciendas Forales de Álava, Bizkaia y Gipuzkoa. KubiBAI es el servicio que hace de intermediario entre Golfmanager y Hacienda para firmar y enviar las facturas.
¿Qué problema resuelve?
Cumplir la normativa TicketBAI automáticamente, sin pasos manuales.
Firma y envía cada factura a Hacienda en el momento de emitirla.
Añade la firma y el QR a la factura (visible en el PDF).
Mantiene el encadenamiento obligatorio de las facturas.
¿Qué sistemas conecta y en qué dirección viajan los datos?
Conecta Golfmanager con KubiBAI y, a través de él, con la Hacienda Foral. El flujo, paso a paso, es:
Golfmanager, al crear una factura, envía la información a KubiBAI.
KubiBAI firma la factura y la remite a TicketBAI (Hacienda Vasca).
KubiBAI devuelve esa firma a Golfmanager.
Golfmanager incluye esa firma en formato QR en la factura.
En el caso de tickets o facturas simplificadas, el QR se añade automáticamente al ejecutar el pago en el TPV. Ese QR sirve de identificador único del ticket ante la Hacienda del País Vasco.
¿Qué información se intercambia?
Información | Dirección | Para qué |
Datos de la factura (emisor, receptor, líneas, impuestos) | Golfmanager → KubiBAI → Hacienda | Firmar y declarar la factura |
Firma y código QR | Hacienda → KubiBAI → Golfmanager | Guardar la factura firmada y mostrar el QR |
Requisitos previos (antes de activar la integración)
Operar en el País Vasco y estar sujeto a TicketBAI.
Tener contratado el servicio KubiBAI y sus claves.
Tener el módulo TicketBAI instalado, junto con el módulo de facturación.
Conocer tu territorio (Álava, Bizkaia o Gipuzkoa) y los datos fiscales de la empresa.
Que el CIF de la empresa coincida exactamente con el dado de alta en KubiBAI (mismas mayúsculas/minúsculas, 9 caracteres sin guion).
Permisos de gestión de facturación para configurar.
Cómo se configura (paso a paso)
La configuración tiene tres bloques: los datos de la empresa, los ajustes de facturación y las claves de KubiBAI.
Paso 1 — Datos de la empresa
Menú Configuración > Facturación > Empresas > sección TicketBAI
Accede a Menú Configuración > Facturación > Empresas y abre tu empresa.
Comprueba que el CIF es correcto y coincide con el de KubiBAI.
En la sección TicketBAI, si el emisor es persona física o autónomo, activa "El emisor es persona física" (para personas jurídicas se deja desactivado).
Si eres persona física, rellena Nombre, Primer apellido y Segundo apellido.
Si además operas en Bizkaia, activa "Es Bizkaia" e indica el Epígrafe de actividad TicketBAI (para campos de golf suele ser
196710).Guarda los cambios.
Paso 2 — Ajustes de facturación
En Menú Configuración > Facturación > Configuración > sección Facturas, en el campo Empresa, selecciona tu empresa.
Activa "Anular simplificadas al emitir factura completa".
En Menú Configuración > Facturación > Series de factura, en el campo Empresa, selecciona también tu empresa.
Guarda los cambios.
Paso 3 — Claves de KubiBAI y territorio
En la configuración de TicketBAI, activa el servicio y deja el modo de producción desactivado para empezar con pruebas.
Introduce las claves de KubiBAI (de prueba y de producción) que te facilitan.
Indica tu territorio: 01 = Álava, 02 = Bizkaia, 03 = Gipuzkoa.
Valida que las facturas se firman y, cuando todo funcione, activa el modo de producción.
⚠️ Recomendación: empieza en modo de prueba con las claves de test, comprueba que las facturas se firman, y activa el modo de producción solo cuando todo funcione. Las claves se guardan cifradas.
Los campos de configuración en detalle
A continuación se explican los campos que intervienen en TicketBAI.
1) El emisor es persona física
• Nombre del campo: El emisor es persona física (Empresas > TicketBAI)
• Descripción: Indica si quien factura es una persona física/autónomo en lugar de una sociedad.
• Impacto en el sistema: Cambia los datos fiscales que se envían (nombre y apellidos en vez de razón social).
• Ejemplo de uso: lo activas si el club factura como autónomo.
Qué ocurre cuando se utiliza: aparecen los campos de nombre y apellidos a rellenar.
Comportamiento del sistema: por defecto está desactivado (persona jurídica).
2) Es Bizkaia
• Nombre del campo: Es Bizkaia (Empresas > TicketBAI, para persona física)
• Descripción: Marca que la persona física opera en Bizkaia, territorio que exige datos adicionales.
• Impacto en el sistema: Habilita el epígrafe de actividad obligatorio en Bizkaia.
• Ejemplo de uso: lo activas si eres autónomo en Bizkaia.
Qué ocurre cuando se utiliza: se piden los datos extra que Bizkaia requiere.
Comportamiento del sistema: solo aplica a personas físicas en ese territorio.
3) Nombre / Primer apellido / Segundo apellido
• Nombre del campo: Nombre, Primer apellido, Segundo apellido (persona física)
• Descripción: Los datos personales del emisor cuando es persona física.
• Impacto en el sistema: Se envían a Hacienda como identificación del emisor.
• Ejemplo de uso: los rellenas si activaste "El emisor es persona física".
Qué ocurre cuando se utiliza: la factura sale con el nombre y apellidos correctos.
Comportamiento del sistema: solo son obligatorios para personas físicas.
4) Epígrafe de actividad TicketBAI
• Nombre del campo: Epígrafe de actividad TicketBAI
• Descripción: Código de la actividad económica exigido para personas físicas en Bizkaia (para campos de golf suele ser 196710).
• Impacto en el sistema: Acompaña a la factura como dato fiscal obligatorio en ese caso.
• Ejemplo de uso: introduces 196710 si te lo indica tu asesoría.
Qué ocurre cuando se utiliza: la factura incluye el epígrafe de actividad.
Comportamiento del sistema: solo se requiere para persona física en Bizkaia.
5) CIF de la empresa
• Nombre del campo: CIF (en Empresas y en Configuración General > Centro)
• Descripción: El identificador fiscal del emisor. Debe coincidir exactamente con el dado de alta en KubiBAI.
• Impacto en el sistema: Si no coincide (mayúsculas/minúsculas, longitud), Hacienda/KubiBAI rechaza el envío.
• Ejemplo de uso: compruebas que el CIF tiene 9 caracteres, sin guion, igual que en KubiBAI.
Qué ocurre cuando se utiliza: la factura se firma a nombre del emisor correcto.
Comportamiento del sistema: una discrepancia provoca errores del tipo "id_card must match the KubiBAI control panel".
6) Empresa (en Facturas y en Series de factura)
• Nombre del campo: Empresa
• Descripción: Asocia la facturación y las series de factura con la empresa configurada para TicketBAI.
• Impacto en el sistema: Garantiza que las facturas se emiten bajo el emisor correcto y con los datos de TicketBAI.
• Ejemplo de uso: seleccionas tu empresa en Configuración > Facturas y en Series de factura.
Qué ocurre cuando se utiliza: las facturas que emitas se vinculan a esa empresa y se firman.
Comportamiento del sistema: si falta, las facturas pueden no enviarse correctamente a TicketBAI.
7) Anular simplificadas al emitir factura completa
• Nombre del campo: Anular simplificadas al emitir factura completa (Configuración > Facturas)
• Descripción: Cuando a un ticket (factura simplificada) se le emite después una factura completa, anula automáticamente la simplificada.
• Impacto en el sistema: Evita duplicar la declaración del mismo importe ante Hacienda.
• Ejemplo de uso: lo activas para que, al convertir un ticket en factura, la simplificada se anule sola.
Qué ocurre cuando se utiliza: se genera la anulación de la simplificada y la nueva factura completa.
Comportamiento del sistema: mantiene la coherencia fiscal entre ticket y factura.
8) Servicio activado / Modo de producción
• Nombre del campo: Servicio activado y Modo de producción (configuración de TicketBAI)
• Descripción: Activan la integración y cambian entre el entorno de pruebas y el real.
• Impacto en el sistema: En pruebas no se declara de verdad a Hacienda; en producción sí.
• Ejemplo de uso: empiezas en pruebas y activas producción al validar.
Qué ocurre cuando se utiliza: en producción, cada factura se firma y declara realmente.
Comportamiento del sistema: usa las claves de prueba o de producción según el modo.
9) Claves de KubiBAI
• Nombre del campo: Claves de KubiBAI (de prueba y de producción)
• Descripción: Las credenciales que permiten a Golfmanager comunicarse con KubiBAI.
• Impacto en el sistema: Sin ellas, las facturas no se pueden firmar ni enviar.
• Ejemplo de uso: las copias del alta de KubiBAI; se guardan cifradas.
Qué ocurre cuando se utiliza: autentican cada envío a KubiBAI.
Comportamiento del sistema: se usan las de prueba o las de producción según el modo.
10) Territorio
• Nombre del campo: Territorio
• Descripción: La Hacienda Foral a la que perteneces: 01 Álava, 02 Bizkaia, 03 Gipuzkoa.
• Impacto en el sistema: Dirige la declaración a la Hacienda correcta y ajusta los requisitos.
• Ejemplo de uso: seleccionas el territorio de tu club.
Qué ocurre cuando se utiliza: las facturas se declaran en la diputación correspondiente.
Comportamiento del sistema: un territorio incorrecto provoca errores en el envío.
ℹ️ Nota: los nombres y la ubicación exacta de algunos ajustes (claves, territorio, modo) pueden variar según tu versión. Tu equipo de implantación y KubiBAI te indican los valores concretos.
Cómo se usa en el día a día
Una vez configurado, no tienes que hacer nada especial: al emitir una factura, Golfmanager la firma y la envía a Hacienda automáticamente, y la factura queda con su firma y su QR (visibles en el PDF).
Facturas normales: requieren los datos del cliente y se firman.
Facturas simplificadas (tickets): no requieren datos del cliente y también se firman (el QR se añade al cobrar en el TPV).
Documentos internos, recapitulativos o proforma: quedan excluidos de TicketBAI.
El sistema gestiona además las exenciones, las retenciones (IRPF) y los destinatarios extranjeros con sus datos específicos.
⚠️ Si KubiBAI no devuelve la firma en el momento de emitir, Golfmanager no te dejará seguir facturando y te mostrará una notificación de error (en el icono de la campana, arriba a la derecha). Hay que resolver esa factura antes de continuar.
Estados, transacciones y acciones
Estado en Ticketbai (columna del listado de Facturas):
Firmada ok (verde): la factura se firmó y envió correctamente.
Pendiente (rojo): se envió pero aún no está firmada (hay que resolverla).
No enviado (rojo): es un tipo que no se firma (por ejemplo, proforma o factura global).
Pestaña Ticketbai (en el detalle de cada factura): muestra la información de la transacción (si fue correcta o el error, con su numeración para identificar la causa).
Enviar una factura "Pendiente":
Revisa el error en las Notificaciones (icono de la campana).
Ve al listado de Facturas y selecciona la factura pendiente.
Pulsa Acciones > Enviar a Ticketbai.
Si pasa a Firmado ok (verde), está validada. Si sigue en Pendiente, deberás anularla y volver a crearla.
Anular una factura: la opción de eliminar está desactivada. Usa Anular para que el sistema genere una factura rectificativa, que se registra automáticamente en KubiBAI.
Conceptos clave
Concepto | Qué es |
Firma | La firma electrónica que da validez a la factura ante Hacienda |
Código QR | El QR que se imprime en la factura, exigido por TicketBAI |
Encadenamiento | Las facturas deben firmarse en orden; cada una enlaza con la anterior |
Territorio foral | Álava (01), Bizkaia (02) o Gipuzkoa (03) |
KubiBAI | El intermediario que firma y envía las facturas a Hacienda |
Limitaciones a tener en cuenta
Las facturas se firman en orden (encadenamiento): si la factura anterior no se firmó correctamente, no se puede firmar la siguiente hasta resolverlo.
Si KubiBAI no devuelve la firma, no podrás seguir facturando hasta resolver la factura pendiente.
No se pueden eliminar facturas: se anulan mediante factura rectificativa.
Depende de KubiBAI y de Hacienda: si el servicio no está disponible, la firma puede no completarse en ese momento.
Algunos documentos quedan excluidos (internos, recapitulativos, proforma).
Es específica del País Vasco y de su normativa TicketBAI.
Preguntas frecuentes
¿Qué es KubiBAI y por qué aparece?
Es el servicio intermediario que firma tus facturas y las envía a la Hacienda Foral. Golfmanager se comunica con KubiBAI y KubiBAI con Hacienda.
¿Tengo que hacer algo al emitir cada factura?
No. Al emitir la factura se firma y envía automáticamente y queda con su firma y QR. Solo tendrás que intervenir si una factura queda "Pendiente".
¿Qué significan los estados "Firmada ok", "Pendiente" y "No enviado"?
Firmada ok = correcta; Pendiente = enviada pero sin firmar (hay que resolverla); No enviado = es un tipo que no se firma (proforma o global).
Una factura se quedó en "Pendiente". ¿Qué hago?
Revisa el error en las Notificaciones (campana), ve al listado de Facturas, selecciona la factura y pulsa Acciones > Enviar a Ticketbai. Si sigue en Pendiente, anúlala y vuelve a crearla.
¿Puedo eliminar una factura?
No. La eliminación está desactivada. Usa Anular: el sistema genera una factura rectificativa que se registra en KubiBAI.
Me sale el error "tax_id_number must be 9 characters / Invalid ID card number".
Revisa en Clientes que el Tipo de identificación y el DNI sean correctos y tengan 9 caracteres.
Me sale "The sender id card number must be 9 characters".
Revisa en Configuración General > Centro que el CIF sea el mismo que en KubiBAI, con 9 caracteres y sin guion.
Me sale "The id_card of the sender must match the ID Card of the KubiBAI control panel".
Revisa en Empresas que el CIF coincide exactamente con el de KubiBAI, incluidas mayúsculas y minúsculas.
¿Aparece el QR en la factura impresa?
Sí. Una vez firmada, la factura (y el ticket simplificado) sale con su QR y su firma, como exige TicketBAI.
¿Qué pasa si Hacienda o KubiBAI están caídos?
El proceso es asíncrono: KubiBAI puede seguir devolviendo a Golfmanager la firma que genera. Si en el momento de emitir no llega la firma, Golfmanager te avisa y no deja seguir facturando hasta resolverlo.
¿Soy persona física/autónomo, cambia algo?
Sí. Debes activar "El emisor es persona física" y rellenar nombre y apellidos; en Bizkaia, además, marca "Es Bizkaia" e indica el epígrafe (p. ej. 196710).
¿A quién contacto para temas de KubiBAI?
Al soporte de KubiBAI (ver "Contacto y ayuda"). Para la configuración en Golfmanager, a nuestro soporte por la burbuja azul.
Buenas prácticas recomendadas
Prueba primero en modo test y valida que las facturas se firman antes de activar producción.
Configura bien el territorio y los datos de la empresa (CIF idéntico al de KubiBAI).
Resuelve cuanto antes una factura no firmada para no bloquear el encadenamiento ni la facturación.
Comprueba que el QR y la firma aparecen en las facturas.
Para corregir, usa Anular (rectificativa), nunca intentes eliminar.
Contacto y ayuda
Para la configuración en Golfmanager o el estado de una factura, escríbenos en la burbuja azul de tu programa de gestión.
Para el alta del servicio, las claves y temas del panel de KubiBAI, contacta con el soporte de KubiBAI:
Persona de contacto: Aingeru Escudero
Teléfono: +34 623 06 87 79
Email: soporte@kubibai.com