Manual Oficial de Usuario & Base de Datos de Ingesta

Aprende a dominar OmniCard con Google Sheets

OmniCard utiliza una hoja de cálculo en Google Sheets como base de datos de ingesta directa. Aquí aprenderás exactamente cómo construirla, qué valores colocar en cada columna, cómo se calculan las fechas de corte y diferidos, cómo configurar tus presupuestos y cómo aprovechar la analítica financiera avanzada.

1

Cómo Crear y Configurar tu Google Sheet

Paso a paso para preparar la hoja de cálculo que alimentará tu OmniCard

Paso 1.1: Crear el Archivo

Crea una nueva hoja

Entra a sheets.new en Google Drive. Nombra el archivo por ejemplo: "Control de Gastos Personales".

Paso 1.2: Crear las 2 Pestañas

Pestañas 100% Configurables

Crea dos pestañas en la parte inferior. Por defecto sugerimos:
• ConsumosTC (para compras y gastos con tarjeta).
• ConsumosCash (para pagos o abonos a tarjetas).
¡Los nombres no son obligatorios ni exactos! Si en tu hoja prefieres llamarlas distinto (ej. Gastos_TC o PagosTC), puedes configurarlas en Ajustes y OmniCard sincronizará con los nombres que elijas.

Paso 1.3: Permisos de Compartir

Acceso de solo lectura

Haz clic en el botón verde "Compartir" en Google Sheets y en Acceso General selecciona: "Cualquier persona con el enlace puede ser Lector". Esto permite al servidor descargar el CSV sin necesidad de claves API complejas.

¿Cómo obtengo el enlace para OmniCard?

Copia la URL completa que aparece en tu navegador cuando estás en la hoja. Tiene una estructura como:
https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms/edit
Esa misma URL la pegas en Ajustes de tu cuenta o al momento de registrarte.

2

Estructura de la Pestaña "ConsumosTC"

Esta pestaña contiene todos los consumos con tarjetas de crédito

La Fila 1 de la pestaña ConsumosTC debe ser la cabecera. El sistema detecta los nombres de las columnas por coincidencia de texto (no es estricto en mayúsculas/minúsculas):

Columna Nombre Encabezado Obligatorio Formato / Ejemplo Explicación & Reglas
A Fecha Correo Opcional 2026-11-05 Fecha en que llegó la notificación por correo del banco.
B Tarjeta Requerido BANCO DINERS CLUB Nombre de la entidad bancaria. Si el banco aún no existe en OmniCard, el sistema lo crea automáticamente.
C Fecha Consumo Requerido 2026-11-04 o 04/11/2026 Fecha exacta en que se realizó la compra. Soporta formatos estándar: YYYY-MM-DD, DD/MM/YYYY o MM/DD/YYYY.
D Hora Consumo Opcional 14:35:10 o 02:35 PM Hora de la transacción. Se utiliza también para la firma hash criptográfica única.
E Establecimiento Requerido SUPERMAXI QUICENTRO Nombre del comercio. Se usa para la autocategorización y reglas personalizadas.
F Divisa Opcional USD Moneda del consumo (por defecto USD).
G Valor Requerido $84.50 o 84.50 Monto del consumo. Si incluye símbolo $ o comas, el sistema los limpia automáticamente.
H Tipo de Consumo Requerido Corriente / Cuota Diferido / Gasto Fijo / Diferido Determina el comportamiento contable (ver sección 5 de diferidos).
I Cuotas Solo en Diferidos 3, 6, 12, 24 (o - para corriente) ¡Generación Automática! Si el consumo es Diferido, solo coloca aquí el número total de cuotas (ej. 6). OmniCard autogenera automáticamente todas las cuotas mensuales individuales (1/6, 2/6, etc.). Si es Corriente o Gasto Fijo, déjala vacía o con un guión (-).

Ejemplo de filas en ConsumosTC:

Fecha Correo, Tarjeta, Fecha Consumo, Hora Consumo, Establecimiento, Divisa, Valor, Tipo de Consumo, Cuotas
2026-11-01, BANCO DINERS CLUB, 2026-11-01, 10:15, SUPERMAXI QUICENTRO, USD, $85.40, Corriente, -
2026-11-02, BANCO GUAYAQUIL, 2026-11-02, 19:40, FYBECA REPUBLICA, USD, $14.20, Corriente, -
2026-11-03, BANCO BOLIVARIANO, 2026-11-03, 15:20, COMPUPALACE APPLE, USD, $450.00, Diferido, 6
2026-11-04, BANCO DINERS CLUB, 2026-11-04, 08:30, NETFLIX MENSUAL, USD, $15.99, Gasto Fijo, -

Nota: En el ejemplo de COMPUPALACE APPLE por $450.00 a 6 cuotas diferidas, OmniCard genera automáticamente las 6 cuotas mensuales de $75.00 cada una (1/6, 2/6, 3/6, 4/6, 5/6, 6/6) mes a mes.

