US-010 — Precio total con desglose

Detalle de la historia¶

Historia¶

Como cliente de FleteChat, quiero recibir el precio total de mi cotización con el desglose claro de cada cargo, para entender exactamente qué estoy pagando antes de aprobar.

Persona de usuario¶

Aplica a todo cliente verificado que completó el flujo de cotización (datos recolectados + servicios opcionales elegidos). Aplica tanto al titular como a colaboradores autorizados.

Contexto de negocio¶

En logística, un precio total sin desglose es motivo común de desconfianza: el cliente no distingue entre flete, recargos por combustible, seguro obligatorio, manejo portuario, agencia, entrega. Cuando algo cambia después (la carga cambia de peso, el combustible sube), el cliente no puede verificar qué parte se ajustó.

El desglose claro hace dos cosas al mismo tiempo: genera confianza (el cliente ve que no hay sobrecargos ocultos) y facilita la aprobación (el cliente sabe lo que está aprobando). También simplifica la conversación posterior: si el cliente pregunta "¿qué es ese cargo?", la respuesta está en el mismo mensaje.

Diálogo de referencia¶

Entrega de cotización¶

Agente: Listo, aquí tiene su cotización:

Cotización C187 — Bogotá → Miami, LCL, DDP

• Flete marítimo LCL — USD 820.00
• Manejo portuario origen — USD 95.00
• Gastos de agencia destino — USD 140.00
• Entrega en bodega en destino — USD 120.00
• Inspección previa al embarque — USD 85.00

Total: USD 1,260.00

Tiempo de tránsito estimado: 12 días. Vigencia de la cotización: 7 días.

Si quiere, la apruebo ahora mismo y empezamos con el embarque.

Cliente pide aclarar un cargo¶

Cliente: ¿Qué es exactamente el "manejo portuario origen"?

Agente: Es el cargo del terminal marítimo en Bogotá por recibir, consolidar y cargar su mercancía en el contenedor de salida. Va al operador del puerto, no a nosotros.

Criterios de aceptación¶

Composición del precio¶

1. El precio total de la cotización es la suma exacta de todos los cargos listados; no hay cargos ocultos ni redondeos no explicados.
2. El desglose incluye una línea por cada servicio o cargo —fijo o opcional— que forma parte del total, con nombre legible y monto.
3. Cuando un cargo depende de una base variable (por ejemplo, 2% del valor declarado), el desglose muestra el monto final calculado, no la fórmula.

Formato¶

1. Los montos se presentan en USD con dos decimales y separadores de miles (USD 1,260.00).
2. El total se presenta de forma visualmente destacada respecto de las líneas del desglose.
3. El mensaje incluye: número de cotización, ruta, modalidad, Incoterm, total, tiempo de tránsito estimado y vigencia.

Trazabilidad¶

1. Todos los valores presentados provienen del sistema (ver historia de precisión y anti-alucinación); FleteChat no estima, no redondea, no calcula de memoria.
2. La cotización queda registrada con su desglose exacto; el mismo desglose es el que se referencia en la aprobación y en la facturación posterior.

Identificación de la cotización¶

1. Cada cotización emitida tiene dos identificadores: a. Un código externo corto, con formato CNNN (prefijo C seguido del número, por ejemplo C187), único por cliente y fácil de mencionar por WhatsApp. Es el consecutivo de la cuenta del cliente: su primera cotización es C1, la segunda C2, y así sucesivamente. El código externo nunca se reusa aunque la cotización se cancele o venza. El prefijo C lo distingue de otros recursos del cliente (por ejemplo, embarques usan E). b. Un código interno largo, único globalmente en el sistema, usado por el equipo operativo, en los documentos formales (instrucciones, facturas, auditoría) y en toda referencia cruzada entre sistemas. El formato es decisión técnica del equipo; lo que la historia exige es que sea un identificador único que no dependa del cliente.
2. El código externo (CNNN) es el que FleteChat usa por defecto en la conversación por WhatsApp con el cliente final; el código interno aparece en los documentos formales generados para el cliente (correo de instrucciones, facturas) y en los canales operativos.
3. Cuando el cliente menciona un código corto en WhatsApp, la búsqueda de la cotización se hace siempre dentro del alcance de su cuenta; el sistema nunca trata C187 como referencia global.
4. FleteChat tolera variaciones en cómo el cliente escribe el código (C187, c187, C-187, c 187, "cotización 187", "la 187"), las normaliza y las resuelve dentro del alcance de la cuenta.
5. Si el cliente menciona un código que no existe en su cuenta, FleteChat lo declara y le pide confirmar el número o describir la cotización que está buscando.

