balam/bitacora/REGISTRO.md

# REGISTRO · Bitácora de comunicaciones — Proyecto Balam

> Log cronológico de **toda** comunicación del proyecto (correos, llamadas, mensajes). Es la fuente de la verdad del "qué se dijo y cuándo". Convención y plantillas para registrar en [README.md](README.md). Material crudo (transcripciones, .eml, PRD) en [`../fuentes/`](../fuentes/).

**Hilo de correo principal:** "Re: Solicitud de cotización – PRD"
**Participantes:**
- **Johann** (proveedor) — `johann_antonio85@hotmail.com`
- **Noe Rocha** — CTO, Balam — `noe.rocha@balamtalentoestrategico.com`
- **Araceli Sanchez Jimenez** ("Ara") — Balam — `araceli.sanchez@balamtalentoestrategico.com`
- **Erika Chavez** — Project Manager, Balam — `erika.chavez@balamtalentoestrategico.com`
- **Pedro Alberto Ayala Elizondo** — Desarrollador / contacto técnico, Balam — `pedro.ayala@balamtalentoestrategico.com`

**Periodo:** 30 abr 2026 → 4 jun 2026
**Orden:** cronológico (más antiguo arriba)

---

## 1 · Apr 30, 2026 — 4:38 PM · Erika Chavez → Johann

> **Asunto:** Solicitud de cotización – PRD
> **CC:** Noe Rocha, Araceli Sanchez

Buenas tardes,

Espero que se encuentren muy bien. Mi nombre es Erika Chávez, Project Manager en Balam. Es un gusto saludarte, Johann.

Por medio de este medio, te comparto el PRD con la finalidad de solicitar tu apoyo en la elaboración de la cotización correspondiente.

Quedo atenta a cualquier duda o comentario.

Saludos.

---

## 2 · May 4, 2026 — 3:30 PM · Johann → Erika (CC Noe, Ara)

Buenos días Araceli,

Gracias por compartir el PRD, ya lo revisé a detalle durante el fin de semana. El alcance está muy claro y bien estructurado.

Para preparar la propuesta técnica con una estimación precisa por fase, me surgen las siguientes preguntas:

### Integraciones
- ¿BIND ERP tiene API habilitada o se trabaja con exportación de archivos?
- ¿BUK expone API para consultar nómina procesada?
- ¿Los 3 bancos entregan estados de cuenta por API, archivos (CSV/OFX) o PDFs?
- ¿Cuál es el banco americano que manejan?
- ¿Pueden dar acceso a ambientes sandbox de BIND y BUK para desarrollo, o solo cuentan con producción?

### Facturación
- ¿Ya cuentan con un PAC contratado para timbrado CFDI? ¿Cuál?
- La facturación a clientes en Texas, ¿es invoice estándar o requiere tax compliance específico?
- El PRD menciona soporte para EUR en RF-02, pero la regla de facturación internacional refiere solo a USD. ¿Confirman que el MVP debe incluir EUR, o lo dejamos preparado para una fase posterior?

### Cobranza
- El PRD indica que ACUNTIA y los "top 3 clientes" no deben recibir recordatorios automáticos. ¿Quiénes son esos top 3? ¿Es una lista fija o configurable?
- Se menciona el uso de tickets físicos en pagos con tarjeta como problema actual. ¿Esto se refiere a pagos con terminal donde el registro es manual?

### Datos y sistemas
- ¿"Book" es un sistema interno? ¿Cuenta con API o base de datos accesible?
- ¿Jira se usa únicamente para gestión de proyectos o también como fuente de datos de clientes/colaboradores?

### Operación
- ¿Aproximadamente cuántos colaboradores tienen en nómina y cuántas facturas emiten al mes?
- ¿Quién sería el contacto operativo para validar reglas de negocio durante el desarrollo?

### Infraestructura y diseño
- ¿Tienen servidor o nube preferida para hospedar la plataforma, o propongo opciones?
- ¿Cuentan con guía de marca / assets (logo, colores, tipografía) para la plataforma, o se diseña desde cero?

Con estas respuestas puedo tener la propuesta lista en 24–48 horas. Si prefieren, podemos agendar una sesión corta de 20–30 minutos para revisarlas en conjunto.

---

## 3 · May 4, 2026 — 7:59 PM · Noe Rocha → Johann (respuestas inline)

> Hola Johan, te paso los comentarios más abajo de lo que sé; algunos los tengo que investigar y otros los puede responder o aclarar Ara (TBD Ara).

