preloader

API para las pruebas de integración con TicketBAI.PRO

Objetivo de la API

Esta API no es un entorno real, es una API con el único objetivo de exponer las funciones que se publicarán próximamente para la integración con TicketBai.PRO, que posibilitará el envío de las facturas a través de las diferentes diputaciones del País Vasco.

Los datos que se envíen serán almacenados en un entorno de pruebas, no serán válidos en el entorno real.

¿Cómo me doy de alta?

Para darte de alta, puedes llamarnos o enviarnos un email, y te indicaremos cómo darte de alta.

¿Y cuándo ya tenga mi configuración?

Cuando tengas tu configuración, lo primero que deberás de hacer es dar de alta un "cliente"", y a partir de ahí remite facturas con su CIF.

No importéis certificados en este entorno ya que serán rechadados, las facturas serán firmadas por nuestro certificado para las pruebas. Las facturas no serán enviadas al entorno real de las diputaciones desde esta API.

¿Te ayudaremos?

Por supuesto, pero te ayudaremos a integrarte con nuestra API, no te haremos el desarrollo de la integración, lo sentimos.

Documentación

Se ofrece la siguiente documentación para las funciones de la API (iremos ampliando dicha documentación en breve, os pedimos paciencia y disculpas).

  • Swagger: entorno web que permite realizar el envío de peticiones a la API, y obtener la espeficiación.

Seguridad

La seguridad está implementada en OpenId, podréis encontrar múltiples ejemplos en internet de como implementarla en vuestros programas.

Cuando os deís de alta para el entorno de pruebas de la API, os facilitaremos el secreto y la configuración para poder obtener el token y poder utilizar la API.

Documentación:

Espeficicación

La API sigue la especificación OpenApi, pudiendo descargar todo el diseño en la siguiente enlace.

El uso de esta espificación permite la generación de código automatizada, así como la integración simple con gran número de tecnologías.

Recursos relacionados:

¿Qué será lo siguiente?

  • Actual: v 0.2: Versión inicial para exponer las especificaciones de la API.
  • v 0.3: Activación de los validadores fiscales de la API para el control de los datos de entrada. (Ahora no están activos porque entendemos que vais a enviar todo bien, pero los activaremos para que en un futuro minimizar el impacto de las subsanaciones por errores)
  • v 0.4: Checkeo del envío a las diputaciones (Esto será transparente, sólo activaremos el envío y podréis consultar la respuesta)
  • v 0.5: Subsanación de facturas (Zuzendu, Bizkaia y Araba)
  • v 0.6: Posibilidad de envío y generación de facturas desde la API
  • Y os seguiremos informando... intentaremos avanzar rápido en estos hitos para que tengáis todas las funcionalidades lo antes posible.