RentBaseDocs

RentBase — Documentación Completa para Comerciantes y Desarrolladores

Versión: 1.0 Última actualización: Marzo 2026 Contacto soporte: rentbasesupport@gmail.com


Índice

  1. Introducción
  2. Instalación y Configuración Rápida
  3. Planes y Suscripción
  4. Configuración Global
  5. Gestión de Productos
  6. Widget del Calendario (Storefront)
  7. Cart Guardian (Protección del Carrito)
  8. Sistema de Descuentos
  9. Reservas
  10. Notificaciones por Email (Pro)
  11. Sistema de Disponibilidad (Visión Técnica)
  12. Gestión de Tickets de Soporte
  13. Idiomas Soportados
  14. FAQ y Solución de Problemas

1. Introducción

Qué es RentBase

RentBase es una aplicación de Shopify que transforma cualquier tienda online en una plataforma de alquiler. Permite a los comerciantes alquilar productos por días u horas, gestionar la disponibilidad del inventario, aplicar descuentos automáticos y supervisar las reservas a través de un panel dedicado.

Para quién está diseñado

Arquitectura

RentBase se compone de tres partes:

ComponenteDónde resideQué hace
App AdminPanel de administración de Shopify (embebida)Configuración, gestión de reservas, ajustes
Widget StorefrontTema de la tienda (Theme App Extension)Calendario de fechas, selector de horas, reserva del cliente

La app está totalmente embebida en Shopify: no abre ventanas externas y se integra de forma nativa en el panel de administración.


2. Instalación y Configuración Rápida

2.1 Instalación

  1. Busca RentBase en el Shopify App Store
  2. Haz clic en Instalar
  3. Autoriza los permisos necesarios
  4. La app se abrirá automáticamente en la página de Quick Start

2.2 Checklist del Quick Start

Al abrir RentBase por primera vez, verás una checklist automática de 3 pasos. La app detecta el estado de cada paso automáticamente.

Paso 1: Activar productos

Nota: Activar un producto no lo modifica visualmente en la tienda hasta que el widget del calendario esté activo en el tema.

Paso 2: Activar el calendario en el tema

Abre el Editor de Temas de Shopify y añade el bloque RentBase Calendar a la página de producto. Este es el widget que tus clientes usarán para seleccionar las fechas de alquiler.

  1. Ve a Online Store → Customize (Editor de Temas)
  2. Abre cualquier producto
  3. En la sección del producto, haz clic en Add block
  4. Busca RentBase Calendar en "Apps"
  5. Posiciónalo según tu preferencia (recomendado: debajo del precio, encima del botón Add to Cart)
  6. Guarda el tema

Paso 3: Configurar ajustes globales

Vuelve al Quick Start: todas las marcas deberían estar en verde. Visita tu tienda y abre un producto activado para verificar que el calendario sea visible.


3. Planes y Suscripción

3.1 Comparación de Planes

FuncionalidadFreePro ($49/mes)
Productos ilimitados
Widget del calendario
Protección del carrito (Cart Guardian)
Descuentos por duración
Descuentos estacionales
Fechas bloqueadas globales
Gestión de inventario/flota
Smart Asset Manager (Matrículas y Números de Serie)
Configuración por producto/variante
Reserva manual (Admin)
Dashboard de reservas (Agenda, Timeline, Registro)
Reservas confirmadas / mes10Ilimitadas
Notificaciones por email (confirmación, recordatorio, feedback)
Sincronización de calendario (iCal/Google/Apple/Outlook)
Contrato Digital (documento + firma + campos personalizados)
Campos Personalizados (formulario pre-checkout)

3.2 Límite de Reservas (Plan Free)

El plan Free permite 10 reservas confirmadas por mes. El conteo incluye:

Las reservas PENDING (aún no pagadas) no cuentan para el límite.

3.3 Upgrade a Pro

  1. Ve a Settings → haz clic en Upgrade to Pro
  2. Se abre la pantalla de pago de Shopify
  3. Confirma la suscripción
  4. Las funcionalidades Pro se activan inmediatamente

