# Vondi

> Vondi (por Tupla) es una plataforma para vender, cobrar y facturar desde el chat: catálogo, cotizaciones, pedidos, pagos (procesados por NetPay), facturación CFDI 4.0, envíos y un agente de IA que atiende por WhatsApp. Todo se opera desde un panel web, una API con API keys por permisos (scopes) y un servidor MCP para que cualquier agente de IA trabaje con tu tienda.

Documentación en español (México). Centro de ayuda: https://vondi.tupla.dev/ayuda. Versión completa en texto: https://vondi.tupla.dev/llms-full.txt.

## API y MCP

- [API keys de tu empresa](https://vondi.tupla.dev/ayuda/api-keys-de-empresa): Credenciales para que un sistema externo, un script o un agente de inteligencia artificial hable con tu cuenta sin usar tu usuario y contraseña.
- [Conectar por MCP (Claude u otro agente)](https://vondi.tupla.dev/ayuda/conectar-por-mcp): Un botón crea la API key recomendada y te da el comando de instalación con el secreto ya puesto, para que un agente de inteligencia artificial pueda operar tu cuenta.
- [Editar tu catálogo con un asistente (MCP)](https://vondi.tupla.dev/ayuda/mcp-catalogo): Crear, editar y dar de baja productos, variantes y precios pidiéndoselo en lenguaje normal a Claude u otro asistente conectado por MCP.
- [Rotar y revocar API keys](https://vondi.tupla.dev/ayuda/rotar-y-revocar-api-keys): Cuándo y cómo rotar (cambiar) o revocar (dar de baja) una API key, sin dejar al asistente sin acceso a mitad de un trabajo.
- [Multi-tenant: keys globales y COMMERCE_TENANT_ID](https://vondi.tupla.dev/ayuda/multi-tenant-y-keys-globales): Cuando un mismo agente debe operar varias empresas, o cuando soporte de plataforma necesita entrar a cualquier cuenta, se usan API keys globales y la variable de entorno COMMERCE_TENANT_ID.
- [Preguntas frecuentes: API keys y MCP](https://vondi.tupla.dev/ayuda/preguntas-api-mcp): Dudas comunes al crear llaves de integración y conectar asistentes.
- [Paquete npm del servidor MCP](https://www.npmjs.com/package/@cgalaviz/parlo-mcp): `npx @cgalaviz/parlo-mcp` con `COMMERCE_API_KEY` (y opcional `COMMERCE_TENANT_ID`, `COMMERCE_API_BASE_URL`).

## Primeros pasos

- [Qué es Vondi](https://vondi.tupla.dev/ayuda/que-es-vondi): El portal operativo de tu tienda: el cliente escribe por WhatsApp, un agente automático responde con tu catálogo real y tú ves y cierras la venta desde el panel.
- [Lista de arranque: tu primer día](https://vondi.tupla.dev/ayuda/lista-de-arranque): Los pasos, en orden, para dejar tu negocio listo para vender por WhatsApp: empresa, catálogo, envíos, agente, canal y una compra de prueba.
- [Recorrido del panel](https://vondi.tupla.dev/ayuda/recorrido-del-panel): Qué hace cada sección del menú lateral, cómo buscar rápido, y qué significan los términos que vas a encontrar en cada una.
- [Entrar, recuperar tu contraseña y cerrar sesión](https://vondi.tupla.dev/ayuda/entrar-a-tu-cuenta): Cómo iniciar sesión, qué hacer si olvidaste tu contraseña, cómo activar una invitación y por qué a veces el panel te pide entrar de nuevo.
- [Roles y qué puede hacer cada uno](https://vondi.tupla.dev/ayuda/roles-de-usuario): OWNER, ADMIN, VENDOR, FINANCE, CATALOG, SUPPORT, VIEWER: qué ve y qué puede modificar cada rol, y cómo invitar a alguien con el rol correcto.
- [Preguntas frecuentes: empezar](https://vondi.tupla.dev/ayuda/preguntas-primeros-pasos): Respuestas cortas a las dudas más comunes de los primeros días con el panel.

## Catálogo

- [Crear y editar productos y variantes](https://vondi.tupla.dev/ayuda/productos-y-variantes): Un producto puede tener varias variantes (talla, color, presentación), cada una con su propio SKU, precio, existencia y estado — paso a paso, con los formatos exactos que acepta cada campo.
- [Fotos de producto y variante](https://vondi.tupla.dev/ayuda/fotos-de-producto): Sube una foto general del producto y, si hace falta, una propia por variante — formatos, tamaño y dimensiones que acepta el sistema, y qué pasa si tu foto no cumple.
- [Importar catálogo desde un CSV](https://vondi.tupla.dev/ayuda/importar-catalogo): Sube muchos productos de golpe con un archivo CSV, con una vista previa (dry-run) antes de guardar nada — qué es un CSV, cómo funciona la validación y el tope de filas.
- [Preguntas frecuentes: catálogo](https://vondi.tupla.dev/ayuda/preguntas-catalogo): Dudas comunes al dar de alta productos, precios, existencias, fotos e importaciones.

## Clientes

- [Fichas de cliente](https://vondi.tupla.dev/ayuda/fichas-de-cliente): La ficha 360° de cada cliente: cifras de por vida, línea de tiempo, cotizaciones, pedidos, pagos, conversaciones, datos fiscales, direcciones, etiquetas y notas — y cómo archivar sin perder historial.
- [Exportar clientes y notificaciones (CSV)](https://vondi.tupla.dev/ayuda/exportar-clientes-y-notificaciones): Quién puede descargar el padrón de clientes y el historial de notificaciones, qué incluye cada archivo y cómo queda registrado.
- [Preguntas frecuentes: clientes](https://vondi.tupla.dev/ayuda/preguntas-clientes): Dudas comunes sobre fichas duplicadas, datos del cliente, etiquetas, facturación, consentimientos y archivar.

## Cotizaciones y pedidos

- [Crear, emitir y compartir una cotización](https://vondi.tupla.dev/ayuda/crear-cotizacion): El cotizador paso a paso: elegir cliente, agregar productos, descuentos, emitir, compartir el link, editar y qué significa cada estado.
- [De cotización a pedido y cobro](https://vondi.tupla.dev/ayuda/de-cotizacion-a-pedido): Cómo una cotización aceptada se convierte en pedido con link de pago, cuánto dura ese link y cómo cobrar algo que no está en tu catálogo con Cobro rápido.
- [Pedidos: estados, entrega y seguimiento](https://vondi.tupla.dev/ayuda/seguimiento-de-pedidos): Qué significa cada estado de un pedido, cómo marcarlo como entregado y el link de seguimiento que recibe tu cliente.
- [Lo que ve tu cliente: cotización, pago y confirmación](https://vondi.tupla.dev/ayuda/lo-que-ve-tu-cliente): Cómo se ven, del lado del cliente, el link de la cotización, la pantalla de pago, la sección de factura y la confirmación.
- [Cancelar una cotización o un pedido](https://vondi.tupla.dev/ayuda/cancelaciones): Qué pasa exactamente al cancelar cada uno, quién puede hacerlo según su rol, y por qué no se puede deshacer.
- [Links públicos: vigencia y revocación](https://vondi.tupla.dev/ayuda/links-publicos-vigencia-y-revocacion): Cuánto duran los links de cotización, pago y seguimiento, cuándo dejan de funcionar y qué datos muestran (y cuáles no).
- [Factura: basta con subir la constancia de situación fiscal](https://vondi.tupla.dev/ayuda/facturacion): El cliente sube el PDF de su constancia y el sistema lee RFC, razón social, código postal y régimen. Cómo funciona en el link de pago, por WhatsApp y en el panel.
- [Preguntas frecuentes: cotizaciones y pedidos](https://vondi.tupla.dev/ayuda/preguntas-cotizaciones): Dudas comunes al cotizar, cobrar y cancelar.

## Pagos

- [Sesiones de pago y libro de movimientos](https://vondi.tupla.dev/ayuda/sesiones-y-libro-de-pagos): Dónde ver qué se cobró, cuándo, y el detalle de cada sesión: sus estados y cada movimiento (cargo o reembolso) que la compone.
- [Reembolsar un pago](https://vondi.tupla.dev/ayuda/reembolsos): Total o parcial, sobre una sesión ya capturada: cómo hacerlo, qué permiso necesitas, y qué información tienes que dar.
- [Preguntas frecuentes: pagos y reembolsos](https://vondi.tupla.dev/ayuda/preguntas-pagos): Formas de pago, pagos pendientes, reembolsos y totales que no cuadran.

## Facturación (CFDI)

- [Facturación: solicitudes, emisión y configuración](https://vondi.tupla.dev/ayuda/facturacion-en-vondi): Cómo funciona la sección Facturación: la fila de solicitudes, la emisión del CFDI con FiscalAPI, la autofacturación y quién puede hacer qué.
- [Datos fiscales válidos: RFC, régimen y uso de CFDI](https://vondi.tupla.dev/ayuda/datos-fiscales-validos): Qué combinaciones acepta el CFDI 4.0, por qué desapareció el uso P01 y qué hacer cuando el sistema rechaza los datos del cliente.
- [IVA 0 %, exento y no objeto de impuesto](https://vondi.tupla.dev/ayuda/iva-0-y-exentos): Cómo se declara en el CFDI un producto cuando tu IVA es 0 %, y dónde se elige: Facturación → Configuración.
- [Factura con resultado incierto: "Confirmar que no se timbró"](https://vondi.tupla.dev/ayuda/confirmar-que-no-se-timbro): Por qué algunas solicitudes fallidas no se pueden reintentar de inmediato y cómo destrabarlas sin duplicar una factura.

## Envío a domicilio

- [Configurar zonas de envío](https://vondi.tupla.dev/ayuda/zonas-de-envio): Cobra distinto según código postal, ciudad o estado del cliente: cómo crear una zona, cómo se elige cuál aplica, y qué es la zona catch-all.
- [Preguntas frecuentes: envío a domicilio](https://vondi.tupla.dev/ayuda/preguntas-envios): Por qué se cobró cierto envío, cómo ofrecer envío gratis y cómo trabaja el agente con las zonas.

## WhatsApp y conversaciones

- [Conectar WhatsApp](https://vondi.tupla.dev/ayuda/conectar-whatsapp): Vincula un número real de WhatsApp a tu negocio: por Evolution (con un código QR, en minutos) o por Meta (API oficial). También cómo desconectarlo.
- [Bandeja de conversaciones](https://vondi.tupla.dev/ayuda/bandeja-de-conversaciones): Filtrar y buscar conversaciones, tomar una para atenderla tú, contestar con texto, audio o archivos, cotizar sin salir del chat, transferir y devolver al agente.
- [Mesa de ayuda: tickets, prioridades y respuestas rápidas](https://vondi.tupla.dev/ayuda/mesa-de-ayuda): Cómo usar la bandeja como mesa de ayuda: estados de ticket, prioridad, vistas guardadas, acciones en lote, indicadores de tiempo de respuesta y respuestas rápidas con /atajo.
- [Notas de voz, fotos y videos en WhatsApp](https://vondi.tupla.dev/ayuda/fotos-audio-y-video): Qué pasa cuando un cliente manda audio, foto, video, ubicación o un documento, cuáles son los límites y qué hacer si el agente no contesta.
- [Preguntas frecuentes: WhatsApp](https://vondi.tupla.dev/ayuda/preguntas-whatsapp): Problemas comunes con la conexión de WhatsApp y la bandeja de conversaciones.

## Agente IA

- [Qué hace el agente automático](https://vondi.tupla.dev/ayuda/el-agente-automatico): Cotiza con el catálogo real, nunca inventa precios ni existencias, entiende texto, notas de voz, fotos y videos, y sabe cuándo pasarte la conversación.
- [Configurar el agente](https://vondi.tupla.dev/ayuda/configurar-el-agente): Nombre, tono, estilo de venta, reglas, palabras que escalan, modelo, WhatsApp y atención humana: qué hace cada ajuste de Consola del agente → General.
- [Conocimiento, aprendizaje y herramientas del agente](https://vondi.tupla.dev/ayuda/conocimiento-del-agente): Cómo enseñarle al agente horarios, políticas y preguntas frecuentes (con archivos o con una página web), cómo aprobar lo que aprende y qué acciones puede hacer.
- [Probar el agente en Chat con el agente](https://vondi.tupla.dev/ayuda/chat-de-prueba): Habla con tu agente como si fueras un cliente, por texto o nota de voz, y mira el carrito, la cotización y el link de pago que va armando.
- [Preguntas frecuentes: el agente](https://vondi.tupla.dev/ayuda/preguntas-agente): Problemas comunes con las respuestas del agente y cómo resolverlos.

## Notificaciones

- [Recordatorios de cotización sin pagar](https://vondi.tupla.dev/ayuda/recordatorios-de-cotizacion): El sistema le recuerda solo al cliente que le falta pagar una cotización, cada tantas horas y hasta un máximo de veces, sin que tengas que escribirle tú.
- [Plantillas de WhatsApp y políticas de Meta](https://vondi.tupla.dev/ayuda/plantillas-de-whatsapp): Fuera de la ventana de 24 h solo se puede mandar una plantilla aprobada por Meta. Cómo registrarlas en Vondi, con versiones, validación de políticas y sugerencias.
- [Preguntas frecuentes: notificaciones](https://vondi.tupla.dev/ayuda/preguntas-notificaciones): Recordatorios que no salen, plantillas de WhatsApp y la cola de notificaciones.

## Empresa y seguridad

- [Marca: logo y colores](https://vondi.tupla.dev/ayuda/marca): Tu logo y tus colores: lo que ve tu cliente en el link público de cotización, el checkout y el seguimiento de pedido, sin que tenga que iniciar sesión.
- [Invitar usuarios a tu empresa](https://vondi.tupla.dev/ayuda/invitar-usuarios): Correo, nombre y rol — la persona recibe un correo con un link de invitación, lo abre, crea su propia contraseña y ya puede entrar.
- [Seguridad de la cuenta: contraseña y verificación en dos pasos (2FA)](https://vondi.tupla.dev/ayuda/seguridad-de-la-cuenta): Cambia tu contraseña, activa la verificación en dos pasos (2FA/MFA) con una app autenticadora, guarda tus códigos de recuperación y entiende los bloqueos por intentos fallidos.
- [Correos que envía Vondi](https://vondi.tupla.dev/ayuda/correos-de-vondi): Invitación, recuperación de contraseña y avisos a tus clientes: quién los manda, qué dicen, cuánto duran sus links y cómo reconocer uno legítimo.
- [Datos y parámetros de la empresa](https://vondi.tupla.dev/ayuda/datos-de-la-empresa): IVA, envío fijo, descuento máximo, vigencias de cotización y de pago, y recordatorios automáticos: qué hace cada ajuste de Admin → Empresa.
- [Actividad: quién cambió qué](https://vondi.tupla.dev/ayuda/actividad-y-auditoria): La bitácora de auditoría registra automáticamente los cambios importantes de tu empresa. Cómo leerla y para qué sirve.
- [Preguntas frecuentes: empresa, usuarios y seguridad](https://vondi.tupla.dev/ayuda/preguntas-empresa): Dudas comunes sobre marca, usuarios, contraseñas y verificación en dos pasos.

## Reportes y uso

- [Inicio: tu resumen de ventas](https://vondi.tupla.dev/ayuda/dashboard-y-resumen): La primera pantalla al entrar: cuánto cobraste, qué está por pagar, cotizaciones, conversaciones y la tendencia de ventas de los últimos 7 días.
- [Uso y costos del agente](https://vondi.tupla.dev/ayuda/uso-y-costos): Cuánto está costando el agente de inteligencia artificial este mes, medido en tokens y en dólares, con el detalle por modelo.

## Glosario

- [Glosario de términos](https://vondi.tupla.dev/ayuda/glosario): Qué significa cada palabra técnica o de negocio que aparece en el panel: de API key a zona catch-all.

## Plataforma (super-admin)

- [Dar de alta una nueva empresa](https://vondi.tupla.dev/ayuda/dar-de-alta-una-empresa): Nombre, slug y el correo de su primer OWNER — el resto lo hace la propia empresa, sin que tú tengas que configurar nada más por ella.
- [Administrar una empresa desde Plataforma](https://vondi.tupla.dev/ayuda/administrar-una-empresa): Cambiar su estado, ver su detalle, gestionar invitaciones y membresías, y sus API keys — todo lo que normalmente haría su propio OWNER, pero desde tu vista de super-admin.
- [Impersonar una empresa](https://vondi.tupla.dev/ayuda/impersonar-una-empresa): Entra y opera el panel exactamente como su dueño (con su mismo rol de OWNER), para dar soporte de primera mano, y todo lo que hagas queda registrado como impersonación.
- [Uso y costos de toda la plataforma](https://vondi.tupla.dev/ayuda/uso-y-costos-de-plataforma): Consumo del agente de inteligencia artificial por empresa, y el detalle día por día y modelo por modelo de una empresa en particular.
- [API keys globales](https://vondi.tupla.dev/ayuda/api-keys-globales): Sin tenant fijo, con todos los permisos — cada llamada decide sobre qué empresa opera.
- [Pestañas del detalle de una empresa y usuarios de la plataforma](https://vondi.tupla.dev/ayuda/detalle-de-empresa): Qué hay en Resumen, Usuarios, Costos, Agente y API keys de cada empresa, cómo renombrarla o suspenderla, y la lista de todos los usuarios de la plataforma.
- [Preguntas frecuentes: super-admin](https://vondi.tupla.dev/ayuda/preguntas-plataforma): Dudas comunes al operar la plataforma completa.

## Optional

- [Centro de ayuda](https://vondi.tupla.dev/ayuda): índice de todas las guías.
- [Página principal](https://vondi.tupla.dev): descripción del producto.
- [Iniciar sesión](https://vondi.tupla.dev/login): acceso al panel.