La embajadora

De qué se trata

La Embajadora es el sistema que construí para que una empresaria pudiera manejar su negocio: caja, pedidos, inventario, algo de contabilidad, y datos reales y precisos de cómo va todo, en un solo lugar. Construí el sistema en paralelo a la operación diaria del negocio, así que varias decisiones de producto terminaron siendo también decisiones de cómo iba a funcionar la empresa día a día.

Es una plataforma de comercio y operación hecha con Next.js 16, React 19, TypeScript y Drizzle ORM sobre SQLite/Turso, pensada para cubrir tanto la tienda pública como todo lo que pasa puertas adentro.

La tienda, del lado del cliente

• Catálogo, carrito y checkout, con pedidos a domicilio.

• Seguimiento público del pedido con un simple código.

• Cada producto tiene su propia página con URL propia, para que se pueda compartir y encontrar en buscadores.

Cómo optimizamos el SEO

No basta con que la tienda se vea bien, también tiene que encontrarse. Cada producto genera su propio título, descripción y URL canónica, con Open Graph y Twitter Cards para que se vea bien al compartirlo. Cada página de producto incluye además datos estructurados (JSON-LD) de tipo Producto y de ruta de navegación, para que Google entienda el precio, la disponibilidad y la categoría sin tener que adivinar. El sitemap se genera de forma dinámica a partir del catálogo real —cada producto nuevo entra solo, sin tocar nada a mano— y el robots.txt bloquea del rastreo todo lo que es backoffice, caja, repartos y pedidos individuales, dejando visible solo lo que sí debe indexarse.

Caja y ventas presenciales

• Una pantalla de caja dedicada, tipo punto de venta: buscador de productos, carrito y cierre de venta pensados para moverse rápido en el mostrador.

• Apertura y cierre de caja por turno, con saldo inicial, saldo final contado y la diferencia contra lo esperado, para que cuadrar la caja no dependa de la memoria de nadie.

• Métodos de pago diferenciados —efectivo, transferencia (con Nequi como opción propia), tarjeta— con registro de las vueltas dadas en efectivo.

• Cálculo automático de la comisión del datáfono en las ventas con tarjeta, IVA incluido, para que el margen real quede claro en cada venta.

• Cada venta genera su propio ticket, con una plantilla de diseño propia y los datos reales del negocio —nombre y logo tomados directo de la configuración de marca, no escritos a mano en el código.

Inventario y proveedores

• Productos con SKU, categoría, stock mínimo y fecha de vencimiento, con alertas por correo cuando algo se está agotando.

• Escaneo de códigos de barras para agilizar el registro y control de productos.

• Gestión de proveedores y órdenes de compra, para llevar el rastro de qué se pidió, a quién y cuándo.

Algo de contabilidad

• Registro de gastos por concepto, entidad y estado —pagado, pendiente, cancelado—, asociados o no a una orden de compra.

• Facturación automática configurable, con un histórico unificado de facturas de proveedores y gastos.

• Reportes del negocio para ver de un vistazo cómo van las ventas, los gastos y el inventario.

Repartos, cada quien con lo suyo

Los domiciliarios tienen su propia sección dentro del sistema, separada del backoffice completo: ven solo los pedidos que les corresponden, con el detalle de cada entrega, y pueden marcarlas como completadas desde ahí mismo, sin perderse entre pantallas que no necesitan.

Pensado para varias manos

Cajeros, bodega, repartidores y auditores tienen su propio rol y su propio acceso, cada uno viendo solo lo que le corresponde. El login de caja funciona con un código de acceso simple, pensado para alguien que está atendiendo un mostrador y no tiene tiempo de escribir contraseñas.

Por debajo

Usa Cloudinary para las imágenes y Resend para los correos transaccionales —alertas de stock bajo, avisos de nuevos pedidos. Para el punto de venta físico se conecta directo con impresoras de tickets por WebUSB y WebSerial, a través de una cola de impresión propia.