balam/planeacion/Guion-validacion-prototipo-2026-07-23.md

Guion — Validación del prototipo Etapa 0 (jue 23-jul, 7:00 pm)

Material: ../prototipo/Prototipo-Balam-Etapa0.pdf (11 páginas) + demo en paputec.mx/balam. Meta de la sesión: que digan "sí, así opera Balam" pantalla por pantalla → cierra la Etapa 0. Regla de oro: en cada pantalla, terminar con UNA pregunta de validación. No presentar; validar.

---

Apertura (2 min)

"Gracias por el tiempo. Lo que van a ver es el proceso que ustedes me enseñaron en las sesiones con Araceli y Arturo, convertido en pantallas. Todo es dato ficticio. El objetivo de hoy es que me digan qué SÍ refleja su operación y qué corregimos — cada 'así no es' de hoy me ahorra semanas de desarrollo."

Aviso útil: "Ayer con Arturo y Araceli aprendí cosas nuevas (fee, flujo Jira); les voy a ir señalando dónde ya sé que hay ajustes."

---

Pág. 2 · El flujo de principio a fin (3 min)

Recorre los 5 pasos: Solicitud Jira → Cotización BIND → Prefactura → Aprobación humana → CFDI + Envío.

"Este es el mapa de todo. La automatización está donde ustedes la pidieron: después de Jira, y con validación humana antes de timbrar. Aprobar y timbrar son acciones separadas — nada se timbra solo."

⚠️ AQUÍ VA LA PREGUNTA GRANDE (caja de reglas, primera línea "PPD por defecto"):

"Esta regla salió del Discovery: PPD por defecto porque cobran a crédito 30–90 días. Pero al sincronizar el histórico real encontré que las 1,374 facturas con método de pago son TODAS PUE, cero PPD. ¿Es política del despacho o práctica que quieren corregir? Cambia el default de la plataforma y toca el requerimiento del SAT que ya vivieron."

Anotar la respuesta — define B7 (capa de escritura).

• Validar también: "¿Recordatorios de morosidad a todos los clientes, sin excepciones — sigue firme?" (lo decidió Ara el 6-jul).

Pág. 3 · Acceso (30 seg — no gastar tiempo)

"Ingreso con cuenta interna, control de sesión y roles — cada quien ve lo suyo. Esto ya está construido en el backend real."

Pág. 4 · Panel de control (4 min)

Señalar en orden: facturado del mes separado MXN/USD (nunca se suman monedas) · emitidas vs pendientes · cartera vencida · bandeja "Qué necesita atención".

"La bandeja es el corazón: bloqueos por falta de cotización, facturas vencidas escaladas, prefacturas esperando aprobación, clientes nuevos sin cédula, facturas emitidas sin enviar. Cada línea tiene responsable y antigüedad."

Dato para credibilidad: "Esto ya no es dibujo — el backend real ya sincroniza la cartera de producción: 1,494 facturas, y los totales cuadran contra BIND al centavo."

Pregunta: "¿Son estos los 4 números que quieren ver al abrir? ¿Falta o sobra una tarjeta?" (Recordar: Pedro ya tiene Power BI de aging — esto es operación, no reporteo; no duplico lo suyo.)

Pág. 5 · Solicitudes (Jira) (3 min)

"La entrada del flujo: sin ticket, no se factura — tal como operan hoy. Filtros por estatus: por validar, listos, bloqueados, facturados."

Conectar con ayer:

"Con lo que me mostró Arturo ayer, esto mapea directo a su space 'Facturación' y su flujo de estatus — donde 'resuelto' es el que confirma facturación válida. La sesión con Pedro para el API de Jira nos dirá si estos tickets entran solos o se capturan."

Pregunta: "¿Las columnas (tipo, cliente, moneda, monto, crédito, recurrente, estatus) son las que Arturo necesita para decidir qué facturar?"

Pág. 6 · Detalle de la solicitud (3 min)

Señalar: datos del ticket, adjuntos (cotización, OC, horas con VoBo), doble check de administración, cotización BIND vinculada como requisito.

Nota ⚠️ (fila "Cliente nuevo"):

"Ayer Arturo me mostró el alta completa en BIND. La decisión que les pido hoy: cuando el ticket trae un cliente que NO existe en BIND, ¿la plataforma solo lo detecta y avisa a administración, o también lo da de alta? Mi recomendación para el MVP: detectar y bloquear; el alta la hace administración en BIND como hoy."

Anotar decisión — cruza con la estimación de ~10 h de Jira→BIND.

Pág. 7 · Preparación, aprobación y emisión (4 min)

"Asistente de 5 pasos: cotización BIND (sin cotización no se puede continuar) → datos de factura → conceptos e IVA 16%/0% con alerta si no cuadra → prefactura en simulación, sin timbrar → aprobación humana. Aprobar NO timbra: son dos clics distintos, de dos momentos distintos."

