Vita-CRM

- Light
- Dark
- System
Apps & Integraciones
Administrá conexiones por tenant

Apps activas

ML

Mercado Libre
No config.
Publicaciones, órdenes y sync

WA

WhatsApp Business
No config.
Mensajería, SLA, plantillas

EM

Email Engine
No config.
Envíos, métricas y logs

IG

Facebook / Instagram
No config.
Mensajes, leads y campañas

Administrar tenant

Tip: toda la configuración se gestiona desde una única pantalla.

Administrar Apps internas

Task Engine, Notificaciones, Jobs y procesos propios de VitaCRM
Acceso Rápido

Contactos

Clientes Potenciales

Cuentas

Chat

Tickets

Eventos

Centro de ayuda inteligente

Consultá en lenguaje natural. Nuestro copiloto IA buscará la mejor respuesta documental en tiempo real.

🤖

1. ¿Qué es una plantilla de email?

Es un mensaje predefinido que se guarda en Vita / AGoNotificaciones y se reutiliza para campañas, alertas de facturación, recordatorios de agenda, seguridad, etc.

Cada plantilla se identifica por un código interno (template_code) y puede usarse en múltiples tareas programadas (task_code).

2. Campos clave en esta pantalla

Nombre de la plantilla: nombre funcional para identificarla en la lista. No se envía al cliente.
Código interno (template_code): identificador técnico, por ejemplo billing_invoice_v1 o crm_followup_v1.
Asunto: texto que verá el destinatario en la bandeja de entrada. Puede incluir placeholders como {{numero_factura}}.
Contenido HTML: cuerpo del email, con diseño, textos y botones.

3. Placeholders y catálogo de datos

Los placeholders son campos dinámicos que se reemplazan automáticamente con los datos del sistema al momento del envío.

Ejemplos frecuentes:

{{Nombre}} – Nombre de la persona/contacto.
{{numero_factura}} – Número de factura.
{{fecha_vencimiento}} – Fecha de vencimiento.
{{cta_url}} – Enlace principal (pagar, ver detalle, confirmar turno).
{{empresa}} – Nombre de la empresa emisora.
{{anio}} – Año actual para usar en el footer.

Importante: los placeholders soportados dependen del template_code elegido. Se definen en el “Catálogo de Templates” del sistema.

4. Ejemplo de plantilla de recordatorio de pago

Ejemplo simplificado:

Asunto:
Recordatorio de pago – Factura {{numero_factura}}

Cuerpo:
Hola {{Nombre}},

Te recordamos que la factura {{numero_factura}} vence el {{fecha_vencimiento}} por un importe de {{monto_total}}.

Podés realizar el pago desde el siguiente enlace:
{{cta_url}}

Saludos,
El equipo de {{empresa}} – {{anio}}

5. Buenas prácticas recomendadas

Usar un template_code que identifique claramente el propósito.
No mezclar lógicas muy distintas en la misma plantilla (ej: facturación y soporte).
Evitar párrafos muy largos; priorizar bloques cortos y escaneables.
Probar siempre el envío con una cuenta de test antes de activarla en producción.

¿Qué es la Gestión de Ventas por Embudo?

Es una herramienta visual que permite organizar, monitorear y gestionar oportunidades comerciales a lo largo de un flujo secuencial. Cada oportunidad pasa por etapas que reflejan su progreso desde el primer contacto hasta el cierre o postventa.

Características clave

Visualización tipo Kanban por columnas (por etapa).
Cada tarjeta representa una propuesta comercial u oportunidad de venta.
Posibilidad de mover las tarjetas entre etapas de forma manual o automática.
Visualización de estado actual, fecha de creación, prioridad, responsable, y otras variables clave.
Vista unificada con la bandeja de entrada y sistema de WhatsApp.

Etapas típicas del embudo

Visitantes: Usuarios o contactos sin interacción directa.
Sospechosos: Contactos que mostraron interés, por ejemplo, completando un formulario o haciendo clic en una campaña.
Prospectos (MQL): Contactos calificados por marketing que cumplen criterios objetivos.
Clientes Potenciales (SQL): Calificados por ventas, listos para una reunión, prueba o presupuesto.
Negociación / Cierre: El cliente está evaluando activamente la propuesta.
Fidelización / Postventa: Seguimiento luego del cierre, oportunidades de venta cruzada o retención.

Casos de uso típicos

Seguimiento visual de propuestas comerciales en diferentes etapas.
Gestión del equipo comercial con control de oportunidades asignadas.
Campañas de generación de demanda o conversión.
Automatización de acciones por etapa (recordatorios, alertas, envíos).

