Preguntas frecuentes API Verifacti

Nuestra API está pensada para desarrolladores con el reto de adecuar su software a Veri*Factu. Entre nuestros usuarios hay fabricantes e integradores de ERPs, softwares de facturación, software TPVs, desarrolladores de apps móvil, consultorías tecnológicas y proveedores de software de todo tipo, así como responsables de IT de empresas individuales que buscan adecuar su software de facturación.

Sí. Puedes crear una cuenta en segundos y acceder a una empresa de prueba desde la cual puedes hacer ya mismo llamadas de prueba al entorno de test de la administración. Podrás hacer parte o incluso toda tu integración desde nuestra cuenta gratuita.

Sí. Desde Verifacti vamos a dar respuesta a las necesidades que surjan entorno a la factura electrónica una vez se haya desarrollado el reglamento.

Sí. Desde Verifacti también te ayudamos a cumplir con Ticketbai. Con muy poco trabajo de integración extra podrás cumplir con los requisitos de cualquiera de las haciendas forales del País Vasco.

Verifacti destaca como una solución inmejorable para el reto Veri*Factu por varios motivos, entre otros, la sencillez de la API, la claridad de la documentación, la facilidad de integración, precios competitivos y el compromiso con la atención al cliente personalizada especialmente de cara a los retos a la fase de integración.

Verifacti es una API Rest sencilla y robusta con los endpoints justos y necesarios para resolver el reto Veri*Factu.

De manera resumida, la API de Verifacti funciona de la siguiente manera:
1. Tú nos haces una petición en formato JSON con los datos de la factura
2. Nosotros te devolvemos el QR (imagen base 64) para que tú lo pintes en tu factura. La factura ya puede ser entregada al cliente final.
3. Nosotros nos encargamos en los 100 segundos posteriores de hacer llegar tu información fiscal (registro de facturación) a la administración.

Esto quiere decir que somos nosotros los que nos encargamos de todas las complejidades necesarias para hacer llegar tu información fiscal o la de tus usuarios a la agencia tributaria: generar la huella de encadenamiento, la gestión de los encolamientos y de enviar la factura a la AEAT en formato XML con un certificado digital.

En Verifacti hay dos entornos: test y producción. Al añadir una empresa (un NIF) dentro de Verifacti hay que especificar el entorno (test o producción) lo que determinará a qué entorno de la administración se envían las peticiones relativas a esa empresa.

El QR codifica una url única en la web de la agencia tributaria que se forma a partir de los siguientes datos: NIF del emisor, serie, número, importe y fecha de emisión. En esta URL la administración te confirmará si ha recibido o no la factura en cuestión.

Cuando tú haces una llamada a Verifacti con los datos de una factura, nosotros te devolvemos el QR de manera inmediata, de manera que tú lo puedes pegar a la factura. Nosotros posteriormente nos encargamos de enviar a la administración toda la información relativa a esa factura en el formato adecuado.

Con Veri*Factu no es necesario. Con el QR es suficiente. La huella debe ir incluida en el XML que se envía a la administración. La generación de dicho XML (con la huella) y su envío a la administración son responsabilidad de Verifacti. Con Ticketbai sí es necesario incluir la huella y forma parte de la respuesta de la API.

No. Si trabajas con nuestra API no será necesario que utilices certificados tuyos (o de tus usuarios). Disponemos de un certificado de representación con el cual podremos enviar tu información fiscal a la administración.

La declaración responsable es un documento que ha de estar visible en tu producto y en el cual manifiestas que cumples con Veri*Factu. Se trata de un texto legal corto para el cual podremos facilitarte un borrador. Nosotros también estaremos obligados a contar con esta declaración responsable. Este documento debe indicar la numeración de tu software.

No. Para cumplir con Veri*Factu no es necesario pasar ningún proceso de homologación. Es suficiente con publicar la declaración responsable.

