Queue Management
Monitor sending status, troubleshoot errors, and manage your email queue.
Queue Management allows you to monitor the progress of your PDF generation and email sending tasks. It provides a detailed view of every job, from the overall profile status down to individual email items.
Overview
The Queue Management system is organized into four levels to help you drill down into issues:
- Profile List: Overview of all profiles and their recent activity.
- Batch List: History of imports (files) for a specific profile.
- Queue List: Individual items (recipients) within a batch.
- Item Details: Detailed data and status for a single item.
1. Profile List (Overview)
The main view shows a card for each Profile you have configured.
- Stats: Each card visualizes the status of items from the last 30 days.
- Error: Items that failed (PDF generation, Sending, or Import).
- Pend: Items waiting to be processed (PDF Generation).
- PDF Generated: Items with PDFs generated, waiting to be sent.
Action: Click on a profile card (or the Edit icon) to view its Batch List.
2. Batch List (History)
This list shows every file you have imported for the selected profile.
- Batch Name: Corresponds to the filename of the imported CSV.
- Import Date: Use this to distinguish between multiple imports of the same file.
- Status Columns:
- Total: Total number of items in the batch.
- Error: Total failures.
- Pending: Waiting for PDF generation.
- PDF Generated: PDFs generated, waiting for email.
- Sent: Successfully sent.
Action: Click the Edit icon on a specific batch row to view its Queue List.
3. Queue List (Items)
This view lists every individual recipient within the selected batch.
Features
- Search: You can search by Recipient (To), Status, Error Message, or data content (JSON).
- Filter: Use the dropdown to show only specific statuses (e.g., "Error" only).
- Delete Batch: The Delete Batch button allows you to remove the entire batch history.
Status Definitions
| Status | Internal Value | Description |
|---|---|---|
| Pending | pending | Waiting for the system to generate a PDF. |
| PDF Generated | pdf_generated | PDF has been created successfully. Waiting to send. |
| Sent | sent | Email has been successfully delivered to the SMTP server. |
| Error (Import) | error_import | Data import failed for this item. |
| Error (PDF) | error_pdf | PDF generation failed. |
| Error (Email) | error_email | Email sending failed (retryable). |
| Error (Email Fatal) | error_email_fatal | Email sending failed permanently (e.g., invalid address). |
Common Error Messages
The following errors may appear in the Error Message column or in the Error List for the batch:
Email Sending Errors
MISSING_TO_RECIPIENT: The "To" address is empty. Check your mapping configuration.INVALID_EMAIL_FORMAT: The email address format is invalid.BACKEND_CONNECTION_FAILED: Could not connect to the SMTP server. Check your internet connection or VPN.SMTP_AUTH_ERROR: SMTP authentication failed. Check your username and password.RETRY_LIMIT_REACHED_SKIP: The system gave up after the maximum number of retries and skipped this item.RETRY_LIMIT_REACHED_ABORT: The system gave up after the maximum number of retries and aborted the batch.
Import & Processing Errors
TEMPLATE_FILE_NOT_FOUND: The configured PDF template file is missing from the workspace.MISSING_MASTER_LOOKUP_VALUE: The item has no value for the lookup key (e.g., Customer ID is empty), so master data could not be retrieved.CSV_DATA_EMPTY_OR_UNREADABLE: The imported CSV file was empty or corrupted.
4. Item Details (Edit & Retry)
Clicking the Edit icon on an item allows you to modify its data or retry a failed process.
Modifying Data
You can correct email addresses (To, CC, BCC) if they were imported incorrectly.
Data Consistency Warning
Input Fields vs. Master Data JSON
The To/CC/BCC input fields on the left are separate from the Customer Master Data JSON on the right.
- The input fields control where the email is sent for this specific attempt.
- The JSON data is used for PDF generation and template rendering.
- Changing one does not automatically update the other. If you need to fix an email address for sending, update the input field.
Modifying Status (Retry)
The status does not change automatically when you save. You must manually select the appropriate status to trigger a retry:
- Pending: Select this status to discard the current PDF and try generating it again (e.g., after fixing JSON data).
- PDF Generated: Select this status to retry sending the existing PDF (e.g., after fixing an email address).
Editing JSON
You can directly edit the Document Content Data and Customer Master Data.
JSON Syntax
Be extremely careful when editing JSON. You must maintain valid syntax, including double quotes (""), commas (,), and brackets ([], {}). Invalid JSON will cause the process to fail again.