📌 Diferencia entre "Gestión por Embudo" y "Negocios"

Gestión por Embudo es una herramienta para trabajar con oportunidades en curso, mientras que Negocios se enfoca en acuerdos ya concretados o en ejecución.

Gestión por Embudo	Negocios
Visualiza el flujo de ventas por etapas (pipeline).	Administra acuerdos o proyectos cerrados o en curso.
Cada elemento es una oportunidad aún no concretada.	Cada registro es un negocio validado o firmado.
Enfocado en proceso y conversión.	Enfocado en gestión operativa y contractual.
Vista tipo Kanban, permite cambiar de etapa.	Vista tipo ficha o tabla, con enfoque en detalles económicos y documentación.
Aplica para equipos de ventas o marketing.	Aplica para administrativos, gerentes o postventa.

Consejo final

Usá la Gestión por Embudo para cerrar más oportunidades, y el módulo de Negocios para garantizar que esas oportunidades se ejecuten correctamente y sean rentables.

¿Qué es la Gestión de Negocios?

El módulo de Negocios permite registrar, controlar y dar seguimiento a cada acuerdo comercial formalizado con un cliente. A diferencia de las propuestas en embudo, aquí trabajamos con oportunidades que han sido aceptadas y requieren ejecución operativa o administrativa.

¿Cuándo se crea un negocio?

Un negocio se genera cuando una propuesta ha sido aceptada por el cliente. Puede nacer desde:

Una oportunidad cerrada desde el Embudo de ventas.
Un contrato firmado o presupuesto aprobado.
Una nueva venta directa documentada.

Contenido típico de un Negocio

Cliente y responsable asignado.
Nombre del negocio, categoría y etapa actual.
Monto, moneda, condiciones comerciales.
Fecha de inicio, vencimiento y cierre.
Documentación adjunta (PDF, contratos, formularios).
Integración con tareas, tickets y propuestas anteriores.

Objetivos del módulo

Hacer seguimiento de negocios activos con datos operativos.
Gestionar el ciclo de vida post-cierre: entregas, pagos, soporte, renovación.
Medir ingresos reales proyectados vs. concretados.
Vincular con facturación, cobranzas o etapas internas de cumplimiento.

🔁 Relación con la Gestión por Embudo

Mientras que el embudo refleja oportunidades en curso, el módulo de negocios representa acuerdos que han sido cerrados y convertidos en compromisos reales.

Gestión por Embudo	Negocios
Propuestas en análisis o negociación.	Oportunidades ya concretadas y aceptadas.
Vista tipo pipeline con cambio de etapa.	Vista tipo ficha, con enfoque documental y financiero.
Gestión de la conversión.	Gestión post-venta, operación y control.
Responsables comerciales (ventas).	Responsables operativos o de cuenta.
Puede cerrarse como ganado o perdido.	No se cierra, se ejecuta o se cancela administrativamente.

Consejo final

Utilizá el módulo de negocios para asegurar la continuidad del cliente una vez que la venta ha sido concretada. Es el lugar donde se documenta la entrega real de valor y se mide el éxito del proceso comercial completo.

¿Sabías que podés vincular automáticamente negocios con tickets, tareas y facturas? Esto te permite tener trazabilidad completa del cliente desde el primer contacto hasta la resolución postventa.

El Explorador de Conocimiento te permite subir, etiquetar, clasificar y gestionar los documentos que alimentan al chatbot. Todo lo que cargues se indexa automáticamente y queda disponible para búsquedas semánticas y respuestas enriquecidas.

Carga rápida

PDF, DOCX, XLSX, PPTX, TXT, MP3, WAV, M4A.

Metadatos útiles

Título, Tag, Carpeta, Lenguaje, Tipo, Observaciones.

Búsqueda y control

Filtrá, exportá a Excel y eliminá cuando sea necesario.

Extensiones: .pdf, .doc, .docx, .txt, .xls, .xlsx, .ppt, .pptx, .mp3, .wav, .m4a.
Tamaño recomendado: hasta 25 MB por archivo (configurable).
Calidad del contenido: evitá imágenes escaneadas sin OCR; preferí texto seleccionable.
Audio: MP3/WAV/M4A se transcriben automáticamente (latencia según duración).

Consejo: separá documentos muy extensos en capítulos/temas; mejora la precisión y el refresco de índices.

