# Criterios de aceptación

## Qué es

Los criterios de aceptación son las condiciones que debe cumplir un cambio concreto para que pueda
darse por válido. Describen qué se podrá observar en unas circunstancias determinadas. «Enviar una
confirmación de la cita» nombra una función. «Al reservar una cita disponible, la confirmación
presenta la misma referencia y hora de inicio que el registro de reserva» permite comprobar parte
del comportamiento y deja abierta la forma de generar esa confirmación.

El manual de servicios digitales del Gobierno británico describe los criterios de una historia de
usuario como una lista de resultados con la que verificar que el servicio ha cumplido su cometido.
La historia explica quién necesita el servicio y para qué. Los criterios concretan el acuerdo para
que se pueda discutir, implementar y verificar. También pueden cubrir una ruta de error, el acceso
mediante teclado o una restricción operativa, siempre que sean pertinentes para aceptar ese
cambio. Las distintas condiciones pueden requerir distintas pruebas.

Conviene separar varios documentos. Una especificación puede definir requisitos comunes a muchos
cambios. Un caso de prueba describe una ejecución que aporta evidencia de uno o varios criterios.
La Definición de Terminado de Scrum recoge las medidas de calidad que debe cumplir el trabajo de
un Incremento. Los criterios de aceptación aclaran el comportamiento de un cambio particular. Un
equipo puede exigir acceso con teclado para cualquier elemento interactivo y concretar, para un
selector de fechas nuevo, que la persona pueda elegir y revisar una cita usando solo el teclado.

## Por qué importa

Un criterio útil saca a la luz una discrepancia cuando todavía es fácil cambiar de rumbo. Para la
persona responsable del servicio, una cita puede estar reservada en el momento en que existe el
registro. Para quien pide la cita, puede no estarlo hasta que llegue un correo. Atención al
público quizá necesita una referencia para contestar si ese correo se pierde. Son resultados
diferentes. Decidir cuándo se muestra el éxito y qué ocurre si falla el proveedor de correo evita
que la discrepancia aparezca por primera vez en producción.

Los criterios marcan qué hay que observar. Una persona puede revisar la pantalla de confirmación y
otra interrumpir de forma controlada el envío de mensajes. Las dos saben qué buscar. Un requisito
de accesibilidad quizá necesita recorrer los controles con el teclado además de una comprobación
automática. Un límite de tiempo necesita un entorno conocido y una carga de referencia. «El
sistema será rápido» permite varias interpretaciones incompatibles.

Las normas y las obligaciones legales se siguen aplicando aunque no se copien en la historia.
Describe cómo se aplica una norma al componente nuevo si sin esa precisión habría que adivinar la
respuesta. Para un calendario, puede bastar con indicar qué acciones deben completarse con el
teclado y citar el estándar de referencia. Así el criterio queda acotado sin perder de vista al
público que depende de ese uso.

## Cómo se aplica en la práctica

Imaginemos un servicio que permite reservar una cita y recibir un mensaje de confirmación. El
borrador dice «se reserva la cita y se envía un correo». La persona que gestiona el servicio,
quien lo desarrolla y quien prepara la verificación pueden discutir tres intentos concretos. Son
ejemplos ilustrativos. Las condiciones definitivas corresponden al equipo responsable del
servicio.

- Si hay una cita libre a las 14:00 en la zona horaria indicada, se crea una sola reserva
  confirmada. Su referencia, fecha y hora aparecen en pantalla y coinciden con el registro.
- Si alguien ocupa ese mismo hueco antes de que se procese la petición, se indica que la cita ya
  no está disponible y se ofrece volver a los horarios libres. No aparece una reserva adicional
  para el hueco ocupado.
- Si falla el envío después de confirmar la cita, la reserva permanece activa. La pantalla sigue
  mostrando la referencia y el fallo queda visible para quien deba gestionarlo.

Cada ejemplo señala el estado previo, la acción y un resultado comprobable. Gherkin les da una
forma conocida con Dado, Cuando y Entonces. Puede facilitar la lectura y el uso de pruebas
automáticas. Para una modificación pequeña también sirve una lista breve. En ambos casos conviene
precisar qué referencia se coteja y desde dónde se observa el resultado. Ver que un correo salió
de una cola no acredita que haya llegado.

El primer intento se hace en la pantalla real. El segundo exige controlar el orden de las
solicitudes. Para el tercero se provoca el fallo después de confirmar la transacción. Si se anotan
esas circunstancias y lo observado, otra persona podrá repetir la verificación. Nuestra
[declaración de accesibilidad](/es/accessibility/) ofrece un ejemplo relacionado. Describe pruebas
con el teclado y señala qué se observó y qué necesita más revisión. Un criterio de uso debería
permitir registrar evidencia de ese nivel de detalle.

## Dónde surgen los problemas

Las expresiones vagas aplazan la discusión. «Se gestiona el error de forma adecuada» deja abierta
la respuesta ante un fallo. Especifica cuándo aparece el mensaje, qué indica, qué acción queda
disponible y qué efecto no debe producirse. En la reserva, una captura que muestra el aviso no
basta para saber si se conservó el registro. Hay que mirar también el estado de la cita.

Otro problema es convertir una opción técnica en el criterio antes de justificarla. «Usar la cola
nueva» puede ser una decisión de arquitectura válida. A quien espera el correo le interesa saber
qué ocurre durante el retraso. Documenta la elección técnica donde se puedan explicar sus motivos
y redacta la condición con el comportamiento observable. Si una integración externa exige un
protocolo concreto, cita el requisito y aclara dónde se aplica.

En el extremo opuesto, una lista puede acabar abarcando toda una versión. Divide el trabajo por
resultados y conserva junto a cada uno su ruta de error importante. Acuerda qué reglas son comunes
y quién verifica el cambio particular. Si un ensayo muestra que falta una condición, registra la
razón del cambio en el criterio y repite las verificaciones afectadas. La siguiente persona podrá
saber qué se había acordado y qué queda abierto.

## Lecturas adicionales

- [Manual del Gobierno británico sobre historias y criterios de
  aceptación](https://www.gov.uk/service-manual/agile-delivery/writing-user-stories)
- [Referencia de Gherkin para describir escenarios y
  ejemplos](https://cucumber.io/docs/gherkin/reference/)
- [Definición de Terminado en la Guía
  Scrum](https://scrumguides.org/scrum-guide.html#definition-of-done)
- [Guía del W3C para verificar el funcionamiento con el
  teclado](https://www.w3.org/WAI/WCAG22/Understanding/keyboard.html)

<https://engineer.company/es/glossary/acceptance-criteria/>
