Ir al contenido principal
v3 - TicketBAI
Actualizado hace más de una semana

Í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

  1. 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

  2. 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

  3. 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

¿Ha quedado contestada tu pregunta?