Ticketprest

Documentación

Ticketprest Restful API

Ticketprest es un software con Restfull API que adapta el sistema de facturación de tu tienda online para cumplir con las obligaciones fiscales de TicketBAI y Batuz.

Cómo funciona a nivel técnico Ticketprest

  1. Tus facturas son enviadas de tu tienda online a nuestro software en formato json.
  2. Ticketprest genera un XML (fichero TBAI) firmado a través de un certificado válido.
  3. Ticketprest obtiene la firma y genera un código QR que se incluye en tus facturas.
  4. Se envia el fichero TBAI a la hacienda que corresponda.

¿Qué necesito para utilizar Ticketprest?

Para poder utilizar Ticketprest es necesario estar dado de alta en nuestro sistema para tener tu token de acceso y tu area de usuario.

También es necesario tener un certificado válido de Izenpe para el firmado de los ficheros TBAI.

Si tu tienda online está creada con PrestaShop, haremos todo a través del módulo que te explicamos a continuación.

Módulo Prestashop

Si tienes una tienda funcionando bajo PrestaShop, desde Ticketprest te facilitaremos un módulo con el que integrar la API de conexión de manera fácil y sencilla.

Símplemente instala el módulo en tu tienda y rellena los datos solicitados:

Cuando se genere una factura, el módulo enviará los datos de la misma a Ticketprest, generando el fichero TBAI firmado y el código QR, incluyendo los mismos en las facturas como puedes ver en el ejemplo:

Ejemplo de factura Prestashop integrada con TicketBAI y Batuz

Los ficheros TBAI generados serán enviados a la Hacienda correspondiente siguiendo las especificaciones concretas de la misma.

Plugin WordPress (Woocommerce)

Si tienes una tienda funcionando bajo WordPress con Woocommerce, desde Ticketprest te facilitaremos un plugin con el que integrar la API de conexión de manera fácil y sencilla.

Simplemente instala el plugin en tu tienda y rellena los datos solicitados:

El plugin es compatible con el módulo de facturación «WooCommerce PDF Invoices & Packing Slips«. Cuando se genere una factura, se enviará los datos de la misma a Ticketprest, generando el fichero TBAI firmado y el código QR, incluyendo los mismos en las facturas como puedes ver en el ejemplo:

Ejemplo de factura wordpress (Woocommerce) integrada con TicketBAI y Batuz

Los ficheros TBAI generados serán enviados a la Hacienda correspondiente siguiendo las especificaciones concretas de la misma.

Endpoints

Ticketprest utiliza los siguientes conectores para el envío y procesamiento de las facturas. Todos ellos se lanzarán desde URLs en las que habrá que indicar el NIF del cliente y su Token de usuario.

1 - Enviar factura

Conector POST

Envío los datos de factura para generar y firmar el XML, generará también la firma TBAI y el QR, y procesará el archivo para el envío a la hacienda que corresponda

Request – Tipo Json , ejemplo de un Json

{
    "nif": "99999999X",
    "factura": {
        "prex": "2021",
        "number": "1",
        "clave" : "01",        
        "total" : "130.68",
        "cliente" : {
            "idType" : "01",
            "CodigoPais" : "ES",
            "nif" : "13131313S",
            "nombre" : "Ticket Prest",
            "direccion" : "dirección postal",
            "codigoPostal"  :"código postal"
        },
        "detalles" :[
            {
                "descripcion" : "Lampara de pie",
                "cantidad" : 3,
                "importeUnitario" : 34.50,
                "descuento" : 0,
                "total" : 103.50
            },
            {
                "descripcion" : "Envío",
                "cantidad" : 1,
                "importeUnitario" : 4.50,
                "descuento" : 0,
                "total" : 4.50
            }
        ],
        "impuestos" : {
            "tipo" : "no-exenta",
            "motivo_exenta" : "S1",
            "tipos": [
                {
                    "base" : 108,
                    "tipo" : 21,
                    "cuota" : 22.68
                }
            ]

        },
        "tipo_servicio" : ""
        
    }
}

Response: Código 200 si el proceso de generación, firma y envío del XML se ha realizado correctamente, de lo contrarío indicará el error que se ha producido

2 - Consultar factura

Conector GET

Envía la cabecera de tu factura en formato Json para obtener el el fichero XML firmado si la factura ha sido enviada y procesada anteriormente al sistema.

Request – Tipo Json , ejemplo de un Json

{
    "nif": "13131313S",
    "factura": {
        "prex": "F2021",
        "number": "80"
    }
}

Response – XML

3 - Obtener firma

Envía la cabecera de tu factura en formato Json para obtener el código de firma si la factura ha sido enviada y procesada anteriormente al sistema

Conector GET

Request – Tipo Json , ejemplo de un Json

{
    "nif": "13131313S",
    "factura": {
        "prex": "F2021",
        "number": "80"
    }
}

Response – Texto (firma TBAI)

4 - Obtener QR

Envía la cabecera de tu factura en formato Json para obtener el código el QR si la factura ha sido enviada y procesada anteriormente al sistema

Conector GET

Request – Tipo Json , ejemplo de un Json

{
    "nif": "13131313S",
    "factura": {
        "prex": "F2021",
        "number": "80"
    }
}

Response – QR en formato png