Pedido en Línea

Catálogo público para que el cliente haga pedidos desde su celular sin login (PE-001)

PE-001 Clientes → Pedido en Línea consulta AY-100
Menú Ayuda

Enviarle este manual a un usuario

El enlace abre solo este manual, sin el menú del sistema. El usuario no necesita clave ni entrar a FactuPOS: se ve en cualquier navegador y en el celular.

El WhatsApp sale del número de Soporte Real y el correo de info@soportereal.com. Con Compartir desde este teléfono sale de su propio WhatsApp y elige el contacto de su lista, sin escribir el número.

Pedido en Línea PE-001

Catálogo interactivo público donde el cliente entra desde su celular o computadora con un link único, ve los productos con imágenes, agrega al carrito, ajusta cantidades y confirma el pedido. No requiere login. El pedido llega al sistema FactuPOS de la empresa para que un agente lo facture o procese.

Diferencia con CL-011 CL-011 Catálogo de Productos es solo lectura — el agente lo comparte para mostrar artículos. PE-001 Pedido en Línea es interactivo — el cliente arma su propio pedido y lo envía. Son módulos independientes, con tokens y tablas distintas.

Cómo se genera el link

Ya no hay que generarlo: con solo abrir el cliente para editarlo, si todavía no tiene link, el sistema se lo crea solo. Usted entra y lo manda.

  1. Abrir el cliente en CL-001 Catálogo de Clientes (botón Editar) o desde el modal de cliente en cualquier módulo de ventas.
  2. En la primera pestaña, Esencial, aparece el recuadro «Enviarle al cliente su link para hacer pedidos» con el celular y el correo del cliente ya escritos.
  3. Tocar Enviar link por WhatsApp o Enviar link por correo.
  4. Si quiere mandarlo a otro número u otro correo, lo escribe ahí mismo antes de tocar el botón. Eso no cambia la ficha del cliente.

En la pestaña Contacto sigue estando el link completo, para copiarlo o para volverlo a generar si necesita anular el anterior. El link es la dirección de la Tienda en Línea con acceso automático: https://soportereal.com/ecommerce/<empresa>?t=<token>

Le avisa si el mensaje salió de verdad Después de tocar el botón aparece un aviso grande con el resultado:
  • Verde — el mensaje salió. En el correo dice a qué dirección y a qué hora; en WhatsApp espera la confirmación del envío antes de ponerse en verde.
  • Amarillo — falta algo suyo: o se abrió WhatsApp y usted tiene que darle Enviar, o el mensaje quedó en cola y todavía no ha salido.
  • Rojo — no se envió, y dice por qué (número inválido, correo mal escrito, etc.).
Con o sin WhatsApp vinculado Si la empresa tiene su número de WhatsApp vinculado al sistema, el mensaje sale solo, desde el número de la empresa. Si no lo tiene, el botón dice «Compartir link por WhatsApp» y se abre su propio WhatsApp con el mensaje ya escrito: solo le da Enviar.
El cliente entra sin clave El cliente abre el link y entra de una vez a la Tienda en Línea, sin escribir correo ni clave: el token lo identifica automáticamente y ve sus propios precios.

Qué ve el cliente

  • Encabezado en una sola línea: logo de la empresa (o su nombre, si no tiene logo), buscador, cuenta y carrito. En el celular el botón de la cuenta queda solo con el ícono y el nombre del cliente se ve al tocarlo, arriba de «Cambiar mi clave» y «Cerrar sesión»
  • Barra de resultados en un renglón: Categorías, Con existencia, la cantidad de resultados y cuántos productos por página. Solo se parte en dos renglones cuando de verdad no cabe (catálogos de miles de productos en pantallas muy angostas)
  • Sidebar de categorías con conteo de productos por categoría
  • Búsqueda por nombre, código o detalle interno (debounce 400ms)
  • Cuadrícula de productos con imagen, nombre, categoría, precio y stock
  • Botón "Agregar" en cada producto que mete 1 unidad al carrito
  • Modal detalle al tocar el producto: carrusel con todas las imágenes, descripción, cantidad ajustable, agregar
  • Carrito flotante con badge de cantidad total
  • Confirmación con notas: el cliente puede dejar instrucciones (horario de entrega, etc.) antes de enviar
  • Pie con los datos de la empresa: nombre comercial, razón social, dirección, teléfono, correo y cédula, en una banda azul oscuro igual que el encabezado. La dirección se muestra solo con los nombres de provincia, cantón, distrito y barrio (sin los códigos de Hacienda). En el celular el pie va compacto para no robarle pantalla a los productos y se queda pegado abajo: aunque la búsqueda traiga pocos productos, el pie no sube a media pantalla.