3.4 Downgrade / Cancelación

Si cancelas el plan Pro:

  1. Periodo de gracia de 24 horas — puedes reactivar sin pérdidas
  2. Después de 24 horas, el downgrade se completa: - El feed del calendario iCal se desactiva (token eliminado) - Las notificaciones por email se desactivan globalmente - Las reservas existentes permanecen - Todos los descuentos y configuraciones de productos se mantienen sin cambios

4. Configuración Global

Los ajustes globales son los valores predeterminados para todos los productos. Pueden ser sobrescritos a nivel de producto o variante (ver Sección 5).

La página de configuración está dividida en secciones:

4.1 Ajustes Generales

CampoDescripciónPredeterminado
Shop TimezoneZona horaria de la tienda. Se usa para todos los cálculos de fechas.UTC
Pending DurationMinutos que una reserva permanece válida en el carrito antes de expirar.15 min
Default InventoryNúmero de unidades disponibles por variante (para gestión de flotas).1

Zona horaria: Selecciona la zona horaria real de tu tienda. Si estás en España, usa Europe/Madrid. Esto asegura que las fechas del calendario correspondan a tu hora local.

4.2 Ajustes de Tiempo

CampoDescripciónPredeterminado
Enable Time SelectionSi está activo, los clientes también seleccionan hora de recogida/devolución (no solo el día).Desactivado
Time FormatFormato horario: 24h (14:00) o 12h (2:00 PM).24h
Buffer HoursHoras de preparación entre el fin de un alquiler y el inicio del siguiente (0-168).0
Include Return DaySi está activo, el día de devolución cuenta como día alquilado para el cálculo del precio.Desactivado

Ejemplo Buffer Hours: Si configuras 4 horas de buffer y un cliente devuelve a las 18:00, el siguiente cliente puede recoger a partir de las 22:00. En alquileres por día (sin horarios), el buffer bloquea todo el día siguiente si es necesario.

4.3 Duración del Alquiler

CampoDescripciónPredeterminado
Minimum Rental DaysDuración mínima del alquiler en días.1
Maximum Rental DaysDuración máxima del alquiler en días.30
Advance Booking DaysDías mínimos de antelación para reservar (0 = mismo día).0

4.4 Disponibilidad

CampoDescripciónPredeterminado
Available DaysDías de la semana en que el alquiler está activo. Desactiva los días de cierre.Todos los días
Pickup TimesHorarios de recogida disponibles (solo con selección de hora activa).09:00 – 18:00
Return TimesHorarios de devolución disponibles (solo con selección de hora activa).09:00 – 18:00

Los horarios pueden añadirse individualmente (lista de slots) o como rango con intervalos de 30 minutos.

4.5 Requisitos

CampoDescripciónPredeterminado
Minimum AgeEdad mínima requerida para el alquiler. Muestra un checkbox de confirmación en el widget.Ninguno
Requires LicenseSi está activo, el cliente debe confirmar que tiene un permiso de conducir válido.Desactivado
Requires DepositSi está activo, se muestra información sobre el depósito.Desactivado
Deposit AmountImporte del depósito.0
Deposit TypeInfo Only (solo informativo) o Add to Cart (añade un producto de depósito al carrito).Info Only
Deposit ProductProducto Shopify que se usa como depósito. La app puede crear uno automáticamente.

Depósito "Add to Cart": Con este tipo, la app crea un producto Shopify especial (con tag rentbase-deposit). Al reservar, el depósito se añade como artículo separado al carrito. El Cart Guardian impide que el cliente lo elimine independientemente del alquiler.

Consentimiento de Depósito en el Widget

Cuando el tipo de depósito es "Add to Cart", el widget muestra una casilla de consentimiento obligatoria que el cliente debe aceptar antes de continuar. Esto garantiza el cumplimiento de la política de Shopify 5.6.5 sobre transparencia de cargos adicionales.

Reembolso del Depósito de Garantía

