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.

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