Ficheros subidos

Realm

Tipo

Quitar filtros

Fecha de subida

Fecha	Tipo	Realm	Ejercicio	Fichero	Origen	Cols	Filas	Cliente	Descargar

Biloop

Nombre	Tipo	Realm	Programación	Última ejecución	Activa

Fecha	Estado	Mensaje	Filas

Api Keys

Haz clic en una fila para editarla.

Cliente	Usuario	Api Key	POST	FICHEROS	ADMIN	Realms	Activa	Creada

Configuración

Ajustes generales de la aplicación y conexión de sincronización a Supabase.

Datos generales

Título y créditos que se muestran en la barra lateral y en la pantalla de créditos.

Título de la aplicación

Empresa (créditos)

Email de soporte

Teléfono de soporte

Logo

Elegir imagen Ningún archivo elegido

SendGrid (remitente de los emails)

Remitente y API Key con los que se manda cualquier email de la app por SendGrid (no SMTP) -- hoy, el "Informe avance" (ver ese menú para el resto de su configuración: asunto, plantilla, KPIs). Es el MISMO remitente/API Key en los dos sitios -- este bloque está aquí duplicado solo por comodidad, para no tener que ir a "Informe avance" si solo hace falta cambiar esto.

Remitente (nombre)

Remitente (email)

API Key de SendGrid

Conexión a Supabase

Conexión directa a la base de datos Postgres de Supabase, usada por el worker de sincronización.

Host

Puerto

Base de datos

Usuario

Contraseña

SSL

Superusuario para operaciones administrativas (crear/revocar roles de "Clientes de API"). Se usa SOLO para eso -- el resto (sincronización, tablas) sigue usando el usuario de arriba. Normalmente postgres.

Usuario superusuario

Contraseña superusuario

Integración Biloop

Conexión con la API de Biloop para la captura automática de diario y plan de cuentas (pantalla "Biloop").

URL base

Usuario

Subscription key

Contraseña

Endpoints (avanzado)

Token

Diario

Plan de cuentas

CIF para la prueba (opcional)

API REST de Supabase

URL y claves de la API de Supabase (Kong), independiente de la conexión directa a Postgres de arriba. Se usará para comprobar que lo que hay en MongoDB y lo que ve la API de Supabase están alineados.

URL de la API

URL interna de la API (opcional, red Docker)

Solo hace falta si este propio servidor y Supabase corren en la misma red Docker y la URL pública de arriba no es alcanzable desde dentro (mismo problema de "hairpin NAT" que ya se ve a veces desde el navegador, pero aquí para las llamadas que hace el propio backend -- por ejemplo, "Informe por email vía API"). Si se deja en blanco, esas llamadas usan la URL de arriba tal cual.

Anon key

Service role key

JWT Secret

El JWT Secret hace falta para poder firmar las claves de "Clientes de API" (menú lateral) -- es tan sensible como la contraseña de Postgres.

Schemas internos publicados en la API REST

A diferencia de los schemas de negocio (menú "Schemas": jerez, ibiza...), estos dos no están ligados a ningún realm -- se activan/desactivan directamente aquí. Igual que cualquier cambio de exposición, esto reescribe docker-compose.yml en el servidor y reinicia los contenedores "rest" y "studio" (tarda varios segundos).

comun -- funciones compartidas (incluida ejecutar_sql, usada por "API Test" y por los clientes de API con SQL libre)

public -- schema por defecto de Postgres/PostgREST

Studio (panel de administración)

Acceso directo a Supabase Studio, protegido con usuario/contraseña delante de Kong. Guárdalos aquí para abrir Studio con un clic en vez de teclearlos en el diálogo del navegador.

URL de Studio

Usuario

Contraseña

Informe avance

Configuración y envío automático (por cron) del informe periódico del cuadro de mando -- antes vivía dentro de "Configuración".

Informe por email (cuadro de mando)

Envío del informe periódico por correo vía la API HTTPS de SendGrid (no SMTP). El contenido se organiza en tarjetas (de momento solo "Producción"); el asunto y el wrapper admiten variables de fusión: {semana}, {anio}, {fecha}, {fecha_larga} ("5 de septiembre de 2026"), {realm}, {schema_organizacion} (nombre "para humanos" del schema, en Proper case -- se configura en "Schemas" al crear/editar cada uno; por defecto es el nombre del schema).