Cuando el tipo de depósito es "Add to Cart" (line item), el comerciante puede reembolsar el depósito directamente desde el panel de Bookings:

  1. Desde la tabla de reservas: En la columna "Actions", junto al botón "View Order", aparece un botón "Reembolsar depósito" (icono ↩) para todas las reservas con depósito > 0 que aún no ha sido reembolsado.
  2. Confirmación: Al hacer clic, aparece una solicitud de confirmación con los botones "Confirmar" y "Cancelar".
  3. Procesamiento: El reembolso se procesa a través de la API de Shopify Admin (suggestedRefund + refundCreate). El cliente recibe automáticamente un email de notificación del reembolso.
  4. Estado: Una vez reembolsado, la columna "Deposit Cost" muestra una insignia verde "Reembolsado" junto al importe. El botón de reembolso desaparece.
  5. Modal de pedido: En el detalle del pedido (modal), los depósitos reembolsados se indican con un banner verde. Para los depósitos aún no reembolsados, está disponible el mismo flujo de reembolso con confirmación.

Nota: Los reembolsos son irreversibles. Una vez confirmado, el importe del depósito se devuelve al método de pago original del cliente.

4.6 Ubicaciones de Recogida y Devolución

CampoDescripciónPredeterminado
Pickup LocationDirección/indicaciones del lugar de recogida.Vacío
Return LocationDirección/indicaciones del lugar de devolución. Dejar vacío si es el mismo que recogida.Vacío

4.7 Fechas Bloqueadas Globales

Sección dedicada para bloquear fechas a nivel global para todos los productos. Ideal para:

Cada fecha bloqueada tiene:

Las fechas bloqueadas globales se combinan con las eventuales fechas configuradas a nivel de producto/variante (unión). Es posible excluir determinadas fechas bloqueadas globales a nivel de producto/variante.

4.8 Descuentos por Duración

Ver Sección 8 — Sistema de Descuentos para la configuración detallada.

4.9 Descuentos Estacionales

Ver Sección 8 — Sistema de Descuentos para la configuración detallada.

4.10 Integración del Calendario (Solo Pro)

Genera un enlace de suscripción iCal para sincronizar todas las reservas confirmadas con:

El enlace está en formato webcal:// y se actualiza automáticamente. Es un feed de solo lectura.

Generar enlace:

  1. En los ajustes, abre la sección del calendario
  2. Haz clic en Generate Calendar Link
  3. Copia el enlace y pégalo en tu app de calendario

Revocar acceso:


5. Gestión de Productos

5.1 Activar productos para alquiler

  1. Ve a la página Products en la navegación lateral
  2. Haz clic en Add Products
  3. Selecciona los productos del catálogo de Shopify
  4. Confirma

Los productos activados muestran:

5.2 Configuración por producto

Haz clic en un producto para abrir su configuración. Puedes personalizar todos los valores de los ajustes globales:

Cada campo no configurado a nivel de producto hereda el valor global.

5.3 Configuración por variante

Si un producto tiene múltiples variantes (ej. talla S, M, L), cada variante puede configurarse de forma independiente:

5.4 Modelo de Herencia

RentBase utiliza un sistema de tres niveles. Para cada ajuste, el valor se resuelve así:

┌──────────────────────────────────┐
│  VARIANTE (máxima prioridad)     │  ← Si está configurada, prevalece
├──────────────────────────────────┤
│  PRODUCTO                        │  ← Si la variante no tiene valor
├──────────────────────────────────┤
│  GLOBAL (mínima prioridad)       │  ← Si tampoco el producto tiene valor
└──────────────────────────────────┘

Ejemplo práctico:

5.5 Fechas bloqueadas — Modelo de unión con exclusiones

Las fechas bloqueadas funcionan de forma acumulativa (unión):

Una fecha bloqueada global bloquea todos los productos. Como excepción:

Ejemplo:

5.6 Almacenamiento en Metafields

Las configuraciones de producto/variante se guardan en Shopify Metafields:

Namespace: rentbase
Key: config
Tipo: JSON

Esto significa:

5.7 Rental Assets (Activos de Alquiler)

RentBase permite rastrear activos físicos individuales para cada variante de producto. Los assets son útiles cuando necesitas saber exactamente qué unidad fue alquilada a qué cliente.

Qué es un Rental Asset

Un Rental Asset representa un único objeto físico identificable. Por ejemplo, si tienes 5 bicicletas eléctricas, cada una puede ser un asset con su propio nombre y número de serie:

Nombre AssetNúmero de SerieEstado
E-Bike #1SN-001Disponible
E-Bike #2SN-002Alquilada
E-Bike #3SN-003Mantenimiento

Gestión de Assets

Desde la página Products, ve a la pestaña Assets:

Estados de los Assets

EstadoSignificado
availableListo para ser alquilado
rentedActualmente asignado a una reserva
maintenanceEn mantenimiento, no disponible para alquiler

Asignación de Assets en Reservas

Al ver una reserva en la página Bookings:

Aviso de Inventario vs. Conteo de Assets

La pestaña Assets muestra avisos cuando la cantidad de inventario no coincide con el número de assets:

Los assets se almacenan como Shopify Metaobjects (rentbase_asset) y están vinculados a las variantes mediante el ID de variante.


6. Widget del Calendario (Storefront)

6.1 Cómo funciona para el cliente

Cuando un cliente visita la página de un producto habilitado para alquiler:

  1. El botón "Add to Cart" original del tema se oculta automáticamente
  2. En su lugar aparece el widget RentBase con: - Calendario interactivo para seleccionar fecha de recogida y fecha de devolución - Si está habilitado, selector de hora de recogida y hora de devolución - Selector de cantidad (para productos con inventario > 1) - Resumen de precio con eventuales descuentos - Checkboxes de requisitos (edad mínima, licencia) si están configurados - Aviso de depósito si está configurado - Ubicaciones de recogida/devolución si están configuradas - Botón "Book Now" para añadir al carrito

6.2 Comportamiento del calendario

El calendario verifica la disponibilidad en tiempo real mediante consultas API en cada cambio de selección.

6.3 Qué se añade al carrito

Cuando el cliente hace clic en "Book Now", se añade un artículo al carrito con los siguientes metadatos (Line Item Properties):

PropiedadDescripción
_bookingIdIdentificador único de la reserva
_rentalDaysNúmero de días de alquiler
_rentalFinalTotalPrecio final después de todos los descuentos
_rentalStartDateFecha de inicio (formato ISO)
_rentalEndDateFecha de fin (formato ISO)
_rentalStartTimeHora de recogida (si está habilitada)
_rentalEndTimeHora de devolución (si está habilitada)

Estas propiedades también son visibles en el pedido de Shopify.

6.4 Personalización en el Editor de Temas

En el Editor de Temas de Shopify puedes personalizar el bloque del calendario:

6.5 Productos no activados

Si un producto no tiene el alquiler activado:

6.6 Multi-variante

Si el producto tiene múltiples variantes:


7. Cart Guardian (Protección del Carrito)

7.1 Qué es

El Cart Guardian es un embed global (activo en todas las páginas) que protege la integridad de las reservas en el carrito. Sin él, el cliente podría manipular cantidades y depósitos.

7.2 Qué hace

ProtecciónDescripción
Bloqueo de cantidadLa cantidad del artículo de alquiler equivale a los días de alquiler. El Cart Guardian oculta el selector de cantidad para evitar modificaciones.
Protección del depósitoSi el depósito está como artículo separado en el carrito, el cliente no puede eliminarlo individualmente. El botón "Eliminar" está oculto.
Eliminación inteligenteSi el cliente elimina una reserva, el depósito asociado se elimina automáticamente.
Compatibilidad con carritosFunciona con carrito de página, drawer cart e implementaciones personalizadas del tema.

7.3 Detección multilingüe