Si trabajas con modo Veri*Factu entonces no es obligatorio conservar los registros de facturación (la información fiscal enviada a la agencia tributaria).

Si trabajas en modo No-Verifactu, entonces sí que hay obligaciones de conservación.

Lo anterior no exime a los softwares de facturación ni a los contribuyentes de aquellas obligaciones de conservación derivadas del reglamento de facturación o cualquier otra norma. Dichas obligaciones anteriores a Veri*Factu no se ven alteradas y siguen existiendo.

No. Tú únicamente nos haces peticiones en JSON a nuestra API. Nosotros nos encargamos del resto: primero te damos el código QR y luego generamos la huella de encadenamiento, gestionamos los encolamientos y enviamos tu información fiscal a la AEAT en formato XML con un certificado digital.

Con Veri*Factu eso no es posible. El motivo es que la administración ha impuesto unos límites a la cantidad y tiempos de las peticiones y es frecuente que una petición realizada a nuestra API tarde hasta 100 segundos en ser enviada a la administración. Por ese motivo nuestra API devuelve el QR de manera inmediata y posteriormente tarda uno o dos minutos en hacer llegar el registro de facturación a la administración.

Se puede hacer manualmente desde la pantalla de inicio de Verifacti o a través de la API de gestión de NIFs. Podrás crear NIFs en los entornos de test o producción, desactivarlos, volver a activarlos posteriormente entre otras acciones.

Tienes un plan gratuito sin límite de tiempo que incluye un NIF del entorno de test. Esto es suficiente en muchos casos para realizar la totalidad o la mayor parte de la integración.

Verifacti funciona con un modelo de suscripción con pagos recurrentes mensuales o anuales según tu plan.

El coste (mensual o anual) de la API Verifacti depende del número de NIFs que tengas activos en el entorno de producción (número de contribuyentes reales). Para los 20 primeros NIFs, los precios están disponibles en la página de precios. A partir de 20 NIFs podemos hacerte una propuesta en función de tus necesidades (usar para ello el formulario de contacto).

Además, si quieres contar con más de un NIF en el entorno de test para realizar pruebas (el primero es gratuito), existe un coste reducido (equivalente al coste del primer NIF en producción) y que te permitirá crear múltiples NIFs en el entorno de test para tus pruebas.

Los precios comunicados en la página de precios incluyen varios miles de facturas al mes por NIF. En caso de superarse esta cifra, la operativa no se interrumpe, sencillamente se añade a la factura de Verifacti una cantidad variable por las facturas adicionales no cubiertas por el plan. Puedes ver datos específicos en la página de precios.

El coste unitario por NIF va bajando a medida que se añaden NIFs. A mayor volumen de NIFs, cada NIF sale más barato.

No. Pagarás solamente lo que uses y el tiempo que lo uses. No tendrás que pagar ningún coste de instalación y podrás dejar de usar el servicio cuando quieras.

Sí. Si te compromentes a un año de uso, entonces hay unos descuentos del 10%. Esto exige un compromiso de permanencia para cada NIF que añadas de un año. El año se contaría desde la fecha en la cual creaste tu suscripción anual (fecha en la cual te convertiste en cliente de pago), o desde la última fecha de renovación de tu plan anual.

Sí. Cuando creas una suscripción con nosotros eso te da derecho a un número determinado de NIFs, independientemente de en qué hacienda tributen esos NIFs. Para cada NIF creado deberás especificar en qué hacienda tributa ese NIF.

Sí. Contamos con una API para gestionar la activación y desactivación de NIFs. Esta API, que está incluida en el precio, es indispensable para softwares con cientos o miles de usuarios (NIFs).

No necesariamente. El plan gratuito cuenta con una empresa ya creada en el entorno de test desde la cual puede hacerse la integración sin coste en su totalidad.

Únicamente te pediremos que pagues en la fase de integración si quieres añadir empresas adicionales al entorno de test. El coste por añadir empresas adicionales en el entorno de test sería un coste único reducido (equivalente a pagar un único NIF en producción).