Edge cases¶

• Cargo a calcular con dato faltante (por ejemplo, seguro variable sin valor declarado). FleteChat lo declara como pendiente, pide el dato que falta y recalcula el total.
• Combinación con descuento especial aplicable (por ejemplo, cliente corporativo con tarifa preferencial). El desglose lo muestra como una línea separada —descuento aplicado— con su monto, no como un precio de base alterado.
• Todos los servicios opcionales fueron descartados. El desglose muestra solo los fijos; el total es la suma de esos.
• Cliente pide la cotización en otra moneda. En v1.0 FleteChat solo emite en USD (ver premisas). Si el cliente insiste en otra moneda, FleteChat lo declara y ofrece handoff.
• Cliente menciona por WhatsApp el código con variaciones ("cotización 187" sin prefijo, "C-187", "c187" en minúscula, "la 187"). FleteChat normaliza y lo resuelve dentro del alcance de su cuenta.
• Cliente confunde el prefijo (dice E187 queriendo referirse a la cotización C187, o viceversa). FleteChat lo detecta si el tipo de recurso mencionado en el contexto contradice el prefijo (por ejemplo, "apruébeme E187"), pide aclaración y ofrece los candidatos más cercanos de ambos tipos.
• Cliente menciona un código corto que coincide con otra cuenta (imposible dentro del sistema porque el alcance es por cuenta, pero conceptualmente es la salvaguarda). FleteChat nunca expone ni resuelve recursos de otras cuentas.

Cómo mediremos éxito¶

• Cero discrepancias cotizado vs facturado: todo monto facturado al cliente coincide con el desglose aprobado en la cotización, salvo ajustes documentados de FleteChat.
• Tasa de aprobación: las cotizaciones aprobadas por el cliente final se mantienen por encima de una meta definida por FleteChat, sin reclamos por falta de claridad en el precio.

Tamaño, prioridad y tipo¶

• Tamaño: S
• Prioridad: P0 — sin precio claro no hay aprobación.
• Tipo: feature

Premisas¶

La historia está redactada bajo las siguientes premisas. Si alguna cambia, la historia debe revisarse y ajustarse en consecuencia. Todas deben ser confirmadas por el cliente antes de cerrar la historia.

• PR-051 — Moneda única. En v1.0, todas las cotizaciones se emiten en USD. Otras monedas no están disponibles.
• PR-052 — Desglose obligatorio. FleteChat siempre muestra el desglose línea a línea junto con el total. No existe modalidad "precio cerrado sin desglose".
• PR-053 — Formato numérico. Montos con dos decimales y separadores de miles, prefijo "USD". Formato consistente en chat y en cualquier documento emitido.
• PR-209 — Código externo de la cotización. Cada cotización emitida tiene un código externo corto con formato CNNN (prefijo C seguido del número), único por cliente, que es el consecutivo de la cuenta del cliente (C1, C2, C3, …) y no se reusa aunque la cotización se cancele o venza. Es el identificador que FleteChat usa por defecto al conversar por WhatsApp con el cliente final.
• PR-210 — Prefijo C para distinguir recursos. El prefijo C es la marca que distingue una cotización de otros recursos del cliente. Para embarques se usa prefijo E (ver historia de número de tracking único); otros recursos futuros (facturas, reclamos) deberán usar prefijos dedicados para evitar ambigüedad en el chat.
• PR-211 — Código interno de la cotización. Cada cotización tiene además un código interno largo, único globalmente, usado por el equipo operativo, en documentos formales (correo de instrucciones, facturas), auditoría y referencias cruzadas entre sistemas. El formato es decisión técnica; la premisa exige que sea un identificador único globalmente e independiente de la cuenta del cliente.
• PR-212 — Resolución del código en WhatsApp. Cuando el cliente menciona un código corto (C187, c187, "cotización 187", "la 187"), FleteChat lo normaliza y resuelve siempre dentro del alcance de la cuenta del cliente. Nunca expone ni cruza recursos entre cuentas distintas.

Refinamiento y Definition of Ready¶

Notas¶

Checklist¶

• ✅ Historia escrita en formato Como / Quiero / Para
• ✅ Persona de usuario identificada
• ✅ Contexto de negocio documentado
• ✅ Criterios de aceptación observables y pass/fail
• ✅ Edge cases relevantes listados
• ✅ Tamaño y prioridad asignados
• ⬜ Premisas PR-051 a PR-053 y PR-209 a PR-212 confirmadas por el cliente
• ⬜ Reglas de negocio aplicables aprobadas
• ⬜ Requerimientos funcionales aplicables aprobados
• ⬜ Historia aprobada formalmente por el cliente