| Pregunta | Respuesta de Noe |
|---|---|
| ¿BIND ERP tiene API habilitada? | **Exportación de archivos** |
| ¿BUK expone API? | **No hasta donde sabemos** |
| ¿Estados de cuenta de los 3 bancos? | **PDFs** |
| ¿Cuál es el banco americano? | TBD Ara |
| ¿Sandbox de BIND y BUK? | **Solo producción** |
| ¿PAC contratado para CFDI? | **Integrado en el mismo sistema de BIND** (hasta donde sabe) |
| ¿Facturación a Texas, tax compliance? | TBD Ara |
| ¿EUR en MVP? | **Dejarlo preparado para fase posterior. Por el momento solo USD** con empresas europeas |
| ¿Quiénes son ACUNTIA + top 3, lista fija o configurable? | **Lista configurable de acuerdo al objetivo de negocio** |
| ¿Tickets físicos en pagos con tarjeta? | TBD Ara |
| ¿"Book" es interno?, ¿API? | **Es un SaaS** |
| ¿Jira para qué se usa? | **Gestión de proyectos y servicios solamente con clientes** |
| ¿Cuántos colaboradores y facturas/mes? | **45 colaboradores + 5 proveedores tipo freelancer** |
| ¿Contacto operativo durante desarrollo? | **Un servidor (Noe) y el gerente administrativo** |
| ¿Nube preferida? | **Preferentemente Azure**; si hay mejor costo-beneficio, abiertos a evaluar |
| ¿Guía de marca / assets? | TBD Ara |

---

## 4 · May 8, 2026 — 5:06 PM · Johann → Noe

Hola Noe,

Antes de compartirles la propuesta técnica final, me gustaría agendar una sesión contigo para revisar algunos puntos que impactan directamente el alcance:

1. **Dashboards:** ¿Qué campos e indicadores necesitan visualizar por módulo (facturación, cobranza, conciliación)? Quiero asegurarme de que el diseño refleje exactamente lo que el equipo de finanzas y dirección necesita ver.
2. **Mapa técnico de datos:** Sería muy útil que en la llamada me pudieras mostrar los sistemas desde donde sacaremos la información — qué sale de BUK, qué está en BIND, qué está en Book y cómo interactúan hoy. Esto me ayudará a dimensionar mejor la parte de integración y asegurar que no haya sorpresas durante el desarrollo.
3. **Acceso a bancos:** Si en algún punto se busca integración vía API bancaria, conviene definirlo desde ahora para contemplarlo en el alcance desde el inicio.

¿Tienes disponibilidad para una sesión de 30–45 minutos?

---

## 5 · May 11, 2026 — 5:47 PM · Noe → Johann

Hola Johan,

Te paso opciones para una reunión:

- Miércoles de 7am a 8am, 6pm a 7pm
- Jueves de 7am a 8am

Te doy opciones muy temprano o muy tarde para que se te acomode en tu horario. Si hay tiempo para ti de verlo en horarios intermedios nos podemos adecuar.

---

## 6 · May 12, 2026 — 10:27 PM · Johann → Noe

Hola Noe,

Jueves de 7-8am me parece bien.

Saludos.

---

## 7 · May 16, 2026 — 10:32 AM · Noe → Johann

Buenos días Johan,

¿Podemos tener la sesión este martes? O bien, si es algo de una llamada, ¿a qué número te podría marcar?

> *(Implícita: la llamada se sostuvo el martes 19 de mayo de 2026 — transcripción en `../fuentes/2026-05-19 - Transcript - Solicitud de cotizacion.txt`.)*

---

## 8 · May 25, 2026 — 10:41 PM · Noe → Johann

Hola Johann,

En el caso de **Bind tiene una API** que veo factible que podamos usar para nuestra necesidad:

- [Referencia API · Portal de desarrolladores · Bind ERP](https://developers.bind.com.mx/api-details#api=bind-erp-api&operation=Activities_AddActivity)
- [API de Bind ERP — sitio de ayuda](https://ayuda.bind.com.mx/hc/es/articles/360007437754-api-de-bind-erp)

Como dato tiene un **límite de 20 mil solicitudes diarias**, no sé si es poco o mucho para nuestra necesidad, pero hay que tomarlo en cuenta.

Como nuestro **primer interés es el tema de facturación**, considero que la propuesta sería **primero solo considerando el sistema ERP Bind**.

Saludos.

---

## 9 · May 27, 2026 — AM · Pedro (desarrollador, Balam) → Johann ⭐ (último mensaje)

Buenos días Johan,

Espero te encuentres bien. Quiero compartirte una **actualización respecto a nuestra plataforma BUK**: confirmamos que sí cuenta con **soporte API para integraciones con herramientas externas**. Puedes consultar la documentación disponible en el siguiente enlace.

> *(Nota: el link al API no se incluyó en el mensaje recibido; pendiente solicitarlo en la respuesta.)*

Aunque **esta integración no es prioridad en este momento**, queremos que cuentes con esta información para que puedas preparar una propuesta cuando sea oportuno avanzar con el tema.

En cuanto tengamos mayor claridad sobre los tiempos, te los haremos saber.

¡Saludos!

> **Lectura estratégica:**
> - Pedro está ejecutando lo que Noe le pidió en la llamada del 19-may (acelerar con BUK / Book / proveedores).
> - **No cambia el alcance del MVP** — BUK sigue siendo Fase 2 post-MVP.
> - **Sí confirma viabilidad técnica** del ciclo end-to-end Jira → BUK → Plataforma → BIND para Fase 2.
> - Pedro perfila como **contacto técnico día a día** durante el proyecto (responde la pregunta abierta del checklist).

---

## 10 · ≈ 2–3 jun 2026 · Johann → Noe (envío de la propuesta) · *Elementos enviados*

> *"Hola Noe, adjunto la propuesta para la plataforma de automatización financiera que conversamos, enfocada en un MVP sobre BIND ERP que cubre fa[cturación]…"* (vista previa)

Envío de la **propuesta v1.0 en PDF** (`Propuesta-Balam.pdf`). MVP BIND-first enfocado en facturación: consulta + **emisión asistida** de facturas MXN/USD vía API de BIND (con dry-run + confirmación humana; timbra el PAC de BIND), cobranza operativa (aging, alertas internas, lista blanca ACUNTIA + Top 3), dashboard, reportes y bitácora. Inversión **$67,200 – $81,600 MXN + IVA**, **6–7 semanas**, anticipo de 30 h (**$18,000 + IVA**) para Discovery. Módulos diferidos (conciliación, Stripe, recordatorios a clientes, asientos, BUK) cotizados de forma indicativa en el **Anexo B**.

---

## 11 · Jun 3, 2026 — 4:41 PM · Pedro → Johann (CC Noe)

> **Asunto:** RE: Solicitud de cotización – PRD

"Buenas tardes, Johan. Gracias por compartir la propuesta. @Noe Rocha y yo la hemos revisado y tenemos **varios comentarios** que nos gustaría compartir contigo directamente en una **sesión conjunta**. ¿Nos podrías compartir tu disponibilidad para mañana por la tarde, o tu horario de preferencia para el jueves 4 de junio?"

---

## 12 · Jun 3, 2026 (tarde) · Johann → Pedro · *Elementos enviados*

> *"Buen día, Pedro: Claro que sí, con gusto. Me funcionaría mejor el jueves 4 de junio a las 7:00 am para revisar los comentarios juntos. Si a esa hora no l[es funciona]…"* (vista previa)

---

## 13 · Jun 3–4, 2026 · Pedro → Johann (confirmación + liga Teams)

> *"Buenos días, Johan. Te agendo para el día de mañana a las 7 am. Te comparto el link de la sesión. Reunión de Microsoft Teams — Unirse: https://teams.microsoft.com/meet/22…"* (vista previa)

Queda confirmada la sesión: **jueves 4-jun, 7:00 am, por Microsoft Teams**.

---

## 14 · Jun 4, 2026 — 7:00 AM · Llamada de revisión de propuesta ⭐

> Participan: Noe, Pedro, Erika y Johann. Transcripción completa en `../fuentes/2026-06-04 - Transcript - Revision de propuesta.txt`.

**Veredicto general:** *"En términos generales, la propuesta está bien."* El proyecto **avanza**; hay puntos a negociar/ajustar antes de formalizar.

**Acuerdos y decisiones:**
1. **Anticipo $18,000 (Discovery): APROBADO.** Arrancan con eso; el monto final del MVP se aclara tras Discovery (Noe entiende que el rango $67.2K–$81.6K depende de lo que se encuentre).
2. **Conciliación: Noe la quiere incluir** (hoy es 100% manual y ya es un problema real). Vio que está cotizada en el Anexo B (~$48–63K). Condicional al flujo: si facturación queda en ~$67K pediría conciliación **de inmediato**; si sube a $81.6K, evaluará tiempos/flujo en las próximas semanas. Enfoque platicado: estados de cuenta PDF → extracción (librerías/OCR/IA) → **matching por algoritmo (~98%)** usando la API de BIND para las facturas. Involucrar a **Arturo** (bancos).
3. **Dashboard/reporteo: posible recorte.** Balam **ya tiene un tablero Power BI** (hecho por Pedro) que resuelve antigüedad de cartera; Noe no quiere pagar por lo que ya tienen. **Sí quiere el módulo de cobranza + alertas internas** (que el tablero no ejecuta). Validar con Pedro qué del dashboard es redundante.
4. **Lista blanca:** confirmado que es **configurable**, no limitada a 3.
5. **Soporte/mantenimiento:** a Noe no le gusta la caducidad de horas a 30 días ("úsalo o lo pierdes"); pide **negociar mayor vigencia**. Johann: negociable.
6. **API BIND:** Pedro hoy usa la llave de **Araceli** para el Power BI; para desarrollo se usará otra (de **Arturo**, mismos permisos). BIND parece permitir **1 API key por usuario** (Pedro confirmará); generarlas desde la **cuenta maestra (ARA)** y **documentar cuál es para qué**.
7. **Azure:** se gestiona con **Guajardo / Erika**. Johann requiere permisos para crear App Service + PostgreSQL (no Global Admin).
8. **Manual de marca:** existe (paleta, tipografía, logos); **Pedro lo envía**.
9. **Reglas de negocio:** se definen con **Arturo + Pedro**.
10. **Metodología IA:** aclarado = no se entrenan modelos con datos de Balam. Noe OK.
11. **Pagos:** anticipo a **7 días** OK; **avances a 30 días** (Balam cobra a sus clientes a 60–120 días; 30 es el mínimo negociado). Johann aceptó.
12. **Gestión del proyecto:** en **Jira** (estilo ágil/Yael, no Gantt). Pedro crea el espacio (plan free); **Erika valida entregables** para el pago.
13. **Comunicación:** canal de **WhatsApp** + correo para evidencia formal. **Erika = contacto principal · Pedro = técnico · Arturo = negocio.**
14. **Fiscal (Johann):** en proceso de cambiar régimen (24 h); confirma que **sí puede facturar**.
15. **Inicio:** Johann puede empezar **cuanto antes**, de preferencia inicio de semana para coordinar con Arturo.

**Próximos pasos definidos en la llamada:**
- **Noe formaliza por correo a partir del 5-jun:** solicita **factura de anticipo**, envía info/accesos y los **ajustes a la propuesta** para arrancar.
- **Johann:** cambiar régimen fiscal (24 h), emitir factura de anticipo, preparar Discovery.
- **Pedro:** enviar manual de marca; revisar llaves API (cuántas por usuario, generar desde ARA); crear proyecto en Jira.
- **Pendiente con Arturo:** reglas de negocio + acceso a bancos (conciliación).
- **Azure:** gestionar con Guajardo/Erika.

---

## Resumen ejecutivo del hilo (para contexto rápido)

### Datos duros confirmados por Balam
- **BIND ERP:** API existe y es viable (confirmado 25-may). Límite 20K req/día. PAC para CFDI integrado en BIND.
- **BUK:** ✅ tiene API (confirmado 27-may por Pedro). No es prioridad para MVP — habilita Fase 2 post-MVP. Link pendiente de recibir.
- **Bancos:** 3 bancos, solo PDFs. Banco americano = IBC Bank Texas (confirmado en llamada del 19-may).
- **Sandbox:** solo producción (BIND y BUK).
- **Volumen:** 45 colaboradores + 5 freelancers, ~50 facturas/mes.
- **EUR:** fuera del MVP; solo MXN + USD.
- **Lista blanca cobranza:** ACUNTIA + top 3, configurable.
- **Book = SaaS** (no interno).
- **Jira:** solo gestión de proyectos con clientes.
- **Nube preferida:** Azure.
- **Contacto operativo durante MVP:** Noe + gerente administrativo.

### Pendientes que Ara (Araceli) debía responder
- Banco americano específico (resuelto en llamada: IBC Texas).
- Tax compliance para clientes Texas (resuelto en llamada: estándar).
- Tickets físicos en pagos con tarjeta.
- Guía de marca / assets.

### Señales clave del CTO
1. **Llamada del 19-may** (transcript aparte): Noe pidió textualmente *"no le queremos estar poniendo estrellitas al pino, nada más estrictamente lo que se necesita"*. Foco = facturación + conciliación.
2. **Correo del 25-may**: Noe pide explícitamente que la **propuesta se recorte a "solo ERP BIND" primero**, dejando bancos/conciliación para fase posterior.

### Estado actual (tras la llamada del 4-jun-2026)
**Propuesta v1.0 enviada y revisada. El proyecto avanza: anticipo de Discovery ($18,000) aprobado.** Noe formaliza por correo desde el 5-jun (factura de anticipo + accesos + ajustes).

**Puntos abiertos a resolver en la v1.1 / por correo:**
- **Conciliación bancaria:** Noe la quiere sumar al MVP (no esperar); definir si entra de inmediato o tras Discovery según flujo. Es prioridad real del cliente.
- **Dashboard:** posible recorte por solaparse con el tablero Power BI de Pedro; conservar el módulo de cobranza + alertas.
- **Soporte:** renegociar la vigencia de las horas (30 días le parece poco).
- **Pagos:** anticipo 7 días; avances a 30 días (aceptado).
- **Accesos:** API BIND vía cuenta maestra ARA (llave de Arturo para dev), Azure con Guajardo, manual de marca de Pedro, reglas de negocio con Arturo.

**Siguiente entrega de Johann:** factura de anticipo + propuesta ajustada (v1.1) incorporando los comentarios.