Dicho de otro modo: pagando una cantidad reducida (equivalente al coste de un NIF en producción) puedes crear múltiples NIFs en el entorno de test para ayudarte a integrar.

Si desactivas un NIF antes de que termine el periodo por el cual has pagado, entonces podrías volver a activarlo sin coste durante el periodo restante.

No. Los precios de Verifacti son por contribuyente (NIF) e independientes del número de TPVs y/o locales desde los cuales se emitan las facturas. Somos una API en la nube que no requiere instalación local de software de ningún tipo.

Estas son las posibles etapas de pagos que tiene por delante un software de facturación o ERP:
1. Puede realizarse la totalidad o gran parte de la integración con la empresa de prueba de la cuenta gratuita.
2. En caso de querer hacer la integración con más de un NIF de test, sería necesario un pago reducido (equivalente al coste de un NIF en producción) para poder crear múltiples NIFs en el entorno de test de cara a hacer pruebas.
3. A partir de Julio de 2025, a medida que los usuarios pidan incorporarse a Veri*Factu se producirá un aumento gradual del número de NIFs en producción y por lo tanto del coste.
4. Una vez Veri*Factu sea obligatorio para el contribuyente, el software deberá incorporarlo para todos los usuarios generando un aumento del número de NIFs de la suscripción y por lo tanto del coste.
5. A medida que los usuarios se den de alta o de baja del software, el número de NIFs (y por lo tanto el coste de la suscripción) irá ajustándose al alza o a la baja.

Por lo general, la integración consta de dos fases.

1. En la primera fase debes conseguir enviar a nuestra API los JSON correspondientes a las interacciones de facturación en tu software (un JSON para la creación de factura nueva, un JSON para la rectificación, etc). Esta fases suele durar de uno a tres días a tiempo completo por parte de un desarrollador.

2. En la segunda fase debes comenzar a enviar peticiones (idealmente peticiones reales de la actividad en tu base de datos) al entorno de test de la administración y debes estar atento a las respuestas para corregir cualquier error que te indique la administración. Esta fase puede durar unos pocos días a tiempo parcial por parte de un desarrollador.

Sí. Puedes registrarte ya en segundos y acceder a la cuenta gratuita en la cual tienes un NIF de prueba para hacer peticiones al entorno de prueba de la administración. No es necesario que te enviemos credenciales puesto que puedes registrarte tú con email y contraseña en segundos cuando quieras.

En la mayor parte de los casos la integración queda realizada con el trabajo de un solo desarrollador en uno a tres días a tiempo completo, y posteriormente unos días adicionales a tiempo parcial.

Sí. Nos distinguimos por participar activamente en la fase de integración, respondiendo con celeridad a las dudas de nuestros usuarios por teléfono y por email.

Sí. En la documentacion de las APIs encontrarás las colecciones de Postman para descargar.

Sí. Tenemos clientes con miles de NIFs y millones de facturas al mes. Nuestra API está en la nube, es escalable y está preparada para absorber grandes volumenes de NIFs y facturas.

Podría suceder que algún problema técnico a cualquier nivel (contribuyente, software facturación, API Verifacti o API administración) impida que se haga llegar a la administración las facturas en tiempo real a la administración. La administración contempla explícitamente escenarios tales como, por ejemplo, una caída de internet del emisor de la factura. La expectativa de la administración en estos casos problemáticos es que que la operativa (facturación) no debe verse interrumpida, es decir, el contribuyente debe continuar facturando incluso si las facturas que emite no llegan correctamente a la administración en tiempo real. La administración aclara que una vez resuelta la incidencia el contribuyente debe hacer llegar todas las facturas que no hayan sido comunicadas tan pronto sea posible, y dispone para ello de un campo 'incidencia' que está disponible también en la API Verifacti.