Listas de precios y descuentos

El precio que ve el cliente respeta su configuración fiscal en CL-001:

  • Tipo de Precio (1-10) del cliente → se aplica la lista correspondiente (parámetro 275 decide si usa la versión 1 o 2 de las vistas de precios)
  • Descuento del cliente → se aplica automáticamente sobre el precio, mostrando el original tachado

Modal detalle (carrusel)

  • Galería: imagen principal grande + flechas + miniaturas + contador 1 / 3
  • Navegación con teclado: ← → entre imágenes, Esc para cerrar
  • Cantidad: − / input / + (respeta Fraccionamiento del artículo: si está activo permite decimales tipo 1.5 kg)
  • Descripción: muestra el campo DetalleInterno del artículo en una card destacada
  • Badge "+N imágenes" en la card de la cuadrícula si el producto tiene varias imágenes

Imágenes

Las imágenes se cargan desde la tabla ArticuloImagenes (campo ImagenNombre ordenado por Orden). Solo aparecen las que tienen archivo físico real en /img/<empresa>/articulos/: si la imagen está registrada en BD pero el archivo no existe, se muestra el placeholder de caja () en lugar de un 404.

Subir imágenes Las imágenes se cargan desde IN-002 Crear/Editar Artículo (módulo Inventarios). Pueden subirse desde la cámara del celular, galería o pegándolas desde el portapapeles. Cada artículo soporta múltiples imágenes con orden manual.

Filtro de productos visibles

Solo se muestran al cliente los artículos con:

  • MostrarEnWeb = 1 — checkbox "Mostrar en web" en IN-002
  • ArticuloEstadoCodigo = 1 — Estado activo

Vista móvil compactada

En pantallas ≤ 600px el grid pasa a 3 columnas con cards muy compactas (categoría y stock ocultos en la card; visibles al abrir el modal detalle). En pantallas ≤ 360px se reduce aún más la tipografía. El botón "Agregar" en mobile muestra solo el ícono .

Estilo visual

El catálogo usa estilo SLDS (Salesforce Lightning Design System): header blanco con borde inferior, brand azul #0176d3, tipografía Salesforce Sans, radius conservador (4-8px), sombras planas, lozenges (badges pill) con borde fuerte para stock. Todos los tokens están en --slds-* dentro de /pedido/css/pedido.css.

Seguridad del token Token aleatorio de 64 caracteres hex (random_bytes(32)). Sin login. Si el cliente comparte el link, cualquiera con la URL puede ver y pedir como ese cliente. El admin puede revocar el token desde el modal de cliente en cualquier momento (Estado = 0 en ClienteTokenPedido).

Base de datos

  • ClienteTokenPedido en cada empresa: Token (64 hex), ClienteCodigo, Estado, FechaCreacion, FechaExpiracion, UltimoAcceso
  • token_lookup en dbcontrol: índice cross-empresa con ServerIP, ServerDB, ClienteCodigo para que la URL pública resuelva a la BD correcta sin saber a priori a qué empresa pertenece

APIs públicas (sin auth)

EndpointMétodoFunción
/api/pedido/validar_token.phpGETVerifica el token y devuelve datos del cliente y empresa
/api/pedido/categorias.phpGETCategorías con conteo de productos visibles
/api/pedido/articulos.phpGETProductos paginados con imagen + array imagenes[]
/api/pedido/buscar.phpGETBúsqueda por nombre/código/detalle (top 30, ranking exacto>empieza con>contiene)
/api/pedido/confirmar_pedido.phpPOSTCrea el pedido con líneas y notas