Handling order confirmation

When a order gets confirmed, it need to be placed into the order status "Confirmed". Since the state transition engine for order states are customizable, this state might be named differently based on the project, but effectively its purpose is to mark that the order is confirmed.

On confirmation of an order the usual practice is to do following tasks:

1. Send confirmation E-mail

2. Notify ERP system to start order processing

3. Reduce stock balances (can be through ERP system, or just the stock balance in Litium Studio is reduced using Litium Studio API)

4. Notify campaign engine to remove voucher code (or reduce the voucher code frequency), so that same voucher code cannot be used again.

Order confirmed state entry action

All above tasks need to be performed just once and only once. So, the ideal place to execute these tasks is on the Entry Action to the order confirmed state. Following code fragment is from the Litium Studio accelerator implementation, which perform the above tasks.

           //Order Confirmed
            var confirmed = new State<OrderCarrier>((short)OrderState.Confirmed, OrderState.Confirmed.ToString(),
                (orderCarrier, currentState, token) =>
                {
                    //Order confirmed entry action.

                    //now the order is confirmed, reduce the stock balances.
                    OrderUtilities.ReduceStockBalance(ModuleECommerce.Instance.Orders[orderCarrier.ID, token], ModuleECommerce.Instance.AdminToken);

                    //notify campaigns engine to take order confirmation actions.
                    ModuleECommerce.Instance.CampaignCalculator.HandleOrderConfirmation(orderCarrier, ModuleECommerce.Instance.AdminToken);

                    //Send order confirmation email.
                    IoC.Resolve<IMailService>().SendEmail(new OrderConfirmationEmail(orderCarrier.ID, orderCarrier.CustomerInfo.Address.Email), false);

                    //TODO: integration code to execute when an order is confirmed.
                    //....
                },
                null);

Following image ilustrates how the voucher code gets reduced when a order is confirmed.