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 Verifactu.
Cómo funciona a nivel técnico Ticketprest
- Tus facturas son enviadas de tu tienda online a nuestro software en formato json.
- Ticketprest genera un XML válido.
- Ticketprest obtiene la huella y genera un código QR que se incluye en tus facturas.
- Se envía el XML a Hacienda
¿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.
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.
Simplemente instala el módulo en tu tienda y rellena los datos solicitados:
En el proceso de alta y primera instalación tendremos una reunión contigo para asegurarnos de que tu sistema de facturación esta configurado de manera correcta y parametrizar el módulo y los envíos de las facturas.
Cuando se genere una factura, el módulo enviará los datos de la misma a Ticketprest, generando el XML y el código QR, incluyendo los mismos en las facturas como puedes ver en el ejemplo:
Los ficheros generados serán enviados a Hacienda 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 y funciona únicamente 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 Verifactu, generando el fichero y el código QR, incluyendo los mismos en las facturas como puedes ver en el ejemplo:
El XML generado será enviado a Hacienda siguiendo las especificaciones concretas de la misma.
Endpoints
Ticketprest utiliza (entre otros) 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 el XML, generará también la huella de seguimiento y el QR, y procesará el envío a Hacienda
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 POST
Envía la cabecera de tu factura en formato Json para obtener información sobre si la factura ha sido enviada y procesada por Hacienda.
Request – Tipo Json , ejemplo de un Json
{
"nif": "13131313S",
"factura": {
"prex": "F2021",
"number": "80"
}
}Response – XML
3 - Obtener Huella
Envía la cabecera de tu factura en formato Json para obtener el código de huella si la factura ha sido enviada y procesada por Hacienda
Conector POST
Request – Tipo Json , ejemplo de un Json
{
"nif": "13131313S",
"factura": {
"prex": "F2021",
"number": "80"
}
}Response – Texto (Huella)
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 por Hacienda
Conector POST
Request – Tipo Json , ejemplo de un Json
{
"nif": "13131313S",
"factura": {
"prex": "F2021",
"number": "80"
}
}Response – QR en formato png