El Cart Guardian reconoce propiedades del carrito en 7 idiomas (italiano, inglés, alemán, francés, español, portugués, chino) para identificar correctamente artículos de alquiler y depósito independientemente del idioma del tema.


8. Sistema de Descuentos

8.1 Descuentos por Duración

Aplica descuentos progresivos basados en la duración del alquiler.

Configuración:

- Días mínimos: a partir de cuántos días se aplica el descuento - Porcentaje de descuento: el porcentaje aplicado

Ejemplo:

Días mínimosDescuento
710%
1420%
3030%

Si el cliente alquila 10 días → 10% de descuento. Con 21 días → 20% de descuento (el nivel más alto aplicable).

Siempre se aplica el descuento del nivel más alto alcanzado (no acumulativo entre niveles).

8.2 Descuentos Estacionales

Aplica descuentos vinculados a períodos específicos del año.

Configuración:

En caso de superposición: Si dos promociones estacionales se superponen, se aplica la de mayor prioridad.

8.3 Fórmula Compuesta

Cuando ambos tipos de descuento aplican, la fórmula es compuesta (no aditiva):

Precio Final = Precio Base × (1 - Descuento Duración%) × (1 - Descuento Estacional%)

Ejemplo:

8.4 Herencia de Descuentos


9. Reservas

9.1 Ciclo de Vida de la Reserva

EL CLIENTE SELECCIONA FECHAS
        │
        ▼
    ┌─────────┐
    │ PENDING  │ ← Reserva creada, artículo en el carrito
    └────┬────┘   (expira después de "Pending Duration" minutos)
         │
    [El cliente completa el pedido]
         │
         ▼
   ┌───────────┐
   │ CONFIRMED │ ← Pedido pagado, reserva confirmada
   └─────┬─────┘   (email de confirmación enviado si es Pro)
         │
    [Período de alquiler terminado]
         │
         ▼
   ┌───────────┐
   │ COMPLETED │ ← Marcada como completada por el comerciante
   └───────────┘

    o en cualquier momento:

   ┌───────────┐
   │ CANCELLED │ ← Cancelada por el comerciante (soft delete)
   └───────────┘

   ┌───────────┐
   │  EXPIRED  │ ← Pending expirado (limpieza automática)
   └───────────┘

9.2 Dashboard de Reservas

La página Bookings ofrece un panel completo con:

Tarjetas KPI (parte superior)

KPI con filtro temporal

Vista Agenda

Vista Timeline

Vista Registro

- Buscar por cliente (nombre o email) - Filtrar por estado (Confirmed, Completed, Cancelled, Expired) - Filtrar por fecha (rango personalizado) - Mostrar expiradas/canceladas (toggle)

9.3 Reserva Manual (Admin)

El comerciante puede crear reservas manualmente desde el dashboard:

  1. Haz clic en Create Booking
  2. Selecciona producto y variante
  3. Selecciona fecha de inicio y fin
  4. Introduce nombre y email del cliente
  5. Opción: Bypass Availability Check (ignora la disponibilidad — útil para overbooking controlado o reservas especiales)
  6. La reserva se crea directamente con estado CONFIRMED

Útil para reservas por teléfono, walk-ins o reservas especiales.

9.4 Completar, Devolución y Cancelar


10. Notificaciones por Email (Pro)

10.1 Descripción General

RentBase envía emails automáticos a los clientes en momentos clave del alquiler. Las notificaciones están disponibles solo con el plan Pro.

10.2 Tipos de Email

TipoCuándo se envíaPropósito
Booking ConfirmationInmediatamente después del pago del pedidoConfirmación de la reserva con detalles
Pickup Reminder~24 horas antes de la recogidaRecuerda al cliente la fecha de recogida
Return Reminder~24 horas antes de la devoluciónRecuerda al cliente la fecha de devolución
Post-Rental Feedback~24 horas después del fin del alquilerSolicitud de feedback/valoración

10.3 Configuración

