balam/planeacion/Guion-sesion-2026-08-21.md

Guion — sesión del viernes 21-ago-2026, 7:00 am (Noé, Araceli, Pedro)

Objetivo: emitir la primera cotización real en BIND desde FAC-106 y validar las 17 categorías. Alcance: termina en la cotización (sin prefactura, sin timbrado, sin tocar Jira). Sondeo y diagnóstico de anoche: Sondeo-FAC-106-y-payload-2026-08-20.md.

---

0 · Esta noche (5 min)

• Avisar a Pedro por WhatsApp — cumple el compromiso del 12-ago de avisar antes de cada escritura, y corrige el shape que se compartió entonces (llevaba VATRate: 16; el correcto es 0.16). Borrador:

Pedro, ya quedó listo el caso sobre FAC-106: la plataforma ya lee el formulario nuevo (cliente, servicio, cantidad, IVA) y encontré la causa del error de la sesión pasada — la tasa de IVA iba en porcentaje y BIND la espera como fracción (0.16), ya corregido y probado en simulación. Mañana muestro la vista previa y, con su ok, emitimos la cotización real y Araceli la cancela al terminar. Nos vemos a las 7.

1 · Antes de las 7:00 (6:35–6:55)

• docker compose up -d (Postgres ya suele estar arriba) · levantar API y frontend.
• Verificar que el modo diga ReadOnly al entrar a la pantalla de emisión (quedó así anoche; el candado se abre solo en el paso 4).
• Re-sondeo exprés de FAC-106 (Pedro anduvo moviendo formularios): abrir la solicitud en la plataforma y confirmar que siga prellenando CEMEX / Servicio de Enlace / 1 / 16% / 1234 / MXN. Si algo cambió, el fallback manual sigue funcionando — se captura a mano en la misma pantalla.
• Terminal lista con los dos comandos del candado (paso 4 y cierre).
• Abrir el sondeo en una pestaña (plan B §4 y preguntas).

2 · Al abrir la sesión — ANUNCIAR ANTES DE EJECUTAR (pendiente arrastrado del 12-ago)

1. Destino de la cotización: se emite real sobre CEMEX con los datos de FAC-106; al terminar, Araceli la cancela en vivo (ella confirmó el 12-ago: sin timbrar, se cancela sin efecto). Así el ejercicio además demuestra la reversa.
2. La prefactura pertenece a otra sesión (candados: cotización → prefactura → aprobación humana → timbrado).
3. Qué se corrigió del 500: escala de la tasa, IVA de partida como monto, lista de precios omitida.

3 · Demo en ReadOnly (el camino feliz, sin riesgo)

Abrir bandeja → FAC-106 → Cotizar: la partida se prellena sola desde el formulario nuevo y la vista previa (dry-run) se genera automática — enseñar el body exacto. Aquí se valida con Araceli que los datos son los que ella capturaría.

4 · Emisión real (una sola vez)

dotnet user-secrets set "Bind:Mode" "Write" --project src/Balam.Api   # + reiniciar API

Confirmar → folio y total en pantalla → "véanlo en su BIND" (Ventas → Cotizaciones) → Araceli cancela → candado de vuelta:

dotnet user-secrets set "Bind:Mode" "ReadOnly" --project src/Balam.Api

Si BIND rechaza: el body del error se lee en pantalla (ya no es 500 ciego). Orden de ataque: (1) agregar PriceListID de una cotización reciente del cliente; (2) mandar el GUID del servicio en ID; (3) probar Type. Y si no sale en vivo, Araceli ya dijo la vez pasada: "haz la prueba y podemos agendar otra sesión" — el dry-run mostrado ya es entregable.

5 · Preguntas que SOLO se resuelven con ellos (en orden de impacto)

1. 🔴 Empresa origen = Balam / RegioTurk / Helmstone — ¿cuentas de BIND distintas? Hay un solo token; si cada empresa factura en su cuenta, cambia el alcance.
2. 🔴 El combo IVA no tiene 0% y hay clientes de exportación en el combo (ACUNTIA S.A.U., VictTec, IAMCFORWARDER). ¿Se agrega la opción?
3. 🔴 "Servicio de Enlace" existe 5 veces en BIND con unidad SAT y ChargeVAT distintos — ¿quién depura BIND y cuál es el mapeo etiqueta→ítem? (segunda mitad de lo que pidió Araceli el 12-ago).
4. Validar las 17 categorías (Pedro las condicionó a Noé+Ara — es esta junta).
5. Regla de edición: ¿historial de cotizaciones o modificar la misma? (quedó como "regla de negocio de Balam" el 12-ago).
6. ☁️ Azure — tercera semana; Noé dijo "lo resuelvo con Pedro" y Pedro ahora es el responsable. Requisitos: grupo de recursos + Contributor (app+BD+Key Vault), sin Global Admin.
7. 👤 Con el relevo a Pedro: ¿a quién se reportan horas/avances/facturación ahora? (todo el circuito iba por Erika).
8. Recordatorios menores: fijar que manda el combo Cliente (11598) sobre el texto libre (11596); quitar el SLA a estos tickets (Pedro lo dijo, confirmar que se hizo); grabaciones de BIND que Pedro ofreció el 12-ago.

Qué NO hacer

• ❌ Emitir antes de la sesión o sin anunciar el destino (candado de Noé, REGISTRO #65 §8).
• ❌ Dejar Bind:Mode=Write al cerrar.
• ❌ Abrir el tema de prefactura/timbrado aunque salga bien a la primera — gradualismo explícito de Arturo.