Manual Completo de Operación de la Tienda
Bienvenido a la Wiki Oficial de VitryApp. Aquí encontrarás la explicación detallada de cada menú, botón y ajuste dentro del panel administrativo para que optimices tus ventas al máximo. Esta guía cubre desde los primeros pasos hasta funciones avanzadas de moderación, geolocalización y notificaciones automáticas.
1. Primeros Pasos y Configuración Inicial
El inicio de tu vitrina digital
Al registrar tu cuenta en VitryApp, ingresarás de inmediato a tu panel completo de administración. Desde allí podrás establecer el nombre comercial, el alias o URL pública única de tu catálogo, el nicho de mercado de tu negocio y la identidad visual de tu marca.
lightbulbTips de Registro e Inicio:
- Registro Simple: Puedes registrarte de forma rápida con tu dirección de correo electrónico o mediante el inicio de sesión con tu cuenta de Google.
- Alias de URL Única: El alias es tu dirección pública única (ej: vitry.app/mitienda). Te recomendamos elegir un nombre descriptivo y estable para que tus clientes puedan encontrarte fácilmente y lo asocies con tu marca.
2. Dashboard (Panel Principal)
El centro de control de tu negocio
El Dashboard es la pantalla inicial que te recibe. Muestra un resumen en caliente de tus visitas totales, pedidos del mes, gráficos de rendimiento, estado de tu plan de suscripción y accesos rápidos a la web pública.
trending_upMétricas y Widgets del Dashboard:
- Visitas: Cantidad de accesos públicos a tu catálogo por parte de clientes (acumuladas con tolerancia multi-tenant).
- Pedidos WhatsApp: Medición del total de compras generadas mediante el enlace dinámico y el Inbox.
- Ingresos Semanales: Gráfico de ventana deslizante de 7 días naturales, evitando caídas abruptas al cambiar de semana calendario.
- Estado de Suscripción: Muestra tu plan actual (Free/Pro) con un botón directo a la sección de Configuración para hacer un upgrade.
- Categorías (Tarjetas Compactas): Listado de tus categorías con truncamiento inteligente de texto para pantallas compactas. Soporta reordenamiento por arrastre (drag-and-drop).
- Acceso Rápido a Catálogo: Botón directo para abrir tu vitrina pública en una nueva pestaña.
3. Catálogo de Productos y Control de Stock
Tus artículos bajo control
En la sección de Productos puedes dar de alta nuevos artículos, organizarlos por categorías, establecer precios promocionales de oferta y gestionar el inventario (cantidad disponible). Cada producto pasa por el sistema de moderación de contenido automático antes de publicarse.
Remera Algodón Premium
inventory_2Reglas del Descuento Automático de Stock:
- Si dejas el campo de stock en blanco o como "Ilimitado", el producto nunca se marcará como agotado (ideal para servicios).
- Al recibir un pedido en el Inbox y presionar "Vendido" (Check verde), el sistema resta automáticamente el stock. Si llega a 0, se marca como "Agotado" en la web pública.
- Edición manual: En la sub-pestaña Inventario puedes modificar el stock directamente sin necesidad de esperar a un pedido.
shieldModeración Automática de Productos:
- Cada producto se analiza por 3 capas de IA: URL patterns, visión con NVIDIA NIM y análisis de texto.
- Si un producto es bloqueado, puedes usar el botón "Apelar Bloqueo" en la ficha del producto para solicitar una revisión manual.
- 3 infracciones acumuladas suspenden la tienda automáticamente.
4. Inbox de Pedidos en Tiempo Real
Tus pedidos listos para despachar
El Inbox recopila las compras ingresadas. Se refresca automáticamente cada 5 segundos mediante polling interno no disruptivo: mantiene el estado expandido de los pedidos y conserva los mapas Leaflet activos sin interferir con la navegación del usuario.
1x Remera Algodón Premium — Gs. 75.000
Total: Gs. 85.000 (inc. delivery)
location_on Mapa Leaflet + Ruta OSRM activa
infoAcciones por Pedido:
check_circle Botón "Vendido"
- Marca el pedido como completado.
- Descuenta automáticamente el stock de cada producto.
- Suma el total al reporte de Facturación.
cancel Botón "No Vendido" / Eliminar
- "No Vendido": archiva como cancelado, no toca el stock.
- "Eliminar": borra permanentemente el registro. ¡No podrás recuperarlo ni ver el ticket!
map Mapa Leaflet con OSRM
- Aparece en pedidos de Delivery o Servicio Presencial con GPS.
- Muestra la ruta vial real (polilínea azul) con distancia y tiempo estimado.
- Botón "Abrir en Google Maps" para guiar al repartidor.
print Botón "Ticket" (Impresora)
- Abre la vista de impresión optimizada para ticketeras térmicas.
- Incluye el logo del comercio configurado dinámicamente.
- Compatible con papel de 58mm y 80mm.
5. Zonas de Delivery Poligonales Personalizadas
Dibuja tu propia cobertura de envíos
VitryApp te permite definir áreas de entrega en forma de polígonos libres sobre el mapa interactivo, rompiendo la limitación de los círculos radiales clásicos. Las distancias se calculan usando enrutamiento vial real con la API OSRM.
ZONA MICROCENTRO
Costo Asignado: Gs. 10.000
mapModo de Operación del Delivery:
- Marcar Local: Permite establecer el punto geográfico de partida del comercio arrastrando el pin rojo.
- Dibujar Zonas: Te permite marcar libremente los puntos en el mapa haciendo clics sucesivos (mínimo 3 puntos). Puedes agregar múltiples zonas con nombres y costos diferentes.
- Validación en Catálogo: Cuando el cliente confirma su ubicación, el sistema verifica si su posición cae dentro del polígono. Si cae en varios, se autoselecciona la zona de menor costo.
- Fallback Radial: Si el cliente está fuera de todas las zonas poligonales, el sistema evalúa la cobertura con rangos radiales OSRM.
- Ruta OSRM: La distancia se calcula con enrutamiento vial real (no línea recta). La ruta se muestra como polilínea azul en el mapa del cliente durante el checkout.
- Persistencia del cliente: El nombre y teléfono del cliente se guardan en localStorage tras el primer checkout y se precargan automáticamente en futuras visitas.
- Reenvío al repartidor: Puedes configurar un número de teléfono de delivery para que el gateway WAP-Manage reenvíe automáticamente el detalle del pedido al repartidor 15 segundos después de notificar al propietario.
6. Personalización de Estética y Color del Carrito
Haz que tu tienda se sienta única
Desde Mi Tienda, tienes el control de la paleta de colores y del comportamiento del carrito. El motor de temas aplica los colores en tiempo real a todos los modales del catálogo público (Carrito, Delivery, Producto, Éxito, Filtros).
Temas Disponibles:
settings Control Granular PRO (Diseñar Carrito):
- Plan Free: Puede ver la simulación interactiva, pero no puede modificar textos, ocultar opciones ni cambiar el color de acento. Se muestra un banner informativo.
- Plan Pro: Doble clic en textos del simulador para modificarlos (ej. cambiar "SIGUIENTE" por "AVANZAR"). Botones de ocultar/mostrar por ojo. Doble clic en botones de acción para cambiar color. Los cambios se aplican al presionar "Guardar y Cerrar".
- Motor de Temas: El sistema inyecta un bloque CSS dinámico (#vitry-theme-override) que garantiza coherencia visual en TODOS los modales en todos los temas (light, dark y degradados), usando valores concretos de color, nunca variables CSS var() para máxima compatibilidad.
7. Configuración de Impresora y Ticketera Física
Imprime comandas y comprobantes en papel térmico
VitryApp tiene compatibilidad integrada con ticketeras térmicas estándar de 58mm y 80mm directamente a través del navegador web, sin instalar drivers propietarios ni programas adicionales. El ticket incluye el logo de tu tienda de forma dinámica.
Al presionar Ticket en cualquier pedido, se abrirá la previsualización del sistema. Configura los márgenes como "Ninguno" (None) y desmarca la casilla de "Cabeceras y pies de página" para evitar textos extra como la URL en el ticket.
En Configuración › Impresora, puedes configurar tu ancho de papel preferido (58mm o 80mm) y subir un logo optimizado en color negro puro para un grabado térmico óptimo. El logo se carga dinámicamente desde profileImage o su fallback logo.
En el diálogo de impresión del navegador, selecciona tu impresora térmica instalada como Destino. Si no aparece, asegúrate de tener los drivers del fabricante instalados y la impresora conectada al equipo.
Puedes imprimir tickets desde dos lugares: el Inbox (Pedidos) o desde la sección de Facturación. En ambos lugares aparece el botón de impresora en cada pedido.
8. Asistente Inteligente IA
Soporte y guía interactiva las 24 horas
¿No encuentras una opción? ¿Quieres saber cómo cargar stock rápidamente? En la barra superior derecha de tu portal de administración verás un botón con icono de robot/chat. Al hacer clic, se abre el panel del asistente conversacional, entrenado exclusivamente con el manual de operación de VitryApp.
smart_toy Características del Asistente IA:
- Disponible 24/7: Responde en español de forma inmediata sin necesidad de esperar a un agente humano.
- Entrenado en el Manual: Sus respuestas se basan exclusivamente en la documentación oficial de VitryApp. No inventa ni supone funciones que no existan.
- Seguridad ISO/IEC 42001: No revela código de programación, credenciales, tokens, contraseñas ni detalles técnicos internos del sistema.
- Respuestas directas y breves: Optimizadas para responder la consulta del comerciante de forma concreta, sin divagaciones.
- Impulsado por IA Google Gemini: El motor conversacional utiliza tecnología de inteligencia artificial avanzada para comprender consultas en lenguaje natural.
9. Sistema de Moderación de Contenido (3 Capas IA)
Protección automática de la plataforma — Zero Tolerance
VitryApp implementa un sistema de moderación automatizado de 3 capas que analiza cada producto antes de publicarlo. Este sistema protege a la plataforma y a los usuarios de contenido inapropiado o ilegal.
Capa 1: URL Patterns (Instantánea)
Al guardar o editar un producto, se inspeccionan las URLs de sus imágenes contra más de 40 patrones de sitios y palabras clave de contenido adulto. Esta capa es instantánea y no consume créditos de IA.
Capa 2: NVIDIA NIM Vision (Visual)
Integrada con el modelo meta/llama-3.2-11b-vision-instruct de NVIDIA NIM. Analiza visualmente la imagen del producto. Soporta imágenes externas (descarga automática), archivos locales del servidor y datos base64. Si el modelo rechaza analizar la imagen, lo marca como infracción.
Capa 3: NVIDIA NIM Texto (Ultra-Estricto)
El texto del producto (nombre y descripción) se analiza con meta/llama-3.1-8b-instruct. El prompt está calibrado para no bloquear títulos cortos, de prueba ("test", "prueba"), números ni productos cotidianos a menos que mencione explícitamente contenido inapropiado.
warning Sistema de Advertencias y Apelación:
- Escaneo al arranque: Al iniciar el servidor, se escanean secuencialmente todos los productos (con 1.5s de retardo entre consultas). Permite re-evaluar y rehabilitar productos bloqueados erroneamente.
- 3 advertencias = Suspensión: Tres infracciones acumuladas suspenden automáticamente la tienda del comerciante.
- Botón "Apelar Bloqueo": Disponible en la ficha de cada producto bloqueado. Solicita una revisión manual por el administrador.
- Panel Admin: Los administradores pueden ver los productos publicados, levantar bloqueos y restablecer el contador de advertencias desde la pestaña de Usuarios.
10. Notificaciones WAP y Gateway de WhatsApp
Alertas automáticas de nuevas ventas en tiempo real
Cada vez que un cliente genera un pedido, VitryApp puede notificarte automáticamente por WhatsApp a través del gateway WAP-Manage. Esta integración funciona de forma asíncrona para no frenar la velocidad del catálogo.
smartphone Registro Estándar + Notificación WAP
El pedido se procesa en VitryApp y el cliente ve un mensaje de éxito en pantalla. El servidor envía automáticamente una alerta WAP al número de WhatsApp del comercio.
Recomendado: Activar notificación WAP para no perderse ninguna venta.
chat_bubble Redirección a WhatsApp
Tras guardar el pedido, el navegador del cliente abre el chat de WhatsApp del comercio con el detalle completo listo para enviar. La notificación WAP automática se desactiva para evitar duplicados.
forward_to_inbox Diferenciación de Mensajes por Plan:
- Plan Free: Recibe un mensaje de texto simple con los datos básicos del pedido (nombre cliente, artículos, total).
- Plan Pro: Recibe un mensaje enriquecido con método de pago, monto a abonar, método de entrega (local/mesa/delivery) y enlace directo a Google Maps con la ubicación del cliente.
- Reenvío al repartidor: Disponible en cuentas Pro. El gateway reenvía el resumen del envío al repartidor 15 segundos después de notificar al propietario.
11. Facturación e Historial de Ventas
Tu registro histórico de ingresos
La sección de Facturación está organizada en dos pestañas principales: Registros e Informes (para historial y balances) y Caja (donde se configura el POS, RUC, Timbrados y el logo de tickets).
point_of_sale Caja POS e Impresión Fiscal
Permite registrar cobros de ventas presenciales de forma ágil, autoincrementando el correlativo de facturación. Los comprobantes se pueden imprimir directamente en impresoras térmicas de 58mm/80mm o guardar como PDF.
gavel Facturación Autoimpresa (DNIT / Paraguay)
Cumple con los requisitos para tickets de Factura Autoimpresa según la RG 24/14 de Paraguay. Requiere RUC, Razón Social, Teléfono, Dirección Fiscal, Nº de Timbrado, Fecha de Inicio y Vencimiento, y numeración correlativa (Boca-Secuencia).
gavel Aclaración Tributaria Importante (DNIT/SIFEN):
Este módulo está preparado exclusivamente para el formato físico tradicional de Facturación Autoimpresa (aprobado por la DNIT). NO es Factura Electrónica integrada con SIFEN (e-kuatia). La Factura Electrónica en Paraguay requiere una integración mediante software homologado, firma digital criptográfica por token y envío síncrono XML por API SOAP a la DNIT en tiempo real. El uso de este módulo es bajo entera responsabilidad y control tributario del comercio titular del timbrado físico.
bar_chart Funciones de Facturación:
- Historial completo: Todos los pedidos completados con fecha, hora, cliente, artículos y total.
- Gráficos de ingresos: Curva de ventas semanal con ventana deslizante de 7 días naturales. Evita caídas abruptas al cambiar de semana.
- Reimprimir ticket: Cada pedido del historial tiene el botón de impresora para generar el comprobante térmico nuevamente.
- Integración con Inventario: Solo los pedidos marcados como "Vendido" se reflejan en los descuentos de stock y en la facturación. Los pedidos eliminados no quedan en el historial.
- warning Advertencia importante: Si eliminas un pedido del Inbox antes de marcarlo como "Vendido", desaparecerá permanentemente y NO quedará en la sección de Facturación.
12. Búsqueda y Filtros en el Catálogo Público
Tus clientes encuentran lo que buscan
El catálogo público incluye un sistema de búsqueda y filtrado para ayudar a tus clientes a encontrar productos de forma rápida sin necesidad de hacer scroll infinito.
search Búsqueda por Texto
Los clientes pueden escribir el nombre o descripción del producto en la barra de búsqueda. Los resultados se filtran en tiempo real a medida que escribe.
category Filtro por Categorías
Navegación horizontal con arrastre entre categorías. Al seleccionar una categoría, el catálogo muestra solo los productos correspondientes.
local_offer Filtro de Ofertas
Los clientes pueden filtrar para ver únicamente los productos en promoción u oferta activa, facilitando las compras de oportunidad.
tune Modal de Filtros Avanzados
Panel deslizable con opciones de filtro por rango de precio, ordenamiento (por precio ascendente/descendente, más nuevo, más vendido) y estado de stock.
13. Diferencias de Planes y Limitaciones
Escoge la potencia que tu tienda nec
Plan Free Solo
- Hasta 150 productos activos
- Nicho unico (productos o servicios)
- Hasta 30 notificaciones WAP diarias
- Delivery poligonal (básico)
- Muestra anuncios de Google Adsense
- Sin acceso a Caja POS ni facturas
- Sin pasarelas de pago online
Plan Estandard Proximamente
- Productos Ilimitados
- Productos y servicios conjuntos
- Notificaciones WAP ilimitadas
- Modulo de Caja POS completo
- Facturas autoimpresas
- Pasarelas locales (UPAY/Pagopar)*
- Personalizacion de marca completa
- * Aprobacion por pasarela demora hasta 72hs.
Plan PRO Proximamente
- Todo el Plan Estandard
- Facturacion Electronica
- Publicidad con Google AdSense*
- * Proximamente: usando la cuenta corporativa a futuro.
storefront Comportamiento del Carrito según Nicho Comercial:
| Nicho | Opciones de Entrega | Subtítulo |
|---|---|---|
| Gastronomía | Retiro, Delivery, Mesa, Reserva | ¿Cómo recibís tu pedido? |
| Comercios/Productos | Retiro en Local, Delivery | ¿Cómo lo entregamos? |
| Servicios Generales | Agendar Turno, Consultar Disponibilidad | Agendá tu turno |
| Servicios Corporativos | Contratar, Solicitar Presupuesto | ¿Cómo coordinamos? |
14. Seguridad del Sistema y Control de Acceso
Arquitectura Zero-Trust para tu seguridad
VitryApp implementa una arquitectura de seguridad Zero-Trust en todos los niveles del sistema, tanto para el acceso al portal como para la protección de activos y datos sensibles.
assignment Compatibilidad Multi-Tenant:
- El sistema soporta tenantId en formato ObjectId y String indistintamente, garantizando compatibilidad con cuentas creadas en distintas versiones del servidor.
- Las estadísticas de visitas acumulan conteos bajo cualquier tipo de dato de tenantId.
- El reordenamiento de categorías es tolerante a ambos formatos de ID.