mi mostrador.

Tu negocio al día.

Guía de instalación, funcionamiento sin conexión y recuperación · Versión 1.0

Primer uso

1. Ingresá al panel web con el usuario del titular. El administrador general habilita comercios, define vigencia y límites.
2. Completá Configuración con los datos del comercio. Agregá usuarios con roles Titular, Encargado o Cajero.
3. Cargá productos o importá CSV / Excel: codigo, nombre, categoria, precio, costo, unidad, minimo, stock. La plantilla usa pesos con decimales. El stock solo se aplica como inicial a productos nuevos.
4. Descargá e instalá Mi Mostrador en Windows 10/11 de 64 bits. Python viene incluido. Microsoft Edge WebView2 debe estar disponible.
5. Activá el equipo con Internet, la cuenta del titular y un nombre para la caja. Después podés ingresar con los usuarios habilitados del comercio.
6. Abrí Caja con el efectivo inicial. En Vender, usá F2 para buscar productos y F4 para cobrar.
7. Al terminar, contá el efectivo y cerrá Caja. Las diferencias quedan registradas.

Ventas y medios de pago

La suma de pagos debe coincidir con el importe de la venta. El efectivo recibido sirve para calcular el vuelto; solo el efectivo aplicado a la venta ingresa a caja. Los pagos combinados permiten dos medios. Cuenta corriente requiere un cliente.

Los descuentos y los cambios de catálogo requieren Titular o Encargado. La devolución referencia una venta original y no permite devolver dos veces la misma cantidad. El ticket es interno y su impresión se identifica como copia / reimpresión.

Cuando no hay Internet

Las operaciones de Windows se guardan en SQLite con su correspondiente movimiento de stock, caja y cola de envío. Cada envío tiene un UUID único. Si la respuesta se pierde, se reenvía la misma operación; el servidor devuelve el resultado ya guardado.

El indicador consulta el backend real. Estados: Sincronizado, Sin conexión con pendientes, Sincronizando y Requiere atención. La comprobación reintenta con espera gradual. Las imágenes, interfaz y tipografías necesarias no dependen de una CDN.

La autorización firmada permite hasta 30 días sin renovar conexión, limitada también por el vencimiento exacto de la licencia, sin días de gracia. Si vence, se bloquean las operaciones y se conserva la exportación y el respaldo de los datos. Revocar un usuario o equipo en la nube se hace efectivo al reconectar o al vencer su autorización local; no existe revocación instantánea de una PC desconectada.

El stock de varias cajas desconectadas puede divergir. La sincronización conserva las ventas efectivamente realizadas y muestra una advertencia si el stock consolidado resulta negativo. Recomendación para la salida inicial: una caja activa por comercio. Los cambios simultáneos de catálogo con versiones incompatibles pausan la cola y requieren revisión.

Respaldos y recuperación

• Datos locales: %LOCALAPPDATA%\Mi Mostrador. Credenciales de activación protegidas con Windows DPAPI para el usuario de Windows que activó la caja.
• Copias locales: carpeta backups, cada hora, se conservan las últimas 30. No se borran al desinstalar. Copiá periódicamente un respaldo a un disco externo.
• Antes de restaurar: cerrá las cajas, sincronizá pendientes y creá un respaldo adicional. Elegí una copia local del mismo comercio. La integridad de SQLite se comprueba antes de reemplazar.
• Después de restaurar: se reconcilia con la nube antes de habilitar nuevas operaciones. Las ventas ya aceptadas en el servidor no se borran por restaurar una copia anterior.
• Si el disco falla y existían ventas nunca sincronizadas, solo un respaldo local o externo puede recuperarlas. La nube no puede reconstruir lo que nunca recibió.
• En un equipo nuevo, activá nuevamente. Si se alcanzó el límite, el titular debe desactivar el dispositivo anterior desde el panel.
• El servidor genera un pg_dump diario y conserva los últimos 30. Están en el mismo VPS; para cubrir la pérdida del VPS se debe conectar un destino externo de respaldo.

Importación y auditoría

La importación valida todo el lote antes de confirmar. Códigos existentes actualizan el catálogo; códigos nuevos crean productos. Los precios de ventas anteriores no se recalculan al cambiar el catálogo. Las operaciones se conservan en un registro de auditoría con actor, equipo, fecha e identificador.

ARCA, facturación y pagos

Para ARCA hacen falta CUIT, punto de venta, certificados y clave privada propios del contribuyente, delegación del servicio, configuración fiscal de productos y pruebas de homologación. No se almacenó ningún certificado fiscal del usuario ni se emitió una factura de prueba o producción.

La integración debe implementar autenticación WSAA, consulta de último comprobante autorizado, solicitudes WSFE, persistencia de CAE y vencimiento, notas de crédito y reconciliación ante respuestas perdidas. La emisión sin conexión requiere una modalidad de contingencia expresamente habilitada; una cola local no es autorización fiscal.

Para Mercado Pago u otro proveedor se requieren credenciales del comercio, entorno de pruebas y webhook autenticado con conciliación. Hasta entonces, tarjetas, QR y transferencias se registran solo después de confirmar la acreditación externa.

Alcance de esta entrega

Los precios de los planes, condiciones comerciales, política de privacidad y nombre comercial definitivo deben definirse antes de vender licencias públicamente. Mi Mostrador es el nombre de trabajo; no se afirmó disponibilidad de marca.

Volver al panel →