Gestión de cola
Supervise el estado de envío, solucione errores y gestione su cola de correo.
La Gestión de Cola le permite supervisar el progreso de sus tareas de generación de PDF y envío de correo. Proporciona una vista detallada de cada trabajo, desde el estado general del perfil hasta los elementos individuales de correo.
Descripción general
El sistema de Gestión de Cola se organiza en cuatro niveles para ayudarle a profundizar en los problemas:
- Lista de perfiles: Vista general de todos los perfiles y su actividad reciente.
- Lista de lotes: Historial de importaciones (archivos) para un perfil específico.
- Lista de cola: Elementos individuales (destinatarios) dentro de un lote.
- Detalles del elemento: Datos detallados y estado de un solo elemento.
1. Lista de perfiles (Vista general)
La vista principal muestra una tarjeta para cada Perfil que ha configurado.
- Estadísticas: Cada tarjeta visualiza el estado de los elementos de los últimos 30 días.
- Error: Elementos que fallaron (Generación de PDF, Envío o Importación).
- Pend: Elementos en espera de procesamiento (Generación de PDF).
- PDF Generado: Elementos con PDF generado, en espera de envío.
Acción: Haga clic en la tarjeta de un perfil (o el icono Editar) para ver su Lista de Lotes.
2. Lista de lotes (Historial)
Esta lista muestra cada archivo que ha importado para el perfil seleccionado.
- Nombre del lote: Corresponde al nombre de archivo del CSV importado.
- Fecha de importación: Use esto para distinguir entre múltiples importaciones del mismo archivo.
- Columnas de estado:
- Total: Número total de elementos en el lote.
- Error: Total de fallos.
- Pendiente: En espera de generación de PDF.
- PDF Generado: PDFs generados, en espera de correo.
- Enviado: Enviados con éxito.
Acción: Haga clic en el icono Editar en una fila de lote específica para ver su Lista de Cola.
3. Lista de cola (Elementos)
Esta vista lista cada destinatario individual dentro del lote seleccionado.
Funciones
- Buscar: Puede buscar por Destinatario (Para), Estado, Mensaje de Error o contenido de datos (JSON).
- Filtrar: Use el menú desplegable para mostrar solo estados específicos (ej., solo "Error").
- Eliminar lote: El botón Eliminar Lote le permite eliminar todo el historial del lote.
Definiciones de estado
| Estado | Valor interno | Descripción |
|---|---|---|
| Pendiente | pending | En espera de que el sistema genere un PDF. |
| PDF Generado | pdf_generated | El PDF se ha creado con éxito. En espera de envío. |
| Enviado | sent | El correo se ha entregado con éxito al servidor SMTP. |
| Error (Importación) | error_import | La importación de datos falló para este elemento. |
| Error (PDF) | error_pdf | La generación de PDF falló. |
| Error (Correo) | error_email | El envío de correo falló (reintentable). |
| Error (Correo Fatal) | error_email_fatal | El envío de correo falló permanentemente (ej., dirección no válida). |
Mensajes de error comunes
Los siguientes errores pueden aparecer en la columna de Mensaje de Error o en la Lista de Errores del lote:
Errores de envío de correo
MISSING_TO_RECIPIENT: La dirección "Para" está vacía. Verifique la configuración de mapeo.INVALID_EMAIL_FORMAT: El formato de la dirección de correo no es válido.BACKEND_CONNECTION_FAILED: No se pudo conectar al servidor SMTP. Verifique su conexión a internet o VPN.SMTP_AUTH_ERROR: La autenticación SMTP falló. Verifique su usuario y contraseña.RETRY_LIMIT_REACHED_SKIP: El sistema se rindió tras el número máximo de reintentos y omitió este elemento.RETRY_LIMIT_REACHED_ABORT: El sistema se rindió tras el número máximo de reintentos y abortó el lote.
Errores de importación y procesamiento
TEMPLATE_FILE_NOT_FOUND: El archivo de plantilla PDF configurado no se encuentra en el espacio de trabajo.MISSING_MASTER_LOOKUP_VALUE: El elemento no tiene valor para la clave de búsqueda (ej., el ID de Cliente está vacío), por lo que no se pudieron obtener los datos maestros.CSV_DATA_EMPTY_OR_UNREADABLE: El archivo CSV importado estaba vacío o corrupto.
4. Detalles del elemento (Editar y reintentar)
Al hacer clic en el icono Editar de un elemento, puede modificar sus datos o reintentar un proceso fallido.
Modificar datos
Puede corregir direcciones de correo (Para, CC, CCO) si se importaron incorrectamente.
Advertencia de consistencia de datos
Campos de entrada vs. JSON de datos maestros
Los campos de entrada Para/CC/CCO a la izquierda son independientes del JSON de Datos Maestros del Cliente a la derecha.
- Los campos de entrada controlan a dónde se envía el correo en este intento específico.
- Los datos JSON se usan para la generación de PDF y renderizado de la plantilla.
- Cambiar uno no actualiza automáticamente el otro. Si necesita corregir una dirección de correo para el envío, actualice el campo de entrada.
Modificar estado (Reintento)
El estado no cambia automáticamente al guardar. Debe seleccionar manualmente el estado apropiado para activar un reintento:
- Pendiente: Seleccione este estado para descartar el PDF actual e intentar generarlo de nuevo (ej., después de corregir datos JSON).
- PDF Generado: Seleccione este estado para reintentar el envío del PDF existente (ej., después de corregir una dirección de correo).
Editar JSON
Puede editar directamente los Datos de Contenido del Documento y los Datos Maestros del Cliente.
Sintaxis JSON
Tenga mucho cuidado al editar JSON. Debe mantener una sintaxis válida, incluyendo comillas dobles (""), comas (,) y corchetes ([], {}). Un JSON no válido causará que el proceso falle nuevamente.