Misión y visión
Misión
Que ningún negocio pequeño dependa de que una sola persona lo recuerde todo.
Sacamos lo que un negocio sabe de la cabeza de su dueño y lo ponemos donde su gente lo pueda ver, todos los días, sin pedir permiso.
Visión
Un negocio propio que no cueste la vida propia.
Locales pequeños donde el dueño cierra la puerta a las seis, se va, y el negocio sigue sabiendo lo que sabe. Donde el equipo no espera instrucciones porque ya está mirando lo mismo. Donde quien emprende tiene tiempo y cabeza para cultivarse en algo más que su propio inventario.
Qué es friendly-123
friendly-123 es una aplicación de control de inventario, ventas y clientes pensada para el pequeño negocio: la tienda de barrio, el local de ropa, la libería boutique, el puesto en el mercado, el stand de feria de fin de semana. Un solo archivo, funciona sin internet, y le dice a golpe de vista qué necesita tu negocio hoy — sin manuales de contabilidad, sin Excel, sin depender de que el dueño esté siempre presente.
Para quién es
Dueños de 1 a 6 puntos de venta (locales, stands, perchas de consignación) que necesitan control real de inventario y plata sin contratar un sistema corporativo.
Su filosofía
Cada producto tiene un color. Tú no memorizas reportes: el color ya te dice si vender, reponer, promover o dejar dormir.
Funciona sin internet
Es una PWA local-first: se instala en el celular o tablet, guarda todo en el dispositivo y sincroniza cuando hay señal.
Los ocho subsistemas de la app
| Vista | Qué resuelve | Quién la ve |
|---|---|---|
| Hoy | Semáforo general del negocio, alertas, ganancia del día, producto estrella | Dueño (plata) / Empleado (conteos) |
| Inventario | Todas las tarjetas de producto, filtros por color, ajustes rápidos, alta de producto | Ambos (alta y perchas solo dueño) |
| Vendido | Cuadrícula táctil de venta, escáner de código de barras, cierre del día | Ambos |
| Etiquetas | Código de barras Code128 y QR listos para imprimir | Ambos |
| Perchas | Fotos de cada percha con semáforo de cumplimiento de meta | Ambos (fotos) / Dueño (gestión) |
| Clientes | Fichas con código único y matriz de estaciones (RFM) | Ambos |
| Comisiones | Liquidación de perchas de socio, franquicia y consignación | Dueño |
| Avanzado | Actividad, gastos, P&G, balance, inventario valorizado, respaldo | Dueño (contador con subclave) |
Los contadores arrancan al llegar a esta sección — así se ve en acción uno de los efectos dinámicos del manual.
Primeros pasos
Instalar friendly-123 toma menos de dos minutos. Estos son los pasos, en orden, para tener el local funcionando hoy mismo.
Abre el enlace de tu negocio en Chrome o Safari
Nunca en el navegador interno de WhatsApp o Instagram — ahí los diálogos de confirmación pueden bloquearse. Si te llega por WhatsApp, toca "Abrir en el navegador".
Instálala como app (opcional pero recomendado)
En Android: menú ⋮ → "Instalar app" o "Agregar a pantalla de inicio". En iPhone: botón compartir → "Agregar a inicio". Queda con su ícono "123" propio y abre sin barra de navegador.
Define tus tres códigos de acceso
Cada rol tiene un código de 3 dígitos (000–999) que se guarda cifrado en el dispositivo: código de dueño (ve la plata y la configuración), código de empleado (vende y cuenta stock, no ve ganancias) y código de contador (una subclave aparte que protege la capa contable dentro de Avanzado). Regístralos en Avanzado → Acceso, junto con un correo de recuperación.
Crea tus sucursales y perchas
Una sucursal agrupa perchas para reportes (ej. "Downtown"). Una percha es la unidad operativa real donde vendes (el mostrador, el stand, la mesa de feria). Puedes tener varias perchas por sucursal.
Da de alta tus primeros productos
A mano desde Inventario → "+ Agregar", o escaneando el código de barras en Vendido y llenando la ficha nueva. Define nombre, categoría, precio, costo, proveedor, stock inicial y los umbrales rojo/amarillo (de cuántas unidades para abajo se enciende cada alerta).
Haz tu primer respaldo
Avanzado → Exportar respaldo, protegido con una clave. Guárdalo en tu WhatsApp o Drive. Repite esto cada semana como mínimo — la app te lo recuerda si pasa mucho tiempo.
Checklist de arranque
- App instalada en el celular o tablet del local
- 3 códigos de acceso definidos (dueño, empleado, contador) + correo de recuperación registrado en Avanzado → Acceso (si EmailJS está configurado, llega por correo; si no, el código aparece en pantalla)
- Sucursales y perchas creadas con su tipo (propio, socio, franquicia, consignación)
- Al menos 10 productos reales cargados con precio, costo y umbrales
- Gastos mensuales de cada ubicación registrados en Avanzado
- Primer respaldo cifrado descargado y guardado fuera del celular
- Empleado capacitado en Vendido + ajuste rápido de stock
El lenguaje de colores: Sistema Simon
Cada producto en friendly-123 está en uno de cinco colores. El color nunca es decorativo: es un diagnóstico automático que combina tu stock, tus umbrales, tu margen y tus días sin vender. Aprende esta tabla una sola vez y ya sabrás leer cualquier percha de un vistazo, para siempre.
| Color | Significa | Se enciende cuando… | Acción del dueño |
|---|---|---|---|
| Verde | Saludable | Stock por encima del umbral amarillo, margen normal, se ha vendido recientemente | Sigue así, no requiere atención |
| Amarillo | Oportunidad | Stock sano y no dormido (menos de 45 días sin ventas), y margen ≥ 50% | Empújalo: está dejando plata sobre la mesa |
| Naranja | Urgente-pronto | Stock entre el umbral rojo y el amarillo, o vence en 4–7 días | Véndelo primero / prográmalo para reposición esta semana |
| Rojo | Emergencia | Stock en cero o por debajo del umbral rojo, vencido o vence en ≤3 días | Actúa hoy: repón, transfiere o retira |
| Negro | Capital dormido | 45 días o más sin ninguna venta, con stock sano | Libera ese dinero: descuento, combo o retíralo del catálogo |
Pruébalo tú mismo: simulador de estado
Elige un color: así se ve una tarjeta real de Inventario.
Un color, un significado
Cada estado tiene un solo color plano. No hay grados ni intensidades: una tarjeta está en verde, en amarillo, en naranja, en rojo o en negro, y eso es todo lo que hay que leer. Antes existía una escala de tres niveles dentro de cada color; se retiró porque obligaba a interpretar matices en vez de reconocer un estado de un vistazo, que es justamente lo que este sistema viene a evitar.
El azul quedó fuera del semáforo a propósito: nunca es una señal de inventario. Si aparece, es parte de la interfaz, no un estado de tus productos.
La regla de oro: nunca memorices, solo mira el color
Todo el diseño de friendly-123 parte de una convicción de Juan Fernando Carpio: el dueño de un pequeño negocio no tiene tiempo de leer reportes de 12 columnas cada mañana. Sí tiene tiempo de mirar una pantalla 8 segundos y saber, sin pensar, qué hacer primero. Por eso cada color tiene siempre la misma pregunta implícita:
- Rojo pregunta: "¿qué se me acaba o se me vence HOY?"
- Naranja pregunta: "¿qué debo vender primero esta semana?"
- Amarillo pregunta: "¿qué producto me está dejando más plata y debería empujar?"
- Negro pregunta: "¿qué plata tengo enterrada en una percha sin moverse?"
- Verde no pregunta nada — es la ausencia de problema, y eso también es información.
Vista Hoy: el semáforo general del negocio
Es la primera pantalla que ve cualquiera al abrir la app. Resume, en 3 segundos, si el negocio necesita atención hoy.
Qué ve el dueño
- Hero tri-estado del negocio: Verde = sin urgencias. Amarillo = hay productos naranja (revisar esta semana). Rojo = hay productos en emergencia. Productos negro y amarillo-oportunidad no afectan el hero
- Entró hoy / Salió hoy / Ganancia de hoy / Valor de tu inventario
- Ventas del día y venta promedio (ticket promedio)
- Lista de alertas rojas y naranjas ordenadas por urgencia
- El "apunte del día": una frase de gestión distinta cada día del año
Qué ve el empleado
- El mismo semáforo y las mismas alertas de stock
- Cantidad de ventas del día (sin montos de plata ni ganancia)
- Los productos estrella que el dueño marcó para impulsar hoy
Esta separación es intencional: el empleado sabe qué vender y cuánto se ha vendido, pero la rentabilidad queda solo para el dueño.
Inventario: la cuadrícula de tarjetas
Cada producto es una tarjeta con su color. Puedes filtrar por estado, ajustar stock sin escanear, marcar estrellas y dar de alta productos nuevos.
Los campos de un producto
| Campo | Ejemplo real (USD) | Para qué sirve |
|---|---|---|
| Nombre | Camiseta AC/DC — Back in Black | Se ve en tarjetas, etiquetas y reportes |
| Categoría | Camisetas | Agrupa en Etiquetas y en reportes |
| SKU | CAM-ACDC-BIB | Código interno legible, no cambia al renombrar el producto |
| Código de barras | 7861000030033 | Lo que lee el escáner en Vendido |
| Precio de venta | $20.00 | Lo que paga el cliente |
| Costo | $8.50 | Define el margen y por tanto si el producto puede ser amarillo (oportunidad) |
| Umbral rojo / amarillo | 8 / 16 unidades | Debajo de 8 se enciende rojo; entre 8 y 16, naranja |
| Proveedor | Rock Import EC | Referencia para reposición |
| Perecible + fecha de caducidad | Sí — vence 2026-07-08 | Activa las alertas de vencimiento (rojo/naranja) sobre las de stock |
| Método de costeo | FIFO (recomendado) | Orden de venta sugerido para perecibles: primero lo que vence antes |
| Comisionista | María Auquilla | Asocia el producto a un comisionista/promotor (opcional). Se elige en un desplegable al dar de alta o editar el producto |
Ajuste rápido de stock (sin escanear)
Cada tarjeta tiene botones − y + para mover 1 unidad sin pasar por el escáner — perfecto para conteos físicos, mermas o ingresos de mercadería. La app siempre pide un motivo corto ("Merma", "Conteo físico", "Regalo a cliente") y lo guarda en el log de movimientos, visible solo para el dueño — el candado natural contra descuadres.
La estrella : el producto que quieres empujar hoy
El dueño puede marcar cualquier producto con una estrella. Ese producto aparece automáticamente en la sección "Para impulsar hoy" de la Vista Hoy y arriba del todo en la cuadrícula de Vendido — así el empleado sabe exactamente qué recomendar sin que el dueño tenga que estar presente.
Crear variantes sin repetir trabajo
Abre la ficha de un producto y toca Crear variante. Elige qué cambia (color, talla, material, estilo, sabor u otro) y escribe el valor. La app precarga precios y configuración, exige un código propio y deja el stock nuevo en cero. Revisa la información antes de guardar y añade una foto que corresponda a esa variante.
Perchas y sucursales
Una percha es tu unidad operativa: el mostrador, un stand, una mesa de feria. Una sucursal agrupa perchas para reportes y liquidación. Cada percha tiene un tipo de negocio que determina cómo se reparte la plata.
| Tipo de percha | Cómo se reparte la venta | Ejemplo |
|---|---|---|
| Propio | 100% para el dueño, sin comisión | Mostrador principal del local |
| Socio | % de comisión fijo o por escalas de cumplimiento de meta | Stand en el Farmers Market: 25% base, sube a 40% si supera $120/mes |
| Franquicia | % de comisión pactado, reporta a su propia sucursal | Punto de venta operado por un tercero bajo tu marca |
| Consignación | % de comisión al consignatario, el resto es neto para el dueño | Makers Fair: 30% para la promotora |
Escalas de comisión: premia el esfuerzo
En vez de un porcentaje fijo, puedes definir escalas que suben la comisión mientras más vende la percha. Ejemplo real de una promotora en el mercado, con meta mensual de $300:
| Ventas del mes hasta… | Comisión |
|---|---|
| $80 | 25% |
| $100 | 30% |
| $120 | 35% |
| $999+ | 40% |
Así la promotora tiene un incentivo directo: mientras más venda, mayor porcentaje se lleva sobre el total — no solo sobre el excedente.
En cada percha de tipo socio, franquicia o consignación hay un botón Commission que abre el editor del trato: % del asociado, meta mensual, tramos/escalas, contribución fija, mínimo garantizado, lectura preferida (asociado/casa) y el interruptor "usar la comisión propia de esta percha" (para ignorar el trato del comisionista cuando quieras que mande el de la percha).
Feria de fin de semana: percha temporal
Para eventos de 2–3 días (una feria artesanal, un bazar navideño) crea una percha marcada como Feria con su propia comisión. Al cerrarla queda archivada con todo su historial y saltas directo a Comisiones para ver su liquidación — sin mezclar sus números con el resto del año.
Fotos de percha con semáforo de meta
La vista Perchas muestra una foto real de cada punto de venta (tomada con la cámara del celular) junto a un semáforo de cuánto lleva cumplido de su meta mensual. Es la forma más rápida de saber, sin abrir números, si una percha va bien.
Vendido: cuadrícula táctil + escáner + cierre del día
Vendido no es un carrito de compras: es control de inventario en tiempo real. Cada toque es una unidad menos en stock, con 5 segundos para deshacer.
Tres formas de registrar una venta
1. Toque directo
Cuadrícula con todos los productos de la percha activa, estrellas primero. Un toque = una unidad vendida. El cliente elegido en el selector aplica a todos los toques.
2. Escaneo o búsqueda
Escribe o escanea el código de barras / SKU. La app suena un beep de confirmación y muestra la ficha completa con precio, stock y estado.
3. Cierre del día
Para quien no registra en vivo: apunta cuántas unidades salieron de cada producto y aplica todo junto al final del día. Descuenta stock y calcula comisiones igual que una venta normal.
Ejemplo de cierre del día — tienda de libros latinoamericanos
La librería del centro no registra venta por venta durante el día. Al cerrar, el dueño cuenta lo que falta en la mesa y apunta:
| Producto | Unidades vendidas hoy | Precio | Subtotal |
|---|---|---|---|
| Kentukis — Samanta Schweblin | 2 | $19.00 | $38.00 |
| Pelea de gallos — M. F. Ampuero | 1 | $18.00 | $18.00 |
| Cometierra — Dolores Reyes | 1 | $21.00 | $21.00 |
| Total del cierre | $77.00 | ||
Al aplicar, la app descuenta el stock de las 3 obras y suma esas ventas al resumen del día — como si se hubiera registrado en vivo.
Venta de la casa, cortesía y fiado
Venta de la casa es una venta pura de la casa: no se asigna comisión a nadie y no cambia al comisionista de la percha. Se elige venta por venta; nunca es obligatorio escoger comisionista.
Cortesía: el cliente no paga (ingreso $0), pero el costo sí cuenta. Fiado: la venta se suma a la deuda del cliente en Clientes; necesita un cliente elegido.
Etiquetas: código de barras y QR listos para imprimir
Cada producto genera su propia etiqueta con código de barras Code128 real (escaneable) y un QR opcional que contiene el código del producto. No abre una ficha web ni publica datos del negocio. Todo se dibuja localmente — sin depender de ningún servicio externo.
7861000030033 — así se "dibuja" el código de barras al abrir una etiqueta (efecto de trazo animado)
Qué trae la etiqueta imprimible
- Nombre del producto y precio grande (fácil de leer desde lejos en un mostrador)
- Fecha de vencimiento si el producto es perecible
- Código de barras Code128 escaneable por cualquier lector
- Código QR con el código del producto, para lectores compatibles. No abre otra aplicación ni publica una ficha del negocio.
- Puedes tocar el código de barras para imprimir solo el código, o guardarlo como imagen PNG — ideal para pegatinas hechas por fuera
En iPhone: al tocar Imprimir aparece la hoja de impresión de Safari. Desde allí eliges una impresora AirPrint o guardas/compartes el resultado.
Clientes y la matriz de estaciones (RFM)
Cada cliente recibe un código único al registrarse. La app clasifica automáticamente a cada uno en una "estación" según qué tan seguido compra y cuánto gasta — la misma lógica que usan las grandes cadenas (RFM: Recencia, Frecuencia, Monto) pero contada con metáforas de siembra, fáciles de recordar sin cursos de marketing.
Otoño — enfriándose
Eran de tus mejores clientes y hace rato no vienen. Búscalos hoy: son la esquina donde se recupera plata perdida.
Verano — en plena cosecha
Compran seguido y fuerte. Cuídalos como oro: son tu ingreso más estable.
Invierno — dormidos
Sin señales de vida. Un mensaje personalizado puede despertarlos.
Primavera — creciendo
Recién germinan. Riégalos: una atención pequeña y vuelven.
Derecha: compran hace poco. Arriba: dejan más dinero. (Pasa el mouse sobre cada cuadrante.)
Cómo se usa en la práctica
Registra al cliente en el mostrador
Nombre y teléfono (opcional). La app genera un código único al instante — se lo puedes mostrar o anotar en su recibo.
Selecciónalo al vender
En Vendido, el selector "Cliente" aplica ese código a la venta. Así la app arma su historial sin trabajo extra.
Revisa la matriz una vez por semana
El cuadrante Otoño es tu lista de reactivación prioritaria: son clientes que ya demostraron que compran fuerte, solo hace falta un empujón.
Importar tu cartera de golpe (CSV)
Si ya tienes una lista de clientes, el dueño puede subirla toda de una vez desde el bloque "Importar tu cartera desde un archivo", al fondo de esta misma sección. Necesita un CSV con dos columnas —nombre y teléfono— y cada cliente recibe su código único automáticamente. El formato exacto, con ejemplo y reglas, está en la Sección 13. El empleado no ve este botón: para él existe solo el registro manual de arriba.
Fiado, abono y pago pendiente
Fiado es lo que el cliente te debe. Abono es crédito a su favor: puede ser para un producto o «sin determinar». El saldo de cada cliente se calcula siempre de su historial, nunca se escribe a mano.
El botón Pago pendiente muestra con un toque solo a los clientes que te deben. Si la app no pudo verificar el saldo de alguno, te lo dice en vez de esconderlo.
Comisiones: lo que le debes a cada promotor/a
Calculado venta por venta, sin Excel y sin sorpresas. Cada percha de tipo socio, franquicia o consignación aparece aquí con su liquidación del mes.
Qué muestra cada tarjeta de liquidación
- Ventas brutas del mes de esa percha
- Comisión de la promotora (según su % fijo o su escala)
- Neto que queda para el dueño
- Cumplimiento de meta mensual, si la percha tiene una definida
- Alerta si la percha lleva 7+ días sin ninguna venta ("percha dormida")
- Botón "Marcar como pagado" una vez que le transfieres o entregas su comisión
- De dónde sale el %: si el comisionista tiene su propio trato, la tarjeta lo indica ("usando el trato propio del comisionista"); si no, usa el estándar de la percha
- Contribución fija y avisos del trato (por ejemplo, si la contribución fija se ignora porque la percha usa escalas por meta)
Editar un comisionista (✎)
Toca el botón ✎ Edit en la tarjeta de un comisionista (o el nombre del promotor dentro de una liquidación) para abrir su editor. Ahí puedes cambiar su nombre, su % base, su meta mensual, sus tramos/escalas, sus datos de pago (teléfono, cédula, banco, cuenta) y notas. Si el comisionista tiene meta y escalas propias, estas mandan sobre las de la percha.
Escalas de comisión por meta
En el editor del comisionista (o en el botón Commission de una percha) puedes definir tramos: el % sube mientras más vende en el mes. Ejemplo con meta de $300: hasta $80 → 25%, hasta $100 → 30%, hasta $120 → 35%, $999+ → 40%. El % se aplica sobre el total vendido, no solo sobre el excedente.
Matriz RFM de promotores/as
Al final de Comisiones, una matriz de 4 cuadrantes clasifica a cada promotor según su valor (ventas del mes) y su recencia (días sin vender): Campeones (alto valor y activos), En riesgo (alto valor pero dormidos), Promesa (activos pero de bajo valor) y Dormidos. Es la misma lógica de la matriz de clientes, aplicada a tu equipo de ventas.
Ranking de promotores/as
Un medallero automático que muestra unidades vendidas, ventas brutas, su SKU más fuerte y una alerta si algún promotor lleva más de 7 días sin vender nada — útil para detectar a tiempo si alguien necesita apoyo o capacitación.
Matriz BCG de tu inventario
Basada en ventas de los últimos 60 días, clasifica automáticamente cada producto en uno de cuatro cuadrantes clásicos de gestión de portafolio — sin que tengas que calcular nada.
Promesas
Venden poco pero van subiendo. Dales vitrina y espacio para crecer.
Estrellas
Venden mucho y van subiendo. Protege su stock — son tu futuro inmediato.
Pesos muertos
Sin movimiento en 60 días. Libera ese capital con descuentos o combos.
Vacas lecheras
Venden mucho, estables. Financian todo lo demás del negocio.
Derecha: venden más que el promedio. Arriba: van creciendo. (Pasa el mouse sobre cada cuadrante.)
Modo Avanzado: la capa contable
Aquí vive el detalle técnico del negocio — actividad, gastos, y la contabilidad ligera (P&G, balance e inventario valorizado). No es para el día a día; es para el contador, el administrador, o el dueño que quiere ver los números a fondo. Por eso pide su propia subclave.
Gastos mensuales
Arriendo, luz, sueldos, internet, etc. Ingresas el total mensual de cada ubicación y la app lo reparte entre los días reales del mes (28 a 31) para estimar el gasto operativo del día dentro del P&G.
Caja chica (en la pestaña Gastos)
El control de efectivo de cada percha vive ahora en la pestaña Gastos (antes estaba dentro de la carpeta de la percha). Elige la percha, ves su saldo y registras + Ingreso o − Retiro con su motivo. Solo lo ven el dueño y el admin; es un control operativo de efectivo en el punto físico, no reemplaza el P&L ni las comisiones.
Pérdidas y ganancias (del día) — ejemplo con impuesto encendido al 15%
| Concepto | Ejemplo |
|---|---|
| Ventas cobradas (con IVA 15%) | $312.00 |
| IVA cobrado (se entrega a la autoridad tributaria) | $40.70 |
| Ingresos netos (sin IVA) | $271.30 |
| Costo de ventas | $118.40 |
| Utilidad bruta | $152.90 |
| Gastos operativos (del día) | $16.77 |
| Utilidad neta del día | $136.13 |
Balance simplificado e inventario valorizado
El balance suma el efectivo estimado del día más el valor de todo tu inventario a precio de venta. El inventario valorizado desglosa, producto por producto, cuánto vale a costo, cuánto vale a precio de venta, y cuál es tu utilidad potencial si vendieras todo hoy — útil para saber cuánto capital tienes realmente "parado" en la percha.
Actividad reciente
Un historial cronológico de todo lo que pasó: ventas, ajustes de stock con su motivo, altas de producto, anulaciones, cambios de estrella, transferencias entre perchas y liquidaciones de comisión. Es tu bitácora anti-descuadre — si algo no cuadra al final del mes, aquí está el rastro completo.
Exportar CSV contable y hacer respaldo
friendly-123 nunca depende de un servidor externo para tus datos. Se guardan en tu dispositivo (y, si activas el cuaderno compartido, viajan cifrados entre tus dispositivos), y tú decides cuándo sacarlo en dos formatos distintos según lo que necesites.
Formato A — Reporte contable en CSV (para tu contador)
Desde Avanzado → "Descargar reporte contable (.csv)". Es un archivo de texto separado por comillas que Excel o Google Sheets abren directamente, con acentos correctos (incluye BOM UTF-8). Esta es la estructura exacta que genera:
"Reporte contable — friendly-123","07/07/2026, 09:14" "AVISO","Insumo para el contador. No es una declaración ante la autoridad tributaria." "PÉRDIDAS Y GANANCIAS (hoy)","" "Ventas cobradas (con IVA)","$312.00" "IVA cobrado (15%, se entrega a la autoridad tributaria)","$40.70" "Ingresos netos (sin IVA)","$271.30" "Costo de ventas","$118.40" "Utilidad bruta","$152.90" "Gastos operativos","$16.77" "Utilidad neta","$136.13" "BALANCE SIMPLIFICADO","" "Ingresos del día estimados","$312.00" "Inventario valorizado","$3,540.00" "Total activos","$3,852.00" "INVENTARIO VALORIZADO POR PRODUCTO","" "Producto","Stock,Costo,Venta,Utilidad potencial" "Camiseta AC/DC - Back in Black","25,$212.50,$500.00,$287.50" "Taza Ceramica Rock Austin","40,$120.00,$320.00,$200.00"
El archivo se descarga con el nombre reporte-contable-friendly-2026-09-22.csv — la fecha de descarga queda siempre en el nombre para no confundir versiones.
- Descárgalo el mismo día que se lo envías al contador — es un corte del día en curso, no acumulado histórico.
- Ábrelo en Google Sheets si vas a compartirlo por enlace en vez de adjunto; conserva las tildes gracias al BOM.
- Si manejas varias ubicaciones, descárgalo una vez por cada percha/sucursal (selecciona la ubicación arriba antes de exportar) — el reporte siempre corresponde a la ubicación activa en pantalla.
- Guarda una copia mensual en una carpeta con el nombre del mes; con 12 archivos al año tienes tu historial contable completo sin depender de la nube de nadie.
Formato B — Respaldo completo cifrado (.json)
Este es el respaldo real de todo el negocio: productos, ventas, clientes, perchas, comisiones y tus códigos de acceso. Está en Avanzado, debajo de la subclave contable, porque es una acción sensible.
Exportar respaldo
La app te pide una clave de al menos 8 caracteres para proteger el archivo (puedes dejarla en blanco, pero no se recomienda). Se descarga como respaldo-friendly-2026-09-22.json.
Guárdalo fuera del celular
Envíatelo por WhatsApp a ti mismo, súbelo a Google Drive, o mándalo por correo. Si el celular se pierde o se daña, este archivo es la única forma de recuperar el negocio completo.
Importar respaldo (si hace falta restaurar)
Avanzado → Importar respaldo → selecciona el archivo → ingresa la clave. Esto reemplaza todos los datos actuales — la app siempre pide confirmación explícita antes de proceder.
Formato C — Importar tu cartera de clientes (CSV)
Si ya tienes tus clientes en Excel, en el celular o en otra app, no hace falta teclearlos uno por uno. Guarda tu lista como CSV y súbela desde Clientes → (al fondo) "Importar tu cartera desde un archivo". Solo el dueño ve este botón; el empleado únicamente registra clientes a mano.
El archivo necesita dos columnas, nombre y teléfono, en ese orden. La primera fila puede ser un encabezado (la app lo detecta y lo salta). Así se ve un archivo válido:
nombre,telefono
Rosa Quinde,0991111001
Marco Sarmiento,0991111002
"Pérez, Juan Andrés",0987654321
Carmen Ulloa,
| Regla del archivo | Detalle |
|---|---|
| Columnas | Nombre en la primera, teléfono en la segunda (el teléfono puede ir vacío) |
| Encabezado | Opcional — si la primera fila dice "nombre" o "teléfono", se salta sola |
| Nombres con coma | Enciérralos entre comillas dobles: "Pérez, Juan" |
| Repetidos | Si un nombre ya existe (o se repite dentro del archivo) se salta, sin crear duplicados |
| Código único | Cada cliente nuevo recibe su código C-#### automáticamente al importar |
| Límites | Hasta 5 000 clientes por archivo y máximo 1 MB de tamaño |
Al terminar, la app te dice exactamente cuántos agregó, cuántos saltó por repetidos y cuántos ignoró por no tener nombre — así sabes que tu cartera entró completa.
Puntos de restauración automáticos
Además del respaldo manual, friendly-123 guarda —solo dentro de ese navegador— una foto de tus datos cada cierto tiempo, por si borras algo sin querer. Esto no reemplaza el respaldo manual: si se borra el caché del navegador o cambias de celular, esos puntos se pierden con él.
Formato D — Respaldo automatizado a ti mismo (correo y/o WhatsApp)
La forma más segura de no perder nunca tus datos por olvido. En Avanzado, con el deslizador (slider) de frecuencia, eliges cada cuánto quieres que la app te obligue a respaldarte — diario, semanal, quincenal o mensual — y por cuáles canales, correo y/o WhatsApp. El mensual es el mínimo obligatorio y no se puede alargar más: así, si algún mes se te pasa por completo, nunca pierdes más de 30 días de historial. Tú fijas y modificas esa frecuencia cuando quieras.
- En teléfono o tablet: al tocar "Respaldar" se abre el menú de compartir de tu propio celular con el archivo ya adjunto. Eliges tu WhatsApp o tu Gmail, te lo envías a ti mismo/a y listo. No tienes que buscar ni adjuntar nada a mano.
- En computadora: se descarga el archivo y se abre el correo/WhatsApp con el mensaje ya escrito; ahí sí adjuntas el archivo recién descargado y envías. Es el máximo posible sin servidor en una laptop.
Transferencias entre perchas
El dolor más común en negocios con más de un punto de venta: una percha se queda sin stock mientras la de al lado tiene de sobra, y nadie se entera hasta que el cliente ya se fue. friendly-123 lo detecta en el momento exacto en que más importa.
Cómo funciona
- Cuando un producto está en rojo o naranja, la app revisa si ese mismo SKU tiene stock sano en otra percha activa.
- Si lo encuentra, muestra un aviso directo en la ficha del producto: "Hay 18 unidades en Local Downtown" con un botón para solicitar la transferencia sugerida.
- La cantidad sugerida siempre deja stock suficiente en el origen (nunca vacía la percha que presta).
- El dueño de origen aprueba la transferencia desde Avanzado — en ese momento el stock se descuenta del origen y queda “en tránsito”.
- El dueño de destino confirma la recepción (también desde Avanzado) — solo entonces el stock se suma al destino. Si el mismo dueño maneja ambos puntos, son dos clics distintos: uno para aprobar y otro para confirmar.
Seguridad, respaldo automático y modo sin internet
Códigos de acceso por rol
Tres códigos de 3 dígitos, cifrados en el dispositivo (dueño, empleado, contador). Un correo de recuperación permite generar uno nuevo si se olvida.
Guardia de doble pestaña
Si abres el negocio en dos pestañas o dispositivos a la vez, la app lo detecta y avisa — evita que una venta se pierda porque la última pestaña en guardar "pisó" a la otra.
Caja negra de errores
Guarda los últimos 20 errores técnicos en el dispositivo. Si algo falla, puedes mandarle esa información a soporte por WhatsApp sin necesitar herramientas de programador.
Sincronización multi-dispositivo
En «Sincronizar equipo», copia la licencia de tu equipo y compártela una vez con cada dispositivo. Misma licencia, mismo cuaderno: ventas, stock y PINs quedan sincronizados solos. Los datos del cuaderno viajan cifrados entre sus dispositivos; FRIENDLY-123 no puede leerlos.
Modo sin conexión (PWA)
El "cascarón" de la app —pantallas, botones, lógica— se guarda en el dispositivo la primera vez que abres friendly-123, así que vuelve a abrir incluso sin señal. Lo único que siempre se pide fresco, nunca desde caché, son tus datos reales y las actualizaciones de versión.
Si olvidas tu clave
Toca «¿Olvidaste?» en la pantalla de entrada. Si alguien del equipo olvidó su PIN, el dueño o un admin puede cambiarlo desde la lista de equipo (Avanzado → Equipo y acceso).
Tu instancia, tu equipo y el control anti fraude
Estas son las novedades que convierten friendly-123 de "una maqueta bonita" en tu negocio, con tu gente y tus reglas.
Probar, activar y comprar
Con el PIN 456 entras a la tienda de muestra: datos ficticios para practicar vender, ajustar stock y cerrar el día. La tienda de muestra nunca vence.
Con el PIN 789 activas tu instancia: registras tu correo y tu WhatsApp, y el dispositivo pasa a ser tuyo, con un identificador único para que tus datos nunca se mezclen con los de otro negocio. Desde ese día tienes 30 días de uso completo, sin topes.
Al terminar la prueba sin licencia pagada, la app queda en solo lectura: puedes ver y exportar toda tu información, pero no registrar nada nuevo. Tus datos nunca se borran. Para seguir registrando, compra tu licencia por WhatsApp +593 99 990 5080 o en staff@jfcarpio.com. La licencia pagada vale para todos los dispositivos de tu negocio y se activa sola, sin volver a entrar.
Tu nombre de negocio, arriba
Como dueño verás un lápiz ✎ junto al título de arriba. Tócalo y escribe el nombre real de tu negocio: queda guardado en tu instancia y viaja en tus respaldos y sincronizaciones. Si por lo que sea fallara, el título por defecto se queda y nada más se rompe.
Tu equipo: empleados con su propio PIN
En Avanzado → Empleados das de alta hasta 49 empleados, cada uno con su nombre y su PIN de 3 dígitos. Cuando entran con su PIN, cada movimiento que hacen queda firmado con su nombre en el historial: quién vendió, quién ajustó stock, quién anuló. Usa PINs distintos al tuyo y al del contador.
Control anti fraude
En Avanzado → Control anti fraude tienes, de un vistazo, tres cosas:
Integridad del historial
Cada movimiento va sellado y encadenado al anterior. Si alguien edita o borra el historial en el equipo para tapar un faltante, el sello no cuadra y aquí sale en rojo, señalando dónde se rompió y qué persona rodea la ruptura.
Anulaciones por persona
Cuántas ventas anuló hoy cada empleado. El truco clásico —vender, cobrar en efectivo y luego anular la venta para quedarse la plata— deja rastro aquí.
Mermas por persona
Cuántas unidades bajó a mano cada empleado (los ajustes negativos). Un robo disfrazado de "rotura" o "merma" se ve sumado, con nombre.
Cuaderno compartido: todo tu equipo al día
Si usas el negocio en más de un dispositivo (caja y bodega, por ejemplo), abre Avanzado → Sincronizar equipo, copia la licencia de tu negocio y entrala una vez en cada dispositivo. Misma licencia, mismo cuaderno: ventas, stock, clientes y PINs quedan sincronizados solos. Los datos viajan cifrados de extremo a extremo.
Una licencia corresponde a un solo negocio: no crees un negocio paralelo en otro aparato. Con ambos aparatos conectados y despiertos, el objetivo es que los cambios aparezcan en menos de 2 segundos; si uno está sin internet o Safari lo suspendió, conserva su copia y se pone al día al reconectar. El indicador junto a Ayuda muestra el estado: sincronizado, conectando o fuera de línea. Estar conectado no reemplaza el respaldo descargable.
Instalar es opcional
friendly-123 funciona entrando a tu URL, siempre. Si quieres, tu teléfono te ofrecerá "Agregar a pantalla de inicio" para tenerla como un ícono más, pero es un extra, no un requisito. La primera opción siempre es entrar.
Casos reales de aprovechamiento full
Cinco negocios distintos, cinco formas distintas de exprimir friendly-123. Todas las cifras están en dólares, a escala real de pequeño negocio.
Tienda de rock — 3 perchas en Austin
Local Downtown (propio), Stand Farmers Market (socio, comisión escalonada) y Makers Fair (consignación). Vende camisetas, vinilos, souvenirs y coleccionables.
- Inventario: 61 SKU activos, valor de venta total ≈ $3,540, margen promedio 55%.
- Uso del semáforo: cada mañana el dueño filtra Inventario en rojo (3–5 productos típicamente) y repone antes de abrir; revisa negro una vez por semana para liquidar coleccionables sin movimiento en 45+ días (ej. el VHS "The Wall" dormido desde abril).
- Comisiones: la promotora del Mercado gana entre $20–41/mes según su escala; el dueño ve en un vistazo si alguna percha lleva 7+ días dormida.
- Transferencias: usa el aviso automático para mover camisetas estrella entre Downtown y el Farmers Market cuando una se queda corta.
Boutique de artesanía y ropa andina — Santa Fe
Sombreros de paja toquilla, aretes de filigrana, bufandas y chales de alpaca, pulseras de mullos. Ticket promedio más alto que el resto de casos.
- Precios reales: Sombrero de paja toquilla $30, Aretes de filigrana $22 (estrella , margen 73% → amarillo), Bufanda de alpaca $25, Chal bordado $35.
- Uso del color amarillo: los aretes de filigrana tienen margen altísimo (costo $6 sobre precio $22) — la app los marca amarillo automáticamente. El dueño los usa como "producto de entrada" en redes sociales porque cada venta deja mucha plata.
- Matriz de clientes: turistas ocasionales caen naturalmente en primavera o invierno; clientas locales frecuentes (bodas, eventos) llegan a verano — la boutique les avisa primero de colecciones nuevas.
Librería boutique de narrativa latinoamericana
Catálogo curado de 8 autoras y autores contemporáneos: Mariana Enríquez, Fernanda Melchor, Samanta Schweblin, Dolores Reyes, entre otras. Precios entre $17 y $22.
- Umbrales bajos por naturaleza: son libros de tiraje limitado — umbral rojo típico de 3 unidades, amarillo de 6. Con solo 2 unidades en bodega, "Mugre rosa" ya se enciende rojo.
- Cierre del día: como las ventas son pocas pero de ticket alto, el dueño no registra en vivo — usa el cierre del día al cerrar la librería, apuntando cuántos ejemplares salieron de cada título.
- Etiquetas: imprime código de barras + QR con el código de cada libro para identificarlo con un lector compatible. El QR no abre la sinopsis en el celular.
Tienda de barrio / minimarket — productos básicos
Agua, pilas, cinta adhesiva, fundas de regalo, chicles. Márgenes ajustados por naturaleza del rubro.
- Margen bajo: Agua sin gas 600ml cuesta $0.70 y se vende a $0.80: margen de apenas 12.5%. En básicos de alta rotación es normal, pero vale la pena negociar con el distribuidor cada seis meses. Revisa estos márgenes en el reporte contable.
- Alta rotación, ticket bajo: ideal para el modo Vendido por cuadrícula táctil — decenas de toques rápidos al día sin escribir nada.
- Reporte contable: con márgenes tan ajustados, el dueño revisa el CSV contable cada semana (no solo mensual) para vigilar que el volumen sí compense el margen bajo.
Feria de fin de semana — evento de 2–3 días
Una feria artesanal o bazar navideño usando la percha temporal "Feria de fin de semana" con comisión de consignación.
- Antes del evento: el dueño abre la feria desde Inventario → Perchas, define el nombre del evento (ej. "Holiday Market") y su % de comisión (30% en el ejemplo por defecto).
- Durante el evento: se asignan productos a esa percha y se vende por cuadrícula táctil — rápido, sin fricción, ideal con mucha gente en fila.
- Al cerrar: un toque archiva la percha (conserva todo su historial) y salta directo a Comisiones, mostrando la liquidación lista para pagarle al consignatario esa misma noche — sin esperar al cierre de mes.
Preguntas frecuentes
La app se queda siempre con la señal más grave entre las dos: si el vencimiento es más urgente que el nivel de stock, gana el vencimiento (y viceversa). Nunca se combinan colores ni se promedian — un producto muestra un solo color a la vez, el más urgente.
No. La Vista Hoy, los reportes de Avanzado y el detalle de comisiones están reservados al código de dueño (y al de contador para la capa contable). El empleado ve stock, ventas registradas y productos estrella, nunca montos de ganancia.
La percha es donde realmente vendes (el mostrador, el stand, la mesa de feria) — es la unidad operativa. La sucursal es un agrupador que usa la app para reportes y para organizar varias perchas bajo un mismo nombre en el gestor de Inventario → Perchas.
Sí, en cualquier momento desde la ficha del producto. La app exige que el umbral rojo sea siempre menor que el amarillo — si los pones al revés, no deja guardar y explica por qué.
Se pierde todo lo que no esté respaldado: los puntos de restauración automáticos viven solo en ese navegador y se pierden con el dispositivo. Por eso el respaldo manual cifrado (Avanzado → Exportar respaldo), guardado fuera del celular, es indispensable — no opcional.
No. Es un insumo ordenado para que tu contador trabaje más rápido — el propio archivo lo advierte en su primera línea. La declaración formal ante la autoridad tributaria siempre debe hacerla un profesional acreditado.
Cuando el stock está sano (por encima del umbral amarillo) pero no ha tenido ninguna venta en 45 días o más.
No. Es local-first: funciona completamente offline en el día a día. El internet solo se necesita para sincronizar entre varios dispositivos o hacer respaldos en la nube — y hasta eso tiene un método alterno por WhatsApp sin conexión directa.
Glosario rápido
- Percha
- Unidad operativa real de venta: mostrador, stand, mesa de feria.
- Sucursal
- Agrupador de perchas para reportes y organización.
- Sistema Simon
- Los cinco colores de estado (verde, amarillo, naranja, rojo, negro) que clasifican cada producto.
- Semáforo de colores
- Los cinco estados del inventario: verde, amarillo, naranja, rojo y negro. Un color plano por estado, sin niveles ni matices.
- Umbral rojo / amarillo
- Cantidades de stock que activan cada alerta de reposición.
- Producto estrella
- Producto marcado por el dueño para impulsar activamente hoy.
- Matriz de estaciones (RFM)
- Clasificación de clientes en primavera, verano, otoño e invierno según frecuencia y monto de compra.
- Matriz BCG
- Clasificación de productos en estrellas, vacas lecheras, promesas y pesos muertos según ventas de 60 días.
- Cierre del día
- Registro por lote de todas las ventas del día cuando no se registraron en vivo.
- Feria de fin de semana
- Percha temporal de consignación para eventos de 2–3 días, archivable con su historial.
- Respaldo cifrado
- Archivo .json con todo el negocio, protegido por una clave elegida por el dueño.