Isolate issues related to e-mail not sending from Dynamics AX 2012 using the SMTP4Dev tool

Updated: March 23, 2016 by James Wang [MSFT]

The SMTP4Dev tool is easy-to-use and utilized to isolate issues related to e-mailing from Microsoft Dynamics AX as well as other software that generates email. This tool is useful in isolating issues with message hand-off or SMTP connection without having to send actual emails.

This tool may be installed on the existing SMTP server or another server local to Microsoft Dynamics AX. If the tool is installed on a server with an existing SMTP service, the SMTP service will need to be stopped if listening in on port 25 to avoid port conflicts. There is an option to change the port in the SMTP4Dev tool, but do not forget to change the port setting in the E-mail parameters form in Microsoft Dynamics AX.

Walk-through:

1. Download and run the tool on the desired server

2. In Microsoft Dynamics AX, navigate to: System Administration > Setup > System > E-mail parameters.
   • Enter the settings to point to the outgoing server via name or IP where SMTP4Dev is running
   • Specify the machine name as the Local computer name which will likely be the AOS
   • Specify the SMTP port which is port 25 by default

3. Run this sample X++ code as a job in the AOT

static void email_test(Args _args)
{    SysMailer   sysMailer = new SysMailer();
;
sysMailer.quickSend("from@test.com","to@test.com","test Alert mail","test Alert
mail");
Info("Success");
}

4. Go to your smtp4dev tool and verify that the e-mail was received.

Common Issue 1:

Error: Method ‘send’ in COM object of class ‘CDO.Message’ returned error code 0x8004020E (<unknown>) which means: <unknown>.

Cause: This error occurs when Microsoft Dynamics AX is unable to authenticate to the SMTP service.

Common Issue 2:

Error: Method ‘send’ in COM object of class ‘CDO.Message’ returned error code 0x80040213 (<unknown>) which means: The transport failed to connect to the server.

Cause: This error occurs when Microsoft Dynamics AX is unable to connect to the SMTP service due to mismatch in port, relay restrictions, or network (firewall) configuration.

And finally, to ensure email functionality in Microsoft Dynamics AX please refer to these knowledge base articles which are available in LCS: