Tutorial Completo del Sistema AMI

Guía detallada de todas las funcionalidades del sistema

Contenido
Acceso al Sistema Navegación Roles y Permisos Tienda Pública Panel Admin Punto de Venta Productos Precios Escalonados Clientes Ventas Configuración Facturación Electrónica
Volver

Acceso al Sistema

URLs de Acceso

El sistema funciona con URLs basadas en "tenants" (empresas nominadas):

https://oietema.com/ami/[nombre-empresa]
Ejemplo:
Empresa con slug "esat": https://oietema.com/ami/esat

Inicio de Sesión

  1. 1Acceder a la URL de tu empresa
  2. 2Click en el botón "Ingresar" (esquina superior derecha)
  3. 3Ingresar email y contraseña
  4. 4El sistema redirige automáticamente según tu rol

Cierre de Sesión

Importante: Al cerrar sesión, el sistema te redirige automáticamente a la página principal de tu empresa, no al login genérico.

Sistema de Roles y Permisos

SuperAdmin
  • Acceso total al sistema
  • Gestiona todas las empresas
  • Crea administradores
  • Panel: /admin/superadmin/
Admin
  • Gestiona solo su empresa
  • Productos, categorías, clientes
  • Configura facturación
  • Panel: /[tenant]/admin/
Usuario (Personal)
  • Acceso al POS
  • Panel admin limitado
  • Realizar ventas
  • Ver ventas propias
Cliente
  • Sin acceso al panel
  • Navegar tienda pública
  • Realizar pedidos online
  • Agregar al carrito

Control de Acceso

Mejora reciente: Cuando un usuario sin permisos intenta acceder a una sección restringida, se muestra una página elegante de "Acceso Denegado" con opciones para iniciar sesión o volver atrás. Ya no se redirige abruptamente al login.

Tienda Pública

Visualización de Productos

La tienda pública muestra todos los productos disponibles organizados por categorías y subcategorías.

Características:

  • Catálogo completo: Productos con imágenes, descripciones y precios
  • Filtros: Por categoría y subcategoría
  • Búsqueda: Buscador de productos por nombre o código
  • Detalles: Página individual para cada producto

Carrito de Compras

Funciones del carrito:
  • Agregar productos desde la tienda
  • Modificar cantidades
  • Eliminar productos
  • Ver subtotal y total
  • Proceder al checkout

Proceso de Pedido

  1. 1Cliente agrega productos al carrito
  2. 2Click en "Ir al Carrito"
  3. 3Revisar productos y cantidades
  4. 4Click en "Proceder al Checkout"
  5. 5Completar datos de envío
  6. 6Confirmar pedido
Los pedidos online quedan registrados en el sistema y pueden ser gestionados desde el panel de administración.

Footer Personalizado

El pie de página muestra:

  • Mensaje: "Gracias por visitarnos"
  • Logo: De la empresa (si está configurado)
  • Nombre: De la empresa
  • Slogan: De la empresa (si está configurado)

Panel de Administración

Acceso

URL: https://oietema.com/ami/[tenant]/admin/

Requiere: Rol de Admin o Usuario (personal)

Menú Principal

Gestión de Productos
  • Productos
  • Categorías
  • Subcategorías
Ventas
  • Punto de Venta (POS)
  • Historial de Ventas
  • Reportes
Clientes
  • Lista de clientes
  • Agregar/Editar
  • Búsqueda rápida
Pedidos
  • Pedidos online
  • Gestión de estados
  • Notificaciones

Opciones Solo para Administradores

Restricción: Las siguientes opciones solo están disponibles para usuarios con rol "admin":
  • Configuración de Empresa
  • Gestión de Usuarios
  • Facturación Electrónica
  • Editar/Eliminar Productos
  • Editar/Eliminar Clientes

Punto de Venta (POS)

Diseño de Interfaz

División 50/50: En pantallas de escritorio, el POS se divide en dos paneles iguales (50% cada uno) para mejor visualización.
Panel Izquierdo
  • Catálogo de productos
  • Barra de búsqueda
  • Escaneo de códigos
  • Atajos de teclado
Panel Derecho
  • Carrito de venta
  • Control de cantidades
  • Total actualizado
  • Finalizar venta

Atajos de Teclado

