​
Servidores

El servidor de producción estará disponible cuando Veri*Factu habilite su propio servidor de producción.
Las URL base de los servidores de producción y de pruebas son las siguientes:
  • Servidor de producción: https://api.kubifactu.com
  • Servidor de pruebas: https://devapi.kubifactu.com

​
Autentificación

Para poder procesar registros de facturación, nuestra API requiere que se identifique a la empresa emisora mediante API-KEY: se trata de una clave que es necesario incluir en los encabezados HTTP de las peticiones. Esta clave se puede encontrar en nuestro panel dentro de la ficha de cada empresa. Consulta la referencia de la API para saber cómo incluir el encabezado HTTP de identificación de la empresa. Las empresas se pueden dar de alta bien desde el panel web (sección Empresas) o bien vía API.

​
Certificados

La firma de las comunicaciones con la AEAT debe firmarse con un certificado autorizado. Nosotros hacemos las veces de intermediarios, con lo que no es necesario tener un certificado para cada empresa cliente que emite registros de facturación a la AEAT. Además, cada intermediario puede optar por usar su propio certificado (en lugar del nuestro) para la firma de las comunicaciones. Para ello, el intermediario debe estar registrado como apoderado o colborador social en la AEAT.

​
Los registros de facturación

Los registros de facturación son los envíos que se hacen a Veri*Factu (AEAT) para el alta, subsanación y anulación de facturas.

​
Obligatoriedad del envío de las facturas a Veri*Factu

Salvo en el caso de los registros de facturación diferidos, el registro de facturación se genera en el momento en que la los datos de la factura son remitidos a nuestro sistema. Tras la generación del registro de facturación este se envía a Veri*Factu (AEAT) para su validación y registro. La fecha de expedición de la factura debe coincidir con la de generación del registro de facturación, es decir, la factura debe sernos enviada en la misma fecha en que es expedida. Además, la factura debe ser entregada al receptor (ya sea en versión impresa o digital) con un QR de cotejo que le permita verificar que la factura ha sido correctamente remitida a la AEAT.
El QR de cotejo lo genera nuestro servicio una vez recibida y procesada la factura adecuadamente.

​
Registros de facturación diferidos

La Agencia Estatal de Administración Tributaria (AEAT) impone ciertos límites al número de solicitudes que un obligado tributario (un CIF/NIF de empresa) puede realizar en un período de tiempo determinado. Actualmente, el límite predeterminado es de una solicitud cada 60 segundos. Para gestionar esto, proporcionamos dos campos de respuesta, next_request_waiting_time y next_request_datetime, que indican el tiempo de espera necesario antes de enviar otra solicitud. En caso de que se emitan múltiples registros de facturación en el margen de tiempo especificado, ofrecemos una función de envío de registros de facturación en diferido. En tales casos, nuestro sistema genera los datos mínimos esenciales requeridos, como códigos QR y otros elementos necesarios, para los registros de facturación. Sin embargo, en lugar de enviarlos inmediatamente a la AEAT, espera hasta que hayan transcurrido los márgenes de tiempo especificados por la AEAT para el emisor respectivo. El envío de registros de facturación en diferido se realiza utilizando los mismos datos que en los registros de facturación no-diferidos, pero apuntando a URLs diferentes. Por ejemplo:
  • URL de alta de facturas no-diferidas: …/api/invoices
  • URL de alta de facturas diferidas: …/api/invoices/deferred
  • URL de anulación de facturas no-diferidas: …/api/invoices/{ID}/cancel
  • URL de anulación de facturas diferidas: …/api/invoices/{ID}/deferredcancel
Una vez el registro se ha enviado y se ha obtenido la respuesta de la AEAT, se envía la información de respuesta en formato JSON a la URL indicada en el campo callback_url indicado en la petición de alta o anulación de registro de facturación. Para más información consulta las correspondientes APIs de envíos y anulaciones de facturas.
En el caso de un registro de facturación “normal” se obtiene el resultado de aceptación por parte de la AEAT de forma inmediata, mientras que para un registro de facturación en diferido se debe esperar a que nuestro sistema haga el envío y se procese la respuesta de la AEAT. En este punto el registro puede ser aceptado, aceptado con errores o rechazado.
Si la empresa cliente no necesita emitir registros de facturación por debajo de los márgenes de tiempo indicados por la AEAT (por defecto, un registro cada 60 segundos), es más simple y directo emitir registros de facturación “normales”, es decir, NO DIFERIDOS, ya que la validación por parte de la AEAT se realiza de forma directa, sin esperas ni procesos de callback.

