{"canonical_url":"https://engineer.company/es/glossary/acceptance-criteria/","content_markdown":"# Criterios de aceptación\n\n## Qué es\n\nLos criterios de aceptación son las condiciones que debe cumplir un cambio concreto para que pueda\ndarse por válido. Describen qué se podrá observar en unas circunstancias determinadas. «Enviar una\nconfirmación de la cita» nombra una función. «Al reservar una cita disponible, la confirmación\npresenta la misma referencia y hora de inicio que el registro de reserva» permite comprobar parte\ndel comportamiento y deja abierta la forma de generar esa confirmación.\n\nEl manual de servicios digitales del Gobierno británico describe los criterios de una historia de\nusuario como una lista de resultados con la que verificar que el servicio ha cumplido su cometido.\nLa historia explica quién necesita el servicio y para qué. Los criterios concretan el acuerdo para\nque se pueda discutir, implementar y verificar. También pueden cubrir una ruta de error, el acceso\nmediante teclado o una restricción operativa, siempre que sean pertinentes para aceptar ese\ncambio. Las distintas condiciones pueden requerir distintas pruebas.\n\nConviene separar varios documentos. Una especificación puede definir requisitos comunes a muchos\ncambios. Un caso de prueba describe una ejecución que aporta evidencia de uno o varios criterios.\nLa Definición de Terminado de Scrum recoge las medidas de calidad que debe cumplir el trabajo de\nun Incremento. Los criterios de aceptación aclaran el comportamiento de un cambio particular. Un\nequipo puede exigir acceso con teclado para cualquier elemento interactivo y concretar, para un\nselector de fechas nuevo, que la persona pueda elegir y revisar una cita usando solo el teclado.\n\n## Por qué importa\n\nUn criterio útil saca a la luz una discrepancia cuando todavía es fácil cambiar de rumbo. Para la\npersona responsable del servicio, una cita puede estar reservada en el momento en que existe el\nregistro. Para quien pide la cita, puede no estarlo hasta que llegue un correo. Atención al\npúblico quizá necesita una referencia para contestar si ese correo se pierde. Son resultados\ndiferentes. Decidir cuándo se muestra el éxito y qué ocurre si falla el proveedor de correo evita\nque la discrepancia aparezca por primera vez en producción.\n\nLos criterios marcan qué hay que observar. Una persona puede revisar la pantalla de confirmación y\notra interrumpir de forma controlada el envío de mensajes. Las dos saben qué buscar. Un requisito\nde accesibilidad quizá necesita recorrer los controles con el teclado además de una comprobación\nautomática. Un límite de tiempo necesita un entorno conocido y una carga de referencia. «El\nsistema será rápido» permite varias interpretaciones incompatibles.\n\nLas normas y las obligaciones legales se siguen aplicando aunque no se copien en la historia.\nDescribe cómo se aplica una norma al componente nuevo si sin esa precisión habría que adivinar la\nrespuesta. Para un calendario, puede bastar con indicar qué acciones deben completarse con el\nteclado y citar el estándar de referencia. Así el criterio queda acotado sin perder de vista al\npúblico que depende de ese uso.\n\n## Cómo se aplica en la práctica\n\nImaginemos un servicio que permite reservar una cita y recibir un mensaje de confirmación. El\nborrador dice «se reserva la cita y se envía un correo». La persona que gestiona el servicio,\nquien lo desarrolla y quien prepara la verificación pueden discutir tres intentos concretos. Son\nejemplos ilustrativos. Las condiciones definitivas corresponden al equipo responsable del\nservicio.\n\n- Si hay una cita libre a las 14:00 en la zona horaria indicada, se crea una sola reserva\n  confirmada. Su referencia, fecha y hora aparecen en pantalla y coinciden con el registro.\n- Si alguien ocupa ese mismo hueco antes de que se procese la petición, se indica que la cita ya\n  no está disponible y se ofrece volver a los horarios libres. No aparece una reserva adicional\n  para el hueco ocupado.\n- Si falla el envío después de confirmar la cita, la reserva permanece activa. La pantalla sigue\n  mostrando la referencia y el fallo queda visible para quien deba gestionarlo.\n\nCada ejemplo señala el estado previo, la acción y un resultado comprobable. Gherkin les da una\nforma conocida con Dado, Cuando y Entonces. Puede facilitar la lectura y el uso de pruebas\nautomáticas. Para una modificación pequeña también sirve una lista breve. En ambos casos conviene\nprecisar qué referencia se coteja y desde dónde se observa el resultado. Ver que un correo salió\nde una cola no acredita que haya llegado.\n\nEl primer intento se hace en la pantalla real. El segundo exige controlar el orden de las\nsolicitudes. Para el tercero se provoca el fallo después de confirmar la transacción. Si se anotan\nesas circunstancias y lo observado, otra persona podrá repetir la verificación. Nuestra\n[declaración de accesibilidad](/es/accessibility/) ofrece un ejemplo relacionado. Describe pruebas\ncon el teclado y señala qué se observó y qué necesita más revisión. Un criterio de uso debería\npermitir registrar evidencia de ese nivel de detalle.\n\n## Dónde surgen los problemas\n\nLas expresiones vagas aplazan la discusión. «Se gestiona el error de forma adecuada» deja abierta\nla respuesta ante un fallo. Especifica cuándo aparece el mensaje, qué indica, qué acción queda\ndisponible y qué efecto no debe producirse. En la reserva, una captura que muestra el aviso no\nbasta para saber si se conservó el registro. Hay que mirar también el estado de la cita.\n\nOtro problema es convertir una opción técnica en el criterio antes de justificarla. «Usar la cola\nnueva» puede ser una decisión de arquitectura válida. A quien espera el correo le interesa saber\nqué ocurre durante el retraso. Documenta la elección técnica donde se puedan explicar sus motivos\ny redacta la condición con el comportamiento observable. Si una integración externa exige un\nprotocolo concreto, cita el requisito y aclara dónde se aplica.\n\nEn el extremo opuesto, una lista puede acabar abarcando toda una versión. Divide el trabajo por\nresultados y conserva junto a cada uno su ruta de error importante. Acuerda qué reglas son comunes\ny quién verifica el cambio particular. Si un ensayo muestra que falta una condición, registra la\nrazón del cambio en el criterio y repite las verificaciones afectadas. La siguiente persona podrá\nsaber qué se había acordado y qué queda abierto.\n\n## Lecturas adicionales\n\n- [Manual del Gobierno británico sobre historias y criterios de\n  aceptación](https://www.gov.uk/service-manual/agile-delivery/writing-user-stories)\n- [Referencia de Gherkin para describir escenarios y\n  ejemplos](https://cucumber.io/docs/gherkin/reference/)\n- [Definición de Terminado en la Guía\n  Scrum](https://scrumguides.org/scrum-guide.html#definition-of-done)\n- [Guía del W3C para verificar el funcionamiento con el\n  teclado](https://www.w3.org/WAI/WCAG22/Understanding/keyboard.html)\n\n\u003chttps://engineer.company/es/glossary/acceptance-criteria/\u003e\n","date_modified":"2026-11-19T06:00:51Z","description":"Cómo escribir criterios de aceptación observables, comprobarlos con un ejemplo de reserva y distinguirlos de la Definición de Terminado.","formats":{"gemtext":"https://engineer.company/es/glossary/acceptance-criteria/index.gmi","gopher":"https://engineer.company/es/glossary/acceptance-criteria/gophermap","html":"https://engineer.company/es/glossary/acceptance-criteria/","json":"https://engineer.company/es/glossary/acceptance-criteria/index.json","markdown":"https://engineer.company/es/glossary/acceptance-criteria/index.md","pdf":"https://engineer.company/es/glossary/acceptance-criteria/index.pdf"},"kind":"page","language":"es","title":"¿Qué son los criterios de aceptación?","url":"https://engineer.company/es/glossary/acceptance-criteria/","version":1}