Tecla Función
F1 Agregar/Buscar Cliente
F2 Finalizar Venta
F3 Enfocar Búsqueda
F4 Limpiar Venta
ESC Volver/Limpiar búsqueda
Enter Confirmar acciones

Sistema de Precios Escalonados

Funcionalidad Clave: El sistema soporta 1 precio base + 4 precios escalonados (5 precios totales) por producto, aplicándose automáticamente según la cantidad.

Configuración

En el formulario de producto, sección "Gestión de Precios":

  • Precio de Compra: Lo que pagaste
  • IVA: 0%, 5% o 10%
  • Recargo 1: Para precio base
  • Recargo 2-5: Para los 4 precios escalonados
  • A partir de 1-4: Cantidad mínima para aplicar cada precio escalonado

Ejemplo Práctico

Configuración:
Precio Compra: ₲ 10,000 Recargo 1: 50% → Precio Base: ₲ 15,000 Recargo 2: 35% → Precio 1: ₲ 13,500 | A partir de: 10 Recargo 3: 20% → Precio 2: ₲ 12,000 | A partir de: 50 Recargo 4: 15% → Precio 3: ₲ 11,500 | A partir de: 100
Visualización en POS:
₲ 15,000
x10 ₲ 13,500
x50 ₲ 12,000
x100 ₲ 11,500

Aplicación Automática

¡Automático! El sistema cambia el precio automáticamente cuando modificas la cantidad:
  • 1-9 unidades → ₲ 15,000 c/u
  • 10-49 unidades → ₲ 13,500 c/u
  • 50-99 unidades → ₲ 12,000 c/u
  • 100+ unidades → ₲ 11,500 c/u

Gestión de Productos

Listado de Productos

Ubicación: Admin → Productos

Información mostrada:

  • Código: Código único del producto
  • Nombre: Nombre del producto
  • Categoría/Subcategoría: Clasificación
  • Precio: Precio de venta base
  • Stock: Cantidad disponible
  • Estado: Activo/Inactivo

Crear/Editar Producto

Campos del formulario:
Información Básica:
  • Código (opcional, se genera automático)
  • Nombre del producto
  • Descripción
  • Categoría
  • Subcategoría (opcional)
  • Imagen del producto
Inventario:
  • Stock inicial
  • Stock mínimo (alerta)
  • Unidad de medida
Gestión de Precios:
  • Precio de compra
  • IVA (0%, 5%, 10%)
  • Recargo 1 (%) → Precio base
  • Recargo 2-5 (%) → Precios escalonados
  • A partir de 1-4 → Cantidades mínimas

Cálculo Automático de Precios

Los precios de venta se calculan automáticamente al ingresar el precio de compra y los recargos. El sistema aplica el IVA si corresponde.

Categorías y Subcategorías

Organiza tus productos en categorías para facilitar la navegación:

  • Categorías: Grupos principales (ej: Electrónica, Alimentos, Ropa)
  • Subcategorías: Subdivisiones dentro de cada categoría (ej: Smartphones, Tablets, Computadoras)

Gestión de Clientes

Listado de Clientes

Ubicación: Admin → Clientes

Información mostrada:

  • Nombre completo
  • Documento de identidad (RUC/CI)
  • Email
  • Teléfono
  • Ubicación (Ciudad, Departamento)
  • Tipo de contribuyente

Búsqueda Rápida

API de búsqueda: El sistema incluye búsqueda rápida de clientes por nombre o documento, especialmente útil desde el POS.

Crear/Editar Cliente

Campos del formulario:
Datos Personales:
  • Nombre completo
  • Email
  • Teléfono
  • Fecha de cumpleaños (opcional)
Datos Fiscales:
  • Documento (RUC o CI)
  • Tipo de contribuyente (Consumidor Final, Contribuyente)
Ubicación Geográfica:
  • Departamento
  • Ciudad
  • Dirección completa

Sistema de Ubicaciones

El sistema incluye un catálogo completo de ubicaciones geográficas de Paraguay (departamentos, distritos y ciudades) según la Dirección General de Estadística, Encuestas y Censos (DGEEC).

Ventas y Reportes

Historial de Ventas

Ubicación: Admin → Ventas

