Set up receiving to use advanced shipping notice documents


This content is archived and is not being updated. For the latest documentation, see Microsoft Dynamics 365 product documentation. For the latest release plans, see Dynamics 365 and Microsoft Power Platform release plans.

Applies To: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2


This topic applies to features in the Warehouse management module. It does not apply to features in the Inventory management module.

This topic describes how to set up Microsoft Dynamics AX 2012 so that you can automatically receive and import an advanced shipping notice (ASN) from your vendors. An ASN is a document in which a sender can provide information about a delivery. Typically, the information includes order details, product descriptions, packing structure, and carrier information. In Warehouse management, you can use the information in an ASN to streamline the receiving process. For example, you can capture some or all of the information in the ASN, and generate the put-away work and instructions by scanning the license plate when you receive it.


The following table shows the prerequisites that must be in place before you start.



Endpoints and data action policies

You must set up endpoint services and data action policies for ASNs in the Microsoft Dynamics AX Application Integration Framework (AIF) to automatically receive and import the ASN to create the load and the associated packing structure.

Ensure that you can transform the file from the sender into the required format

To automate the receiving process by using an ASN, you must be able to import the information into Microsoft Dynamics AX. Typically, ASNs are provided in an XML format. However, other file formats are also used. Work with your supplier to determine the file format that they can provide, and then determine how to transform it into the XML format that Microsoft Dynamics AX requires. For example, the structure of the XML file can differ depending on the information that you want to capture. You can use an XSLT file to transform the XML file into the format that is required by Microsoft Dynamics AX.

The following example shows a structure for an XML file that can be imported through the AIF.

<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns="">
    <MessageParts xmlns="">
      <WHSShipmentASN xmlns="">
        <WHSShipmentTable class="entity">
          <WHSUOMStructure class="entity">
            <WHSASNItem class="entity">
              <InventDim class="entity">
                 <InventBatchId /> 
                 <InventSerialId /> 
          <DirPartyPostalAddressView class="entity">

Set up the AIF to automatically import inbound advanced shipping notices

To import ASNs on a schedule, you must configure an inbound integration port and a batch job. You use the AIF import process to import an ASN, which can either create a load for the inbound items or use an existing load. The packing structure of the inbound load is also created automatically.

There is one requirement for the inbound port that is specific to receiving an inbound ASN. You must expose the WHSShipmentASNService.create service operation. For an example of how to set up an inbound integration port, see Walkthrough: Configuring an inbound integration port for Office Excel import.

Set up warehouse management parameters for inbound advanced shipping notices

To set up warehouse management parameters for ASNs, follow these steps:

  1. Click Warehouse management > Setup > Warehouse management parameters.

  2. On the General tab, on the Receiving exceptions FastTab, in the Code for missing items from ASN field, select the work exception to use if an item that is listed in the ASN is missing from the load.

  3. To automatically generate the inbound load when a purchase order line is created or updated, on the Automatically create at purchase order entry tab, select the Automatically create at purchase order entry check box.

Provide the supplier with the purchase order number

You must create a purchase order and provide your supplier with the purchase order information so that they can include the number in the ASN. If the ASN has been imported, you can then use the license plate ID that is listed in the ASN to receive the shipment and assign it to the purchase order. The load details and the associated packing structure are updated automatically.

Set up a mobile device for license plate receiving

You can create a mobile device menu item that enables a worker to scan a license plate to receive an order based on the information in an advanced shipping notice. For more information, see Configure mobile devices for warehouse work.

Technical information for system administrators

If you don't have access to the pages that are used to complete this task, contact your system administrator and provide the information that is shown in the following table.



Configuration keys

Click System administration > Setup > Licensing > License configuration. Expand the Trade license key, and select the Warehouse and Transportation management configuration key.