El remitente y la API Key de SendGrid de aquí abajo son los MISMOS que en Configuración → "SendGrid (remitente de los emails)" -- cambiarlos aquí o allí es indistinto, se guardan en el mismo sitio.

Remitente (nombre)

Remitente (email)

API Key de SendGrid

Asunto

Cuerpo (wrapper HTML) -- debe incluir el marcador {{CONTENIDO}} donde se insertan las tarjetas

Suavizar la curva del gráfico (media móvil)

Semanas hacia atrás para los ratios €/hora

Producción/hora y Gastos/hora ya no dividen el importe de una semana entre las horas de esa misma semana -- se suma el importe y las horas de esta ventana de semanas hacia atrás (se acorta sola si no hay tanta historia) y se divide esa suma. Un número más alto da un ratio más estable pero menos sensible a cambios recientes.

KPIs incluidos en el informe -- arrastra para ordenar

El orden de esta lista es el orden en el que aparecen las tarjetas en el correo.

Schema para probar

Email de prueba

Envío automático (reglas)

Cada regla manda este informe solo (schema propio, destinatarios propios) según su propia programación semanal -- se ejecuta por cron, ver worker_informe_avance_email.php. La configuración de arriba (remitente, plantilla, KPIs) es COMÚN a todas las reglas.

Nombre	Schema	Para	CC	Programación	Último envío	Activa

Schemas

Haz clic en una fila para editarla.

Realm	Schema Supabase	Descripción	Activo	En API REST	Actualizado

Tablas

Haz clic en una fila para editarla.

Schema

Buscar

Schema	Tipo	Tabla Supabase	Descripción	Campos	Activo	Auto-sincro	Actualizado

Campos

Elige una tabla, busca y haz clic en una fila para editarla. Solo se puede trabajar en una tabla a la vez.

Tabla

Buscar

Destino	Tipo dato	Índice	Partición	Expresión

Dimensiones

Una dimensión es una tabla de Supabase generada por completo a partir de un comando SQL libre (normalmente un SELECT DISTINCT sobre una o varias tablas ya sincronizadas): se borra y se recrea entera cada vez, con todas sus columnas indexadas. Se regenera sola cuando termina bien la sincronización de alguna de sus tablas disparadoras, o a mano con "Generar ahora". Haz clic en una fila para editarla.

Schema

Buscar

Schema	Nombre	Comando	Disparada por	Último resultado	Activa

Logs de sincronización

Resumen de estado de cada sincronización ya terminada (forzada desde el panel o automática por subida de fichero). Haz clic en una fila para ver todo el detalle. Se conservan los últimos 30 días.

Filtrar por Schema

Filtrar por Tabla

Filtrar por fecha

Fecha	Schema	Tabla	Modo	Origen	Resultado	Resumen	Duración

Clientes API

Terceros externos (cuadros de mando, reports) que consumen la API REST de Supabase con una clave propia: solo lectura en los schemas que se le asignen, y lectura/escritura completa en hasta 2 schemas propios suyos. Haz clic en una fila para editarla.

Nombre	Rol	Schemas propios	Activo	Schemas de lectura

Ayuda: cómo escribir las expresiones

Cada expresión es código PHP que se evalúa con eval() y debe devolver el valor final del campo. Para referirte a un valor de la fila origen, escribe su nombre de cabecera entre llaves, por ejemplo {Importe} (equivale a acceder al valor de la columna "Importe" de esa fila).

Concatenar texto: usa el operador . de PHP.

{Nombre} . ' ' . {Apellidos}

encadena(x1, x2, nexo): une x1 y x2 con el separador "nexo" solo si AMBOS tienen contenido; si alguno está vacío, simplemente los concatena sin el separador.

encadena({Calle}, {Numero}, ', ')

etiqueta(pre, x, post): devuelve "pre . x . post" solo si x tiene contenido; si x está vacío, devuelve una cadena vacía.

etiqueta('(', {Telefono}, ')')

esnulo(x, valor): devuelve x si tiene contenido, o "valor" (el valor por defecto) si x está vacío.

esnulo({Descuento}, 0)

Condicionales sencillos: usa el operador ternario ? :.

{Importe} > 0 ? 'positivo' : 'negativo'

Condicionales con if(): como la expresión debe ser un único valor, envuelve el if en una función anónima que se ejecuta al momento (capturando $c, la fila origen, con use ($c)):

(function() use ($c) { if ({Importe} > 0) { return 'positivo'; } return 'negativo'; })()