Título: Nombre claro y único. Ej: Política de Devoluciones v1.3 (2025).
Tag: Etiqueta(s) corta(s) para búsquedas. Ej: soporte, pagos, reserva. Usá 1–3 por archivo.
Carpeta: Categoría organizativa. Ej: reservas, soporte, pagos, comercial.
Lenguaje: Idioma principal del contenido. Seleccioná es-ES, es-UY, en-US, etc. Para audio, el idioma de la transcripción.
Tipo: Clasificación funcional. Sugeridos: procedimiento, política, plantilla, faq, reporte, contrato.
Observaciones: Notas para el operador/QA: alcance, vigencia, versión, links internos. Ej: Válido LATAM. Reemplaza v1.2. Fuente: Legal/2025-03.

Estándar recomendado de nombre de archivo: {Carpeta}/{Tipo}/{Idioma}/{Tema}-v{MAJOR.MINOR}.ext
Ejemplo: soporte/faq/es-UY/politica-devoluciones-v1.3.pdf

Hacé clic en Cargar archivo y seleccioná el documento/audio.
Completá Título, Tag, Carpeta, Lenguaje, Tipo y Observaciones.
Guardá los cambios. El sistema valida tipo y tamaño.
El archivo se procesa e indexa: extracción de texto, OCR (si aplica) y transcripción de audio.
Queda disponible para búsqueda semántica y respuestas del chatbot.

Tip: tras reemplazar versiones (v1.2 → v1.3), eliminá la anterior o marcala como obsoleta para evitar respuestas desactualizadas.

Texto limpio: usá títulos (H1–H3), listas y tablas claras; evita imágenes con texto incrustado.
Versionado semántico: MAJOR.MINOR.PATCH en Título y Observaciones. Ej: v2.1.0.
Un tema por archivo: mejora el ranking y reduce ambigüedad.
Metadatos consistentes: Carpeta/Tag/Lenguaje coherentes con el contenido real.
Datos sensibles: anonimizá PII (teléfono, cédula, email) si no es imprescindible.

Evitá subir hojas de cálculo con múltiples pestañas dispares; usá una pestaña por tema o divide en varios archivos.

✅ El archivo está en un formato admitido y sin contraseñas.
✅ Título claro con versión (si aplica).
✅ Tag (1–3), Carpeta correcta.
✅ Lenguaje coincide con el contenido/audio.
✅ Tipo refleja la función (política, FAQ, plantilla...).
✅ Observaciones con vigencia/fuente.

“Formato no admitido”: convertí a PDF o DOCX/XLXS/PPTX/TXT.
“Archivo protegido”: remové contraseña/edición restringida y reintentá.
“Tamaño excedido”: comprimí o dividí en varios archivos temáticos.
Transcripción con errores: revisá Lenguaje correcto y calidad del audio.
Documento no aparece en búsqueda: esperá la finalización del indexado o verificá metadatos.

Si el problema persiste, reportá con: nombre del archivo, hora de subida y captura del mensaje.

¿Cuánto demora en estar disponible?
Generalmente segundos a pocos minutos según tamaño/transcripción.

¿Puedo reemplazar un archivo?
Sí: subí la nueva versión y eliminá o marcá como obsoleta la anterior.

¿Qué pasa con datos sensibles?
Subí sólo lo necesario, preferentemente anonimizado. Respetar políticas internas de privacidad.

¿Se puede exportar la lista?
Sí: usá el botón Exportar (XLSX) en la barra de acciones.

¿Qué estoy viendo?

Tiempo actual: métrica derivada del último día disponible.
Promedio (avg) y P95: segundos promedio y percentil 95 del SLA.
Registros SLA: cantidad de mediciones consideradas.
Serie diaria: agregación por día dentro del rango consultado.

Endpoint consultado

POST https://api.bestroute.io/kpi/getWhatsSLA/whats-sla-metrics

Body (JSON):

{
  "token": "<token>",
  "date_from": "YYYY-MM-DD",
  "date_to": "YYYY-MM-DD"
}

Período y resumen

Rango consultado

-- ? --

Totales

AVG -- P95 -- Registros --

Detalle por día

Fecha	SLA promedio	Registros

Movimientos

Si el servicio retorna eventos/mensajes individuales, se listarán aquí.

Fecha/hora	Canal	Operador	SLA (mm:ss)	Referencia

¿Qué muestra esta tarjeta?

Demos agendadas: resumen de presentaciones o demostraciones programadas con clientes o prospectos.
Fechas y horarios: muestra el período de cada demo dentro del rango consultado.
Ejecutivo asignado: indica el responsable de la presentación.
Estado: identifica si la demo está pendiente, confirmada o finalizada.

Origen de los datos

POST https://api.bestroute.io/kpi/getWhatsSLA/whats-sla-metrics

Body (JSON):

