Documenta semana 24-27 jul: validación de prototipo (aprobada), API de Jira y avance de Etapa 1

- REGISTRO #55: validación del prototipo Etapa 0 (24-jul) APROBADA; único bloqueo = definir el flujo de facturación en Jira (sesión propuesta por Araceli para el martes 28)
- REGISTRO #56: sesión de API de Jira con Pedro (27-jul) — token PAF a 1 año, bandeja FAC; + seguimiento por correo del mismo día con los límites de velocidad (65k puntos/h, burst/s, por-issue) y entrega del token por Google Drive
- REGISTRO #57: hilo de WhatsApp con Erika (21-27 jul) — coordinación, envío del flujo por correo y reagenda 23→24 jul; 3 imágenes inferidas
- Transcripciones y correo en fuentes/; guion de validación en planeacion/
- Avance-Etapa1-2026-07-27 (nota + mensaje para Erika) y Excel del corte del 27-jul (núcleo verificado; capa de escritura en pausa por definición de Balam)
- Seguimiento-horas: sesiones del 24-jul (validación) y 27-jul (API Jira)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

fuentes/2026-07-27 - API de conexión con JIRA Transcript.txt

@@ -0,0 +1,173 @@
+API de conexión con JIRA
+Mon, Jul 27, 2026
+
+0:03 - Noe Rocha
+Hola Erika, buenos días. ¿Cómo estás? Bien, gracias. Todo muy bien, también. ¿Te confirmó Pedro? Sí. Vamos a esperar. Hola Johann, buenos días. Hola, ¿qué tal? Buenos días.
+
+0:21 - Unidentified Speaker
+Hola Erika, hola Pedro.
+
+0:23 - Unidentified Speaker
+Buenos días. Hola, buenos días.
+
+0:27 - Pedro Alberto Ayala Elizondo
+¿Qué tal? Buenos días.
+
+0:31 - Noe Rocha
+Bueno, pues ya estamos todos. Espero que hayan tenido un buen fin de semana. Caluroso, pero buen fin de semana. Bueno, a ver, como propósito del tema, dentro del descubrimiento que está haciendo Johann, Pedro, se ha visto que muchas partes del proceso, que en un principio no se habían especificado, están llegando a través de JIRA. Específicamente para temas de facturación. Como están haciendo de Jira, originalmente no habíamos contemplado la conectividad, pero ahorita ya vemos que va a ser necesario. Entonces, aquí lo que queremos ver contigo y que le expliques a Johann, bueno, más allá de cómo funciona Jira, sino cómo se conecta a través de un API Jira actualmente para extraer información y darle un poquito de vista de... No sé si quieras ver también el proceso ¿O nos vamos directamente a cómo funciona? ¿Cómo estamos haciendo hoy la conectividad a través del API? Sí, con la conectividad a través del API me es suficiente.
+
+1:38 - Johann
+Vale, ya está.
+
+1:39 - Noe Rocha
+Te dejo el micrófono, Pedro.
+
+1:41 - Noe Rocha
+Adelante, por favor. Muy bien.
+
+1:43 - Pedro Alberto Ayala Elizondo
+Bueno, con el API de Jira, hoy actualmente se está utilizando... Bueno, yo lo utilizo para varios tableros de servicio de TI. Entonces, yo lo utilizo para varios tableros de TI. Entonces, algunos los tengo para limpieza de usuarios, otros los hago para aprobadores, otros simplemente para conectores. Pero sus principales funciones, más que nada, es para crear y consultar actividades, tickets, el tema de aprobaciones, aprobaciones pendientes, el tema de documentos adjuntos. Sí tiene una muy amplia variedad en temas de extracción. En el que sí tiene mucho de dónde agarrar. Entonces, pues, no sé si tienes alguna pregunta en específico de la API, cómo se gestiona o cómo funciona. O si en verdad no sé si necesitas la llave como tal para generar una con alguna fecha de expiración en específica.
+
+2:46 - Johann
+Sí, una API key y también entender por ejemplo ahora que me mencionas que si tiene la posibilidad de extraer por ejemplo los ítems de un tablero y consultar el estatus y cambiar el estatus de esa tarea es es muy útil sí sí todo todo es es accionable es tanto de lectura como de edición entonces vas a poder hacer cualquier tipo de creación que se podría hacer manual pero se puede hacer de manera entonces te paso igual quieres alguna por reporte xt te funciona?
+
+3:25 - Noe Rocha
+disculpa con reporte txt?
+
+3:28 - Pedro Alberto Ayala Elizondo
+si osea con un documento txt con el api si perfecto dejeme entonces lo genero vamos a llamarle De momento vamos a llamarle... Le estamos llamando Plataforma de Automatización Financiera. Vamos a llamarlo PAF, el token, para que no haya... Vamos a hacerlo de un año de expiración. Hasta el... 27 de julio del 2027. Y te la comparto, ya la tengo, si quieres ahorita te la por correo. Excelente.
+
+4:51 - Johann
+No sé si quieren ver algo más, algo que tengan dudas del API en general.
+
+4:57 - Pedro Alberto Ayala Elizondo
+Yo creo que van a salir las dudas ya una vez estando en acción con la herramienta, empezar a extraer los datos, empezar a jugar con las consultas. Yo tengo una duda.
+
+5:12 - Noe Rocha
+El consumo de APIs es algo parecido a Vine, que te limita en cuanto a extracción?
+
+5:19 - Pedro Alberto Ayala Elizondo
+Déjeme ver, porque creo que sí tiene el consumo al lado, pero estaba viendo que no tiene como una página como la de Bind, que es Bind de desarrolladores. Entonces creo que sí tiene una que es Atlassian.
+
+5:40 - Noe Rocha
+Si quieres, nomás investiga y luego lo vemos con Johann. En este momento. Porque si voy a tener un límite de transacción por escritura o por consulta, entonces tendremos que ver cómo funciona esto sobre la operación.
+
+5:58 - Pedro Alberto Ayala Elizondo
+Sí, creo que no existe uno por día. O sea, por día no hay, por así decirlo.
+
+6:05 - Noe Rocha
+Y las APIs las generas desde tu cuenta o... Desde mi cuenta. Las puedes diferenciar, ¿verdad? Con nombre. Con el nombre.
+
+6:15 - Pedro Alberto Ayala Elizondo
+Sí, justo así las tengo diferenciadas. De hecho, una práctica sí es ir renovando constantemente, bueno, no constantemente, pero ir renovando en cierto punto los tokens para evitar ambigüedades. Entonces, todavía están ahí todas en la base de datos y van a seguir apareciendo.
+
+6:34 - Unidentified Speaker
+Ok.
+
+6:34 - Noe Rocha
+¿Qué otra consideración importante es ahí con el uso de la API? De Argentina, particularmente.
+
+6:43 - Pedro Alberto Ayala Elizondo
+Pues, como tal, es algo muy intuitivo. Es como cualquier extracción de datos mediante un API. Simplemente haciendo los comandos correctos mediante SQL o algún lenguaje, se pueden extraer los datos de manera clara. Yo, más que nada, lo utilizo para temas de SLA. Yo tengo unos SLA configurados en cada uno de los procesos que tenemos dentro de Jira. Entonces, tengo la configuración para que este, para que este API me esté arrastrando este tipo de información. Y también el tema de la facturación. ¿Con quién está la prover? ¿En qué estatus está? También han habido temas para cambiar estatus que se han podido lograr con el API.
+
+7:29 - Unidentified Speaker
+Ok.
+
+7:29 - Noe Rocha
+Muy bien. Se fue realmente bastante rápido. Entonces, ¿el acuerdo se lo mandas en un TXT? Sí, ya lo tengo.
+
+7:37 - Pedro Alberto Ayala Elizondo
+Y no sé si así como...
+
+7:40 - Noe Rocha
+hay una página de desarrolladores de Jira. Simplemente para temas de consulta que tenga que tener Johann sobre el uso.
+
+7:51 - Unidentified Speaker
+Ok.
+
+7:52 - Pedro Alberto Ayala Elizondo
+Sí, eso todo te lo incluyo ahorita en el correo como informativo. Va, de acuerdo.
+
+8:00 - Unidentified Speaker
+Muy bien.
+
+8:01 - Noe Rocha
+Johann, ya con esta información, ¿cuál sería su idea?
+
+8:06 - Johann
+¿Cuáles serían los siguientes pasos? Los siguientes pasos, de mi parte, yo revisaría la documentación de Jira. También, si me pudieran compartir pronto el nombre exacto del tablero en donde vamos a consultar los tickets, también sería útil para saber a dónde o de dónde extraer esos tickets. Entonces, yo investigo la documentación y con la piqui que me comparte Pedro, ya puedo integrarlo al prototipo que estamos haciendo.
+
+8:35 - Noe Rocha
+Pedro. Pero no sé si está identificable a través de la API. O con un nombre. Supongo que con el nombre del tablero.
+
+8:46 - Pedro Alberto Ayala Elizondo
+Pero el tablero se refiere al de Power BI.
+
+8:50 - Noe Rocha
+No, no. Es que el tablero...
+
+8:53 - Pedro Alberto Ayala Elizondo
+Corrígeme, Johann.
+
+8:54 - Noe Rocha
+Si te refieres más bien a la... Al Space? Sí, al Space. Así es.
+
+9:01 - Pedro Alberto Ayala Elizondo
+Ah, ok, ok. ¿Dónde están almacenados todos los tickets? De facturación. Sí, en la bandeja de facturación.
+
+9:10 - Noe Rocha
+Sí, porque hay varias bandejas. Entonces, para que no tengas que buscar en todas. Ser muy específico de a cuál nos referimos.
+
+9:20 - Pedro Alberto Ayala Elizondo
+Esas son las bandejas que hay por hoy. Administración General, ITS, Medilo, Recursos Humanos, Facturación. Y por hoy, donde se encuentra lo bueno es aquí.
+
+9:31 - Noe Rocha
+Ya. Y si, por ejemplo, cuando tú has hecho la revisión o has usado el API, ¿cómo identificas cuál bandeja es? Por la llave.
+
+9:44 - Pedro Alberto Ayala Elizondo
+Por la llave. Esta tiene llave AG, llave DITCM, este es RH, este es FAC y este es HD.
+
+9:54 - Noe Rocha
+Ok, entonces la llave para el tablero de facturación debería ser FC. Sí, FAC.
+
+10:00 - Unidentified Speaker
+FAC.
+
+10:01 - Pedro Alberto Ayala Elizondo
+FAC guión y el numerito. Y esos son todos los correspondientes al... Sí, lo bueno que la API de Jira es global, entonces vas a poder extraer información de todas las banderas, pero la bandeja que nos importa es facturación, pero es que hay ciertas cosas que pasan en recursos humanos que al momento de cerrarse en recursos humanos genera cosas en facturación, también en administración general. Haz de cuenta que facturación es como el, la bandeja padre y se va, es la que se alimenta de varios, de varios que vienen siendo las demás.
+
+10:41 - Unidentified Speaker
+Por procesos diferentes.
+
+10:43 - Pedro Alberto Ayala Elizondo
+Ajá.
+
+10:44 - Noe Rocha
+Que todas vienen cayendo en facturación. Muy bien.
+
+10:49 - Pedro Alberto Ayala Elizondo
+Bien, pero, eh, reviso.
+
+10:51 - Noe Rocha
+¿Qué más, Johann? Creo que con esto es suficiente.
+
+10:57 - Johann
+Igual, cuando comience a ser ya las pruebas, les comparto mis dudas, o si me hablan Hasta entonces voy a estar haciendo un script de consulta. Y si pudieran apoyarme, me gustaría también hacer un script de creación, eliminación y edición de un registro de prueba. Para ver que todo esté correcto y ya de ahí implementarlo.
+
+11:29 - Noe Rocha
+O sea ya, digamos, probar una creación de un documento, dices tú?
+
+11:35 - Unidentified Speaker
+Sí.
+
+11:36 - Noe Rocha
+Si te parece, ya cuando sea el momento de hacer la creación. Hacemos una prueba en vivo. Y veremos cómo funciona.
+
+11:48 - Johann
+Sí, sin problema. O también si tienen a la mano un script. Donde ya tengan un CRUD.
+
+11:57 - Noe Rocha
+Fíjate que no tenemos algo así, ¿verdad Pedro? A través de API no. No hemos tenido la necesidad de hacerlo. Bueno, si es el checkpoint, entonces tú nos dices, Johann, para hacer para las dudas o para alguna prueba en específico. ¿Te parece? Sí, me parece bien. Vale, pues. Bueno, pues entonces es todo. Gracias por su desmañanada.
+
+12:29 - Pedro Alberto Ayala Elizondo
+Buen inicio de semana. Igualmente. Igualmente. Bye. Muchas gracias.