Fechas y horas para Supabase: nunca uses la fecha/hora tal cual viene del fichero -- convierte siempre con una de estas 6 funciones, que no dependen de dónde esté físicamente el servidor (no usan zona horaria ni idioma, así que dan el mismo resultado siempre y no fallan al insertar en Supabase). Usa las que empiezan por Excel2Supa cuando el origen es un .xlsx (la fecha llega como un número de serie de Excel) y las que empiezan por TXT2String cuando el origen es un .txt/.csv con la fecha ya escrita como texto "31/12/2026" o "31/12/26", hora "6:23:22" o fecha y hora "21/12/2026 23:59:59" (sin necesidad de ceros de relleno; el año puede venir con 2 o 4 dígitos -- con 2 dígitos se completa como 00-68 → 2000-2068, 69-99 → 1969-1999).

Excel2SupaFecha({fecha}) · Excel2SupaHora({hora}) · Excel2SupaTimeStamp({fecha_hora})
TXT2SupaFecha({fecha}) · TXT2SupaHora({hora}) · TXT2SupaFechaHora({fecha_hora})

Usa "Tipo dato" date con las de Fecha, time con las de Hora y timestamp con las de FechaHora. Si el valor de origen no tiene el formato esperado, devuelven un valor nulo en vez de fallar.

TXT2String(x, formato) / Excel2String(x, formato): como las 6 anteriores pero con el formato de SALIDA libre, para cuando necesitas un texto legible (no una columna date/timestamp de Supabase). TXT2String parte de una fecha en texto ("31/12/2026" o "31/12/2026 23:59:59", igual que las de arriba); Excel2String parte de un número de serie de Excel. El "formato" es una plantilla con estos tokens: YYYY (año), YY (año 2 dígitos), MM (mes 01-12, o minutos si va pegado a HH o a SS), DD (día), HH (hora 00-23), SS (segundos), MonthName (nombre del mes en castellano), DayName (nombre del día de la semana en castellano: Lunes, Martes...) y Quarter (trimestre: "1T".."4T"). El resto del texto de la plantilla se deja tal cual.

TXT2String({fecha}, 'DD/MM/YYYY') · Excel2String({fecha_hora}, 'DayName DD/MM/YYYY HH:MM')
TXT2String({fecha}, 'DD de MonthName de YYYY') · Excel2String({fecha}, 'YYYY-Quarter')

También está disponible cualquier función nativa de PHP (strtoupper, trim, number_format, substr, etc.), y las expresiones se prueban siempre contra la fila de ejemplo (real, autocargada y editable desde el botón { }) antes de guardarlas.

Índice: la casilla junto a "Tipo dato" no forma parte de la expresión -- marca si esta columna debe llevar un índice en Supabase para acelerar las consultas que filtren o agrupen por ella (por ejemplo, una fecha o un código que se busca a menudo). No marques todos los campos por sistema: cada índice de más ralentiza ligeramente cada inserción.

Partición: marca, como mucho en un campo de tipo "date" o "timestamp" por tabla, cuál es la fecha de negocio (por ejemplo, la fecha del asiento) que decide cómo se agrupan las filas para sincronizar con Supabase de forma eficiente (por año en ejercicios cerrados, por mes en el año en curso). Si ninguna columna de una tabla se marca como partición -- lo habitual en tablas de referencia o dimensiones sin fecha -- esa tabla se sincroniza troceada por bloques fijos de 200 filas en el orden de subida.

Explorador de ficheros

Ficheros subidos

Biloop

Nueva tarea Biloop

Log de ejecuciones

Api Keys

Configuración

Datos generales

SendGrid (remitente de los emails)

Conexión a Supabase

Integración Biloop

API REST de Supabase

Schemas internos publicados en la API REST

Studio (panel de administración)

Informe avance

Informe por email (cuadro de mando)

Envío automático (reglas)

Vista previa del informe

Nueva regla

Informe por email -- demo vía API

Informe avance -- vista ampliada

Schemas

Tablas

Campos

Dimensiones

Logs de sincronización

Clientes API

Subir fichero manualmente

Crear API Key

Crear schema

Crear tabla

Crear dimensión

Nuevo cliente de API

Prueba de permisos

Consulta SQL

Documentación

Guía de subida de ficheros

Ejemplos SQL

Guardar consulta SQL

La consulta está tardando

Sincronización

Detalle de sincronización

Añadir campo

Editar expresión

Editar fila de ejemplo

Autopoblar campos

Ayuda: cómo escribir las expresiones

Créditos