Services Overview for Commerce Runtime

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

Microsoft Dynamics AX retail services are scalable and extensible services that are empowered through a combination of the commerce data exchange and the commerce runtime.

Commerce Runtime Configuration

Services are enumerated as types in the commerce runtime configuration file. You can add types in the commerce runtime configuration file to control which services are loaded in the commerce runtime.

Services are loaded in the order in which they are listed in the configuration file. All of the default services are loaded automatically, but if you add a new service above one of the default services, the new service will replace the default service. For more information, see Integrate a Service into the Commerce Runtime.

IService interface

The IService interface is comprised of an execute method that takes a service request as input and returns a service response.

The service request object contains the data that is needed to carry out an operation. To add new functionality to your store, implement a new message. Then create a service that can handle that message. For more information, see Integrate a Service into the Commerce Runtime.

Default Services

Microsoft Dynamics AX offers many services in the commerce runtime that support the basic functionality of an online store. You can add your own services or extend the services that are included in Microsoft Dynamics AX. The following table describes some of the services that you might use for your online store. For more information about each service, see the Microsoft.Dynamics.Commerce.Runtime.Services reference documentation.




Verifies addresses and gets location information like cities, counties, or states.


Calculates auto-charges, price charges, and shipping charges for a transaction.


Converts currencies based on exchange rates.


Maintains customer information.


Enables customers to find items in your store based on criteria like category or color.


Sends email to customers based on an email template defined in Microsoft Dynamics AX.


Implements a program that rewards repeat customers.


You can connect your online store to a payment service to provide credit card authorization and utilize pre-configured payment processing. You can also extend the payment service to add additional third party payment processors.


Obtains the price of an item in real time. The price is adjusted based on the base price and any applicable discounts. Discounts can be customized for each retailer.


Calculates the quantities of products that are available to sell.


Rounds the tender amount based on the tender type and store.


Creates a sales order based on a customer shopping cart.


Calculates shipping costs and determine shipping options for the current order. You can use shipping data from Microsoft Dynamics AX or from a third party shipping service. For more information about how to use a third party shipping service, see Walkthrough: Integrating a new Shipping Service.


Generates a list of stores based on criteria like proximity and product availability.


Calculates the sales tax for the current order. You can use sales tax information from Microsoft Dynamics AX or from a third party sales tax service.


Calculates the totals on the sales transactions and sales lines.

See also

Online Store

Retail Modern Point of Sale