johannvelazquez/balam
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
balam/04 - AGENDA-LLAMADA-CTO.md
T

17 KiB
Raw Permalink Blame History

Agenda · Llamada CTO (martes 19 mayo 2026)

Documento de preparación personal para la llamada de pre-arranque del proyecto Balam. Complementa 03 - GUIA-STAKEHOLDERS.md (Sección 2). La Guía tiene la lista exhaustiva de preguntas; este documento tiene lo que ya investigué para no llegar en cero, las preguntas concretas que se derivan de esa investigación, y el orden para los 60-75 min.

Hallazgo principal: BIND ERP sí tiene API documentada. Esto cambia el tono de la llamada — la pregunta deja de ser "¿hay API?" y pasa a ser "¿qué módulos están expuestos, cuál es el plan de uso?".

0. Mentalidad para entrar a la llamada

  • No vendas, valida. La propuesta ya está firmada (o por firmar); esta llamada existe para detectar si algún supuesto crítico hoy no se cumple. Mejor descubrirlo aquí que en semana 2.
  • No prometas fechas exactas antes de ver el export real de BIND y los PDFs.
  • No discutas tarifa ni stack.
  • Apunta hacia los artefactos del cierre (Sección 7) — todo lo que NO sea uno de esos 5 entregables es ruido.

1. Estado de lo investigado (lo que YA sé antes de entrar)

Esta sección es para que entres a la llamada con contexto real, no asunciones. Cada hallazgo viene con la pregunta que se le deriva.

