Configure

This section explains how to configure the Litium ChannelEngine Connector

There are two kinds of configuration sources for the Litium.AddOns.ChannelEngine package. First is the configuration defined for Litium channels. The second one is defined in Litium.AddOns.ChannelEngine.dll.config file.

Channel configuration

Channel configuration related to Channel Engine may be defined in Channel Engine field group. Follwoing fields are available:

Field Name Description
API URL Defines URL of the ChannelEngine endpoint responsible for handling integration requests related to this Litium channel.
Merchant API Key API Key used to authenticate integration in ChannelEngine Merchant API service.
Carrier Name Name of the delivery service that will be sent to ChannelEngine upon creation of order delivery in Litium.
Monitored Inventory ID of the inventory which stock changes shall be monitored and forwarded to ChannelEngine.
Monitored Price List ID of the price list which changes shall be monitored and forwarded to ChannelEngine. NOTE! This pricelist must be including VAT and in the same currency as the base currency used in ChannelEngine.
Default Delivery Method Name of the Delivery method that shall be selected for orders imported from ChannelEngine.
Default Payment Method Name of the Payment method that shall be selected for orders imported from ChannelEngine.
Default currency Currency configured as base currency on the ChannelEngine portal. Orders will be created in this currency using the the currency converted amounts from ChannelEngine.

Global settings

Global package settings that affect all configured channels are stored in Litium.AddOns.ChannelEngine.dll.config file which is automatically created when referencing Litium.AddOns.ChannelEngine nuget package. Following table contains all configuration entries defined in this file:

Attribute Name Description
enableIntegration Determines whether the integration shall be enabled on the currently running system.
stockUpdateInterval Time interval between successive executions of a task that updates Channel Engine stock by checking all the items in the Inventory configured for each of the Litium channel.
priceUpdateInterval Time interval between successive executions of a task that updates Channel Engine prices by checking all the items in the Price List configured for each of the Litium channel. NOTE! This should be set according to how often you update your prices, to avoid ChannelEngine orders being placed with old prices.
ordersImportInterval Time interval between successive executions of a task that imports new orders from each of the Litium channels that has correct Channel Engine configuration assigned.
ordersSynchronizationRetryInterval Time interval between successive executions of a task that checks each Channel Engine order for an unsucessfully acknowledgement or shipment creation and retries the attempt.
defaultOrderStatus An integer representing an order status that the new order imported from Channel Engine shall be assigned with.
defaultDeliveryStatus An integer representing a delivery status that the new order imported from Channel Engine shall be assigned with.
orderAcknowledgementStatus An integer representing an order status for which each of the order imported from Channel Engine shall be acknowledged in Channel Engine when entering this state.
orderShipmentStatus An integer representing an order status for which shipment of each of the order imported from Channel Engine shall be created in Channel Engine when entering this state.

Note that the order and delivery statuses you configure has to comply with the order fulfilment process and states in your solution.

About the product feed

Different marketplaces have different requirements for the structure of product information. ChannelEngine documentation contains a guide for each marketplace on how to make sure your product information is correct. Please make sure that your feed contains information for both base product (parent in ChannelEngine) and variant (child in ChannelEngine).

About orders

The following data are added to orders created from ChannelEngine

Litium OrderCarrier property ChannelEngine property Description
AdditionalOrderInfo["CEExtraData"] ExtraData  
AdditionalOrderInfo["CEOrderKey"] Id + "_" + ChannelName  
AdditionalOrderInfo["CEChannelOrderID"] Id  
AdditionalOrderInfo["CEChannelName"] ChannelName  
AdditionalOrderInfo["CEChannelID"] ChannelId  
AdditionalOrderInfo["CEChannelOrderNumber"] ChannelOrderNo  
AdditionalOrderInfo["CEChannelCreatedAt"] CreatedAt  
AdditionalOrderInfo["CEChannelOrderDate"] OrderDate  
AdditionalOrderInfo["CEIsBusinessOrder"] IsBusinessOrder  
AdditionalOrderInfo["CEVatNo"] VatNo  
AdditionalOrderInfo["CEOrderAcknowledged"]   True if order has been succesfully acknowledged to CE. False if acknowledgement has been tried and failed. Missing if acknowledgement has not been attempted yet.
AdditionalOrderInfo["CEShipmentCreated"]   True if shipment has been succesfully created in CE. False if shipment creation has been tried and failed. Missing if shipment creation has not been attempted yet.

Note that no changes can be done on orders created from ChannelEngine. Order cancellation is not currently supported by the connector. If you cancel an order in Litium, the order need to be manually cancelled from ChannelEngine dashboard.

By default, a new customer and/or organisation will be created for each order from ChannelEngine. The connector will not try to match any existing customers or organisations in Litium.

ChannelEngine does not support pro-rata calculations for VAT on shipment fee. The VAT amount received from ChannelEngine will be used to calculate the VAT percentage of the shipment fee in Litium.