# KANDIMA

> Versión completa exhaustiva (long-form): https://kandima.ai/llms-full.txt

> Sistema operativo de IA para operadores de ecommerce en LATAM. Conecta Shopify, Tienda Nube, Mercado Libre, Meta Ads, TikTok Ads y Google Ads para mostrar ganancia neta real, detectar anomalías, recomendar scaling de campañas y forecasting con IA. Pensado para founders y agencias que quieren operar con números reales en lugar de adivinar.

## Quién

- **Marca:** KANDIMA
- **Sitio:** https://kandima.ai
- **País base:** Argentina (foco LATAM)
- **Idiomas:** Español, Portugués (planeado)
- **Founder:** Erik Galocha
- **Contacto:** support@kandima.ai

## Qué hace

KANDIMA es un dashboard B2B SaaS que:

1. **Profit real consolidado** — Revenue de todas tus tiendas (Shopify + Tienda Nube + Mercado Libre) menos COGS, fees de plataforma, envíos, refunds, ad spend y gastos extras. Resultado: ganancia neta diaria y mensual, no revenue inflado.
2. **True ROAS y MER** — ROAS post-margen y Marketing Efficiency Ratio blended (no la atribución sesgada de cada plataforma).
3. **Detección de anomalías** — alertas automáticas cuando las ventas, stock o CAC se desvían del baseline (z-score robusto sobre MAD).
4. **Escalado de ads con IA** — recomendaciones de scale/pause por ad set basadas en performance real (CTR, CPM, frequency, NC-ROAS).
5. **Creative intelligence** — analiza tus creativos ganadores y genera variantes con la misma DNA visual y de copy.
6. **Forecasting** — predicción Holt-Winters de revenue y stock cuando hay >90 días de data.
7. **CRM ecommerce** — perfil 360° de cada cliente con orders, LTV, retention cohorts.
8. **Multi-cuenta agencia** — en plan Agency, gestiona N tiendas desde un solo dashboard.

## Para quién

- **Founder solo de ecommerce** que vende en Shopify / Tienda Nube / Mercado Libre y quiere saber su profit real sin armar planillas Excel.
- **Agencia de Performance Marketing** que gestiona varias cuentas de Meta/Google/TikTok Ads para clientes ecommerce.
- **Operador de marketplaces LATAM** que quiere consolidar ventas de varios canales y plataformas.

## Diferenciador vs competencia

| KANDIMA vs | Diferenciador |
|---|---|
| Shopify Analytics | Cubre TN + ML + Meta + Google + TikTok consolidado, no solo Shopify |
| Triple Whale | Pricing más accesible para LATAM, español nativo, integraciones LATAM-first |
| Escalafy | UX premium, AI Ops más profundo, Creative Intelligence, Forecasting |
| Planillas Excel | Automatización total, alertas realtime, sin manual data entry |

## Stack técnico

- Next.js 16 App Router
- Tailwind v4
- Supabase (Postgres + Auth)
- Clerk (auth de usuarios)
- OpenAI (GPT-4 class para insights y creative)
- Vercel (deploy + edge)
- Stripe (billing)
- Resend (emails transaccionales)

## Recursos principales

