Panel de ventas y asientos a Sage

El panel de Hub Fiscal se instala desde la Biblioteca y te da, sobre la base de datos del Hub Fiscal, todo lo necesario para ver cuánto se vende, dónde, y qué se ha contabilizado en Sage X3. Solo lee datos: no cambia nada en Hub Fiscal ni envía nada a Sage.

Qué incluye

Cinco dashboards

Dashboard	Para qué sirve
Hub Fiscal · KPIs por portal	Documentos, venta neta, IVA y notas de crédito de cada portal (mitienda.com, .it, .fr, .pt), con Canarias separada dentro de mitienda.com. Gráfico de barras, donut y tabla por portal.
Hub Fiscal · Ventas por país	Venta neta por país de destino (los 12 primeros y «Otros»), reparto y evolución diaria.
Hub Fiscal · Resumen	Visión general: totales, documentos por estado y por proveedor fiscal, y los últimos documentos.
Sage · Asientos agrupados	Lo que se envía a Sage: un asiento por día, grupo y tipo, con su estado (enviado, pendiente, fallido), la primera y la última factura y el número que devuelve Sage. Pulsa una fila para ver los documentos que incluye.
Sage · Detalle de operaciones	Busca cualquier documento por número de pedido o de factura y comprueba si ya está contabilizado. Pulsa una fila para ver el detalle completo de la operación.

Dos formularios

• Hub Fiscal: buscar un documento: escribes un número de pedido o de factura y devuelve los cinco documentos más recientes que coinciden.
• Hub Fiscal: simular la agregación a Sage: eliges un día y calcula cuántos asientos saldrían, sin enviar nada a Sage ni escribir nada en Hub Fiscal. Siempre es una simulación. Si algún asiento de ese día quedó pendiente o fallido, lo indica como «por reenviar» (la agregación real los reintenta sola en su siguiente pasada).

Además, la plantilla trae un portal con menú lateral que reúne las siete pantallas en una sola página.

Cómo se calculan las cifras

• Venta neta = facturas − notas de crédito, sobre el importe neto (sin IVA), y solo de documentos completados.
• Portal: el dominio del que viene el pedido. Canarias se separa por el código postal de envío (35xxx y 38xxx) dentro de mitienda.com.
• Sin contabilizar (en el dashboard de Sage): documentos completados, de un portal que numera Hub Fiscal (no los que numera un tercero, como Bill.pt) y que todavía no están en ningún asiento. Todo lo anterior al día de arranque de la contabilización cuenta aquí: es normal.
• Los dashboards leen la base en vivo, sin copias: lo que ves es lo que hay.

Filtros

Los dashboards llevan una barra de filtros: fechas (desde / hasta), portal, tipo (facturas o notas de crédito) y, según el dashboard, estado del asiento, búsqueda por pedido o factura y estado en Sage (contabilizado o pendiente). Los portales que ofrece el filtro «Portal» vienen fijados en la plantilla (mitienda.com, .it, .fr y .pt): edita el filtro en cada dashboard para poner los dominios de tu tienda. Funcionan también en el enlace público y puedes guardar una vista con el filtro puesto, por ejemplo …/d/<token>?portal=mitienda.it&from=2026-10-01&to=2026-10-12.

Instalación

1. Credencial. En la cuenta debe haber una credencial de Hub Fiscal (tipo MySQL) con la palabra «Hubfiscal» en el nombre, por ejemplo «MySQL Hubfiscal». Si hay varias, el panel avisa. Basta un usuario con permiso de solo lectura (SELECT).
2. Tablas de Sage. Los dashboards «Sage ·» necesitan las tablas de la agregación en la base de Hub Fiscal (schema_aggregation.sql y schema_batches.sql). Si faltan, el dashboard lo dice con un mensaje claro; los de ventas funcionan igualmente.
3. Instalar la plantilla desde la Biblioteca. Se crea una app con los dashboards, los formularios y el portal en borrador.
4. En los dos workflows de los formularios, elige la credencial de Hub Fiscal en cada nodo de Hub Fiscal.
5. Abre la app y, si quieres usar el portal, pulsa Portal → Publicar.

Datos fiscales: cuida quién ve los enlaces

Un dashboard o portal publicado muestra importes de ventas a cualquiera que tenga el enlace. En producción usa un grupo de seguridad en la carpeta de la app (los dashboards y formularios lo heredan) o deja los dashboards sin publicar y ábrelos con tu sesión. Ver seguridad de formularios y dashboards.

Servidores propios (On-Premise)

Los dashboards se alimentan de una ruta de solo lectura del motor (/api/hubfiscal-panel) que usa la credencial de Hub Fiscal de la cuenta. Un motor anterior a esa versión no la tiene y los dashboards dan error al cargar: actualiza el motor antes de instalar la plantilla.

Límites

• Cada dashboard muestra, como máximo, los 300 documentos más recientes que cumplen el filtro.
• Los dashboards no escriben datos. La contabilización real a Sage sigue en su propio workflow (cron apagado hasta que se active a propósito).
• El filtro «rango de fechas» del editor de dashboards no llega a los widgets en la vista con sesión; por eso el panel usa dos campos separados, «Desde» y «Hasta».