{
  "token": "<token>",
  "date_from": "YYYY-MM-DD",
  "date_to": "YYYY-MM-DD"
}

Período y resumen general

Rango consultado

-- → --

Totales

Promedio -- P95 -- Registros --

Detalle por día

Fecha	Duración promedio	Cantidad

Historial de movimientos

Si el servicio retorna registros individuales, se mostrarán a continuación.

Fecha/hora	Ejecutivo	Cliente	Duración (mm:ss)	Observaciones

¿Qué muestra esta tarjeta?

Total de servicios gestionados por cada usuario (ejecutivo) en el período indicado en la esquina superior derecha.
Incluye la fila “Sin asignar” cuando el servicio no tiene ejecutivo asociado.

Fuente de datos (API)

POST · /kpi/getWhatsSLA/getServiciosPorEjecutivo

{
  "token": "<tu_token>"
}

Respuesta (ejemplo):

{
  "code": 200,
  "meta": { "range": ["2025-11-02","2025-11-09"], "tz": "America/Montevideo" },
  "data": [
    { "IdUser": 10, "Usuario": "gerencia@agoerp.com", "Servicios": 227 },
    { "IdUser": 15, "Usuario": "dsantos@agoerp.com", "Servicios": 51  },
    { "IdUser": 20, "Usuario": "amachin@agoerp.com",  "Servicios": 18  },
    { "IdUser": 0,  "Usuario": "Sin asignar",         "Servicios": 4   }
  ]
}

meta.range define el período visible en la tarjeta.
data contiene las filas a renderizar en tabla y barra.

Recomendaciones

Si ves muchos registros en “Sin asignar”, revisá reglas de asignación y mapeo de usuarios.
El token debe ser válido; si expira, renovalo antes de llamar al endpoint.

¿Qué muestra este gráfico?

Mensajes entrantes por hora local de WhatsApp.
Compara Hoy con Ayer, Semana -1 y Año -1.
Respeta la zona horaria enviada (tz), p. ej. America/Montevideo.

Fuente de datos

Endpoint (POST):

https://api.bestroute.io/kpi/getWhatsSLA/getRecepcionCompare

Parámetros esperados

token (string): credencial válida (patrón estándar: getToken()).
date (YYYY-MM-DD): día base para comparar.
tz (string): zona horaria IANA.
compare_to (array): comparativas, ej. ["yesterday","week","year"].

Ejemplo de request

{
  "token": "?TU_TOKEN?",
  "date": "2025-11-08",
  "tz": "America/Montevideo",
  "compare_to": ["yesterday", "week", "year"]
}

Sugerencia: obtener el token con tu patrón estándar (getToken()) y validar antes de invocar.

Cómo interpretar la respuesta

{
  "meta": { "date": "YYYY-MM-DD", "tz": "America/?TZ?" },
  "labels": ["00","01",...,"23"],
  "series": {
    "today": [...], "yesterday": [...], "week": [...], "year": [...]
  }
}

labels: horas del día (00–23).
series.*: cantidades por hora alineadas a labels.
El tablero suma cada serie para los totales de Hoy / Ayer / Semana -1 / Año -1.

Notas y buenas prácticas

Si no hay datos en una hora, el valor es 0.
Verificá tz para evitar desfasajes de horario de verano.
Mantené el request idempotente y logueá code/message para troubleshooting.

La pantalla de Contactos centraliza las personas con las que se relaciona tu empresa: clientes finales, decisores, referentes de pago, contactos operativos, etc.

1. ¿Qué es un contacto en VitaCRM?

Cada fila de la grilla representa una persona de contacto asociada a una cuenta o empresa.
Los datos principales son: Nombre, Compañía, Email, Móvil, Cédula/RUT y Dirección.
Estos datos se reutilizan en embudos, tickets, eventos, campañas y WhatsApp.

2. Relación con Cuentas

Desde el módulo de Cuentas podés ver y gestionar los contactos de cada cliente.
Un mismo contacto puede estar vinculado a una cuenta principal y utilizarse en diferentes gestiones comerciales.
Recomendación: mantené alineados los datos entre Cuentas y Contactos para evitar duplicados.

3. Acciones disponibles en la grilla

Icono de editar: actualiza datos del contacto (email, móvil, compañía, etc.).
Icono de actividad / historial: consulta el uso del contacto en tickets, eventos o gestiones comerciales (si tu rol lo permite).
Botón “Agregar contacto”: crea un nuevo registro para usarlo luego en todo el CRM.
Botón “Exportar”: descarga los contactos listados aplicando los filtros activos.

4. Filtros y búsqueda