Reforzar seguridad (le importa a Noé):

"Y cuando llegue la escritura real: dry-run, confirmación humana por factura y feature flag apagado por defecto — como acordamos ayer, con todo el cuidado de que es producción."

Pregunta: "¿Quién aprueba en la vida real — siempre Arturo, o hay segundo aprobador?"

Pág. 8 · Envío al cliente (3 min)

"El proceso NO termina al timbrar: termina cuando el correo sale con los adjuntos correctos. Checklist bloqueante por cliente — ejemplo CEMEX: PDF+XML automático, Excel de horas con VoBo, asunto con su nomenclatura exacta. Si falta algo, el envío se bloquea — hoy un error de estos rebota la factura y con 90 días de crédito cada rebote empuja el cobro."

Pregunta / pendiente: "Para cargar las reglas reales necesito el Excel de particularidades por cliente que quedó con Ara y Arturo — ¿cómo va? Ya revisé los procedimientos que me mandaron el 16-jul; el Excel me completa destinatarios y nomenclaturas."

Pág. 9 · Cuentas por cobrar (3 min)

"El aging que hoy llevan en Excel, leído de BIND: por vencer, 1–30, 31–60, 61–90, +90 — MXN y USD siempre separados, el tipo de cambio DOF es solo informativo. Saldo y días de mora por factura."

Credibilidad: "Los números reales ya viven en el backend: la cartera sincronizada cuadra exacta contra BIND."

Pregunta: "¿Estos rangos de aging son los que usan? ¿Les sirve el corte por factura o necesitan también por cliente?"

Pág. 10 · Pagos y recordatorios (4 min) — LA PANTALLA CON MÁS AJUSTES DE AYER

1. Fee (caja "Tolerancia por comisión"):

"Ayer Araceli me aclaró el proceso real: el fee bancario lo registra y deduce EL DESPACHO — Balam no hace ese asiento. Entonces esta pantalla se ajusta: la plataforma DETECTA la diferencia en pagos internacionales, la ETIQUETA como probable fee y avisa; quien salda es el despacho. ¿De acuerdo con ese ajuste?"

2. Fecha de detección: "La fecha que muestro es la del registro en BIND (lo captura el despacho), no la fecha valor del banco — BIND no expone pagos individuales. ¿Les funciona así para el MVP?"

3. Recordatorios (columna derecha) — poner el límite con suavidad:

"Ojo con esta parte: las alertas D+1 y el escalamiento D+15 son INTERNAS y van en el MVP. Los correos automáticos AL CLIENTE (D+5, D+30) están cotizados en el Anexo B — aquí los dejo visibles y preparados para activarse, pero no son parte de esta fase. Lo señalo para que no haya sorpresa al cierre."

Pág. 11 · Bitácora (2 min)

"Todo queda registrado: quién aprobó, quién emitió, qué override de IVA se hizo y por qué, con ticket Jira y folio BIND. Esto responde exactamente al problema que me contó Arturo ayer: 'dijeron que ya facturaron y no había evidencia'. Aquí la evidencia es automática. Y la bitácora ya existe en el backend real, no solo en el prototipo."

---

Cierre (5 min)

1. Pedir el veredicto explícito:

"¿Validan que este flujo representa su operación? Con su OK doy por cerrada la Etapa 0, aplico los ajustes que anotamos y el demo público lo doy de baja como quedamos."

2. Recap de decisiones tomadas hoy (leerlas en voz alta): PUE/PPD · alta de cliente (detectar vs crear) · fee = despacho confirmado · recordatorios internos vs Anexo B · rangos de aging.

3. Siguientes pasos (recordar compromisos de ayer): diagrama del flujo Jira en tamaño legible · sesión con Pedro (API Jira + facturación recurrente) · Excel de particularidades de envío · Azure esta semana.

4. Si el ambiente lo permite, la comercial:

"Ing. Noé, ya de regreso del viaje — ¿pudieron revisar la propuesta v1.2 para lo de la facturación inicial de las 30 horas?"

Chuleta de respuestas rápidas

• "¿Y si queremos que también mande correos al cliente?" → Está cotizado en Anexo B; la pantalla ya lo deja preparado. Lo activamos como ampliación cuando cierre el MVP.
• "¿Esto ya jala con BIND de verdad?" → La lectura sí: clientes, facturas, cotizaciones y cartera ya sincronizan de producción, en solo-lectura. La escritura va con los candados acordados.
• "¿Cuándo estará?" → Etapa 1 va adelantada (backend, auth, sync y seguridad por tenant ya construidos). Las fechas finas dependen de Azure y de las decisiones de hoy.
• "¿Multiempresa / Regiotour?" → Fuera del MVP (un token BIND por empresa); el diseño ya lo soporta a futuro.
• "¿Forecast por contrato?" → Lo dijo Noé ayer: no es para ahorita; queda anotado para una fase posterior.