3

Estructura de la Pestaña "ConsumosCash" (Pagos a Tarjetas)

Esta pestaña registra los pagos o abonos que realizas desde tus cuentas bancarias para liquidar tus tarjetas

Cuando transfieres dinero o pagas tu tarjeta por banca web, regístralo en ConsumosCash. OmniCard cruzará el pago con el estado de cuenta correspondiente para restar la deuda.

Columna Nombre Encabezado Obligatorio Ejemplo Propósito
A Fecha Correo Opcional 2026-11-28 Fecha de confirmación del banco.
B Fecha Transaccion Requerido 2026-11-28 Fecha en que se debitó el pago. Determina a qué período contable se imputa el pago.
C Hora Transaccion Opcional 11:20:00 Hora del pago.
D ID Transaccion Opcional TRX-948102 Número de referencia o comprobante bancario.
E Banco Origen Opcional Banco Pichincha Banco de tu cuenta de ahorros/corriente de donde salió el dinero.
G Banco Destino Requerido BANCO DINERS CLUB ¡Muy Importante! Debe coincidir exactamente con el nombre de la tarjeta en OmniCard para poder descontar el saldo.
J Monto Requerido $350.00 Monto del abono o pago total.
K Tipo de Transaccion Requerido PAGO TARJETA El texto debe contener las palabras clave pago y tarjeta para que OmniCard lo filtre y lo aplique.
4

Tipos de Ajustes y Personalizaciones en OmniCard

Todo lo que puedes configurar desde el menú de Ajustes para amoldar el sistema a tus hábitos

Días de Corte y Pago (In-Line)

Configura tus ciclos de corte por tarjeta

En Ajustes puedes editar directamente sobre la tabla:
• Día de Corte (1-31): Día exacto en que tu banco emite el estado de cuenta. Cualquier consumo posterior a este día se traslada automáticamente al mes siguiente.
• Día de Pago (1-31): Fecha límite en que debes liquidar el saldo.
• Color Distintivo (HEX): Para diferenciar de inmediato cada banco en los gráficos Donut.
• Producto / Marca: Ej. Visa Infinite, Amex Metal, Diners Sphaera.

Presupuesto y Salud Financiera

Define tus límites de endeudamiento

• Ingresos Mensuales Netos: Tu salario o ingresos líquidos disponibles en el mes (ej. \$3,500.00).
• % Asignado a Tarjetas: Porcentaje máximo de tus ingresos que decides pagar con tarjeta (siguiendo la regla financiera del 30%).
El sistema calcula tu cupo prudente mensual:
Cupo = Ingresos × (% / 100)

Categorías y Reglas de Comercios

Autocategorización y personalización

OmniCard incluye un catálogo por defecto (Supermercado, Salud, Restaurantes, etc.). Si haces clic en la píldora de categoría de cualquier consumo en el Dashboard:
1. Puedes reasignar la categoría al instante.
2. Puedes marcar: "Aplicar también a consumos futuros de este comercio". El sistema crea una regla MerchantCategoryRule que recordará la clasificación en futuras sincronizaciones.

Sincronización en Vivo y Deduplicación

Botón "Sincronizar Sheets" en la barra superior

Cada vez que ingreses nuevos gastos en tu Google Sheet, simplemente presiona el botón de sincronización. El sistema:
• Genera una firma SHA-256 única para cada gasto.
• Nunca duplica transacciones aunque sincronices varias veces al día.
• Muestra una notificación Toast en tiempo real con el conteo de nuevos registros.

Nombres de Pestañas Personalizadas

Nombres 100% libres para tus hojas en Google Sheets

No estás atado a nombres fijos. Si en tu libro de cálculo prefieres nombrar las pestañas como Gastos_2026, MisTarjetas o AbonosBancarios:
• Ve a Ajustes y modifica los campos "Nombre Pestaña Consumos (TC)" y "Nombre Pestaña Pagos (Cash)".
• OmniCard leerá directamente esas pestañas sin necesidad de alterar la estructura de tu Google Sheet.

5

Cálculo de Diferidos y Cuotas Futuras

Cómo OmniCard proyecta tus compromisos de deuda a 12 meses vista

Uno de los mayores dolores de cabeza en el control de tarjetas es el seguimiento de compras a cuotas diferidas (ej. 3, 6, 12 o 24 meses). OmniCard maneja esto con un motor matemático especializado:

1. Autogeneración Inteligente de Cuotas (Última Mejora):

Si bien en un inicio se aceptaba que desde Google Sheets viniera cada cuota mensual escrita a mano (ej. 1/6, 2/6), con la última mejora del sistema ya no es necesario ingresar cuota por cuota en tu hoja.

