CRM omnicanal Sunkiss

Alcance

Sunkiss vendía por dos canales sin conexión entre sí y controlaba el stock, los costes y la publicidad por separado. El CRM lleva el stock como un registro de movimientos que no se borra, con remanente estimado por lote y vencimiento, descuenta cada venta pagada de Tiendanube y Mercado Libre una sola vez y gestiona combos, devoluciones y envíos a influencers. Sobre esa base calcula margen real con lo que liquidó Mercado Pago, segmenta clientes, lee Meta y Google Ads en modo lectura y programa las acciones del Cyber Monday. Está desplegado desde finales de octubre de 2026 con la Fase 1A cerrada.

Funciones principales

• Stock por lotes con FEFO. Cada entrada, venta, salida o ajuste es un movimiento que no se puede editar ni borrar. El remanente de cada lote se estima repartiendo las salidas por fecha de vencimiento y la interfaz lo rotula siempre como estimado.
• Combos con versiones. Un combo descuenta cada componente y su disponible es el que permite el componente más escaso. Cambiar la composición crea una versión nueva, así las ventas y las devoluciones pasadas conservan la composición con la que se vendieron.
• Ventas unificadas de Tiendanube y Mercado Libre. Tiendanube avisa por webhook firmado y los dos canales se consultan cada 15 minutos. Solo descuentan las pagadas, una publicación sin vincular genera una alerta y la vista de ventas muestra el margen con el coste de la fecha de venta.
• Conteo físico y alertas. El conteo compara lo contado con el stock estimado más lo pagado sin enviar menos las devoluciones en camino. La diferencia se imputa por lote de forma conservadora y un desvío de más de cien unidades abre una alerta.
• Devoluciones y envíos a influencers. Cada caso de posventa guarda su efecto en stock por producto y lote: vuelve a stock, baja o reembolso sin devolución. Un envío a una influencer cargado como salida y como pedido gratuito se detecta en los dos sentidos y descuenta una sola vez.
• Cobros conciliados y finanzas. Cada venta se cruza con el pago de Mercado Pago para obtener comisión, cuotas que paga el vendedor, retenciones y dinero pendiente de liberar. Finanzas suma gastos fijos, publicidad y costes en dólares para dar el resultado del mes.
• Clientes RFM y contactos sugeridos. Los compradores se deduplican entre canales por email, teléfono y documento. Se segmentan por recencia, frecuencia y monto, con cohortes por mes de primera compra, y el sistema propone mensajes de reposición o reseña que el dueño envía a mano.
• Anuncios y auditoría en modo lectura. Lee campañas de Meta y Google Ads, calcula el ROAS de equilibrio con el margen real del CRM y propone cambios con reglas fijas. La auditoría puntúa siete áreas con hallazgos e impacto estimado; el dueño aplica cada cambio a mano.
• Cyber Monday programado. Objetivos y comparativa en directo contra el Cyber anterior a la misma hora, día por día y por canal. Una grilla de promociones programa descuentos, cupones y encendido de anuncios de Meta, que se pueden ensayar enteros en modo simulación.

Arquitectura

Clientes

Web del dueño y del operador, usable desde el móvil · Encuesta pública por pedido con enlace firmado

Interfaz web

Next.js 16 y React 19 · Tailwind 4 con la identidad de la marca · Login con Supabase Auth y roles dueño y operador

API

FastAPI con psycopg 3 y pool de conexiones · JWT de Supabase y permisos por rol · Webhooks firmados con HMAC de Tiendanube · Módulo outbound, único lector del modo de escritura

Dominio y servicios

Ledger de stock y reparto FEFO como funciones puras · Motor de ventas por efecto deseado y posventa · Conciliación de cobros, finanzas y segmentos RFM · Reglas de anuncios, auditoría y acciones del Cyber · Claude con salida JSON validada por esquema

Datos e integraciones

PostgreSQL en Supabase con 38 migraciones y RLS · Tiendanube, Mercado Libre y Mercado Pago · Meta Ads, Google Ads e Instagram en lectura · Navegador Chromium propio para la Biblioteca de anuncios y TikTok · n8n con 11 flujos que solo disparan trabajos · Docker en un VPS de Hetzner

Tecnologías

Interfaz

Next.js, React, TypeScript, Tailwind CSS

Backend

Python, FastAPI, Pydantic, JWT

Datos

PostgreSQL, Supabase

IA y voz

Claude (Anthropic)

Automatización y vídeo

n8n, Playwright

Infraestructura

Docker, Hetzner

Integraciones

Mercado Libre, Mercado Pago, Meta Ads, Google Ads, Instagram Graph API, TikTok

Web y comercio

Tiendanube

Calidad

pytest

Resultados medidos

• 487 casos de test automatizados de backend, en 63 archivos (dominio, servicios, API y canales). Fuente: Recuento de funciones test_ en apps/api/tests del repositorio del CRM (commit 4133177) · 2026-11