Services Overview for Commerce Runtime

Important

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

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.

Service

Description

AddressService

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

ChargeService

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

CurrencyService

Converts currencies based on exchange rates.

CustomerService

Maintains customer information.

DimensionService

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

EmailService

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

LoyaltyService

Implements a program that rewards repeat customers.

PaymentService

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.

PricingService

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.

ProductAvailabilityService

Calculates the quantities of products that are available to sell.

RoundingService

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

SalesOrderService

Creates a sales order based on a customer shopping cart.

ShippingService

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.

StoreLocatorService

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

TaxService

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.

TotalingService

Calculates the totals on the sales transactions and sales lines.

See also

Online Store

Retail Modern Point of Sale