Ahora simplemente registras una sola fila en tu Google Sheet:
• Tipo de Consumo: Diferido.
• Valor: Monto total de la compra (ej. $600.00).
• Cuotas: Solo el número total de cuotas pactadas (ej. 6).

Al presionar "Sincronizar Sheets", OmniCard autogenera automáticamente todas las cuotas mensuales individuales (1/6, 2/6, ..., 6/6) dividiendo el valor exacto ($100.00/mes) y programándolas mes a mes en el calendario financiero.

2. Diferencia entre Tipo "Corriente" y "Diferido":

• Corriente: Se cobra al 100% en el corte inmediato (columna Cuotas va con - o vacía).
• Diferido: Compra a plazo donde el valor se difiere. OmniCard genera las cuotas mensuales facturables y mantiene el diferido original informativo para no duplicar el saldo adeudado (is_billable = False).

3. Seguimiento de Cuotas y Extinción de Deuda:

En el Dashboard y en los modales verás el avance de cada cuota autogenerada (ej. 2/6). El sistema sabe que ya pagaste 2 cuotas y restan 4 cuotas por liquidar.
Deuda Futura Pendiente = Monto de Cuota × Cuotas Restantes

4. Meses de Gracia (Grace Period):

Si realizas una compra diferida con promoción "Empieza a pagar en 3 meses", el campo opcional grace_period posterga la imputación de la primera cuota la cantidad de meses especificada a partir de la fecha de compra.

Timeline a 12 Meses

Curva de Extinción de Pasivos

En la pestaña de Informes, OmniCard simula el avance mes a mes de todos tus diferidos vigentes, mostrándote exactamente en qué mes se extinguirá cada cuota y cuándo recuperarás tu liquidez completa.

6

Los 5 Informes Financieros en OmniCard

Descubre cada una de las pestañas analíticas disponibles en la sección de Informes

1. Tablero Mensual

Distribución en gráficos Donut de tus consumos por cada banco y por categoría. Incluye barras de gastos por rubro y tabla con buscador en vivo para auditar cada centavo del mes seleccionado.

2. Tablero Anual (12 Meses)

Evolución histórica mes a mes del gasto facturado en los últimos 12 períodos contables. Compara tus consumos contra los pagos efectuados para identificar meses con desbalances de deuda.

3. Auditoría de Gastos Hormiga

Filtra automáticamente micro-transacciones menores a \$5, \$10, \$15 o \$20 (cafés, taxis, delivery). Te muestra el porcentaje de fuga sobre tu total y calcula la proyección anualizada ($\text{mes} \times 12$).

4. Estrategia & Tarjetas (La Regla de los 45 Días)

Te indica cuál de tus tarjetas conviene utilizar HOY según la fecha de corte. Si una tarjeta cortó ayer, obtienes entre 40 y 45 días de financiamiento a 0% de interés antes de tener que pagarla.

5. Semáforo Presupuestario y Alertas de Salud Financiera

Monitorea en tiempo real cuánto has gastado en relación con tu presupuesto mensual de tarjetas:
• Verde (< 70%): Presupuesto saludable, margen seguro de liquidez.
• Amarillo (70% a 89%): Atención y precaución, modera gastos prescindibles.
• Naranja (90% a 99%): Alerta crítica, cerca de agotar el cupo prudente.
• Rojo (≥ 100%): Presupuesto rebasado, riesgo de sobreendeudamiento.

7

Cómo Registrarte y Seguridad de Datos

Aislamiento por usuario y privacidad absoluta de tu información financiera

Pasos para Registrarte

  1. Entra a la página de Crear Cuenta.
  2. Ingresa tu nombre, nombre de usuario deseado y correo electrónico.
  3. Define una contraseña segura (mínimo 6 caracteres).
  4. (Opcional) Pega la URL de tu hoja de Google Sheets. Puedes hacerlo ahora o después en los Ajustes.
  5. Haz clic en "Crear Cuenta y Comenzar".

Al crearse tu usuario, OmniCard precarga automáticamente las tarjetas bancarias comunes de Ecuador con sus fechas de corte y productos predeterminados (Diners Sphaera, Guayaquil Amex, Bolivariano Visa, etc.) para que no empieces de cero.

Aislamiento y Privacidad Multi-Inquilino

• Datos 100% aislados: Ningún otro usuario de OmniCard puede ver tus tarjetas, tus consumos, tus pagos ni la URL de tu Google Sheet.

• Autenticación por Username o Email: Puedes iniciar sesión indistintamente con tu usuario o con tu correo registrado.

• Sin credenciales bancarias: OmniCard nunca te pide claves de acceso a tus bancos ni contraseñas bancarias; se alimenta exclusivamente de la hoja de cálculo que tú controlas.

¿Listo para tomar el control de tus finanzas?

Configura tu Google Sheet con los pasos de esta guía y comienza a consolidar tus estados de cuenta hoy mismo.