Índice
Introducción
Nos adaptamos a las últimas necesidades fiscales en el País Vasco. Con esta nueva integración con TicketBAI, nuestros clubes vascos podrán facturar y estar sincronizados con la Hacienda Tributaria Vasca.
¿En qué consiste?
Golfmanager, al crear una factura (1), mandará la información a KubiBai
KubiBai firmará la factura y se la mandará a TicketBAI (Hacienda Vasca) (2)
KubiBai devolverá a Golfmanager esa firma (3)
Golfmanager incluirá esa firma en formato QR a la factura
¿Cómo consultar las transacciones?
Sección: Menú principal > Facturación > Transacciones de TicketBAI
Cada intento de pago a través del TPV en Golfmanager va a generar un registro que nos permite ver si la transacción ha sido exitosa o si ha habido algún error. En el caso de que haya algún error, este se indica con una numeración que luego nos servirá para identificar porque se produce el error.
En cada transacción tendremos una referencia y acceso directo al ticket y venta al que corresponde la transacción.
En esta imagen se muestra un ejemplo del registro de transacciones.
Configuración por parte del equipo de Golfmanager
1.- Desde Menú de Configuración > Sistema > App Market.
Instalar módulo de Ticket Bai
2.- Desde Menú de Configuración > Facturación > Configuración > Sección Configuración de TicketBAI.
Para rellenar los datos que aparecen en la pantalla, tienes que ir a la web de kubiBAI:
web: https://kws.kubibai.net
user: solicitar al equipo de soporte
password: solicitar al equipo de soporte
NOTA. Esta web sirve a Golfmanager como cuadro de mandos para consultar las transacciones de cada uno de los clubs.
3.- Campo Api Key de usuario de producción:
Desde la web de kubiBAI > selecciona en el desplegable de Golf Manager
Seleccionar Editar Perfil
Copia el campo API-KEY de usuario
Desde el sistema de Golfmanager > Menú Configuración > Facturación > Configuración > Sección Configuración de TicketBAI.
pega este dato en el campo Api Key de usuario de producción
4.- Campo Api Key de cliente de producción:
Desde la web de kubiBAI > Selecciona en Empresas
Selecciona en Nueva Empresa
Selecciona en Persona Jurídica
Rellena los datos del formulario:
Nombre
CIF/NIF
Territorio TicketBAI. El club tiene que verificar el territorio que va a usar:
Araba
Bizkaia
Gipuzkoa
Utilizar encadenamiento automático. Activar esta opción
Selecciona en el botón de Guardar
Desde la web de kubiBAI > Selecciona en Empresas
Selecciona el nombre de la empresa
Pestaña Datos
Copia el campo API-KEY
Desde el sistema de Golfmanager > Menú Configuración > Facturación > Configuración > Sección Configuración de TicketBAI.
pega este dato en el campo Api Key de cliente de producción
5.- Campo ID del territorio:
Desde el sistema de Golfmanager > Menú Configuración > Facturación > Configuración > Sección Configuración de TicketBAI.
usa uno de estos IDs en el campo ID del territorio según el territorio seleccionado en la web de kubiBAI:
Araba: 2b26c86-352c-44e6-980a-d89c4de762a6
Bizkaia: b4039144-5069-4584-88e1-7086c9f01adc
Gipuzkoa: dded8ad1-0574-4ee4-b4f7-36687cba73b9
6.- Enviar Autorización de intermediación:
Desde la web de kubiBAI > Selecciona en Empresas
Selecciona el nombre de la empresa
Pestaña Autorización intermediación
Descarga una de las autorizaciones según el territorio para que el club lo devuelva firmado
Una vez que te lo devuelvan firmado, adjuntarlo desde la opción Adjunta tu autorización
7.- Crear Usuarios:
Desde la web de kubiBAI > Selecciona en Empresas
Selecciona el nombre de la empresa
Pestaña Usuarios
Botón Crear usuario
Rellena los datos de la persona que se va a encargar de mirar los datos del dashboard:
Nombre
Email
Email para notificaciones
Ahora ya tienes el sistema operativo para operar conectando con la Hacienda Vasca.
Cómo eliminar una factura
En principio hemos desactivado la opción de que se pueda Eliminar una factura. Tendrías que usar el botón de Anular para que el sistema genere una factura Rectificativa y se pueda registrar mediante Transacción automática en kubiBAI.
Posibles errores
Puede ser que tengas algún error de configuración en Golfmanager, la conexión del club a internet puede estar fallando, o puede haber problemas con el servidor de Golfmanager… que no te permita emitir la factura. Ponte en contacto con nuestro soporte para ver cual es la razón
Puede ser que Hacienda (TicketBAI esté caído y no responda a KubiBai, pero al ser asíncrono, KubiBai seguirá mandando a Golfmanager la firma que ellos mismos han generado
Si KubiBai no manda la firma a Golfmanager en el momento de su emisión, Golfmanager no te dejará seguir facturando y te mostrará un banner arriba con el error y un botón “sincronizar” que tendrás que hacer clic para volver a preguntar por esa firma de factura
Error ticketBai caído
El día 17 de mayo de 2024 kubiBai estaba funcionando correctamente, pero ticketBai se cayó. Por lo tanto la factura estaba firmada pero no enviada a ticketBai. Lo hemos solucionado de la siguiente manera:
Hemos ido al backoffice de kubiBai y hemos mandado la factura manualmente a ticketBai desde el detalle de la factura
Hemos cogido los IDs y la firma y la hemos metido manualmente a la transacción de ticketBai en GM
Hemos ido a la configuración de Facturación 7 TicketBai y hemos habilitado el servicio y borrado el último ID fallido
Hemos ido al TPV y ha funcionado
La factura que se quiere mandar desde GM ya existe en kubiBAI.
Vamos a la web de kubiBAI y buscamos esa factura que ya existe.
Copiamos la firma, el ID de kubibai y el ID de ticketbai y lo pegamos en las transacciones.
En kubiBAI existen facturas que no existen en GM.
Hay que desinstalar kubiBai en el tenant.
Hay que facturar en GM.
Hay que ir a kubibai y copiar la firma, el ID de kubibai y el ID de ticketbai y pegarlo en las transacciones de las facturas creadas en el sistema
Nota: si hay varias facturas hay que importar las transacciones y solo hace falta copiar los datos en la ultima transacción.
Mensaje error: tax_id_number must be 9 characters, Invalid ID card number.
Menú principal > Facturación > Transacciones de TicketBAI > Error
Si visualizas este mensaje, revisa en la ficha del cliente que el tipo de identificación y el número de DNI estén correctos, debe contener 9 caracteres.
Mensaje error: The sender data.sender id card number must be 9 characters, Invalid ID card number
Menú principal > Facturación > Transacciones de TicketBAI > Error
Si visualizas este mensaje, revisa en Menú de Configuración > Configuración General > Centro, que el CIF es el mismo que está puesto en ticketbai con 9 caracteres (sin guion)
Mensaje error: The id_card of the sender must match the ID Card of the KubiBAI control panel.
Menú principal > Facturación > Transacciones de TicketBAI > Error
Si visualizas este mensaje, revisa en menú de Configuración > Facturación > Empresas que el CIF coincide con el introducido en la web de kubiBAI
Datos de contacto
Persona de contacto: Aingeru Escudero
Teléfono: +34 623 06 87 79
Email: soporte@kubibai.com