Desde la navegación lateral Notifications:

  1. Master Switch: Activa/desactiva todas las notificaciones globalmente
  2. Sender Name: Nombre que aparece como remitente (ej. "Tu Tienda")
  3. Reply-To Email: Email para respuestas del cliente
  4. Para cada tipo de email: - Activar/Desactivar individualmente - Asunto del email - Body HTML con variables Liquid

10.4 Variables de Template

En los templates puedes usar estas variables con la sintaxis {{ variable }}:

VariableValor
{{ booking.id }}ID único de la reserva
{{ booking.customer }}Nombre del cliente
{{ booking.productName }}Nombre del producto alquilado
{{ booking.startDate }}Fecha de inicio del alquiler
{{ booking.endDate }}Fecha de fin del alquiler
{{ booking.duration }}Duración en días
{{ shop.name }}Nombre de la tienda

10.5 Cron Job para Recordatorios

Los recordatorios (recogida, devolución, feedback) son procesados por un cron job automático que:


11. Sistema de Disponibilidad (Visión Técnica)

11.1 Modos de Operación

RentBase soporta dos modos de disponibilidad:

Modo Diario (enableTime = false):

Modo Horario (enableTime = true):

11.2 Gestión de Inventario / Flota

Cada variante tiene un valor inventory_quantity (predeterminado: 1):

Nota: El inventario se puede establecer en 0 a nivel de producto o variante. El inventario global predeterminado tiene un mínimo de 1.

Ejemplo de flota:

11.3 Buffer Hours

Las horas de buffer crean una ventana de preparación entre alquileres consecutivos:

Alquiler A termina: 15 marzo, 16:00
Buffer Hours: 4
Próxima recogida disponible: 15 marzo, 20:00

En alquileres por día (sin horarios):
Alquiler A termina: 15 marzo
Buffer Hours: 24
Próximo día disponible: 17 marzo

El buffer se aplica solo a los cálculos de disponibilidad — las fechas reales de la reserva no cambian.

11.4 Gestión de Zona Horaria

Todas las fechas se:

Esto asegura que "15 de marzo" en el calendario siempre corresponda al 15 de marzo en la zona horaria de la tienda, independientemente del servidor o la ubicación del cliente.

11.5 Unión de Fechas Bloqueadas

El sistema combina fechas bloqueadas de tres fuentes:

  1. Configuración (global + producto + variante) → fechas estáticas
  2. Reservas (cuando el inventario se agota) → fechas dinámicas
  3. Exclusiones → elimina ciertas fechas

El resultado final es la unión de todas las fuentes, menos las exclusiones.


12. Gestión de Tickets de Soporte

La página Support ya no es solo una zona de FAQ: ahora incluye un flujo interno de tickets para enviar solicitudes de soporte con contexto técnico útil ya adjunto.

12.1 Apertura de un ticket

Desde Support, el comerciante puede crear un ticket rellenando:

Si se introduce un Booking ID, RentBase intenta resolver la reserva correcta de esa tienda antes de guardar el ticket.

12.2 Diagnósticos adjuntos automáticamente

Cuando el ticket está vinculado a una reserva, RentBase guarda también un paquete de diagnóstico resumido con:

Esto permite al soporte empezar desde datos verificables en lugar de reconstruir el problema manualmente.

12.3 Historial de tickets dentro de Support

La misma página muestra también los tickets recientes de la tienda, con:

Así el comerciante puede comprobar rápidamente qué ya ha sido enviado al soporte.

12.4 Regla operativa importante

No se deben incluir datos sensibles del cliente en el mensaje del ticket, como documentos, firmas, detalles de pago o archivos privados. Utiliza Booking IDs o Request IDs para que RentBase pueda recuperar los diagnósticos correctos de forma segura.


13. Idiomas Soportados

RentBase soporta 7 idiomas con detección automática:

IdiomaCódigoAdminWidget Storefront
Englishen
Italianoit
Deutschde
Españoles
Françaisfr
Portuguêspt
中文zh

Cómo funciona:


14. FAQ y Solución de Problemas

Configuración