Utilizá el panel de “Filtros de Contactos” para acotar por nombre, compañía, email, móvil, nivel u otros criterios.
La caja “Buscar registro” permite localizar rápidamente un contacto por texto libre.
Los filtros aplicados impactan tanto en la vista como en la exportación.

5. Buenas prácticas

Definí siempre al menos: Nombre, Móvil y Email para poder contactar a la persona desde cualquier módulo.
Actualizá los datos cuando cambie la compañía, el cargo o el número de contacto.
Usá la misma estructura de nombres y correos para mantener la base ordenada (evitar duplicados y correos mal escritos).

Resumen rápido

Editar: abre el asistente en 5 pasos para actualizar datos de la cuenta.
Fusionar: une dos cuentas que representan al mismo cliente en una sola ficha 360°.
Ver logs: muestra el historial de cambios sobre la cuenta.
Eliminar cuenta: acción de alta sensibilidad para inactivar o eliminar la cuenta.

360°: resumen general de la cuenta y módulos activos.
Contactos / Oportunidades / Tickets: pestañas específicas por tipo de relación.
Línea de tiempo: eventos en orden cronológico (negocios, tickets, cambios de estado).

Concepto de ficha 360°

La ficha 360° concentra toda la información relevante de una cuenta en un único lugar: datos generales, contactos, oportunidades comerciales, tickets, facturación e historial de actividad.

La idea es que cualquier usuario (comercial, soporte o administración) pueda entender el estado actual de la relación con el cliente en pocos segundos, sin tener que abrir múltiples pantallas.

Encabezado de la cuenta y KPIs

En la parte superior de la ficha se muestran los datos clave:

Nombre de la cuenta y ID interno.
Segmento e industria (si se utilizan en la instancia).
Representante asignado y propietario de la cuenta.
Datos de contacto principales: Correo, Teléfono, Móvil.
Moneda y última actividad registrada.
KPI básicos: órdenes, gastos, puntos y deuda.

Estos indicadores permiten identificar rápidamente la relevancia de la cuenta, su situación financiera y el nivel de interacción reciente.

Acciones principales sobre la cuenta

Editar Actualización de datos mediante el asistente

El botón Editar abre el asistente en varios pasos para modificar los datos de la cuenta. En la configuración actual, se organiza en:

Datos generales: nombre de la cuenta, compañía, correo, teléfonos, cuenta de balance, documento y RUC.
Direcciones: datos de contacto, envío y cobro.
Ubicación y público: segmentación geográfica y clasificación comercial.
Facturación y afiliación: datos fiscales, condiciones comerciales y contratos.
Otros datos: información adicional, notas internas y gestión de baja.

Se recomienda revisar al menos los Datos generales y la Ubicación y público antes de empezar a trabajar con oportunidades, tickets o facturación para esa cuenta.

Fusionar Unificación de cuentas duplicadas

La opción Fusionar se utiliza cuando detectamos que existen dos o más cuentas que representan al mismo cliente (por ejemplo, duplicados por variaciones en el nombre, errores de carga, etc.).

Criterios habituales para decidir una fusión:

Mismo RUT o documento fiscal.
Nombre de cuenta muy similar o igual.
Mismos correos de contacto principales.
Mismo teléfono / móvil de referencia.

Importante: antes de fusionar, validar con el equipo comercial o de administración qué cuenta debe quedar como principal (la que conserva el historial) y cuál será absorbida.

Luego de la fusión, las oportunidades, tickets y registros asociados deben quedar vinculados a la cuenta principal, evitando perder contexto histórico del cliente.

Ver logs Historial de cambios y auditoría

La opción Ver logs muestra el historial de operaciones realizadas sobre la cuenta: altas, modificaciones, fusiones, cambios de estado, responsables, etc., indicando quién hizo el cambio y cuándo.

Esta vista es clave para auditorías, resolución de incidentes y seguimiento de decisiones internas sobre la cuenta.

Eliminar cuenta Uso exclusivo para administrar bajas

El botón Eliminar cuenta es una acción sensible y normalmente está restringida a perfiles con permisos avanzados.

Dependiendo de la configuración del sistema, esta acción puede:

Marcar la cuenta como inactiva o de baja, manteniendo el historial.
O bien solicitar un flujo de revisión previo a una eliminación definitiva.

Antes de eliminar una cuenta, verificar si:

Tiene deuda pendiente o procesos abiertos de facturación.
Existen tickets activos o en curso.
Hay oportunidades o negocios en etapas críticas.

Pestañas principales de la ficha

360°

