Skip to content

Troubleshooting

Document Dispatch is a powerful tool for managing and automating document distribution within Business Central. While designed for efficiency and reliability, users may occasionally encounter issues that require troubleshooting. This guide provides solutions to common problems, helping administrators and users resolve them quickly and maintain seamless operations.

Resending Failed Queue Entries

In previous versions of Document Dispatch, an issue occurred where queue entries with the type Multimail Error remained stuck in an error state after attempting to resend them. This prevented users from successfully processing these entries and required manual intervention.

This issue has been resolved. Users can now simply resend the affected queue entries, and they will go through the dispatch process correctly, ensuring proper delivery.

To resend failed queue entries, follow these steps:

  1. Navigate to the Document Dispatch Queue.
  2. Locate the entries with the status Multimail Error.
  3. Select the affected entries.
  4. Execute the Send Again (Direct) action.

Note

  • The system will now process these entries as intended, updating their status accordingly.
  • This ensures that previously failed messages are dispatched without requiring additional manual corrections.
  • If an entry still encounters an issue, verify its configuration and any related settings in the Document Dispatch module.

Handling Empty PDF/A3 Documents in the Dispatch Queue

A previous issue in Document Dispatch caused queue entries containing an Attachment Group with a PDF/A3 document to be empty. This was due to a bug that affected the merging process of PDF/A3 files, resulting in an incorrect or blank document.

This issue has been fixed. Users can now resend affected queue entries, and the merged PDF files will be generated correctly.

To resend queue entries with empty PDF/A3 documents, follow these steps:

  1. Navigate to the Document Dispatch Queue.
  2. Identify the entries containing an attachment group with a PDF/A3 document.
  3. Select the affected entries.
  4. Execute the Send Again (Direct) action.

Note

  • The system will now correctly merge and generate the PDF files as expected.
  • If an issue persists, ensure that the affected attachment group and dispatch profile are configured correctly.
  • This fix eliminates the need for manual document corrections, improving workflow efficiency.

Got it! Here's the revised version in English, without using dashes (–) for separating sentences or clauses. It's structured clearly and uses natural separators like periods and commas instead.

Email Limitation

When sending a large number of emails either directly via the Factbox or delayed via the job queue, you can quickly run into email rate limits. If no proper throttling is configured, emails may fail to send once the account limit is exceeded.

However, Microsoft Dynamics 365 Business Central provides a built-in solution for this: Email Throttling. You can configure a rate limit per email account, which queues emails and processes them step by step. This helps prevent sending errors by ensuring the rate limit is not exceeded. When throttling is in effect, the Document Dispatch queue entries will be shown with the status "Processing", indicating that the email is in the queue and will be sent shortly. This status is updated automatically as the system processes the emails.

Recommendation

We highly recommend configuring an email rate limit to ensure your emails are throttled appropriately. You can find more information on how to do this here: Easily comply with email sending limits through email throttling

If you are experiencing errors in Document Dispatch related to sending limits, try adjusting the rate limit of your email account.

Your specific sending limits can vary depending on your Microsoft account type. Please refer to the official documentation for detailed information: Microsoft Exchange Online - Sending Limits

In addition to rate limits, message size and attachment limits also apply. Each email can only contain a limited number and size of attachments. To help with this, we provide several features to handle large data dispatches more effectively.

One solution is the OneDrive integration available in Document Dispatch. This allows you to group multiple documents into a single OneDrive folder. Instead of attaching all documents to the email, a single OneDrive link is sent. This enables mass document delivery without hitting attachment limits. We highly recommend using this method for high-volume document distribution.

If you prefer to send documents as attachments, and you're using our Document Central integration to automatically include archived documents, you can also apply file extension restrictions. In the Dispatch Profile, navigate to the Document Central attachment options and enable the file extension restriction settings.

You can choose between a whitelist or blacklist approach. For example, if you want to ensure only PDF documents are attached to emails, enable whitelist mode and add pdf under file extensions. This helps eliminate unnecessary files and reduces the risk of exceeding size limits or sending irrelevant content.