Guía de la consola

La consola de Boty Invoice (/consola) es el espacio de trabajo del despacho: desde ahí das de alta a tus clientes gestionados, creas sus series de numeración, sellas facturas de ensayo y verificas la integridad de cada cadena.

Todo es sandbox

Toda la consola opera en modo sandbox (Fase 0). Un aviso no descartable lo recuerda en cada pantalla. Ninguna factura sellada aquí tiene validez legal ni fiscal. Ver El sandbox del piloto.

Acceso

• Necesitas iniciar sesión y tener membresía de operador de Boty Invoice (suscripción activa a un plan Despacho).
• Sin membresía, la consola te redirige a la página de precios.
• Si tu membresía se revoca mientras trabajas, la consola te lleva a una pantalla de “sin acceso” que lo explica — nunca a un error genérico.

Panel

La pantalla inicial muestra el nombre de tu despacho, tu rol y tu plan, junto a dos contadores reales leídos de la API: clientes activos y facturas selladas. Si los datos no se pueden cargar, verás un estado de error honesto — nunca un cero inventado.

Cartera de clientes

Ruta: /consola/clientes.

Lista todos los clientes gestionados del despacho. Por defecto muestra solo los activos; la casilla “Mostrar archivados” añade los archivados, cada uno etiquetado visiblemente como “Archivado”.

• Estado vacío. Un despacho sin clientes ve “Aún no tienes clientes” y el enlace para dar de alta el primero — nunca una tabla en blanco.
• Estado de error. Si la carga falla, la pantalla muestra un mensaje de error e invita a reintentar — nunca una lista vacía que parezca una cartera genuinamente sin clientes.

Facturas

Ruta: /consola/facturas.

Lista global de todas las facturas selladas del despacho (serie, número, fecha, cliente, total). Cada fila enlaza al detalle de la factura. Punto de entrada de la facturación cuando no partes de la ficha de un cliente concreto.

Alta de cliente gestionado

En Cartera → Nuevo cliente registras un cliente con dos campos: razón social y NIF/CIF/NIE.

• El NIF/NIE se valida con el dígito de control (mod-23) antes de enviar nada; el CIF se valida solo por formato. El servidor revalida siempre.
• Si el NIF ya existe en tu despacho, el formulario lo marca como error de campo (no se crea un duplicado).
• Si alcanzaste el límite de clientes gestionados de tu plan, un aviso te lo dice con claridad; ampliar el plan es la única vía para seguir dando de alta.

Ficha de cliente

Cada cliente gestionado tiene su ficha con:

• Series de numeración — lista y creación de series (código + tipo: ordinaria, rectificativa o simplificada). La numeración la asigna el servidor; la consola nunca inventa un número.
• Historial de facturas — cada fila abre el detalle de la factura sellada.
• Verificación de la cadena — un botón que re-verifica la cadena de hashes de ese cliente y muestra el resultado: “Cadena verificada — íntegra” o “Cadena rota — no verificada”, indicando en qué factura se detectó la rotura. Cada cliente tiene su propia cadena, aislada de las demás.

Nueva factura: previsualizar y sellar

Desde la ficha del cliente, Nueva factura abre el flujo de emisión:

1. El emisor es el propio cliente gestionado — fijado, no editable.
2. Completas el receptor (razón social, NIF/CIF/NIE, país), la serie, la fecha y las líneas (concepto, cantidad, precio unitario, categoría de IVA y tipo).
3. La previsualización del motor fiscal calcula base imponible, cuota de IVA y total en el servidor — la consola nunca calcula totales por su cuenta. Cuando cambias una línea, la previsualización se actualiza automáticamente; el botón de sellar queda bloqueado hasta que los nuevos totales estén listos.
4. Sellar en sandbox registra la factura de forma definitiva en la cadena de ese cliente.

Una factura sellada es inmutable

No existe editar ni borrar una factura sellada — en ninguna pantalla ni en la API. La única corrección posible es emitir una rectificativa.

Detalle de la factura sellada

El detalle muestra el registro completo: emisor y receptor, líneas, desglose de IVA, totales, y la sección de integridad y cadena (hash del registro, hash del cuerpo, hash anterior, algoritmo SHA-256 y versiones de cadena y motor).

• El código de verificación (QR) se muestra como enlace de texto, enmarcado “SANDBOX — sin validez legal”. No se genera imagen escaneable en esta fase.
• Puedes exportar la factura como Facturae 3.2.2 (XML) o UBL 2.1 (XML). Ambos ficheros llevan un marcador de sandbox en su contenido: no son válidos como factura.

