Samples included in the package

The samples included in the WSIK package are separated into two different assemblies, according to the suggested architecture. Separating the contract assembly from the implementation assembly will make it easier to upgrade the service implementation (including assembly version) without having to distribute new assemblies to the all clients. This is only necessary if the contracts themselves are changed.
  • Contracts are found in the assembly and project Litium.Studio.Integration.Sample.Contract.
  • Implementation are found in the assembly and project Litium.Studio.Integration.Sample.

General

The Command helper will help you create a self-signed certificate. To create a certificate you need Microsoft Visual Studio installed on the computer and the program will be found in Microsoft Visual Studio Tools folder.

Inbound services

To enable simple testing of the inbound services a small windows client is included as a sample. The windows client is found in the Litium.Studio.Integration.Sample.Client project.
The inbound service example is found in the Litium.Studio.Integration.Sample-project and the service is located in file Site\Integration\Inbound.svc where you find the full implementation.

Import article

This sample will create or update articles in the product catalog. It has support for one or more articles using the following field setup.

import article

Language independent fields: 

  • Article number
  • Price and VAT percentage
  • Stock balance (Quantity)
  • Image (including filename)

Language dependent fields (English and Swedish):

  • Description
  • Display name
     

Get article information

This sample will get a single article from the product catalog. The article field setup is the same for this sample as for the Import article sample above.

Import pricelist

This sample will create or update price and VAT percentage for one or more articles in the product catalog.

import pricelist

Import stock balance

This sample will create or update the stock balance for one or more articles in the product catalog.

import stockbalance

Outbound services

Create order and get delivery package number

The outbound services sample is built inside the checkout flow plugin to enable integration with the outbound service when an order is created.

This example will only return dummy-data and the external reference is not implemented. (That reference and the real implementation are for the developer to implement in the solution.)

The outbound service example is found in the Litium.Studio.Integration.Sample-project. The service is located in file PricingRules\SampleCheckoutFlow.cs and Site\Integration\OutboundService.cs where you find the full implementation.

Asynchronous events

This sample will demonstrate how easily you make events that will be queued until they execute without errors. Use the asynchronous events together with outbound calls; otherwise the event will fail if the external system is down. When using asynchronous events, the event will be raised again to let the system try to reach the service again until the event is succeeded.

Update customer information

The sample project for the asynchronous events is found in the folder Events. The instance creation of the event handler is located in the Global.asax file found in the root-folder of the sample project.

The asynchronous events example in found in the Litium.Studio.Integration.Sample-project. The service is located in file Events\RelationOutbundEventListener.cs where you find the full implementation.

Is this page helpful?
Thank you for your feedback!