Reading Time: 3 minutes

Un informe de error no es una queja. Es un conjunto de instrucciones y evidencia que permite a otra persona reproducir un problema, comprender su impacto y decidir qué hacer a continuación. Cuando los informes de errores son vagos, los equipos graban el tiempo en los mensajes de ida y vuelta, conjeturas y «no pueden reproducir» los extremos muertos. Cuando están bien escritos, las soluciones se mueven más rápido, las prioridades son más claras y todos se mantienen más tranquilos.

Esta guía muestra una forma práctica y amigable para los desarrolladores de informar errores. Obtendrá una estructura que funciona en cualquier sistema de tickets, consejos para escribir pasos reproducibles, una guía de gravedad rápida y plantillas y ejemplos listos para copiar.

Lo que se supone que debe lograr un informe de error

Un informe de error útil responde a tres preguntas:

  • ¿Puedo reproducirlo? (Pasos + Entorno + Datos de Prueba)
  • ¿Qué es exactamente lo que está mal? (comportamiento real vs esperado)
  • ¿Cuánto importa? (impacto + severidad + frecuencia)

También ayuda a clasificar el problema correctamente. No todo es un «bicho». A veces es una solicitud de función, una pregunta de soporte o un problema de entorno. Los informes claros mantienen su cartera de pedidos limpias y su tiempo de ingeniería enfocado.

Antes de escribir: 5 minutos de preparación que ahorra horas

comprobar si hay duplicados

Busque tickets existentes utilizando palabras clave como mensajes de error, nombres de funciones o títulos de pantalla. Si existe un problema similar, agregue sus detalles como comentario en lugar de crear un nuevo ticket.

reproducir de nuevo y capturar el flujo exacto

Intente reproducir el problema una vez más y documente los pasos con precisión. Si el problema es intermitente, calcule con qué frecuencia ocurre y bajo qué condiciones.

Recoger la evidencia mínima

  • Capturas de pantalla para la interfaz de usuario o problemas de diseño
  • Vídeos cortos para problemas de temporización o de varios pasos
  • Registros o salida de la consola para fallos o errores de API
  • Datos de muestra desinfectados cuando los datos desencadenan el problema

La anatomía de un informe de error fuerte

Título

Un buen título sigue la fórmula: ¿Qué sucede + dónde + bajo qué condiciones?

  • Pago: el botón «Pagar» permanece deshabilitado después de aplicar el código de descuento
  • Informes del panel: la exportación CSV falla para el rango de fechas durante 90 días
  • Safari móvil: el encabezado pegajoso se superpone a los resultados de búsqueda después de desplazarse

Medio ambiente

  • Versión de la aplicación o número de compilación
  • navegador o dispositivo y versión del sistema operativo
  • Función o permisos de usuario
  • Condiciones de configuración regional, zona horaria o de red si es relevante

condiciones previas

  • El usuario ha iniciado sesión como administrador
  • La cuenta tiene una suscripción activa
  • El conjunto de datos contiene un registro con campos vacíos

Pasos para reproducir

  1. Inicie sesión como usuario con el rol de administrador.
  2. Abrir Informes → Ingresos.
  3. Seleccione el rango de fechas “Últimos 180 días”.
  4. Haga clic en Exportar CSV.

Resultado real vs resultado esperado

El resultado real describe lo que realmente sucede, incluidos los mensajes de error. El resultado esperado describe lo que debería suceder desde el punto de vista del usuario.

Frecuencia

  • Siempre
  • A menudo
  • Algunas veces
  • Raro

Gravedad e impacto

Gravedad Significado Ejemplo
bloqueador Detiene el flujo de trabajo central Los usuarios no pueden iniciar sesión
Crítico Pérdida de datos o riesgo de seguridad Registros eliminados inesperadamente
Mayor Característica clave rota La exportación falla sin solución alternativa
Menor molesto pero no bloquea Problema de alineación de la interfaz
Trivial problema cosmético pequeño error tipográfico

ejemplos

Ejemplo de interfaz de usuario

Título: Móvil Safari: Encabezado Sticky Superpone resultados de búsqueda después de desplazarse
Entorno: iPhone 13, iOS 17.3, Safari, compilación de aplicaciones 2.8.1
Condiciones previas: Iniciar sesión como usuario estándar

  1. Abra la página de búsqueda.
  2. Escriba «polímero» y envíe.
  3. Desplácese hasta que se carguen 20 resultados.

Resultado real: el encabezado se solapa con los primeros resultados.

Resultado esperado: los resultados son completamente visibles y se pueden hacer clic.

Ejemplo de API

Título: Informes API devuelve 500 para exportaciones durante 90 días
Entorno: Producción
Condiciones previas: La cuenta contiene más de 10.000 registros

  1. Informe de ingresos abiertos.
  2. Seleccione el rango de fechas de los últimos 180 días.
  3. Haga clic en Exportar CSV.

Resultado real: 500 Error interno del servidor.

Resultado esperado: se muestra con éxito las descargas de CSV o se muestra una advertencia clara.

Plantilla de informe de error

Title:
Environment:
Preconditions:
Steps to reproduce:
1)
2)
3)

Actual result:
Expected result:

Frequency:
Impact:
Severity:
Workaround:

Attachments / Evidence:

Lista de verificación final

  • Los pasos son claros y mínimos
  • El comportamiento real y esperado están separados
  • Se incluye el entorno y el contexto
  • Se adjunta y desinfecta la evidencia
  • Se explica el impacto

Conclusión

Un informe de error claro ahorra tiempo para todos los involucrados. Reduce la confusión, acelera las correcciones y mejora la colaboración entre los usuarios, el control de calidad y los desarrolladores. La estructura consistente y la claridad importan más que la longitud o la jerga técnica.