Información mostrada:

  • Fecha y hora de la venta
  • Número de factura
  • Cliente
  • Vendedor (usuario que realizó la venta)
  • Total de la venta
  • Método de pago
  • Estado (completada, pendiente, cancelada)

Detalle de Venta

Al hacer click en una venta, se muestra:

Información completa:
  • Lista de productos vendidos
  • Cantidad y precio unitario de cada producto
  • Subtotal por producto
  • IVA desglosado (5% y 10%)
  • Total general
  • Datos del cliente
  • Forma de pago

Opciones de Impresión

El sistema soporta múltiples formatos de impresión:

  • Ticket 56mm: Para impresoras térmicas pequeñas
  • Ticket 80mm: Para impresoras térmicas estándar
  • Factura A4: Para impresoras láser o de inyección

Ventas a Crédito

El sistema soporta ventas a crédito, permitiendo registrar pagos parciales y seguimiento de saldos pendientes.

Reportes

Información disponible:

  • Ventas del día/semana/mes
  • Productos más vendidos
  • Ventas por vendedor
  • Resumen de ingresos

Configuración de Empresa

Acceso restringido: Solo usuarios con rol "admin" pueden acceder a esta sección.

Información de la Empresa

Ubicación: Admin → Configuración

Campos configurables:
Datos Básicos:
  • Nombre de la empresa
  • Slug (identificador en la URL)
  • RUC
  • Email de contacto
  • Teléfono
  • Slogan (aparece en el footer)
Dirección:
  • Dirección completa
  • Ciudad
  • Departamento
Branding:
  • Logo de la empresa
  • Colores corporativos

Gestión de Usuarios

Los administradores pueden crear y gestionar usuarios del sistema:

  • Crear usuarios: Admin o Personal
  • Asignar roles: Define permisos de acceso
  • Activar/Desactivar: Controla el acceso al sistema
  • Editar perfiles: Actualiza información de usuarios

Configuraciones Generales

  • Moneda del sistema: 1 moneda base (₲ Guaraníes) + 3 monedas alternativas configurables
  • Zona horaria
  • Formato de fechas
  • Opciones de facturación

Facturación Electrónica

El sistema está preparado para integración con el sistema de Facturación Electrónica de la SET (Subsecretaría de Estado de Tributación) de Paraguay.

Tipos de Factura

El sistema soporta los siguientes tipos de comprobantes:

Factura Electrónica

Tipo: Factura

Uso: Ventas a contribuyentes

Características:

  • RUC del cliente requerido
  • Desglose de IVA
  • Timbrado electrónico
  • Envío automático a SET
Ticket/Boleta

Tipo: Comprobante simplificado

Uso: Ventas a consumidor final

Características:

  • No requiere RUC del cliente
  • Proceso más rápido
  • Para montos menores
  • IVA incluido

Configuración de Facturación

Ubicación: Admin → Configuración → Facturación Electrónica

Datos requeridos:
  • RUC de la empresa
  • Timbrado
  • Número de establecimiento
  • Punto de expedición
  • Rango de facturación autorizado
  • Fecha de vencimiento del timbrado

Proceso de Facturación

  1. 1Completar venta en el POS
  2. 2Seleccionar tipo de comprobante
  3. 3Ingresar datos del cliente (si es factura)
  4. 4Confirmar la venta
  5. 5El sistema genera el comprobante
  6. 6Envío automático a SET (si está configurado)
  7. 7Impresión del comprobante

Estado de Facturas

El sistema registra el estado de cada factura:

  • Aprobada - Factura procesada correctamente por SET
  • Pendiente - En proceso de envío
  • Rechazada - Error en el proceso
  • Sin enviar - Modo offline o ticket
Importante: La integración con SET requiere certificados digitales válidos y configuración específica proporcionada por la Subsecretaría de Estado de Tributación.

Actualizaciones Recientes

Febrero 2026
  • ✅ Sistema de precios escalonados automático
  • ✅ Página de acceso denegado amigable
  • ✅ Cierre de sesión redirige a tenant
  • ✅ Footer mejorado con logo y slogan
  • ✅ Iconos de navegación rápida (POS, Admin)
  • ✅ POS dividido 50/50 en escritorio
  • ✅ Visualización de múltiples precios en productos

Versión del Tutorial: 1.0

Sistema: AMI Multi-tenant POS

Última actualización: 17 de febrero de 2026