---
title: "Mensajes de error"
slug: "error-messages"
updated: 2026-07-27T07:23:55Z
published: 2026-07-27T07:23:55Z
canonical: "docs.document360.com/error-messages"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.document360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mensajes de error

Mensajes de error bien elaborados ayudan a los usuarios a entender qué falló y cómo solucionarlo, reduciendo la frustración y las solicitudes de soporte. Esta guía establece estándares para escribir mensajes de error claros, consistentes y empáticos a lo largo de la interfaz.

## Principios fundamentales

| Principio | Qué significa |
| --- | --- |
| **Claridad** | Utiliza un lenguaje sencillo y cotidiano. Evita la jerga y las descripciones vagas. |
| **Capacidad de acción** | Dile al usuario exactamente qué hacer a continuación. Si no hace falta ninguna acción, díselo. |
| **Empatía** | Nunca culpes al usuario. Usa una expresión neutra y de apoyo. |
| **Consistencia** | Utiliza el mismo tono, estructura y terminología en todos los mensajes (por ejemplo, no mezcles "error de servidor" y "error de sistema" para el mismo problema). |
| **Brevedad** | Sé breve — suficiente contexto para ser útil, nada más. |
| **Accesibilidad** | Sigue las directrices de WCAG para que los mensajes sean comprensibles para usuarios de todas las capacidades. |

## Anatomía de un mensaje de error

Cada mensaje de error debería responder hasta tres preguntas:

1. **¿Qué ha pasado?** Exponga el problema claramente.
2. **¿Por qué ocurrió?** *(opcional)* Añade una breve razón si ayuda al usuario a entender.
3. **¿Qué debería hacer el usuario a continuación?** Da una acción o un punto concreto para ayudar más.

**Estructura:**

| Componente | Ejemplo |
| --- | --- |
| Cabecera | "No se puede procesar la solicitud" |
| Descripción | "Tuvimos un problema mientras procesamos su solicitud. Por favor, inténtalo de nuevo." |
| Acción/Ayuda | "Si el problema persiste, contacta con el soporte en support@document360.com." |

## Directrices de escritura

| Directriz | ✅ Do | ❌ No |
| --- | --- | --- |
| Utiliza lenguaje claro | "El tamaño del archivo supera el límite permitido." | "Fallido en la subida del archivo por limitaciones de tamaño." |
| Sé específico | "Dirección de correo electrónico inválida. Por favor, introduzca un formato válido (por ejemplo, name@domain.com)." | "Error de entrada." |
| Aportar una solución | "El nombre de usuario ya está tomado. Prueba con otro nombre de usuario." | "Este nombre de usuario no está disponible." |
| Evita la jerga técnica | "No pudimos conectarnos al servidor. Comprueba tu conexión a internet e inténtalo de nuevo." | "Error del servidor 503 detectado." |
| Utiliza un lenguaje educado y positivo | "Algo salió mal. Por favor, inténtalo de nuevo en unos minutos." | "¡Error! Inténtalo de nuevo." |
| Alinearse con el contexto | "No pudimos salvar eso. Por favor, inténtalo de nuevo." | "¡Error de guardado! ¡Acción bloqueada!" |
| Usa la voz activa | "No pudimos encontrar el artículo solicitado." | "El artículo solicitado no fue encontrado." |
| Evita las palabras negativas | "No pudimos completar tu petición." | "No he procesado tu solicitud." |

**Códigos de error:** Inclúyelos solo para errores complejos o técnicos que ayuden a la resolución de problemas.

> Ejemplo: "La solicitud no pudo procesarse (Código de error: 403). Contacta con el soporte para recibir ayuda."

## Escenarios de error comunes

| Escenario | Mensaje de error |
| --- | --- |
| Entrada inválida | "Contraseña inválida. La contraseña debe tener al menos 8 caracteres e incluir un número." |
| Campo requerido faltante | "Se requiere dirección de correo electrónico. Por favor, introduzca su correo electrónico para continuar." |
| Tiempo de espera del servidor | "Estamos teniendo problemas para conectarnos al servidor. Por favor, inténtalo de nuevo más tarde." |
| Error de subida de archivos | "Fallido la subida del archivo. Asegúrate de que el archivo tenga menos de 5 MB y esté en un formato compatible." |
| Acceso denegado | "No tienes permiso para ver esta página. Contacta con tu administrador." |
| Incumplimiento de pago | "El pago no pudo ser procesado. Revisa los datos de tu tarjeta o prueba otro método." |
| Entrada duplicada | "Este nombre de categoría ya existe. Por favor, elige otro nombre." |
| Sesión finalizada | "Tu sesión ha expirado. Por favor, inicia sesión de nuevo para continuar." |

## Lista de verificación previa a la publicación

- ¿El mensaje es claro y conciso?
- ¿Explica eso qué salió mal?
- ¿Ofrece un siguiente paso concreto?
- ¿Está libre de jerga técnica?
- ¿El tono es educado y profesional?
- ¿Es coherente con otros mensajes de error del producto?

## Mantenimiento

Revisa periódicamente todos los mensajes de error a medida que evolucionan las características del producto y actualízalos con rapidez para evitar directrices desactualizadas o confusas.