La consola de gestión

La consola es la cara para personas de Verifactu API: donde se da de alta la cuenta, se configuran los obligados y se ve, registro a registro, qué respondió la AEAT antes de consolidarlo en tu sistema.

Cuenta y acceso

Una cuenta es un cliente de la API (en la jerga de la API, un tenant). La creas en Crear cuenta con el nombre de la empresa, tu nombre, tu correo y una contraseña. En ese momento la consola pide a la API un tenant nuevo y recibe su clave administrativa, que guarda cifrada. Con ella hace todo lo que haces tú en el panel; nunca la verás ni la necesitarás.

Si la cuenta la creó ZC por ti (alta asistida), recibirás un enlace de activación de un solo uso, válido 48 horas, en el que eliges tu contraseña. Después entras por Iniciar sesión.

El acceso es el mismo de ONE: una sola identidad para la consola y para ONE CRM. La sesión es una cookie httpOnly emitida para .zctechpartners.cloud, así que entrar en un producto es entrar en el otro, y cerrar sesión cierra los dos. La contraseña la custodia el proveedor de identidad; la consola no la guarda ni la ve. No hay «recuérdame»: en un dispositivo compartido, cierra sesión.

Tener identidad de ONE no da consola: si tu cuenta no es cliente de Verifactu API, el acceso es correcto pero no hay panel que mostrar. La consola es de la cuenta, no de la identidad.

Panel

La primera pantalla resume la cuenta: los obligados con su estado y entorno, los últimos registros con su estado de remisión y un acceso directo a lo que suele faltar al principio (un obligado sin certificado, ninguna clave de integración creada). Arriba, junto al nombre de la empresa, se indica si la clave administrativa de la consola es de producción (live) o de pruebas (test).

Obligados

Un obligado tributario es un NIF que factura. Al darlo de alta (Obligados → Nuevo) decides tres cosas que después no se cambian:

Campo	Qué significa
NIF y razón social	Los del emisor de las facturas. Van tal cual al registro de facturación y al QR.
Entorno	Preproducción o producción. El mismo NIF puede darse de alta en los dos; ver Entornos y claves.
Vía de representación	Certificado propio: el obligado carga su certificado de representante y la API firma con él. Apoderamiento a ZC: se firma con el certificado de ZC y hace falta el apoderamiento (trámites IZ862/IZ863 de la Sede) a nombre del obligado. Colaborador social: para gestorías adheridas al convenio.

El obligado tiene un estado que resume si ya puede emitir:

Estado	Significa	Qué hacer
Falta certificado	Vía propia sin certificado cargado.	Cargar el .p12 en la ficha.
Pendiente de legitimación	Vía de apoderamiento cuya legitimación aún no se ha verificado.	Tramitar el apoderamiento y anotarlo en las notas; ZC lo verifica.
Activo	Puede emitir y remitir.	—
Bloqueado	Certificado caducado o revocado, o bloqueo por el operador.	Cargar un certificado válido o contactar.

Certificado electrónico

En la ficha del obligado se carga el fichero .p12 / .pfx del certificado de representante de la empresa (FNMT, Uanataca, Camerfirma…) con su contraseña. El fichero viaja cifrado a la custodia de la API y la consola no lo conserva. Al cargarlo se comprueba que el certificado es del NIF del obligado y su vigencia; se muestra la huella y la fecha de caducidad. Un certificado nuevo sustituye al anterior; también puede revocarse.

Series de facturación

Las series son sólo una etiqueta contable: agrupan registros para consultarlos e informar. No numeran. El número completo de cada factura (FAC-2027-0001, A/1, lo que use tu programa) lo pone quien emite, factura a factura, y viaja intacto al registro y al QR.

Registros

Cada factura emitida por la API deja un registro de alta; cada anulación, un registro de anulación. El listado se filtra por estado, tipo y obligado, y se pagina. El detalle de un registro muestra:

Número de factura, fecha de expedición, huella y huella anterior (la cadena).
El estado de remisión, con una explicación de qué significa y si requiere hacer algo.
El QR de cotejo tal como debe imprimirse, y el enlace para cotejarlo en la Sede.
El historial de envíos a la AEAT: cada intento con su resultado, código, descripción y CSV.
Qué hacer con él, en pasos. Reenviar es la única acción que se ejecuta desde aquí, y sólo cabe cuando el envío se agotó sin que la AEAT llegara a registrar nada: reintenta el mismo bloque, no crea un registro nuevo.

Un rechazo no se arregla con un botón. Si el motivo es un fallo técnico de la AEAT (cuatro códigos concretos), el sistema reemite esos mismos datos por su cuenta y no hay que tocar nada. Si el motivo es el dato —un NIF no censado, un importe descuadrado—, la corrección se emite como un registro nuevo con el dato ya corregido: el registro rechazado no se reescribe. Esa vía todavía no está abierta en la API, así que de momento el detalle del registro explica qué falla y a quién avisar, en lugar de ofrecer una acción que no existe.

Estado	Qué significa
Pendiente	Registrado y encadenado. El planificador lo remitirá a la AEAT en el próximo tick (cada pocos minutos).
Encolado / Enviando	Forma parte de un lote que ya está en la cola o en vuelo hacia la AEAT.
Aceptado por la AEAT	La AEAT lo ha aceptado. El QR es cotejable en la Sede.
Aceptado con errores	La AEAT lo ha admitido pero señala una incidencia no bloqueante. Conviene revisar el detalle; no hay que reenviar.
Rechazado	La AEAT lo ha rechazado. Si fue por un fallo técnico suyo, se reemite solo; si fue por el dato, hay que corregirlo y emitir un registro nuevo. El detalle dice cuál de los dos.
Subsanado	Se emitió un registro de subsanación que corrige a éste.
Sin reintento	Se agotaron los reintentos de envío. Requiere intervención: revisa el error y reenvía.

Los registros son inmutables: ni la consola ni la API permiten editarlos o borrarlos. Corregir es emitir una rectificativa o una anulación, que son registros nuevos encadenados a los anteriores. Es lo que exige el reglamento (art. 8) y lo que hace cotejable la cadena.

Claves API

Aquí se crean y revocan las claves con las que tu software habla con la API. Al crear una eliges nombre, perfil (integración, lectura o administración), entorno (preproducción vf_test_ o producción vf_live_) y, opcionalmente, el ámbito de obligados. La clave completa se muestra una sola vez; en el listado sólo queda su prefijo, sus capacidades y cuándo se usó por última vez.

La clave marcada como «la de esta consola» es la administrativa de la cuenta. No se puede revocar desde aquí: sin ella la consola dejaría de funcionar.

La consola tiene su propia base de datos, separada de la de la API, con un rol que no puede leer ni escribir datos fiscales. Todo lo que ves de registros y obligados lo pide a la API en el momento, con tu clave administrativa.
La clave administrativa se guarda cifrada con AES-256-GCM bajo una clave de cifrado que sólo existe en el servidor de la consola. Se descifra en memoria para cada petición y nunca llega al navegador.
Los certificados no pasan por la consola más que de camino a la custodia cifrada de la API.
Infraestructura en la Unión Europea: Vercel (Fráncfort) y Neon (eu-central-1).

← Entornos y claves

Integrar tu software →