Subir fichero manualmente

Para cuando algún proceso automático falle y haya que subirlo a mano. Admite .txt/.csv (tabulador) o .xlsx.

Subir como

Tipo

Realm

Ejercicio (opcional)

Fichero

Elegir fichero Ningún fichero seleccionado

Crear API Key

Cliente

Usuario

Subir por POST

Acceso Panel sus Ficheros

Acceso Admin

Subir por POST: solo puede llamar al endpoint de subida de ficheros, no entra al panel web. Acceso Panel sus Ficheros: entra al panel (solo ve Ficheros), puede subir y bajar a mano pero no eliminar, y solo ve lo que subió esta misma api key. Acceso Admin: acceso total (incluye eliminar ficheros y gestionar api keys, schemas, tablas, etc.).

Realms autorizados (para Subir/Bajar)

Clave manual (opcional)

Crear schema

Un Schema se crea a partir de un realm que ya exista en algún fichero subido, y mapea a un schema de Postgres en Supabase. El realm no se puede cambiar después de creado.

Realm

Schema en Supabase

Descripción (opcional)

Nombre de organización (opcional)

Activo

Expuesto en la API REST de Supabase

Crear tabla

Cada tabla pertenece a un Schema concreto (y por tanto a un realm) y a un tipo de fichero. El realm y el tipo no se pueden cambiar después de creada. Los campos de la tabla se gestionan aparte, en "Campos".

Schema

Tipo

Tabla en Supabase

Descripción (opcional)

Activo

Sincronizar automáticamente al subir un fichero

Full de seguridad cada sincronizaciones automáticas en delta (0 = nunca por ciclo)

Crear dimensión

La tabla destino se borra y se recrea entera con el resultado del comando cada vez que se genera -- no hace falta que el comando sea un "SELECT" simple, puede llevar WITH, UNION, joins... El Schema no se puede cambiar después de creada.

Schema

Nombre (tabla destino)

Activa

Descripción (opcional)

Comando

Tablas disparadoras

Cuando termine bien una sincronización (delta o full) de cualquiera de estas tablas, la dimensión se regenera sola.

Nuevo cliente de API

Un cliente de API es un tercero externo con su propia clave: solo lectura en los schemas que marques abajo, y lectura/escritura completa en hasta 2 schemas propios suyos (nombre libre -- se crean automáticamente en Supabase si no existen).

Nombre

Schemas propios (lectura y escritura completa, hasta 2)

Lectura y escritura completa (tablas, filas, estructura) solo para el propio cliente en estos schemas -- tú puedes leerlos y modificarlos también con la clave de administración. Cambiar el nombre de un schema ya creado lo renombra en Supabase (conserva los datos); el botón "×" lo elimina de forma permanente.

Schemas de lectura

Clave de API

Se puede volver a consultar en cualquier momento (no caduca ni cambia salvo que revoques el acceso).

Prueba de permisos

Comprobaciones reales de solo lectura (has_schema_privilege / has_table_privilege / pg_has_role) ejecutadas directamente en Supabase -- no modifican ningún dato.

	Comprobación	Detalle

Consulta SQL

Ctrl+Enter también ejecuta.

Escribe una consulta y pulsa "Ejecutar".

Vista agrupada

Compacto

Ver campos de negocio

Documentación

Cualquiera con este enlace podrá ver la documentación, sin necesidad de api key. Podrás revocarlo cuando quieras.

Revocar invalida este enlace para siempre; si vuelves a compartir se genera uno nuevo.

Guía de subida de ficheros

Cualquiera con este enlace podrá ver esta guía, sin necesidad de api key. Podrás revocarlo cuando quieras.

Revocar invalida este enlace para siempre; si vuelves a compartir se genera uno nuevo.

Ejemplos SQL

Este cliente todavía no tiene ningún ejemplo SQL guardado -- pulsa "+ Nuevo ejemplo" para crear el primero.

Nombre

Contenido

Guardar consulta SQL

Se guarda junto a este cliente de API. Si ya existe una consulta guardada con el mismo nombre, se sobrescribe.

Nombre

La consulta está tardando

Sincronización

Detalle de sincronización

Añadir campo

Destino

Tipo dato

Índice

Partición

Solo los campos de tipo "date" o "timestamp" pueden ser el campo de partición.

Expresión

Descripción (opcional)

Editar expresión

Código PHP -- usa {NombreCampo} para referirte a un valor de la fila origen. Pulsa ? (en la pantalla de Campos) para ver ejemplos (encadena, etiqueta, esnulo, fechas...), o usa la lista de la derecha como chuleta rápida: un clic inserta el campo/función en el cursor.

Editar fila de ejemplo

Se usa para "Probar" las expresiones de los campos. Edita el JSON (clave: valor) y guarda.

Autopoblar campos

Esto reemplaza TODOS los campos ya configurados en esta tabla. Elige de dónde sacarlos.

Tabla origen

No hay ninguna otra tabla con campos configurados para copiar.

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.

Créditos

Desarrollado por Technology Group, SL.

Soporte: soporte@tecgroup.es
Teléfono: 916029243

Ficheros subidos

Biloop

Api Keys

Configuración

Datos generales

Conexión a Supabase

Integración Biloop

API REST de Supabase

Schemas internos publicados en la API REST

Studio (panel de administración)

Informe por email (cuadro de mando)

Schemas

Tablas

Campos

Dimensiones

Logs de sincronización

Clientes API

Explorador de ficheros

Ficheros subidos

Biloop

Nueva tarea Biloop

Log de ejecuciones

Api Keys

Configuración

Datos generales

Conexión a Supabase

Integración Biloop

API REST de Supabase

Schemas internos publicados en la API REST

Studio (panel de administración)

Informe por email (cuadro de mando)

Vista previa del informe

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