Vista principal con un resumen de módulos clave: ventas, tickets, facturación y otros indicadores. Aquí se muestran resúmenes como “3 negocios activos”, “2 tickets abiertos” o “Saldo a favor”.

Contactos

Personas asociadas a la cuenta (contactos comerciales, facturación, soporte, etc.). Desde aquí se gestionan correos, móviles y roles dentro de la organización del cliente.

Oportunidades

Listado de negocios o propuestas vinculadas a la cuenta, con su etapa en el embudo, montos e hitos relevantes.

Tickets

Incidentes, consultas y solicitudes de soporte asociadas a la cuenta. Permite ver rápidamente si hay temas abiertos antes de contactar al cliente.

Línea de tiempo

La Línea de tiempo muestra los eventos de la cuenta en orden cronológico: cambios de estado de tickets, avances de negocios, notas internas y otros hitos relevantes.

Los filtros rápidos (7d / 30d / 90d) permiten acotar la vista a los últimos días para enfocarse en la actividad reciente.

Antes de contactar al cliente, es recomendable revisar la línea de tiempo para tener contexto actualizado sobre las interacciones más recientes.

Flujo sugerido de trabajo con la ficha 360°

Abrir la ficha 360° desde una búsqueda o listado de cuentas.
Revisar el encabezado (deuda, órdenes, gastos, puntos, último contacto).
Consultar la línea de tiempo para ver la actividad reciente.
Si es necesario, ajustar datos mediante Editar (correo, teléfonos, RUT, estado, etc.).
Validar si existen duplicados y, de ser necesario, usar Fusionar.
Usar Ver logs cuando haya dudas sobre quién modificó la cuenta o por qué cambió un dato.
Solo recurrir a Eliminar cuenta cuando se trate de un caso validado y autorizado.

Seguir este flujo ayuda a mantener la base de datos de cuentas limpia, coherente y auditada, mejorando la calidad de la información en todo el CRM.

Esta pantalla se usa para crear, editar, activar/desactivar o eliminar integraciones por empresa. Cada fila representa una combinación Empresa + App con sus credenciales y configuración.

1) Cómo usar el listado

Empresa: buscá por company_name o company_id.
App: filtra el tipo de integración (Task Engine, Meta, WhatsApp, Email, Meli, etc.).
Estado: muestra integraciones activas o inactivas.
Aplicar: ejecuta los filtros.
Limpiar: restablece filtros y muestra todo.

2) Campos al crear/editar

Campo	Qué significa	Recomendación
Company ID	Identificador numérico de la empresa.	Usar el ID correcto. Evitar duplicados para la misma App.
Company Name	Nombre visible de la empresa.	Referencia informativa (no reemplaza al Company ID).
¿Activo?	Habilita o deshabilita la integración.	Si está inactiva, la app no debería operar.
App / App Name	Tipo de integración y su nombre descriptivo.	Seleccionar la App correcta. App Name es informativo.
External Tenant ID	ID del tenant externo (cuando la app usa un identificador propio).	Completar solo si la integración lo requiere.
API Base URL	URL base del servicio asociado a la integración.	Debe ser una URL válida (preferentemente https).
API Key	Clave/API Key para autenticación (si aplica).	Opcional. Usar solo cuando el proveedor lo requiera.
Auth Token	Token de autenticación (si aplica).	Opcional. Mantenerlo protegido (no compartir).
Config (JSON)	Configuración avanzada en formato JSON para la app.	Debe ser JSON válido. La validación es en tiempo real.

3) Acciones del listado

Editar: modifica la integración (URLs/credenciales/config).
Eliminar: borra la integración (usar solo si no debe existir).
Activar/Desactivar: pausa o habilita sin perder datos.

4) Buenas prácticas y validaciones

Evitar duplicar registros para la misma combinación Empresa + App.
Si cambiás API Base URL o credenciales, luego probá el flujo asociado (por ejemplo conexión/estado).
Si el JSON es inválido, corregir antes de guardar.

Esta sección permite administrar los Grupos de productos. Los grupos son una capa de clasificación que se ubica dentro de una Familia y se utilizan para organizar los productos de forma clara y consistente.

📂 Estructura del catálogo

El catálogo de productos se organiza de la siguiente manera:

Ramo: categoría principal.
Familia: subcategoría dentro del ramo.
Grupo: clasificación específica dentro de la familia.
Producto: ítem final comercializable.

Ejemplo:
Alimentos → Congelados → Verduras → Arvejas

🔍 Consulta de grupos

Al ingresar al módulo, el sistema muestra el listado de grupos existentes. La información se carga en tiempo real, sin necesidad de recargar la pantalla.

