Ir al contenido principal
Todas las coleccionesv3 - Manual de configuraciónv3 - Otros
v3 - TicketBAI ⚠️👷🏻‍♀️🚧
v3 - TicketBAI ⚠️👷🏻‍♀️🚧
Actualizado hace más de un mes

Í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

Configuración por parte del equipo de Golfmanager

1.- Desde Menú de Configuración > Sistema > App Market.

  • Instalar módulo de Ticket Bai

  • Instalar módulo de Notificaciones del Sistema

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 ver el estado de envío a TicketBAI en Golfmanager

Sección: Menú principal > Facturación > Facturas

Accediendo al listado de facturas podrás ver una columna de Estado en Ticketbai, donde se indica el estado de la firma en Ticketbai.

  • Si se ha enviado correctamente, aparecerá una etiqueta de color verde con el texto Firmada ok

  • Las Facturas Proforma y las Factura Globales no tienen que ser firmadas y por tanto, cuando la factura generada en el sistema sea de alguno de estos dos tipos, aparecerá una etiqueta de color rojo con el texto No enviado.

  • Si la factura generada en el sistema se ha enviado a ticketbai y no ha sido firmada, aparecerá una etiqueta de color rojo con el texto Pendiente.

Cómo consultar las transacciones

Sección: Menú principal > Facturación > Facturas > Pestaña Ticketbai

Cada intento de pago a través del TPV en Golfmanager va a generar una Factura y 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 Factura tendremos una pestaña de Ticketbai con la información correspondiente a la transacción.

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á una notificación con el error. Puedes acceder a esta notificación desde el símbolo de la campana que encuentras en la parte superior derecha del sistema, junto a la rueda de configuración.

Cómo enviar a Ticketbai una Factura, cuyo "Estado en Ticketbai" en el sistema es "Pendiente"

Sección: Menú principal > Facturación > Facturas

Si al acceder al listado de Facturas visualizas que la última Factura emitida en el sistema, su estado en Ticketbai, sigue los siguientes pasos.

  1. Accede a las Notificaciones del sistema, desde el símbolo de la campana que encuentras en la parte superior derecha del sistema, junto a la rueda de configuración.

  2. Visualizarás un mensaje de tipo Error relacionado con la última transacción de Ticketbai

  3. Revisa el error que te muestra el sistema

  4. Accede al listado de Facturas

  5. Selecciona la referencia de la última factura emitida en el sistema, cuyo estado en Ticketbai aparece como Pendiente

  6. Selecciona Acciones

  7. Selecciona Enviar a Ticketbai

    1. Si el estado en Ticketbai cambia a color verde y con el texto Firmado ok, la factura se ha validado correctamente.

    2. Si el estado en Ticketbai permanece en rojo y Pendiente, tendrás que eliminar la Factura y volver a crearla en el sistema.

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.

Mensaje error: tax_id_number must be 9 characters, Invalid ID card number.

Menú principal > Facturación > Facturas > Pestaña 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?