Planes de Prueba — /test-plans
Un Plan de Prueba es la prueba de humo de una Interfaz: una lista ordenada de escenarios que corre de una vez y dice qué pasó y qué no.
Es lo que hoy vive en el Postman de alguien — y por eso no viaja junto cuando la integración se instala en otro cliente, nadie lo revisa, y no se vuelve a ejecutar cuando la integración cambia.
Cada escenario se ejecuta por el mismo camino del Banco de Pruebas, que a su vez es el camino de producción. Nada aquí reimplementa recolección ni entrega — así que un plan verde es una afirmación sobre el sistema de verdad.
El plan
| Campo | Qué significa |
|---|---|
| Nombre y descripción | Cómo el equipo se refiere a este conjunto de casos |
| Interfaz | Elegida en la creación y no cambia después: los escenarios apuntan a sus Recolecciones y Entregas |
| Visibilidad | Público = quien ya tiene acceso a la Interfaz lo ve; Privado = solo usted |
| Eliminación bloqueada | Otras personas siguen pudiendo editar y ejecutar; solo el dueño elimina |
El alcance del plan no se declara — emerge de los escenarios. La lista muestra por qué Aplicaciones y Definiciones pasa ese plan, calculado de lo que hay adentro. Un campo declarado aparte mentiría el día en que alguien agregara un escenario nuevo.
Escenarios
Un escenario es un disparo del Banco de Pruebas con lo que se espera de él escrito al lado: objetivo (Recolección o Entrega), Definición, modo, payload y parámetros, más las expectativas. Los objetivos son los mismos del Banco de Pruebas — sin las Entregas de las herramientas de Help Desk.
El orden importa y es suyo: los escenarios suben y bajan en la lista, y la ejecución sigue esa secuencia.
Expectativas
| Expectativa | Verifica |
|---|---|
| Estado final | El desenlace del mensaje (procesado, error de entrega, error de negocio…) |
| HTTP | El código devuelto por el destino |
| Duración máx. (ms) | El techo de tiempo aceptable para ese escenario |
| Retorno contiene / no contiene | Un fragmento que debe (o no puede) aparecer en la respuesta |
Deje en blanco lo que no quiera verificar.
Lo que no se pudo verificar no se vuelve verde ni rojo: aparece en gris, con el motivo. Un escenario sin ninguna expectativa evaluable se marca como sin aserción, y no como aprobado — si no, un plan quedaría todo verde sin haber probado nada.
Escenarios sugeridos por IA
El botón Sugerir escenarios con IA arma una lista de casos a partir de lo que el CMS ya sabe de la Interfaz: sus Definiciones, el contrato de payload observado en el tráfico real y los Errores de Negocio registrados. El script del Transformador no se envía.
Los escenarios sugeridos nacen desactivados. La sugerencia no ejecuta nada: encender y correr sigue siendo decisión de una persona. Ver Gobernanza de IA para el registro y la moderación de esas conversaciones.
Ejecutar
El botón Ejecutar corre los escenarios activos en orden. Cuando el plan escribe de verdad en algún destino, la confirmación lista cuáles son esos destinos y pide el nombre del plan tecleado — la misma lógica del Ciclo completo en el Banco de Pruebas, aplicada de una vez a un conjunto.
El resultado de cada escenario es uno de estos:
| Resultado | Cuándo |
|---|---|
| Aprobado | Todas las expectativas evaluables coincidieron |
| Reprobado | Alguna expectativa no coincidió — la pantalla muestra lo esperado y lo obtenido |
| Sin aserción | Se ejecutó, pero no había nada verificable |
| Error | El disparo en sí falló |
| No ejecutado | El escenario estaba desactivado |
Historial y PDF
Cada corrida queda guardada con quién ejecutó, cuándo, la duración y el marcador (“7 de 9 aprobados”). Abrir una ejecución la muestra escenario por escenario, con el mismo detalle del Banco de Pruebas: qué se envió, qué volvió, y la comparación entre esperado y obtenido.
El retorno completo solo se guarda cuando el escenario reprueba. Guardar el cuerpo de toda respuesta de todo escenario de toda corrida llenaría la base con lo que nadie va a leer; lo que interesa después es siempre la falla.
El botón Descargar PDF genera el informe de la corrida — identificación de la ejecución, resumen de los escenarios y el detalle de cada uno. Es el documento que se adjunta a una homologación.
El plan viaja junto
Los Planes de Prueba entran en el Import/Export de configuración y en el Pack. Cuando la integración se instala en otro cliente, los casos de prueba van con ella — que es exactamente lo que no pasaba cuando vivían en una colección de Postman.
Dónde está en el menú
Laboratorio de Integración, justo debajo del Banco de Pruebas: un plan es la misma acción del Banco de Pruebas, repetida y guardada.