Podés buscar grupos por nombre.
Podés filtrar por familia.
Vas a ver cuántos productos tiene cada grupo.

➕ Alta de grupo

Utilizá esta opción cuando necesites crear un nuevo grupo.

Hacé clic en “Agregar grupo”.
Ingresá el nombre del grupo.
Seleccioná la familia correspondiente.
Confirmá la operación.

Una vez creado, el grupo queda disponible inmediatamente para ser usado en la carga o edición de productos.

✏️ Modificación de grupo

Podés modificar un grupo existente para corregir su nombre o cambiar la familia a la que pertenece.

Seleccioná el grupo desde el listado.
Elegí la opción Editar.
Realizá los cambios necesarios.
Guardá los cambios.

🗑️ Eliminación de grupo

La opción de eliminar se utiliza cuando un grupo ya no debe estar disponible.

El sistema puede impedir la eliminación si el grupo tiene productos asociados.
Se recomienda verificar la cantidad de productos antes de eliminar.

Eliminar un grupo puede afectar la organización del catálogo. Realizá esta acción solo si estás seguro.

✅ Buenas prácticas

Usar nombres claros y representativos.
Evitar duplicar grupos con el mismo significado.
Revisar la familia antes de crear un nuevo grupo.
Mantener el catálogo ordenado mejora búsquedas y reportes.

🛠️ Soporte

Si tenés dudas sobre cómo organizar los grupos o necesitás asistencia, contactá al área de soporte o a tu administrador del sistema.

¿Qué es este módulo?

La gestión de productos es el corazón operativo de VitaCRM. Todo lo que se vende, publica, stockea, factura o reporta parte de la definición correcta de un producto.

Un producto mal definido genera errores en ventas, inventario, precios, reportes e integraciones.
Un producto bien definido se reutiliza en todo el sistema.

Modelo de producto

Cada producto se construye por bloques independientes. Esto permite que el sistema escale sin duplicar datos.

General: identidad única del producto
Atributos: variantes, talles, colores, tags
Inventario: stock, reposición, ubicación
Comercial: precios, costos, impuestos
Logística: dimensiones, envíos, restricciones
Imágenes: publicación visual multicanal
Avanzado: SEO, integraciones y flags técnicos

Cada bloque puede evolucionar sin romper los demás.

Cómo se usa en la práctica

Ventas / POS
Precios, impuestos y stock se toman directamente desde este módulo.
Web / E-commerce
Visibilidad, imágenes, SEO y promociones dependen de la configuración avanzada.
Inventario
Alertas, reposición y disponibilidad se calculan en base a estos datos.
Reportes & BI
Margen, rotación, rentabilidad y ABC usan esta estructura.

Flujo recomendado de carga

1. General
2. Comercial
3. Inventario
4. Logística

5. Atributos / Variantes
6. Imágenes
7. Avanzado

No es obligatorio completar todo en una sola sesión. El sistema está preparado para crecer producto a producto.

Errores comunes a evitar

Cargar precios sin definir impuestos
No controlar stock en productos físicos
Duplicar productos en lugar de usar variantes
No cargar imágenes principales
Usar tags sin criterio

Evolución del módulo

Este módulo seguirá creciendo con:

Listas de precios avanzadas
Versionado de productos
Autosave y borradores
Sincronización en tiempo real
Asistencia inteligente (IA)

Este módulo permite administrar los tipos de cambio utilizados por el sistema. Incluye alta, modificación, eliminación y consulta de historial por fecha y moneda.

1) ¿Para qué sirve?

Registrar cotizaciones por fecha para una moneda específica.
Consultar histórico y auditar cambios.
Corregir importes en caso de carga errónea.
Eliminar registros únicamente cuando se haya cargado un dato incorrecto.

2) Ubicación

General → Base del sistema → Monedas → Tipo de cambio

3) Conceptos clave

Fecha: día al que corresponde la cotización (formato YYYY-MM-DD).
Moneda (Mone): identificador numérico de la moneda (se selecciona desde el catálogo de monedas).
Importe: valor del tipo de cambio para esa fecha y moneda.
Histórico: el sistema registra múltiples fechas; no se sobreescribe el pasado salvo que se modifique explícitamente.

4) Reglas y buenas prácticas

Se recomienda cargar el tipo de cambio una vez por día por moneda (según política interna).
Para correcciones, utilizar Modificación antes que Baja.
La Baja debe reservarse para errores de carga o registros duplicados.
Este módulo no calcula automáticamente el tipo de cambio vigente; gestiona registros (CRUD) e histórico.
El orden recomendado para auditoría es fecha DESC (más reciente primero).

