API Consumption

API Operations can be performed from Developer portal and client applications with a few prerequisites and authentication processes.

The APIs can be consumed by following the steps mentioned below.

Developer portal

Sign up to the developer portal.
Login to the developer portal at https://westconapi.developer.azure-api.net/
Select APIs option from the Menu bar, so that you will be directed to the APIs page where you need to select a relevant API.

In the selected API section, you can see the sample request and response.

Sample Request and Response

Click on Try it button in the API detail page, where you can see the authorization details.
In the Authorization section, select value as "Client credentials" from dropdown values for "apiuat_oauth"
key as marked in the below screenshot.
Upon selecting the client credentials from the drop-down, you will get a popover screen which requests you to Authorize.
Authorize Once your request will get authorized after which you can send the request to get a response.

Authorization Screenshot 4

Authorization Screenshot 5

Response Test

Client applications

test

Westcon API’s can be accessed by authorized client applications only.

The Westcon support team will register the application and provide the client credentials through which the client would
get an access token
to consume the API’s.

API call to get Access Token

HTTP Method

Post
Request URL

https://login.microsoftonline.com/ec8933c6-cfb2-4dd9-bfc9-621cde1dea8f/oauth2/token
Request Body Type

x-www-form-urlencoded
Request Body Parameters

client_id

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

client_secret

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

grant_type

client_credentials

Sample Request

grant_type=client_credentials&client_id=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx&client_secret=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Response

{
    "token_type": "Bearer",
    "expires_in": 3599,
    "ext_expires_in": 3599,
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6IkxQSmJr..."
}

API call to get Order Status

HTTP Method

Post
Request URL

https://api.westconcomstor.com/Orders/orderStatus
Request Headers

Authorization

This values should be a Bearer token which we received from Microsoft Login

Developer can find this Subscription Key in Profile

Content-Type

application/json

Request Body

{ 
  "mT_OrderStatus_API_REQ": { 
  "partnerKey": "0****************3",   
  "orderType": "W",   
  "language": "EN",   
  "order":[
          "6****4",
          "6****9"
          ]
 }
}

Sample Response:

{
  "MT_OrderStatus_Response": [{
      "eRPOrderNumber": "0********4",
      "eRPOrderLineNumber": "0****0",
      "customerOrderNumber": "Rb****-03",
      "customerLineNumber": "",
      "eRPProductNumber": "T****3",
      "lineQuantity": "         2.000",
      "unitOfMeasure": "EA",
      "lineStatusCode": "INV",
      "lineStatusDescription": "Invoiced",
      "statusDate": "yyyymmdd",
      "shipDate": "yyyymmdd",
      "billingDocument": "0*******7",
      "parentERPLine": "0****0"
    },
    {
      "eRPOrderNumber": "0********4",
      "eRPOrderLineNumber": "0****0",
      "customerOrderNumber": "Rb****03",
      "customerLineNumber": "",
      "eRPProductNumber": "T****3",
      "lineQuantity": "         2.000",
      "unitOfMeasure": "EA",
      "lineStatusCode": "INV",
      "lineStatusDescription": "Invoiced",
      "statusDate": "yyyymmdd",
      "shipDate": "yyyymmdd",
      "billingDocument": "0*******7",
      "parentERPLine": "0****0"
    },
    {
      "eRPOrderNumber": "0********9",
      "eRPOrderLineNumber": "000010",
      "customerOrderNumber": "VC REGULAR MFR SN",
      "customerLineNumber": "",
      "eRPProductNumber": "U************U",
      "lineQuantity": "         1.000",
      "unitOfMeasure": "EA",
      "lineStatusCode": "SHI",
      "lineStatusDescription": "Shipped",
      "statusDate": "yyyymmdd",
      "shipDate": "yyyymmdd",
      "billingDocument": "",
      "parentERPLine": "0****0"
    },
    {
      "eRPOrderNumber": "0********9",
      "eRPOrderLineNumber": "000020",
      "customerOrderNumber": "VC REGULAR MFR SN",
      "customerLineNumber": "",
      "eRPProductNumber": "C***********T",
      "lineQuantity": "         2.000",
      "unitOfMeasure": "EA",
      "lineStatusCode": "SHI",
      "lineStatusDescription": "Shipped",
      "statusDate": "yyyymmdd",
      "shipDate": "yyyymmdd",
      "billingDocument": "",
      "parentERPLine": "0****0"
    }
  ]
}

Sample Client application

Extract the code and change the configuration values as required in web.config file.

Please click here to download the Source code.

Once the zip file is downloaded, extract the file and navigate to the web.config file.

Add the below configuration values in "appSettings" section of Web.config file.

Configuration values:

< add key="client_id" value="3a****48-2**7-4**f-b**8-1****5d****9" />

< add key="client_secret" value="GpR****B.z****X.*5:J****3IR****nR" />

< add key="resource" value="e4****f9-b**f-4**7-a**b-e****e6****4" />

< add key="subscriptionKey" value="bb****************************68" />

Build and Run the Solution.

Required fields for a successful order request

Partner Key: Include the partner key provided by Westcon.

Order Type:
W: Westcon Order Number. Type in W, if you have the Westcon Order Number.

C: Customer Order Number. Type in C, if you have your own Customer Order Number.
Language: Select the required language.

Order Number: Include one or more Order Numbers in the Orders block. You cannot mix and match Customer and Westcon Order Numbers.