FleteChat v1.0 — Glosario¶
Términos técnicos, de negocio y logísticos que aparecen en las historias y demás documentos del análisis. Sirve como referencia única para evitar ambigüedad al leer el FRD.
Los términos que ya son ampliamente conocidos en la industria (factura, cliente) no se repiten salvo que tengan un significado específico dentro de FleteChat.
Logística y comercio internacional¶
| Término | Definición |
|---|---|
| Incoterm | Condición comercial internacional estandarizada por la Cámara de Comercio Internacional. Define quién asume el transporte, los riesgos y los costos entre comprador y vendedor. En v1.0 se soportan al menos EXW, FOB, CIF, DDP y DAP; el catálogo exacto se define en la carga inicial (US-043). |
| Modalidad | Medio físico de transporte del embarque. En v1.0: aéreo, marítimo LCL (carga consolidada), marítimo FCL (contenedor completo). Otras modalidades se agregan en fases posteriores. |
| Tipo de operación | Perspectiva del cliente respecto al flujo de carga: importación (carga que entra al país de destino) o exportación (carga que sale del país de origen). En v1.0 se soportan ambos. |
| Origen | País y ciudad desde donde parte la carga. En cotización el agente pide origen y destino explícitamente (US-007, US-008). |
| Destino | País y ciudad donde se entrega la carga. |
| Tránsito | Tiempo estimado desde que la carga sale del origen hasta que llega al destino. El cotizador lo provee junto con el precio (US-011). |
| Tracking | Número externo corto (ENNN) con el que el cliente consulta el avance de su embarque por WhatsApp. Único por cuenta, no reutilizable. |
| Instructivo | Documento PDF con instrucciones operativas para una de las partes del embarque (proveedor del cliente, operador logístico externo, personal interno de FleteChat). Se emiten al aprobarse formalmente una cotización (US-019, US-020, US-021). |
| Embarque | Operación logística concreta en ejecución, originada por la aprobación formal de una cotización. Tiene un número ENNN, una secuencia de estatus y uno o más instructivos asociados. |
| Cotización | Oferta comercial con código CNNN, precio desglosado, vigencia limitada y condiciones asociadas. No es un compromiso hasta que se aprueba formalmente. |
| Re-cotización | Emisión de una cotización nueva a partir de una previa, aplicando precios y condiciones vigentes en ese momento. En v1.0 existe re-cotización rápida para clientes con nivel corporativo activo (US-013). |
Negocio y modelo comercial¶
| Término | Definición |
|---|---|
| Titular de la cuenta | Persona que creó la cuenta en FleteChat. Tiene visibilidad total sobre toda la actividad de la cuenta y es quien autoriza agregar colaboradores (US-003). |
| Colaborador | Contacto adicional asociado a la cuenta del titular (p. ej. un asistente, un comprador del equipo). Ejerce operaciones en nombre de la cuenta pero con visibilidad acotada a sus propias operaciones (US-003). |
| Cliente corporativo | Cuenta con un nivel corporativo activo asignado, lo que le da acceso a una lista de precios distinta de la base y a funcionalidades como la re-cotización rápida. |
| Nivel corporativo | Categoría comercial aplicada a un cliente (por ejemplo Gold, Platinum). Apunta a una lista de precios específica y tiene una vigencia temporal (US-037, US-038). |
| Lista de precios | Conjunto de tarifas vigente para un corredor / modalidad / Incoterm / tipo de operación / servicio. Puede ser base (para clientes sin nivel) o corporativa (asociada a un nivel). Se gestiona manualmente (US-044) o por import Excel (US-045). |
| Wildcard | En lista de precios, valor que indica "cualquiera" para una dimensión (p. ej. un Incoterm wildcard aplica a cualquier Incoterm dentro de la ruta). Definido en la carga inicial L1..L6. |
| Tarifa fija vs variable | Una tarifa fija aplica un precio constante; una tarifa variable se calcula según una fórmula (p. ej. USD por kg, USD por m³). Cada combinación de la lista declara cuál usa. |
| Costo mínimo | Piso de facturación aplicable cuando el cálculo variable daría un valor por debajo de ese umbral. Se aplica por combinación. |
| Vigencia de cotización | Plazo durante el cual la cotización es honrable. Default sugerido: 7 días corridos, configurable globalmente (US-014). Una cotización vencida no puede aprobarse. |
| Handoff | Transferencia de la conversación del agente conversacional a un operador humano. Se activa con consentimiento explícito del cliente (US-033); mientras dura la atención humana el agente no responde automáticamente. |
| Aprobación formal | Acto irreversible por el cual el cliente confirma la contratación de la cotización. En v1.0 se consuma con el click del cliente en el enlace enviado por correo, confirmado por un segundo click en la landing de confirmación (US-012 + PR-226). Dispara la emisión del embarque. |
| Snapshot | Captura de una configuración o precio vigente al momento de un evento. Se usa para garantizar que una cotización emitida a un precio y nivel corporativo determinados se honre en esos términos aunque el precio o el nivel cambien después (US-012 PR-221, US-038 PR-157, US-044 PR-176). |
| Secuencia de estatus | Cadena de estados por los que pasa un embarque (p. ej. emitido → en origen → en tránsito → en destino → entregado). Dinámica por servicio contratado (US-027) y congelada en el momento de la emisión del embarque. |
| Opt-out | Preferencia del cliente de no recibir comunicaciones proactivas no críticas. Granular (total o por categoría) y reversible (US-064). Los mensajes críticos se envían aunque haya opt-out activo. |
| Mensaje crítico / no crítico | Clasificación que determina si un mensaje proactivo respeta el horario razonable y el opt-out (no crítico) o se envía siempre (crítico). La matriz oficial vive en US-057 AC 2 y PR-230. |
Técnico-funcional¶
| Término | Definición |
|---|---|
| Agente conversacional (agente AI) | Componente de FleteChat que atiende al cliente por WhatsApp usando un modelo de lenguaje grande (LLM). Tiene identidad, tono y principios declarados (US-051..US-060). Lleva el nombre "FleteChat". |
| Cotizador | Componente de negocio (HT-10) responsable de emitir cotizaciones a partir de los datos recolectados. Lee el catálogo (tarifas, servicios, niveles corporativos) y produce código CNNN, desglose, vigencia y tránsito. No conoce nada posterior a la cotización. |
| Ensamblador de embarques | Componente de negocio (HT-11) responsable de toda la lógica post-aprobación: emitir el ENNN, congelar la secuencia de estatus, determinar los campos del formulario operativo, componer los datos de los tres instructivos y publicar el evento shipment_ready. |
| MCP (Model Context Protocol) | Protocolo estandarizado con el que el cotizador y el ensamblador exponen sus interfaces como tools consumibles por el agente conversacional y por otros sistemas (HT-12). |
| Backoffice | Interfaz web interna de FleteChat usada por los roles admin, operator y price_manager para gestionar clientes, cotizaciones, embarques, catálogos, listas de precios, usuarios y audit log. |
| Formulario público | Página web pública sin login, accesible solo con un enlace firmado. Se usa para captura de datos operativos del embarque (US-015), para la confirmación de aprobación formal (US-012 PR-226), para la vista detallada de reportes (US-030) y para la descarga del paquete Ley 81 (US-061). |
| Magic link | Enlace firmado de un solo uso enviado por correo que permite a un cliente completar una acción sin login. Se usa para verificar el número de WhatsApp (US-004). |
| Plantilla proactiva (plantilla Meta) | Mensaje aprobado por Meta (WhatsApp Cloud API) que permite escribir al cliente fuera de la ventana de 24 horas de conversación abierta. Requiere redacción y aprobación previa. |
| Ventana de 24 horas | Período posterior al último mensaje del cliente durante el cual FleteChat puede escribir mensajes libres por WhatsApp. Fuera de esa ventana se requiere plantilla proactiva aprobada. |
| OTP (One-Time Password) | Código numérico de corta vigencia enviado al cliente como segundo factor para acceder a un recurso sensible (vista web de reportes US-030, descarga de paquete Ley 81 US-061). |
| Audit log | Registro inmutable de acciones sensibles del sistema (logins, cambios de rol, ediciones de datos, cotizaciones emitidas, aprobaciones, etc.). Consultable desde el backoffice por el admin (US-050). |
| Parámetros globales | Valores configurables desde el backoffice por el admin que gobiernan el comportamiento del sistema: vigencias, umbrales, ventanas horarias, plazos legales, retenciones, etc. (US-046). |
| Rol | Categoría de usuario del backoffice que determina qué acciones puede ejecutar. En v1.0 hay tres: admin (gestión completa), operator (atención operativa + handoff), price_manager (listas de precios). Existe además un superadmin técnico (soporte Kaeus) fuera del alcance funcional. |
| Ley 81 (Panamá) | Ley de protección de datos personales de la República de Panamá que rige el consentimiento, los derechos del titular (acceso, portabilidad, rectificación, eliminación, oposición) y las obligaciones del responsable del tratamiento. |
| DPD / DPO (Delegado / Responsable de Protección de Datos) | Persona designada formalmente por FleteChat con responsabilidad sobre el cumplimiento de la Ley 81. Su contacto aparece en la política de privacidad publicada. |
| ANTAI | Autoridad Nacional de Transparencia y Acceso a la Información de Panamá. Autoridad de control ante la cual FleteChat puede estar obligado a registrar bases de datos personales y a notificar brechas de seguridad. |
Control de versiones¶
| Versión | Fecha | Cambios |
|---|---|---|
| 1.0 | 2026-04-20 | Versión inicial. |