Johann
67bce9d691
Los dos pendientes que Erika re-preguntó el 28-jul: la adenda formaliza la generación automática de cotizaciones desde tickets FAC ($5,400–$7,200 + IVA, consistente con las ~10 h comunicadas el 21-jul) como solicitud de cambio conforme a la §10 de la propuesta v1.2; el Excel resume horas por etapa (E0 cerrada en 21.83 h, E1 en 19.75 h, E2/E3 con rangos contractuales) con importes para facturación. PDF con el mismo diseño del paquete v1.2. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
6.2 KiB
Adenda 01 — Integración Jira → BIND
Generación automática de cotizaciones desde los tickets de facturación
| Preparada para | Noe Rocha (CTO) · Araceli Sánchez Jiménez (CEO/Operaciones) · Erika Chávez (PM) · Pedro Alberto Ayala Elizondo (Contacto técnico) |
| Preparada por | Johann Velazquez — Consultor de Software · Monterrey, N.L. |
| Fecha | 28 de julio de 2026 |
| Documento | Adenda 01 a la Propuesta Comercial v1.2 — solicitud de cambio conforme a la §10 (control de cambios) |
| Vigencia | 30 días naturales a partir de la fecha de emisión |
1. Antecedente
La propuesta v1.2 dejó Jira explícitamente fuera del alcance del MVP (§1.3 y Anexo A.4), conforme a la información disponible al momento de cotizar. Durante el Discovery y las sesiones de julio, la dirección confirmó que el proceso interno evolucionó: hoy todo el flujo de facturación de Balam nace y se gobierna en Jira — "lo que no está en Jira no se procesa" — con una bandeja dedicada (Facturación, llave FAC-) y un flujo de estatus formal que culmina en "resuelto".
En la sesión del 22 de julio el CTO planteó incorporar esta conectividad como ajuste de alcance; en la validación del prototipo del 24 de julio se ratificó, y en la sesión técnica del 27 de julio con Pedro Ayala quedó confirmada la viabilidad: la API de Jira cubre lectura y escritura de tickets, se entregó el token de integración ("PAF", vigente al 27-jul-2027) y se documentaron los límites de consumo del lado de Atlassian. La estimación preliminar (~10 h) se comunicó a la PM el 21 de julio; esta adenda la formaliza por escrito, como lo prevé el control de cambios de la propuesta.
2. Alcance del cambio
La integración agrega a la primera etapa las siguientes capacidades:
- Conexión con la API de Jira mediante el token PAF y lectura de los tickets de la bandeja Facturación (
FAC-), con consumo autorregulado conforme a los límites de velocidad documentados por Atlassian. - Generación automática de la cotización en BIND cuando un ticket alcanza el estatus disparador que Balam defina (candidato natural: la entrada del ticket al proceso de facturación, previo a "resuelto"), a través de la misma capa de escritura controlada del MVP.
- Trazabilidad ticket ↔ cotización ↔ prefactura/factura, visible en la plataforma y registrada en la bitácora de auditoría. Los tickets leídos alimentan además la vista "qué necesita atención" del tablero.
- Pruebas controladas: scripts de consulta y de creación/edición sobre un registro de prueba, y una prueba observada con el equipo de Balam antes de habilitar la generación automática en operación (según lo acordado en la sesión del 27 de julio).
El control fiscal no cambia. La integración crea cotizaciones, nunca facturas: se mantiene la cadena acordada — cotización → prefactura → aprobación humana → timbrado por el PAC de BIND — con modo de simulación (dry-run), feature flag y registro en bitácora. No existe timbrado automático.
3. Qué no incluye
- Alta automática de clientes en BIND. Si el cliente del ticket no existe en BIND, la plataforma lo detecta y lo notifica; darlo de alta automáticamente es una decisión de proceso aún abierta y, de aprobarse, se estima por separado.
- Tickets con múltiples facturas. El supuesto de esta adenda es un ticket → una cotización. El manejo del caso masivo (un ticket con un listado de decenas de facturas) se define junto con Balam; si requiere desarrollo adicional, se estima por separado.
- Otros usos de Jira — reporteo de horas de consultores, tableros sobre otras bandejas o el espacio comercial para pipeline de ventas — así como los módulos diferidos del Anexo B, permanecen fuera del alcance.
4. Estimación e inversión
| Concepto | Horas | Inversión (MXN) |
|---|---|---|
| Integración Jira → BIND: lectura de la bandeja FAC, disparador por estatus, cotización automática, trazabilidad y pruebas | 9 – 12 | $5,400 – $7,200 |
- Tarifa vigente: $600 MXN/h + IVA (§3.3). El rango es consistente con la estimación de ~10 h comunicada el 21 de julio y opera bajo el mismo esquema de horas reales con tope: al aproximarse al máximo, el trabajo se detiene y se revisa con Balam.
- Facturación: como el resto de los avances — semanal (viernes) por horas efectivamente trabajadas, con pago a 30 días naturales.
- Efecto en el total de la primera etapa: de 112 – 136 h ($67,200 – $81,600) pasa a 121 – 148 h ($72,600 – $88,800), antes de IVA.
5. Supuestos y dependencias
- Definición del flujo de facturación por parte de Balam (actualmente en revisión interna; sesión por agendar): de ella salen el estatus disparador y las reglas de prefactura. La implementación de esta adenda inicia una vez cerrada esa definición.
- Token PAF vigente con visibilidad de la bandeja FAC (entregado el 27 de julio) y un interlocutor técnico (Pedro) para dudas de Jira, con respuesta en menos de 48 horas.
- Diagrama del flujo Jira de facturación en tamaño legible (comprometido por Balam en la sesión del 22 de julio).
- Bandeja FAC como fuente. FAC opera como bandeja "padre" del proceso de facturación; si las pruebas muestran que algún disparador nace en otra bandeja sin reflejarse en FAC, el ajuste se revisa en conjunto.
- Sin ambiente de pruebas de BIND: toda prueba de escritura será acotada, acordada previamente y observada, como se convino con el CTO.
6. Condiciones
Todo lo no modificado por esta adenda — condiciones comerciales (§3.3), garantía de 45 días, propiedad del código, metodología de desarrollo y supuestos generales — permanece en los términos de la propuesta v1.2 y del contrato de servicios firmado. La mención de Jira como "fuera de alcance" (§1.3 y Anexo A) queda sustituida por el alcance acotado que esta adenda define.
7. Aceptación
Conforme a la §10 de la propuesta (control de cambios), esta adenda se ejecuta tras su aprobación por escrito; basta la confirmación por correo electrónico. No requiere un nuevo contrato.
Johann Velazquez · Consultor de Software Monterrey, Nuevo León