Rectificativa

Desde el detalle de una factura sellada, Emitir rectificativa:

• El emisor y el receptor se toman de la factura original — no editables.
• Necesitas una serie de tipo rectificativa para ese cliente; si no existe, la consola te pide crearla primero en la ficha del cliente.
• El motivo de la rectificación es obligatorio: sin motivo no se envía ninguna solicitud.
• La rectificativa se sella como documento nuevo (tipo 381) enlazado a la original. La factura original nunca se modifica.

Panel de conformidad

Conformidad resume el estado real de tu emisión: entorno (sandbox), versión de encadenamiento, estado de la cadena del registro más reciente (re-verificado en cada visita) y la línea de declaración responsable, que hoy dice la verdad: no se ha emitido ninguna declaración responsable todavía. Sin registros sellados, cada valor muestra “sin registros todavía” en lugar de un dato inventado.

Ayuda guiada de primer uso

El botón ”?” de la barra superior abre el panel de ayuda: el tour de la pantalla actual, la lista de todos los tours disponibles y dos preferencias explícitas (tours guiados / datos de ejemplo), cada una con “Sí”/“No”.

Tours por pantalla. Cada uno de los cuatro destinos del menú (Panel, Cartera, Facturación, Conformidad) tiene su propio tour. El primer tour arranca automáticamente la primera vez que llegas a la consola; después solo lo hace si lo pides desde el botón de ayuda.

“Primeros pasos”. Panel persistente con cuatro tareas de arranque: dar de alta el primer cliente, crear una serie de numeración, sellar la primera factura de ensayo y probar una rectificativa. Cada tarea se marca completada según el estado real de la cuenta — nunca por una marca guardada localmente.

Modo de ejemplo (Cartera, Facturas y Panel). Mientras la cartera no tiene clientes activos, /consola/clientes, /consola/facturas y el Panel muestran datos de ejemplo con un aviso visible — “Estás viendo datos de ejemplo. No son datos reales de tu despacho.” — que desaparece en cuanto das de alta tu primer cliente real o pulsas “Salir del modo de ejemplo”. La pantalla de Conformidad nunca muestra datos inventados.

Datos de ejemplo

Desde /consola/clientes, el botón “Generar datos de ejemplo” crea filas reales a través del mismo motor de sellado: 3 clientes gestionados y 8 facturas selladas en 4 series (7 ordinarias y una rectificativa de ejemplo). Los datos de ejemplo funcionan en el sandbox igual que los datos reales.

• Marca de ejemplo. Cada cliente generado lleva una etiqueta visible “Ejemplo” junto a su nombre. Esta marca no aparece en ningún fichero exportado (Facturae/UBL).
• Límite del plan. Los clientes de ejemplo cuentan contra el cupo del plan. Si generarlos lo superaría, la consola lo rechaza con un mensaje claro — nunca genera un subconjunto recortado.
• Un solo lote. Si ya existe un lote de ejemplo, la consola lo indica y señala el botón “Eliminar datos de ejemplo”.
• “Eliminar datos de ejemplo” archiva, no borra. Los clientes pasan a estado “Archivado” y desaparecen de la vista activa, pero siguen siendo visibles marcando “Mostrar archivados”, con sus facturas intactas. Ninguna acción de la consola borra un registro fiscal ya sellado.

Captura de datos por foto

El botón “Rellenar desde una foto” solo aparece cuando la capacidad de lectura de documentos está configurada en la plataforma. Si no lo está, los formularios funcionan igual sin ningún botón deshabilitado.

La IA nunca sella una factura. Leer una foto solo puede rellenar campos editables que el gestor revisa y confirma manualmente.

Alta de cliente (/consola/clientes/nuevo). El botón “Rellenar desde una foto (DNI/CIF)” rellena la razón social, el NIF/CIF/NIE y la dirección como valores editables del formulario. El gestor sigue teniendo que pulsar “Registrar cliente”; la lectura no crea ningún registro por sí sola.

Nueva factura (/consola/clientes/:id/facturar). El botón “Rellenar desde una foto de la factura” guarda un borrador editable con los datos leídos y navega a él. Los importes nunca se leen de la foto — se calculan siempre con el motor fiscal.

Cuando la foto no se puede leer. La pantalla muestra “No se pudo leer el documento. Rellena los datos manualmente.” y el formulario queda tal como estaba.