---
title: "Sales order confirmation"
slug: "bc-sales-order-confirmation"
description: "Learn how to send a sales order confirmation notification using Microsoft Dynamics 365, including setup, XML generation, and email configuration."
tags: ["BC", "BIS", "Business Central", "Business Integration Solutions", "Walkthrough"]
updated: 2026-06-25T09:59:05Z
published: 2026-06-25T09:59:05Z
canonical: "docs.staedean.com/bc-sales-order-confirmation"
---

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

# Sales order confirmation

This walkthrough provides an overview of how to send a sales order confirmation notification.

A sales order confirmation is a seller-generated document that authorizes the sale of specified items, issued after receipt of a customer's purchase order. A sales order usually implies no additional labor or material cost for the sale, except where it starts a production process.

## Prerequisites

| Template | Description | Default report |
| --- | --- | --- |
| NM_SO.CONFIRM | Template: Sales Order Confirmation sent by Email Writer | Order Confirmation (1305) |

## Story

This connection uses the following pipeline elements:

- A **Code Event** triggers the pipeline. On the **Sales Order Card** page (page 42), add a new button with a few lines of code: see [Code event setup](/business-central/docs/bc-create-a-code-event-netcode-event). When a user selects this button, the Code Event detects it.
- The **XML Generator** activity creates an XML file based on an internal document.
- The **Splitter** activity creates one message for each sales order.
- The **XML Minifier** activity cleans the message of empty nodes and blocks that are not mandatory.
- The **Header Mapper** activity adds the headers to the message body, filling in the recipients and email subject.
- The **XML to HTML Translator** activity creates an HTML email message based on your branding templates. You can also configure an HTML body manually.
- The **Attachment Generator** activity adds attachments to the email message based on standard Microsoft Microsoft Dynamics 365 Business Central report functionality.
- The **Email Writer** endpoint sends the email.
- The internal document NM_SALESORDER contains all the information needed to configure the **XML Generator** activity, the **Splitter** activity, the **Header Mapper** activity, and the **XML to HTML Translator** activity. Adding other fields to this document lets you define a personalized email message.

![Notification Management](https://cdn.document360.io/da662430-6a41-47b1-8c7e-7e4ac37a9756/Images/Documentation/DM_NM_UsingEmailWriter.png)

## Setup

1. Import the Notification-NM_SO.CONFIRM.zip configuration package, or use the Business Integration Solutions template if available.

![SO Confirm Import](https://cdn.document360.io/da662430-6a41-47b1-8c7e-7e4ac37a9756/Images/Documentation/DM_SOConfirm_Import.png)
2. Add a new email account in **Email Accounts**, then select **SMTP Account** to send notifications via the Papercut SMTP server.

![Email Account](https://cdn.document360.io/da662430-6a41-47b1-8c7e-7e4ac37a9756/Images/Documentation/bis_EmailAccountIDsetup.png)
3. On the notification page, edit the EMAILWRITER and add the **Account ID** created in the previous step. Run the configuration once.

![Settings](https://cdn.document360.io/da662430-6a41-47b1-8c7e-7e4ac37a9756/Images/Documentation/DM_Reminder_Settings.png)

## Process

1. Open the **Sales Order Card** and choose an order for customer 20000 Selangorian Ltd.
2. Check the data on the **Sales Order Card**.
3. Select the Code Event button on the page (**Send Notification**).

## Result

![SO Confirm Result](https://cdn.document360.io/da662430-6a41-47b1-8c7e-7e4ac37a9756/Images/Documentation/DM_SOConfirm_Result.png)

The mail sends to all recipients. Using Papercut, the mail is captured in the demo environment, showing a preview of the HTML mail body and a PDF attachment of the **Order Confirmation** report.

> [!NOTE]
> **Note**
> 
> For a brief guide, see [Papercut SMTP setup](/business-central/docs/bc-simulate-mail-using-papercut).

## Related

- [Create a Code event / NETCode event](/bc-create-a-code-event-netcode-event.md)