5) ¿Cómo registrar un nuevo tipo de cambio? (ALTA)

Presionar Nuevo tipo de cambio.
Seleccionar Fecha.
Seleccionar Moneda.
Ingresar el Importe.
Confirmar con Guardar.

Ejemplo de alta (referencia técnica)

{
  "operation": "alta",
  "fecha": "2026-01-15",
  "Importe": 39.85,
  "Mone": 2
}

6) ¿Cómo corregir un tipo de cambio? (MODIFICACIÓN)

Ubicar el registro en la grilla (por fecha y moneda).
Presionar Editar.
Actualizar Importe y/o Moneda si corresponde.
Confirmar con Guardar.

Ejemplo de modificación (referencia técnica)

{
  "operation": "modificacion",
  "Id": 1324,
  "fecha": "2026-01-15",
  "Importe": 40.10,
  "Mone": 2
}

Importante: la modificación identifica el registro por Id + fecha. Si cambia la fecha, se trata como un registro diferente (recomendado crear uno nuevo y dar de baja el anterior si correspondiera).

7) ¿Cuándo eliminar un tipo de cambio? (BAJA)

Ubicar el registro incorrecto.
Presionar Eliminar.
Confirmar la acción (irreversible).

Ejemplo de baja (referencia técnica)

{
  "operation": "baja",
  "Id": 1324,
  "fecha": "2026-01-15"
}

8) ¿Cómo consultar el histórico? (GET)

Usar filtros por fecha, moneda u orden para encontrar registros específicos.
La consulta devuelve un listado con: Id, fecha, Importe, Mone.

Ejemplo de consulta paginada y ordenada (referencia técnica)

{
  "limitinit": 0,
  "limit_last": 10,
  "OrderBy": "fecha ASC"
}

9) Solución de problemas

Verificá que la moneda exista en General → Base del sistema → Monedas y que esté activa. Luego recargá la pantalla.

Revisá que la fecha esté seleccionada, que la moneda sea válida y que el importe sea numérico. Si persiste, revisar consola y reportar el detalle del error.

Este módulo solo administra registros. La regla de “vigente” depende de la lógica de negocio del proceso que lo consuma (facturación, reportes, etc.).

Nota: Si necesitás que el sistema determine automáticamente el tipo de cambio vigente por moneda, debe implementarse un endpoint específico de negocio (no incluido en este administrador).

Este módulo permite administrar y supervisar todas las publicaciones sincronizadas con MercadoLibre desde VitaCRM. Aquí podrás visualizar el estado de cada publicación, monitorear actividad de compradores y ejecutar acciones operativas como actualización de precio, stock o estado de publicación.

Información mostrada en la tabla

Artículo

Muestra el nombre del producto publicado en MercadoLibre, junto con su identificador de publicación (Item ID). Este identificador es utilizado por MercadoLibre para referenciar el producto dentro de su plataforma.

Estado

Representa la situación actual de la publicación dentro de MercadoLibre. El sistema muestra el estado operativo y el identificador de la publicación asociada.

Precio

Indica el precio actual publicado en MercadoLibre junto con la moneda configurada para la publicación.

Fechas

Incluye la fecha de creación de la publicación y la última fecha de sincronización realizada con MercadoLibre.

Preguntas

Muestra la cantidad de preguntas realizadas por compradores dentro de la publicación. Desde esta sección podrás monitorear consultas pendientes.

Estados de las publicaciones

Publicada

La publicación se encuentra activa y visible para los compradores en MercadoLibre.

Pausada

La publicación fue pausada temporalmente y no está visible para compradores. Puede ser reactivada en cualquier momento.

Cerrada

La publicación fue finalizada y ya no se encuentra disponible en MercadoLibre.

Acciones disponibles

Ver detalle
Permite visualizar toda la información técnica asociada a la publicación.

Ver en ML
Abre la publicación directamente dentro de MercadoLibre.

Editar precio
Permite actualizar el precio publicado del producto.

Editar stock
Permite actualizar la cantidad disponible del producto.

Editar descripción
Permite modificar la descripción visible del producto.

Activar publicación
Reactiva una publicación previamente pausada o cerrada.

Pausar publicación
Detiene temporalmente la visibilidad de la publicación.

Cerrar publicación
Finaliza la publicación de manera definitiva.

Uso de filtros

Los filtros ubicados en la parte superior permiten localizar publicaciones específicas según diferentes criterios como estado de publicación, moneda, categoría o rango de fechas.

Utiliza el campo de búsqueda para encontrar rápidamente publicaciones por nombre de producto, identificador de MercadoLibre (Item ID) o SKU.