1.1 BIND ERP — tiene API pública ⚡ (cambia el supuesto #2)

Hecho confirmado Fuente Implicación
API documentada en developers.bind.com.mx Portal BIND · Ayuda BIND Fase 1 puede ir vía API en vez de export, si los módulos que necesitamos están expuestos
Auth: Bearer Token (API Key) Ayuda BIND API Key se saca desde Perfil → Integraciones
Rate limit: 20,000 req/día Ayuda BIND Más que suficiente para ~50 facturas/mes
Endpoints confirmados: /api/Invoices, /api/Invoices/{idOrNumber} con UUID/folio fiscal · /api/inventory · módulo Customers (consultar, agregar, actualizar) API tracker / Ayuda BIND Cubre facturación + clientes, que es exactamente Fase 1
NO confirmado: webhooks, endpoint de pagos, endpoint de asientos contables, sandbox, timbrado CFDI 4.0 vía API — Son las 5 preguntas clave de la llamada para BIND

Preguntas concretas al CTO sobre BIND (en orden de prioridad):

  1. ¿Han usado la API de BIND antes, o solo el export? ¿Tienen ya un API Key activo?
  2. ¿Saben si BIND expone webhooks (factura creada, factura pagada, factura cancelada)? Si no, voy a tener que hacer polling — afecta cadencia y costo de Fase 1.
  3. ¿Hay endpoint en BIND para registrar pagos y para subir/generar asientos contables? Si sí, Fase 4 cambia (en lugar de export Excel para el contador, escribimos directo). Si no, mantenemos el plan actual.
  4. ¿BIND ofrece sandbox, o solo producción? — Define cómo trabajamos en Fase 0/1 sin tocar datos reales.
  5. ¿El timbrado CFDI 4.0 está expuesto vía API o sigue siendo solo botón en la UI? — Importa para visión Fase 2 (que la plataforma emita directo en lugar de "trigger humano en BIND").

Si NO conoce la API o nunca la han usado: no es bandera roja por sí solo, pero pídele acceso ese mismo día para inspeccionarla yo.

1.2 BUK — tiene API REST documentada ✅ (supuesto #6 sostiene)

Hecho confirmado Implicación
BUK ofrece API RESTful para exportación de datos Visión Fase 2 (BUK → factura automática) es viable
Plataforma BUK México activa (buk.mx) No hay riesgo de no-cobertura geográfica
30+ integraciones nativas + flujos configurables Hay precedente, no es greenfield

Preguntas concretas al CTO sobre BUK:

  1. ¿Quién administra BUK internamente? ¿Tienen ya credenciales API o hay que solicitarlas?
  2. ¿Qué disparador de BUK marcaría "nómina aprobada lista para facturar al cliente"? (Es el caso de uso #1 del PRD original — viable solo si ese evento existe en BUK.)
  3. ¿Cómo registran hoy en BUK las horas por colaborador-cliente? ¿Lo hace BUK, Jira, o vive en una hoja aparte?

1.3 IBC Bank Texas — sin API, pero hay 2 alternativas a PDF ⚠️

Esto es el riesgo más alto del MVP según la propuesta. Lo que ya sé:

Hecho confirmado Fuente Implicación
IBC ofrece eStatements PDF/PNG, retención 18 meses online IBC Online Banking Lo que asumimos en la propuesta
IBC permite export a Quicken/QuickBooks (formato .QBO/.QFX/.OFX) IBC Online Banking Esto es enorme — parsear .QBO (XML estructurado) es 10× más barato y robusto que parsear PDF con Claude
Plaid cubre marginalmente bancos MX, pero sí cubre la mayoría de US banks — IBC posiblemente sí esté en Plaid Plaid Docs Plan B si .QBO no funciona y si están dispuestos a compartir credenciales

Preguntas concretas al CTO sobre IBC:

  1. ⚡ ¿Hoy descargan estado de cuenta IBC en PDF, o también en formato .QBO/Quicken? Si pueden descargar .QBO, eliminamos el riesgo de parsing con Claude para IBC. Cambia el alcance de Fase 3 significativamente.
  2. ¿IBC ofrece "Direct Connect" para QuickBooks (vía OFX server) o solo "Web Connect" (descarga manual del archivo)? — Direct Connect = automatizable. Web Connect = sigue siendo descarga manual pero con archivo bueno.
  3. ¿Estarían dispuestos a compartir credenciales IBC con un agregador tipo Plaid? (Si la respuesta es no, no insistir — política de seguridad típica.)

1.4 Bancos MX — Belvo cubre el universo posible ✅

Hecho confirmado Fuente
Belvo cubre 32 instituciones MX para data + payments, incluyendo BBVA, Banorte, Citibanamex, Santander, HSBC, Scotiabank, Banregio, Inbursa, Banco del Bajío, Mifel Belvo Direct Debit Institutions

Preguntas concretas al CTO sobre bancos MX:

  1. ¿Cuáles 2 bancos MX exactos son? (Si están en la lista de Belvo arriba, hay plan B viable.)
  2. ¿Conocen Belvo o han evaluado integración bancaria previamente? — Posicionarlo como Fase 2 (no MVP), pero útil saber si hay apertura. La objeción típica es "no compartimos credenciales con terceros".
  3. ¿Tienen PDFs históricos de los últimos 3-6 meses de los 3 bancos para validar parsing en Fase 0?

1.5 Stripe MX — timeline manejable, pero hay que arrancar ya ✅

Hecho confirmado Fuente Implicación
Aprobación típica: horas a 2 días, máximo 2 semanas en casos complejos Stripe MX requisitos Si arrancan el trámite hoy, semana 4 (cobranza + pago link) está cubierta
Requisitos: entidad mexicana + RFC + CLABE + representante legal Stripe Support Si falta uno solo, Stripe MX no opera
Comisión: 3.6% + $3 MXN, sin IVA sobre la comisión Stripe pricing —
Alternativas si Stripe no aprueba: Conekta (100% MX, OXXO/SPEI nativo, 3.4% + $3 + IVA) o Mercado Pago Comparativa Stripe vs Conekta vs MP 2026 Plan B documentado

Preguntas concretas al CTO sobre Stripe:

  1. ¿La empresa ya tiene RFC + CLABE + representante legal con CURP listos? Si sí, abrimos cuenta esta semana y empezamos verificación.
  2. ¿Algún convenio o pricing especial con Stripe? ¿O ya tienen cuenta?
  3. Si Stripe MX rechaza o se tarda más de 2 semanas, ¿hay apertura a Conekta como Plan B?

1.6 Jira — variable crítica es Cloud vs Server

No requiere research técnico (Jira es estándar), pero confirmar:

  1. ¿Jira es Cloud o Server? (Cloud = API limpia OAuth 2.0; Server = más complicado, depende de versión.)
  2. ¿Hay registro de horas por colaborador-cliente en Jira hoy, o eso vive en otro lado (hoja de cálculo, BUK)?

2. Estructura de los 60-75 min (orden propuesto)

Asume que el CTO da máximo 60 min reales. Si te dan más, expandes Bloques 4 y 5.

Min 0-5 · Apertura

  • Saludo, agradecimiento por el tiempo.
  • Encuadre claro (en menos de 60 segundos): "El objetivo de hoy no es vender ni planear el proyecto — eso ya está en la propuesta. El objetivo es validar conmigo, sistema por sistema, que los supuestos de la propuesta se sostienen. Cada minuto que invertimos aquí me ahorra 10 minutos en semana 2."
  • Permiso para tomar nota / grabar (siempre pídelo).

Min 5-30 · Bloque 1 — Sistemas y datos (el corazón)

Orden interno (no negociable, va de menor a mayor riesgo):

  1. BIND ERP (8-10 min) — usa las 5 preguntas de 1.1
  2. Bancos MX (5 min) — qué bancos exactos, PDFs históricos, posición sobre Belvo
  3. IBC Texas (5 min) — la pregunta del .QBO es la más importante de toda la llamada
  4. BUK + Jira (3-5 min) — son Fase 2, no MVP, no profundices
  5. Stripe (3 min) — RFC/CLABE/representante listos sí/no

Min 30-45 · Bloque 2 — Infra, compliance, seguridad

Usa la tabla de Sección 2.3 de 03 - GUIA-STAKEHOLDERS.md. Los críticos:

  • ¿Azure activa? ¿Quién la administra? ¿Centro de costos?
  • ¿Política interna sobre enviar PDFs bancarios a un LLM externo (Claude API)? — supuesto #11 de la propuesta.
  • ¿Cómo manejan secretos hoy?
  • ¿NDA — el suyo o el mío?

Min 45-55 · Bloque 3 — Realidades operativas y reglas no escritas

Lo mínimo crítico (ver Sección 2.4 y 2.5 de la Guía):

  • Distribución de las ~50 facturas: ¿concentradas o uniformes?
  • Tiempo actual de conciliación + % retrabajo (línea base para criterios de éxito 60%/70%).
  • Lista blanca: ¿Top 3 exactos?
  • ¿Cuál es el peor escenario que les preocupa? (Esta pregunta abre cosas no escritas.)

Min 55-65 · Bloque 4 — Cierre operativo

Pide explícitamente los 5 entregables de Sección 7. No salgas de la llamada sin esto.

Min 65-70 · Pregunta-trampa

"Si dentro de 6 meses esta plataforma está funcionando exactamente como esperan, ¿qué métrica concreta tendría que estar moviéndose para que sintieras que valió la pena?"

Esta pregunta revela la prioridad real. A veces sale algo que no está en el PRD.

3. Banderas rojas a escuchar activamente

Si oyes cualquiera de estas, no las negocies en la llamada — anótalas y replantea después.

Si escuchas... Significa Acción
"BIND no, eso lo administra el contador externo" No tienes acceso técnico real Pedir contacto del contador antes de Fase 0
"No sabemos quién descarga los PDFs hoy" No hay dueño operativo Bloqueador para Fase 0 — necesitas dueño
"No podemos compartir PDFs reales todavía" Supuesto #1 en riesgo Posponer fecha de arranque hasta tenerlos
"Azure la administra otro proveedor" Latencia + permisos Pedir sponsor interno antes de Fase 0
"Tenemos que consultar con legal sobre enviar datos a Claude API" Supuesto #11 en riesgo Plan B: extracción local (Tesseract + reglas) — replantear costos
"No tenemos RFC todavía / lo está tramitando la contadora" Stripe MX no opera Bloqueador para Fase 2 — Conekta Plan B inmediato
"IBC solo lo veo cuando entro al portal y le doy print" El peor caso Confirma .QBO antes de aceptar este peor caso
"Ya intentamos esto antes con otro proveedor" Hay historia Pregunta qué pasó — lecciones gratis

4. Banderas verdes (señales de que el proyecto va a fluir)

Si escuchas... Significa
"El admin de BIND es Juanito y le digo que te ayude esta semana" Dueño técnico claro
"Aquí tienes mi API Key de BIND, úsala" Velocidad máxima en Fase 0/1
"Tenemos sandbox de BIND" Reduce 50% el riesgo de Fase 1
"IBC sí permite descargar .QBO" Fase 3 se simplifica 30-40%
"Stripe ya está creada y verificada" Fase 2 sin bloqueador
"El gerente admin se llama X y está disponible miércoles y viernes" Cadencia de validación realista
"Hay un Slack/Teams con el equipo que te van a meter" Comunicación async funcionando

5. Demostraciones de preparación (cosas que dices para mostrar que sí investigaste)

Úsalas cuando aplique. No las metas todas a fuerza — son munición, no checklist.

  • "Vi que BIND tiene un portal en developers.bind.com.mx con auth Bearer y rate limit de 20K req/día. ¿Ya tienen API Key o lo sacamos juntos esta semana?"
  • "Belvo cubre BBVA, Banorte, Santander, Citibanamex, HSBC y Scotiabank en MX. ¿Cuáles son los 2 que ustedes usan? Si están en la lista, hay plan B para Fase 2."
  • "IBC ofrece export a Quicken/QuickBooks en .QBO. Si me confirmas que sí está disponible para su cuenta business, eliminamos el mayor riesgo del MVP — ya no dependemos de OCR sobre PDF para Texas."
  • "Stripe MX típicamente aprueba en 1-2 días si los datos están limpios. Conekta es el Plan B si hay algún tema con RFC/CLABE."

Cuidado: decir demasiado puede sonar a "ya tengo todo resuelto" → puede bajarles la urgencia de mandarte artefactos. Equilibrar.

6. Lo que NO conviene hacer (recordatorios)

  • No prometer fechas exactas antes de ver el export real de BIND y los PDFs.
  • No entrar en debate de stack (Next.js vs. otra cosa) — eso es decisión tuya.
  • No discutir tarifa — está en la propuesta. Si lo abren, respondes corto y rediriges.
  • No aceptar scope creep ("¿también podrías hacer X?") → "Lo agendamos para Fase 2."
  • No dar opinión técnica fuerte sobre cómo operan hoy — vienes a entender, no a juzgar.

7. Lo que pides cerrar antes de colgar (entregables de la llamada)

Estas son las 5 promesas concretas que necesitas salir con ellas en mano (idealmente con dueño y fecha):

  1. Compromiso de envío en 5-7 días hábiles:
    • 1 export real anonimizado de BIND (facturas + clientes), o acceso vía API Key
    • 1 PDF de estado de cuenta por cada uno de los 3 bancos (3 archivos) — preferentemente últimos 3 meses
    • Si aplica: 1 archivo .QBO de IBC Texas para validar formato
    • Lista de clientes en lista blanca (ACUNTIA + Top 3 con nombre exacto)
  2. Acceso o creación de subscripción Azure con un sponsor identificado.
  3. Borrador de NDA (si aplica) + posición sobre el uso de Claude API.
  4. Cadencia confirmada: 2-3 standups async/semana + demo viernes + sesión técnica quincenal.
  5. Próxima sesión técnica agendada (idealmente día 1 de Fase 0) con el contacto técnico día a día designado.

8. Cosas a hacer YO antes de la llamada (mañana antes de entrar)

  • Revisar la propuesta firmada (00 - PROPUESTA-COMERCIAL.md) para tener los 11 supuestos frescos.
  • Tener 03 - GUIA-STAKEHOLDERS.md abierto en otra pestaña por si necesito profundizar una pregunta.
  • Tener este documento abierto en otra pestaña.
  • Crear un Postman collection mínimo apuntando a developers.bind.com.mx para mostrarlo en pantalla si la conversación lo amerita. (Opcional, pero impresiona.)
  • Confirmar el link de la videollamada y prueba audio/cámara 10 min antes.
  • Tener una hoja en blanco a mano para anotar nombres, fechas, números.

9. Post-llamada (mismo día, antes de dormir)

  • Mandar correo de resumen + compromisos al CTO en menos de 4 horas — formato: 5 bullets de lo que acordamos + 5 bullets de lo que cada uno entrega y para cuándo.
  • Actualizar 00 - PROPUESTA-COMERCIAL.md con cualquier supuesto que haya cambiado.
  • Si cambian supuestos críticos (BIND con API rica, IBC con .QBO, política contra Claude API, etc.), abrir 02 - PLAN-EJECUCION.md y ajustar Fase 0/1/3 según corresponda.
  • Anotar en una sección de "riesgos abiertos" del proyecto las banderas rojas que escuchaste.

Apéndice · Fuentes investigadas

Reference in New Issue View Git Blame Copy Permalink