US-018 — Número de tracking único

Detalle de la historia¶

Historia¶

Como cliente de FleteChat que aprobó formalmente una cotización, quiero recibir un número de tracking único del embarque, para poder hacer referencia a mi operación en cualquier consulta posterior sin ambigüedad.

Persona de usuario¶

Aplica a todo cliente verificado (titular o colaborador autorizado) cuya cotización se aprobó formalmente (Paso 3 de la aprobación, ver historia correspondiente). También es referencia de uso para el equipo operativo de FleteChat y para los operadores logísticos externos.

Contexto de negocio¶

Antes del click de aprobación formal (Paso 3) no existe todavía un embarque: existe una cotización aprobada en intención y un borrador de datos operativos. El embarque nace recién cuando el cliente hace click en el enlace de aprobación del correo de instrucciones: ese acto dispara la emisión del número de tracking y la puesta en marcha de la operación.

El número de tracking tiene dos roles: - Para el cliente por WhatsApp: un código corto, fácil de escribir, de recordar y de mencionar (E42, E151, E7). Es el identificador que el agente usa por defecto cuando conversa con el cliente sobre el embarque (estatus, cambios, preguntas). - Para documentos formales, operadores externos, auditoría y referencias cruzadas: un código largo único globalmente, que aparece en las instrucciones a proveedor y operador logístico, en la facturación y en los registros contables.

Esta historia establece la regla dual y la asignación al emitir el embarque. La operación conversacional posterior (consultas de estatus, historial, notificaciones) se trata en las historias del Epic de seguimiento de embarques.

Diálogo de referencia¶

Emisión al aprobar formalmente¶

[El cliente hace click en el enlace de aprobación formal del correo de instrucciones.]

Agente: Cotización C187 aprobada formalmente. Su embarque queda registrado como E42 y la operación está en marcha. Le iré avisando por aquí cada avance.

Cliente menciona el código corto después¶

Cliente: ¿Cómo va E42?

Agente: Su embarque E42 (Bogotá → Miami, LCL DDP) está en tránsito marítimo; la llegada estimada sigue siendo el viernes.

Cliente menciona variación del código¶

Cliente: Dame estatus del e42.

Agente: Claro, su embarque E42 ...

Criterios de aceptación¶

Emisión¶

1. El número de tracking se emite exactamente una vez, al momento del click de aprobación formal de la cotización (Paso 3; ver historia de aprobación por WhatsApp). No se emite antes, no se regenera después.
2. La emisión es atómica con el registro de la aprobación formal: si la emisión falla, la operación de aprobación completa se revierte a nivel de estado conceptual y FleteChat aplica el manejo transparente de errores (ver historia correspondiente).

Código dual¶

1. Cada embarque tiene dos identificadores: a. Un código externo corto, con formato ENNN (prefijo E seguido del número, por ejemplo E42), único por cliente. Es el consecutivo de embarques de la cuenta del cliente: su primer embarque es E1, el segundo E2, y así sucesivamente. El código externo nunca se reusa. El prefijo E lo distingue de las cotizaciones (C) y de otros recursos futuros del cliente. b. Un código interno largo, único globalmente en el sistema, usado en documentos formales (instrucciones a proveedor y operador, facturación, tracking interno), auditoría y toda referencia cruzada entre sistemas. El formato es decisión técnica del equipo; la historia exige unicidad global e independencia del cliente.

Uso por canal¶

1. El código externo ENNN es el que FleteChat usa por defecto al conversar por WhatsApp con el cliente final.
2. El código interno aparece en las instrucciones formales (proveedor, operador logístico, equipo interno — ver historias de los tres instructivos), en el correo de confirmación de aprobación y en facturas/registros contables.
3. Ambos códigos conviven como referencia cruzada: desde un código se llega al otro en cualquier sistema del ecosistema.

Resolución en WhatsApp¶

1. Cuando el cliente menciona un código corto (E42, e42, E-42, "embarque 42", "el 42"), FleteChat lo normaliza y resuelve siempre dentro del alcance de la cuenta del cliente. Nunca expone ni cruza embarques entre cuentas distintas.
2. Si el cliente confunde el prefijo (dice C42 queriendo referirse al embarque E42, o viceversa), FleteChat lo detecta, pide aclaración y ofrece los candidatos más cercanos.

Inmutabilidad¶

1. Una vez emitido, el número de tracking no es editable por ningún actor ni rol. Correcciones operativas se reflejan en los datos asociados (estatus, observaciones, destinatarios), no en el identificador.

Edge cases¶

• Cliente aprueba cotización sin embarques previos. Se le emite E1; el contador del cliente se inicializa.
• Fallo técnico en la generación del código al momento de aprobar. La aprobación formal no se registra; FleteChat aplica la política de manejo transparente de errores, reintenta y, si sigue fallando, activa handoff. No se emiten números "intermedios" que luego queden sin embarque asociado.
• Cliente corporativo con alto volumen que llega a números de 4 o 5 dígitos (E1234). El formato soporta sin problema; la legibilidad por WhatsApp se mantiene porque sigue siendo corto y deterministicamente escribible.
• Cliente cancela un embarque recién emitido. El código no se reusa para el siguiente; la secuencia continúa (E42 cancelado → siguiente es E43).

Tamaño, prioridad y tipo¶

• Tamaño: S
• Prioridad: P0 — todos los flujos de seguimiento, facturación y operación dependen de este identificador.
• 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-083 — Código externo del embarque. Cada embarque tiene un código externo corto con formato ENNN (prefijo E seguido del número), único por cliente, que es el consecutivo de embarques de la cuenta del cliente (E1, E2, E3, …) y no se reusa aunque el embarque se cancele. Es el identificador que FleteChat usa por defecto al conversar por WhatsApp con el cliente final.
• PR-084 — Prefijo E para distinguir recursos. El prefijo E es la marca que distingue un embarque de otros recursos del cliente: cotizaciones usan C (ver historia de precio total con desglose), otros recursos futuros deberán usar prefijos dedicados para evitar ambigüedad en el chat.
• PR-085 — Código interno del embarque. Cada embarque tiene además un código interno largo, único globalmente, usado en documentos formales (instrucciones a proveedor y operador, 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-086 — Emisión atómica al aprobar. El número de tracking se emite exactamente al momento del click de aprobación formal (Paso 3). Emisión y registro de la aprobación son atómicos: si uno falla, el otro no queda huérfano.
• PR-087 — Inmutabilidad. El número de tracking (ambos códigos) es inmutable después de emitido.

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-083 a PR-087 confirmadas por el cliente
• ⬜ Reglas de negocio aplicables aprobadas
• ⬜ Requerimientos funcionales aplicables aprobados
• ⬜ Historia aprobada formalmente por el cliente