P: He instalado la app pero el calendario no aparece en la tienda. R: Debes activar el bloque RentBase Calendar en el Editor de Temas (Online Store → Customize). Ve a un producto, añade el bloque desde la sección "Apps" y guarda. Verifica también que el producto esté activado para alquiler desde la página Products.

P: El Quick Start muestra el calendario como "no activo" aunque lo he añadido. R: Asegúrate de haber guardado el tema después de añadir el bloque. Si el bloque está deshabilitado (ojo tachado en el Editor de Temas), el Quick Start lo detecta como no activo.

P: ¿Los clientes pueden cambiar la cantidad en el carrito y pagar menos días? R: No, si el Cart Guardian está activo. El Cart Guardian oculta los controles de cantidad para artículos de alquiler. Asegúrate de que esté habilitado en los App Embeds del tema.

Configuración

P: Si cambio los ajustes globales, ¿se actualizan los productos ya configurados? R: Los ajustes globales son los valores predeterminados. Los productos con configuración específica mantienen sus propios valores. Solo los productos sin configuración específica usan los valores globales.

P: ¿Tengo que configurar cada producto individualmente? R: No. Configura los ajustes globales una vez. Solo los productos que necesiten valores diferentes (diferente inventario, diferentes horarios, etc.) requieren configuración específica.

P: ¿Cómo bloqueo la tienda para las vacaciones de Navidad? R: Ve a Settings → Fechas Bloqueadas Globales. Añade el período (ej. 24-31 diciembre) y todos los productos estarán bloqueados para ese período. Si un producto específico debe permanecer disponible, añádelo a las exclusiones en la configuración del producto.

Descuentos

P: ¿Los descuentos por duración y estacionales se suman? R: No, se componen (fórmula multiplicativa). Descuento duración 10% + descuento estacional 15% = 23,5% total (no 25%). Es más justo y estándar del sector.

Reservas

P: Un cliente ha reservado pero no ha pagado. ¿La reserva desaparece? R: Sí. Las reservas PENDING expiran después de la duración configurada en "Pending Duration" (predeterminado: 15 minutos). Después de expirar, las fechas vuelven a estar disponibles.

P: ¿Puedo crear reservas manualmente para clientes que llaman por teléfono? R: Sí. En la página Bookings haz clic en "Create Booking". También puedes activar "Bypass Availability Check" para reservar fechas que aparecen como ocupadas.

P: ¿Cómo veo las reservas del mes? R: Usa la vista Timeline en la página Bookings para una vista de calendario mensual, o la vista Registro con filtros de fecha.

Plan y Facturación

P: ¿Cuántas reservas puedo gestionar con el plan Free? R: 10 reservas confirmadas por mes. Las reservas pending (no pagadas) no cuentan.

P: Si cancelo el plan Pro, ¿pierdo las reservas? R: No. Todas las reservas existentes, configuraciones de productos y otros ajustes se mantienen. Pierdes acceso a las notificaciones por email y al calendario iCal.

P: ¿Hay una prueba gratuita? R: El plan Free es ilimitado en el tiempo. Puedes usarlo todo el tiempo que quieras con el límite de 10 reservas/mes. El plan Pro incluye 14 días de prueba gratuita. El upgrade es inmediato y cancelable en cualquier momento.

Técnico

P: ¿Los metafields persisten si desinstalo la app? R: Sí. Los Shopify Metafields (rentbase.config) en los productos sobreviven a la desinstalación. Al reinstalar, las configuraciones de productos se reencontrarán. Los datos en la base de datos de la app (reservas, ajustes globales) se eliminan al desinstalar.

P: ¿La app funciona con temas personalizados? R: Sí. RentBase usa Theme App Extensions (sistema oficial de Shopify), compatible con todos los temas Online Store 2.0. El Cart Guardian detecta automáticamente diferentes layouts de carrito (página, drawer, personalizado).

P: ¿Cuál es la diferencia entre el Calendario y el Cart Guardian? R: El Calendario es un bloque que aparece en la página de producto para la selección de fechas. El Cart Guardian es un embed global (en todas las páginas) que protege el carrito impidiendo manipulaciones de cantidad y depósito.