​
Encadenamiento (trazabilidad) y SIFs

La trazabilidad se refiere a que se pueda garantizar que no hay “huecos” o “saltos” en la secuencia de generación de los registros de facturación correspondientes a las facturas expedidas utilizando un determinado Sistema Informático de Facturación (SIF), así como que dicha secuencia se corresponde con la de la fecha y hora de generación empleadas. Los registros de facturación se encadenan de forma independiente dentro de cada SIF y para cada empresa que emita facturas. Es decir, existe una única cadena de registros de facturación por cada par de valores distintos de SIF y empresa emisora de facturas. Así, cada centro de facturación (por ejemplo, cada tienda de una misma empresa) puede operar como un SIF independiente.
Un SIF puede procesar registros de facturación de diferentes empresas.
Una empresa puede tener uno o varios SIFs. Por ejemplo, una empresa con varias tiendas puede operar con un SIF por cada establecimiento, de forma que el encadenamiento/trazabilidad de las facturas se trate por separado, pero no es obligatorio hacerlo.
Nuestro sistema se encarga de generar los datos de encadenamiento de forma automática en base a las facturas previamente procesadas para los correspondientes SIFs y empresas.

​
Rectificaciones, subsanaciones y anulaciones

  1. Si los errores detectados tras la emisión están previstos en el Reglamento de Obligaciones de Facturación (ROF), aprobado por el Real Decreto 1619/2012, deberá efectuarse su rectificación de acuerdo con el procedimiento que indique el ROF según el tipo de error de que se trate, lo que implica expedir nueva/s factura/s rectificativas de la factura original errónea, en la/s que se pondrán los códigos de los campos de RF qué le/s corresponda/n de entre los que se detallan en la OM HAC/1177/2024.
  2. Si los errores detectados tras la emisión NO están contemplados en el ROF, pero afectan a campos del registro de facturación (RF) generado al emitir la factura (que, digamos, “no se ven” en la factura impresa, es decir, son campos “internos”, como ciertas codificaciones tributarias), se debe corregir la factura original (esos datos “internos” de la misma) y se debe generar un RF de alta de subsanación de esa factura donde conste ya la nueva información que proceda. Por lo que se refiere al concepto de subsanación, este se produce cuando se detecta un error en algún dato del RF cuyo “arreglo” no suponga tener que emplear el procedimiento de rectificación de la factura según el ROF. En este caso, bastará con “reparación o subsanación” de los datos erróneos que había en del registro original mediante la generación de un nuevo registro de alta de subsanación (que tendrá ya los datos correctos).
  3. Si los errores detectados tras la emisión NO están contemplados en el ROF ni afectan a campos del registro de facturación (RF) generado al emitir la factura, se corrige la factura original sin que sea preciso generar un nuevo RF de ningún tipo.
  4. Si se considera que “toda la factura” en sí misma está mal o no debería haberse emitido, siempre que para solucionarlo no deba emplearse algún procedimiento (de rectificativa u otro) previsto en el ROF, se podrá “anular” generando para ello un RF de anulación.
Con carácter general, todas las facturas emitidas, en la medida en que respondan a operaciones realmente efectuadas (como es el caso habitual) no pueden anularse. En el caso de que exista alguna diferencia entre lo facturado y la realidad, por ejemplo, que por un defecto de cantidades o de calidades, o por otras razones, y se deba modificar su importe, procederá la emisión de una factura rectificativa, en los términos que establece el ROF (Reglamento de Obligaciones de Facturación, aprobado por el Real Decreto 1619/2012) y la Ley y Reglamento del IVA. Esa rectificación, con carácter general, puede realizarse por medio de la sustitución de la factura inicial por una nueva factura o bien por la modificación de la factura inicial.