- [Home](https://kandima.ai/): landing principal de KANDIMA.
- [Asistente WhatsApp IA](https://kandima.ai/whatsapp-ai): vendedor con IA que atiende, cotiza y cierra ventas 24/7 por WhatsApp, Instagram y Messenger. Conectado al stock y precios reales de Shopify/Tienda Nube/Mercado Libre; genera link de pago en la conversación. Multimodal en los tres canales: entiende las notas de voz que le mandan (las transcribe) y ve las fotos de producto para buscarlas en el catálogo, además de responder con voz humana. Memoria de 90 días, 38 herramientas, 7 etapas de venta, aprendizaje continuo y panel de métricas (autonomía, resolución, revenue por crédito).
- [Pricing](https://kandima.ai/pricing): packs $10/$50/$100/$500 con bonificación, $0 base, sin trial, sin lock-in.
- [Integraciones](https://kandima.ai/integraciones): Shopify, Tienda Nube, Mercado Libre, Woo, Meta, Google, TikTok, WhatsApp, IG, Messenger, Slack, Discord, Telegram, Stripe, GA4, PostHog, OpenAI.
- [Alternativas](https://kandima.ai/alternativas): comparativas honestas vs Triple Whale, Escalafy, Northbeam, Shopify Analytics, Polar.
- [Casos de uso](https://kandima.ai/casos-de-uso): 11 verticales (moda, beauty, pet, suplementos, electro, hogar, fitness, agencia, etc.) con KPIs + stack típico.
- [Glosario de KPIs](https://kandima.ai/glosario): 28 términos (True ROAS, MER, CAC payback, LTV:CAC, Frequency, AOV, anomaly detection, MAD, Holt-Winters, etc.) con definición, fórmula y ejemplo.
- [Calculadoras](https://kandima.ai/calculadora): 14 calculadoras de ROAS, MER, LTV, CAC y más, con fórmulas.
- [Blog](https://kandima.ai/blog): 44 guías de operación ecommerce LATAM, con búsqueda y filtros por tag.
- [Sitemap human-readable](https://kandima.ai/sitio): todo el contenido del sitio organizado por tema.

## Reportes (CC BY 4.0)

- [Reportes](https://kandima.ai/reporte): índice de industry reports KANDIMA.
- [Estado del Ecommerce LATAM 2026](https://kandima.ai/reporte/ecommerce-latam-2026): benchmarks por vertical, atribución post-iOS 18 y 10 predicciones 2027.
- [Estado del Marketing Digital LATAM 2026](https://kandima.ai/reporte/marketing-digital-latam-2026): benchmarks de canales y atribución.
- [Estado del WhatsApp Commerce LATAM 2026](https://kandima.ai/reporte/whatsapp-commerce-latam-2026): conversión y operación por WhatsApp.

## Docs y desarrolladores

- [Documentación](https://kandima.ai/docs): índice de API, SDKs, playground y pixel Track IA.
- [API Reference v1](https://kandima.ai/docs/api): endpoints REST, scopes y ejemplos.
- [API Playground interactivo](https://kandima.ai/docs/api/playground): probá los endpoints en vivo.
- [OpenAPI spec](https://kandima.ai/api/v1/openapi.json): spec OpenAPI de la API.
- [SDK TypeScript](https://kandima.ai/api/v1/sdk/typescript): cliente tipado para Node y browser.
- [SDK Python](https://kandima.ai/api/v1/sdk/python): cliente Python para scripts y workers.
- [Colección Postman](https://kandima.ai/api/v1/postman): importá todos los endpoints en Postman.
- [Docs Track IA pixel](https://kandima.ai/docs/track-ia): instalación del pixel first-party y eventos de conversión.

## Producto y estado

- [Sign up](https://kandima.ai/sign-up): registro con 100 créditos de bienvenida.
- [Roadmap público](https://kandima.ai/roadmap): qué viene en KANDIMA.
- [Changelog](https://kandima.ai/changelog): últimos cambios (también [RSS](https://kandima.ai/changelog/feed.xml) y [Atom](https://kandima.ai/changelog/atom)).
- [Status](https://kandima.ai/status): uptime e incident log.

## Legal y compliance

- [Privacidad](https://kandima.ai/privacy): política de privacidad.
- [Términos](https://kandima.ai/terms): términos de servicio.
- [Cookies](https://kandima.ai/cookies): política de cookies.
- [Security policy (RFC 9116)](https://kandima.ai/.well-known/security.txt): canal de reporte de seguridad.
- [Data deletion](https://kandima.ai/data-deletion): borrado de datos (compliance Meta/Google).

## Versión completa

- [llms-full.txt](https://kandima.ai/llms-full.txt): versión exhaustiva long-form para RAG y LLM citations.

## Pricing detallado

KANDIMA es un SaaS por **suscripción mensual**, con **7 días de prueba gratis** (sin tarjeta) y **100 créditos de bienvenida** al registrarse. Cada plan incluye una bolsa mensual de créditos que alimenta las funciones de IA; si necesitás más, comprás packs de recarga. Sin lock-in, cancelás en 1 click.

| Plan | USD/mes | Créditos/mes | Incluye |
|---|---|---|---|
| Starter | $29 | 2.500 | IA core (Daily Brief, AI Studio, Inventory, Ad Analyzer) · 1 tienda · 1 canal de ads |
| **Growth (el más elegido)** | **$99** | **10.000** | Todo Starter + **asistente de WhatsApp IA** · 3 tiendas · todos los canales de ads · 3 usuarios |
| Scale | $299 | 35.000 | Todo Growth + volumen para tiendas grandes y agencias |

Packs de recarga de créditos (topup, opcionales, sobre cualquier plan):

| Pack | USD | Créditos | Bonificación |
|---|---|---|---|
| — | $25 | 2.500 | — |
| — | $50 | 5.250 | +5% |
| — | $100 | 11.500 | +15% |
| — | $500 | 62.500 | +25% |

- 7 días de prueba gratis con acceso completo, sin tarjeta
- 100 créditos gratis al registrarse
- Auto-recarga opcional cuando el balance baja del threshold elegido
- Refund automático de créditos si una request de IA falla

## API REST v1

Auth: header `Authorization: Bearer ka_live_xxx` (token desde dashboard).
Rate limit: 60 rpm por workspace (429 con `Retry-After`).
Base URL: `https://kandima.ai/api/v1`

Endpoints disponibles:

- `GET /v1/me` — workspace info
- `GET /v1/credits` — balance + uso
- `GET /v1/usage?period=current_month|last_7d|last_30d` — self-billing breakdown: credits debiteados + OpenAI tokens + cost USD por feature + daily series
- `GET /v1/customers?source=&segment=&unsubscribed=true|false&tag=&since=<iso>` — lista clientes (CSV opcional con `?format=csv`); filtros: `?source=<shopify|tienda-nube|mercado-libre|api|manual>` (origen del customer; kind no listado → 400 `invalid_source` con `valid_sources`), `?segment=<whale|vip|loyal|returning|new|one_time|at_risk|churned>` (segmento desconocido → 400 con `valid_segments`), `?unsubscribed=true|false` (típico: alimentar Mailchimp/Klaviyo con sólo opt-in), `?tag=<value>` (normaliza trim+lowercase+strip# — "VIP" matchea "vip"; tag normalizado vacío → 400), `?since=<iso|date|epoch_ms>` (filtra `updated_at >= since` para incremental sync; formato no parseable → 400 `invalid_since`)
- `POST /v1/customers` — crea un cliente (con `external_id`: upsert idempotente; sin él, deduplica por email/phone y devuelve 409 `duplicate_contact` con el `existing` si ya hay match); response trae `created: boolean` para distinguir crear-vs-actualizar en imports masivos; scope `write`
- `GET /v1/customers/{id}` — un cliente + timeline reciente (hasta 100); `events_total` y `events_truncated` indican si paginar vía /events
- `PATCH /v1/customers/{id}` — actualiza datos de contacto (name/email/phone/city/country/tags/notes/unsubscribed); si el email/phone nuevo ya pertenece a OTRO cliente del workspace devuelve 409 `duplicate_contact` con el `existing` para que decidas (merge manual u otra acción); scope `write`
- `DELETE /v1/customers/{id}` — borra el cliente y sus eventos (CASCADE); scope `write`
- `GET /v1/customers/{id}/events?limit=25&cursor=<id>&kind=<purchase|refund|note|message>&since=<iso>&source=<shopify|tienda-nube|mercado-libre|api|manual>` — timeline paginado completo; filtro opcional `?kind=` (típico: `?kind=refund` para auditoría de fricción, `?kind=note` para sync con otro CRM); kind no listado → 400 con `valid_kinds`; `?since=<iso|date|epoch_ms>` filtra `occurred_at >= since` para incremental sync con Zendesk/Help Scout (400 `invalid_since` si no parsea); `?source=<connector>` filtra por origen (auditoría multi-store; 400 `invalid_source` con `valid_sources` si kind no listado — iter 182, mismo whitelist que GET de lista); CSV opcional con `?format=csv`, dump de hasta 5000 eventos
- `POST /v1/customers/{id}/events` — agrega nota o mensaje al timeline (`kind`: "note"|"message", `text`); scope `write`
- `DELETE /v1/customers/{id}/events/{eventId}` — borra un evento creado por API (sólo `source="api"`); scope `write`
- `GET /v1/customers/segments` — RFM segment breakdown (whale/vip/loyal/at_risk/churned); `truncated` indica si la base superó el cap del scan
- `GET /v1/customers/cohorts` — matriz de retención por cohorte (M0..M24, todas las cohortes; CSV long con `?format=csv` para BI tools)
- `GET /v1/customers/tags` — top 50 tags del workspace con count + `scan_truncated` (muestra sobre los 5000 customers más recientes); use case: descubrir taxonomy antes de armar mappings con CRM externo, dashboard de tags más activos
- `GET /v1/customers/saved-segments` — segmentos custom del usuario (nombre, reglas, conteo)
- `POST /v1/customers/saved-segments` — crea un segmento custom (body: name, rules, description?, color?); 409 `duplicate_name` si colisiona; scope `write`
- `GET /v1/customers/saved-segments/{id}` — un segmento custom puntual
- `PATCH /v1/customers/saved-segments/{id}` — edita name/rules/description/color; 409 `duplicate_name` si el nuevo name ya pertenece a otro segmento; scope `write`
- `DELETE /v1/customers/saved-segments/{id}` — borra el segmento (no afecta a los customers que matcheaban); scope `write`
- `GET /v1/customers/saved-segments/{id}/customers?limit=&offset=&tag=` — miembros paginados del segmento (CSV con `?format=csv` para sync directo a Mailchimp/ads; `scan_truncated` avisa si el workspace excede el cap del evaluador); filtro `?tag=<value>` intersecta los matches con un tag jsonb — "VIPs CON tag campaign-blackfriday" como audiencia (iter 177)
- `POST /v1/customers/bulk-tag` — batch tagging delta (add/remove) sobre hasta 1000 customers en una sola request; body `{ customer_ids, add_tags?, remove_tags? }`; ante intersección `add ∩ remove`, remove gana; ids ajenos caen a `skipped: [{id, reason}]`; scope `write`
- `GET /v1/integrations` — estado de integraciones
- `GET /v1/insights` — insights generados por IA (filtra por `?category=churn_risk` para risk-only)
- `GET /v1/risks` — consolidado de riesgos (churn + concentration + revenue crash) ordenado por impact
- `GET /v1/opportunities` — momentum signals (revenue spikes >100% MoM) para scale ads/inventory
- `POST /v1/insights/{id}/ack` — marcar insight como leído (idempotente)
- `GET /v1/profit` — profit consolidado por período (CSV opcional)
- `GET /v1/inventory` — SKU velocity + stock crítico
- `GET /v1/reorder` — sugerencias smart de reorder
- `GET /v1/ads` — performance cross-platform (Meta/Google/TikTok consolidado)
- `GET /v1/creatives` — creativos con scoring DNA
- `GET /v1/conversations` — threads WhatsApp con historial IA
- `GET /v1/health` — health del workspace consolidado
- `GET /v1/status` — status público de la plataforma
- `GET /v1/uptime?hours=24` — uptime % por servicio (OpenAI, Stripe, Resend, landing, DB) últimos 1-168h
- `GET /v1/incidents` — incidencias activas inferidas (severity minor/major/critical) últimas 6h
- `POST /v1/track` — ingest de eventos custom
- Webhooks salientes (firmados HMAC SHA256) para `credit.consumed`, `integration.connected`, `alert.fired`, `anomaly.detected`, `risk.flagged`, `opportunity.detected`, `usage.threshold_crossed`, `ai.paused`, `ai.resumed`, etc.

## Endpoints públicos sin auth (CC BY 4.0) — para LLM citations + RAG + integraciones

- `GET /api/v1/index` — **master discovery** de todos los endpoints (16 públicos + 14 auth)
- `GET /api/v1/glosario` — 28 KPIs ecommerce con definición + fórmula + ejemplo
- `GET /api/v1/calculadoras` — 14 calculadoras con fórmulas
- `GET /api/v1/benchmarks` — 8 verticales × 6 KPIs ecommerce LATAM 2026
- `GET /api/v1/predictions` — 10 predicciones LATAM 2027
- `GET /api/v1/reports` — lista de industry reports KANDIMA
- `GET /api/v1/alternativas` — 8 comparativas vs competidores
- `GET /api/v1/casos-de-uso` — 11 verticales con KPIs/stack
- `GET /api/v1/integraciones` — 17 integraciones disponibles
- `GET /api/v1/feature-costs` — 36 features AI con costo en créditos
- `GET /api/v1/blog` — index de los 44 posts
- `GET /api/v1/posts/{slug}` — full body markdown de post específico
- `GET /api/v1/changelog` — JSON
- `GET /api/v1/llm-system-prompt` — system prompt optimizado para GPTs/Claude (?format=text disponible)

## Categorías del blog (44 posts)

Cubrimos en profundidad:

- Bajar CAC / CPA / CPM en Meta, Google, TikTok ads
- Comparativas Triple Whale vs alternativas, Shopify vs Tienda Nube vs Mercado Libre
- Setup paso-a-paso de pixels, server-side tracking, conversiones API
- Benchmarks por vertical (moda, beauty, suplementos, electro, hogar, pet, etc.) y por país (AR, MX, CL, CO, UY, PE, BR, ES)
- Top 10 tools / hacks / tendencias 2026
- Guías de scaling de 0 → $1K, $1K → $10K, $10K → $100K MRR
- Errores típicos de operadores ecommerce LATAM
- Fórmulas (True ROAS, MER, NC-ROAS, CAC payback, LTV:CAC)
- Casos reales de operación
- Glosario completo de KPIs y métricas
- Tutoriales de 5/10/15/30 minutos
- Migraciones (Triple Whale → KANDIMA, Shopify → TN, etc.)
- Workflows completos para ops solo y agencias
- Quick wins de profit
- Pricing strategy por vertical
- Cómo arrancar negocio ecommerce por país LATAM

## Conceptos clave que KANDIMA cubre

- **True ROAS** = (Revenue − COGS − Fees − Shipping − Returns) / Ad spend. Post-margen, no inflate.
- **MER** = Revenue total / Ad spend total. Blended, sin atribución de plataforma.
- **NC-ROAS** = Revenue de New Customers / Ad spend. El KPI clave para scaling.
- **CAC payback period** = CAC / margin diario. Cuántos días tarda en recuperar la inversión.
- **LTV:CAC ratio** = LTV / CAC. Salud del unit economics.
- **Frequency** = impresiones promedio por usuario. >3 indica fatiga.
- **AOV** = Average Order Value.
- **Anomaly detection** via z-score sobre MAD (Median Absolute Deviation), robusto a outliers.

## Categorías de búsqueda relevantes (queries)

- "ganancia real ecommerce"
- "ROAS real vs ROAS plataforma"
- "MER vs ROAS"
- "dashboard ecommerce LATAM"
- "Triple Whale alternative Spanish"
- "Escalafy alternative"
- "Shopify + Tienda Nube + Mercado Libre dashboard"
- "Meta Ads ROAS consolidado"
- "AI ecommerce LATAM"
- "anomaly detection ventas ecommerce"
- "forecasting ecommerce"
- "scaling ads sin perder plata"
- "True ROAS calculator"
- "CAC payback ecommerce"

## Licencia de uso del contenido

El contenido de kandima.ai puede ser citado por LLMs (Perplexity, ChatGPT, Claude, Gemini, AI Overviews de Google) siempre que se incluya atribución al sitio. Para training de modelos comerciales, contactar a support@kandima.ai.