Especificación de requisitos de software: cómo redactar una ERS útil
La especificación de requisitos de software (ERS, o SRS por sus siglas en inglés) es el documento que dice qué debe hacer un sistema, para quién, con qué datos y con qué nivel de calidad, antes de escribir una sola línea de código. Bien hecha, permite comparar ofertas con el mismo alcance, fijar un precio cerrado y comprobar al final si el software cumple lo pactado. Esta guía explica qué contiene, cómo redactar requisitos que se puedan probar y cómo usar el documento durante el proyecto.
Por qué una especificación compensa
Cuando un proyecto de software sale mal, la causa rara vez es que el equipo no supiera programar. Casi siempre es que cada parte entendía algo distinto: el cliente pensaba que las devoluciones estaban incluidas, el proveedor pensaba que no; el director financiero esperaba un informe que nadie había pedido por escrito. La especificación convierte esas suposiciones en frases que se pueden leer, discutir y aprobar.
Para la empresa que encarga el software, la ERS tiene tres usos muy concretos:
- Pedir ofertas comparables. Si tres proveedores presupuestan el mismo documento, las diferencias de plazo y de enfoque se ven. Sin él, cada uno presupuesta su propia interpretación.
- Cerrar el alcance. Trabajamos con precio cerrado para el alcance acordado por escrito, y la especificación es justamente ese alcance. Lo que no está, se trata como un cambio, con su propio acuerdo.
- Aceptar la entrega. Cada requisito se convierte en una prueba. Al final del proyecto no se discute si «funciona bien», se comprueba requisito por requisito.
Es la misma lógica que seguimos en el desarrollo de software a medida: primero se acuerda por escrito qué se construye y después se construye, y usted ve el resultado antes de publicarlo.
El estándar de referencia: de IEEE 830 a ISO/IEC/IEEE 29148
Muchas plantillas que circulan como «especificación de requisitos IEEE 830» se basan en una norma que ya no está vigente. La ficha oficial de IEEE 830-1998, «Recommended Practice for Software Requirements Specifications», la marca como norma sustituida por ISO/IEC/IEEE 29148:2011 (consultado el 12 de noviembre de 2026). La ficha de ISO/IEC/IEEE 29148:2018, «Systems and software engineering, Life cycle processes, Requirements engineering», indica que es la norma activa, que sustituye a la edición de 2011 y que define cómo es un buen requisito y qué atributos y características debe tener (consultado el 12 de noviembre de 2026).
En la práctica, la estructura de IEEE 830 (introducción, descripción general, requisitos específicos) sigue siendo útil para ordenar el documento. Lo que aporta la norma actual es el énfasis en la calidad de cada requisito y en su gestión durante todo el ciclo de vida, no solo al principio. No hace falta comprar la norma para escribir una buena ERS, pero conviene saber que es la referencia si su proyecto entra en una licitación o en una auditoría.
Qué hace bueno a un requisito
Un requisito bien redactado se puede leer de una sola manera y se puede comprobar. Los criterios prácticos que aplicamos al revisar una especificación son estos:
- Necesario. Si se quita, alguien lo echaría de menos. Si nadie sabe por qué está, sobra.
- Inequívoco. Una sola interpretación posible. «El sistema debe ser rápido» no lo es; «la búsqueda de clientes muestra resultados en menos de dos segundos con la base de datos de producción» sí.
- Verificable. Existe una prueba que dice sí o no. Si no se puede probar, no se puede aceptar.
- Completo. Incluye las condiciones y las excepciones: qué pasa si el campo está vacío, si el cliente no existe, si la conexión se corta.
- Coherente. No contradice a otro requisito ni a la ley.
- Trazable. Tiene un identificador y un origen (quién lo pidió y por qué), para seguirlo hasta el código y las pruebas.
Ejemplos de requisitos funcionales, mal y bien escritos
| Así no | Así sí |
|---|---|
| El sistema permitirá gestionar pedidos. | RF-12. Un comercial puede crear un pedido para un cliente existente, con una o más líneas de producto, y guardarlo como borrador o enviarlo a aprobación. |
| Los usuarios recibirán avisos. | RF-20. Cuando un pedido supera el límite de crédito del cliente, el sistema envía un correo al responsable financiero en menos de cinco minutos y bloquea su envío hasta que lo apruebe. |
| Debe ser fácil exportar datos. | RF-31. El administrador puede exportar todos los pedidos de un periodo a CSV y a Excel, con las mismas columnas que la vista de listado. |
| El sistema será seguro. | RNF-04. Todos los usuarios inician sesión con segundo factor; tras cinco intentos fallidos la cuenta se bloquea quince minutos y queda registrado. |
Para cada requisito funcional importante añadimos criterios de aceptación con la forma «dado... cuando... entonces...». Por ejemplo: dado un cliente con límite de crédito superado, cuando el comercial envía el pedido, entonces el pedido queda en estado «pendiente de aprobación» y el responsable recibe el aviso. Esa frase es, casi palabra por palabra, la prueba que se ejecutará al final.
Plantilla de especificación de requisitos de software
Esta es la estructura que usamos como punto de partida. Se adapta al tamaño del proyecto: en un sistema pequeño, varios apartados ocupan un párrafo.
- Introducción. Propósito del documento, alcance del sistema (qué incluye y qué no), definiciones y siglas, documentos de referencia y control de versiones.
- Objetivos de negocio. Qué debe mejorar el software y cómo se medirá: tiempo de tramitación, errores, horas de trabajo manual, obligaciones legales.
- Usuarios y perfiles. Quién lo usará, con qué permisos, desde qué dispositivos y con qué frecuencia.
- Descripción general. Contexto, procesos actuales y futuros (un diagrama sencillo ayuda), supuestos y restricciones: tecnología obligada, plazos, presupuesto de infraestructura, normas aplicables.
- Requisitos funcionales. Agrupados por proceso o módulo, cada uno con identificador, descripción, prioridad, origen y criterios de aceptación.
- Datos. Entidades principales, campos obligatorios, volúmenes previstos, datos que se migran del sistema anterior y cuánto tiempo se conservan.
- Interfaces e integraciones. Pantallas clave, sistemas con los que intercambia información (ERP, CRM, banca, pasarela de pago, Agencia Tributaria), formato y frecuencia.
- Requisitos no funcionales. Rendimiento, disponibilidad, seguridad, privacidad, accesibilidad, idiomas, copias de seguridad y recuperación.
- Criterios de aceptación globales. Cómo se probará el conjunto y quién da la conformidad.
- Anexos. Ejemplos de documentos reales (facturas, informes, formularios), maquetas y glosario del negocio.
Requisitos que se suelen olvidar
Los requisitos funcionales salen solos en las entrevistas. Los que se olvidan son los que nadie menciona porque «se dan por hechos», y son los que más cuestan cuando aparecen tarde:
- Protección de datos. El artículo 25 del RGPD, «Protección de datos desde el diseño y por defecto», obliga al responsable del tratamiento a aplicar medidas técnicas y organizativas apropiadas, como la seudonimización, ya en el momento de determinar los medios del tratamiento (consultado el 12 de noviembre de 2026). Traducido a la ERS: qué datos personales trata el sistema, quién los ve, cuánto tiempo se guardan y cómo se borran.
- Permisos y auditoría. Quién puede ver, modificar y borrar cada cosa, y qué cambios quedan registrados con usuario y hora.
- Accesibilidad. Si el software o la web se dirige a consumidores, puede estar sujeto a la ley de accesibilidad; nuestra guía de accesibilidad web explica a quién obliga y qué nivel se pide.
- Migración. Qué datos del sistema anterior se traen, quién los limpia y cómo se comprueba que han llegado completos.
- Operación. Dónde se aloja (en nuestros proyectos, en una región de centro de datos de la UE), copias de seguridad, tiempo máximo de recuperación y quién da soporte después.
- Propiedad. Que el código fuente, las cuentas y la documentación sean de su empresa desde el primer día. Es una condición del contrato, pero conviene que la especificación lo recoja.
Errores frecuentes al redactar una ERS
- Describir la solución en lugar del problema. «Un desplegable con los clientes» es una decisión de diseño; el requisito es «el comercial elige el cliente del pedido entre los clientes activos». Deje el diseño al equipo, salvo que haya una razón de negocio.
- Palabras que no se pueden probar. Rápido, intuitivo, moderno, flexible, fácil. Cada una debe sustituirse por un número o un criterio.
- Copiar el sistema antiguo. Reproducir las pantallas actuales arrastra también sus defectos. Pregunte por qué se hace cada paso antes de especificarlo.
- Todo con prioridad máxima. Si todo es imprescindible, nada lo es. Separe lo necesario para empezar a trabajar de lo que puede llegar después; es la base de un buen desarrollo de MVP.
- Un documento que nadie mantiene. Una ERS aprobada en enero y no actualizada en marzo deja de servir para aceptar la entrega.
Cómo se usa la especificación durante el proyecto
La ERS no es un trámite previo que se archiva. Es el documento de referencia en cada fase, como explicamos en la guía sobre las fases del desarrollo de software:
- Diseño. Cada pantalla y cada componente responde a uno o más requisitos.
- Construcción. Los requisitos se reparten en entregas; usted ve cada entrega funcionando, no solo un informe de avance.
- Pruebas. Los criterios de aceptación se convierten en casos de prueba, manuales o automáticos. Nuestro servicio de pruebas de software parte de ellos.
- Cambios. Cada cambio se anota en la especificación con su versión, su motivo y su efecto en plazo y precio, antes de construirlo.
- Mantenimiento. Quien mantenga el sistema dentro de dos años, su equipo u otro proveedor, sabrá por qué funciona como funciona.
En proyectos ágiles el documento se completa por partes, y la metodología elegida cambia el ritmo, no la necesidad de tener los requisitos por escrito; lo comparamos en la guía de metodologías de desarrollo de software.
Cómo le ayudamos
Podemos redactar la especificación con su equipo como primera fase, con entrevistas y talleres con las personas que harán el trabajo, revisión de sus documentos y procesos actuales, y una versión aprobada al final. El documento es suyo: puede usarlo para encargarnos el desarrollo o para pedir otras ofertas. Si ya tiene una especificación, la revisamos y le señalamos lo ambiguo, lo que falta y lo que no se puede probar. Si el sistema ya existe y nadie lo documentó, una auditoría de código permite reconstruir qué hace antes de cambiarlo. Puede escribirnos en español o en inglés y le respondemos en un día laborable.
Preguntas frecuentes
¿Qué diferencia hay entre una ERS y un documento de requisitos de negocio?
El documento de requisitos de negocio explica por qué existe el proyecto y qué debe conseguir la empresa, por ejemplo reducir el tiempo de tramitación de un pedido o cumplir una obligación legal nueva. La especificación de requisitos de software dice qué debe hacer el software para lograrlo: funciones, datos, reglas, interfaces y niveles de calidad. En un proyecto pequeño ambos caben en un solo documento, con los objetivos de negocio como primer capítulo.
¿Quién debe redactar la especificación de requisitos?
La responsabilidad es de la empresa que usará el software, porque solo ella conoce su trabajo y sus reglas. En la práctica, un analista o el equipo del proveedor la redacta junto con los usuarios, a partir de entrevistas, talleres y los documentos actuales, y la empresa revisa y aprueba cada parte. Una especificación escrita solo por el proveedor, sin la revisión de quienes harán el trabajo, suele dejar fuera las excepciones que importan.
¿Sigue vigente el estándar IEEE 830?
No. Según la ficha oficial del IEEE, la norma IEEE 830-1998 está retirada y sustituida por ISO/IEC/IEEE 29148:2011, que a su vez fue sustituida por la edición de 2018, hoy activa. La estructura clásica de IEEE 830 sigue siendo un buen punto de partida, pero la referencia actual es ISO/IEC/IEEE 29148:2018.
¿Cuánto debe ocupar una ERS?
Lo necesario para que dos equipos distintos entiendan lo mismo al leerla. Para una herramienta interna con pocos usuarios pueden bastar unas pocas páginas; un sistema con integraciones, varios perfiles y obligaciones legales necesita bastante más. La extensión no es el objetivo: cada requisito debe ser claro, comprobable y tener un responsable.
¿Una ERS es compatible con el desarrollo ágil?
Sí. En un proyecto ágil la especificación no se congela al principio: el alcance y las reglas importantes se fijan antes de empezar y el detalle de cada función se completa justo antes de construirla, como historias de usuario con criterios de aceptación. Lo que no cambia es que los requisitos estén por escrito y que se sepa qué versión está aprobada.
¿De quién es la especificación cuando la redacta el proveedor?
En nuestros proyectos, de su empresa, igual que el código fuente. Puede usarla para pedir otras ofertas, para incorporar a otro proveedor o para mantener el sistema con su propio equipo, sin pedir permiso a nadie.
Solicite un presupuesto por escrito
Describa en unas líneas lo que necesita. En un día laborable recibe un presupuesto por escrito: alcance, plazos y precio cerrado o estimación de horas. La solicitud no le compromete a nada.