P: ¿Cómo funciona la sincronización del calendario con Google/Apple/Outlook? R: RentBase genera una URL webcal:// que puedes pegar en tu app de calendario. El feed es de solo lectura y se actualiza automáticamente. No es una sincronización bidireccional: los cambios en el calendario externo no se reflejan en RentBase.

Assets e Inventario

P: ¿Cuál es la diferencia entre cantidad de inventario y assets? R: La inventory_quantity determina cuántas unidades pueden reservarse simultáneamente (disponibilidad). Los assets son los objetos físicos individuales que rastrear por nombre y número de serie. Idealmente, el número de assets debe coincidir con la cantidad de inventario.

P: ¿Cómo desactivo temporalmente un producto sin eliminarlo? R: Establece la inventory_quantity en 0 en la configuración del producto o variante. El widget del calendario mostrará un mensaje "temporalmente no disponible" y no se podrán hacer reservas. Cuando el producto esté disponible de nuevo, pon el inventario al valor deseado.

P: ¿Qué pasa si establezco el inventario a 0? R: El widget del calendario muestra un mensaje "temporalmente no disponible". El selector de fechas se oculta y los clientes no pueden reservar el producto. Las reservas existentes no se ven afectadas.

Seguridad de Archivos y Privacidad (Pro)

P: ¿Cómo se almacenan los documentos y firmas subidos? R: Todos los archivos (documentos de identidad, firmas, adjuntos de requisitos) se almacenan de forma segura en tu propia base de datos — nunca en CDNs públicos. Las imágenes se comprimen automáticamente en el cliente antes de subirlas (máx. 1200px, JPEG 85%). Todos los datos sensibles se cifran en reposo con AES-256-GCM.

P: ¿Existe retención y eliminación automática de datos? R: Sí. Puedes configurar un período de retención (en días) en los ajustes de "Checkout y Documentos". Tras finalizar el alquiler y expirar el período de retención, los documentos, firmas y archivos subidos se eliminan automáticamente. El valor predeterminado es 90 días. Establece 0 para conservarlos indefinidamente (no recomendado para cumplimiento del RGPD).

P: ¿Cuál es el tamaño máximo de subida? R: El máximo es 10MB por archivo. Sin embargo, las imágenes se comprimen automáticamente antes de subirlas a unos 100-200KB, por lo que en la práctica el límite rara vez se alcanza. Solo se aceptan archivos JPEG, PNG, WebP y PDF.

P: ¿Los archivos subidos cumplen con el RGPD? R: RentBase implementa varias medidas de cumplimiento: cifrado AES-256-GCM en reposo, compresión automática para minimizar datos almacenados, eliminación automática tras el período de retención configurable, y almacenamiento en tu base de datos privada (nunca en CDNs públicos). Recomendamos establecer un período de retención adecuado a la normativa de tu país.


Glosario

TérminoSignificado
App BlockComponente visual de app, posicionable en el tema Shopify
App EmbedComponente global de app, insertado en el <body> de todas las páginas
Buffer HoursHoras de preparación entre el fin de un alquiler y el inicio del siguiente
Cart GuardianComponente que protege el carrito de manipulaciones
Floating TimeFormato fecha/hora sin indicador de zona horaria en el feed iCal
InventarioNúmero de unidades disponibles para una variante (1 = individual, >1 = flota)
Line Item PropertiesMetadatos adicionales adjuntos a un artículo del carrito Shopify
MetafieldCampo de datos personalizado en un producto/variante Shopify
Pending DurationTiempo máximo que una reserva permanece reservada en el carrito
Rental AssetObjeto físico individual rastreable vinculado a una variante (almacenado como Shopify Metaobject)
Soft DeleteEliminación lógica (el registro permanece en la DB con deletedAt configurado)
Theme App ExtensionSistema Shopify para insertar componentes de app en temas

Documentación creada para RentBase v1.0 — Marzo 2026