Add

Functions

Add Item Price is used to add a price and price information to the items of a sales order.

URL-{Root URL}/API/SO/PriceAdd/{API Key}

Parameters

Parameter  Description Required Comment
SoNo Sales Order Number Y  
price Sales Order Price Y
taxable Is the SO Taxable N Can be 'true' or 'false'
flat
   
recordType      
saleTypeID Sales Type ID N Can be 'CABLE/Harn', 'CONSULTING', 'LABOR', 'OTHER', 'PC ASSEMB.', 'PRIORITY', 'REPAIR', 'RESTOCKING', 'REWORK', 'SPARE PART', 'STENCILS', 'SYSTEM'
extended    
uniqueLn Unique Sales Order item identifier  Y Must be unique. 
plpricelink Price Link Key N Must be unique. 

Example Strings

 

Add Price

URL-?SoNo=SONO&uniqueln=UNIQUELN&price=1&taxable=1&flat=1&saletypeid=RESTOCKING

JSON

{

'SoNo':'785',

'uniqueln':'UNIQUELN',

'price':'1',

'taxable':'1',

'flat':'1',

'saletypeid':'RESTOCKING'

}

A successful add should return

{

$id: "1",

Code: 200,

Message: "Sales Order Price added successfully.",

SessionId: null,

IsValidUser: true,

ResponseObject: null

}

Common Errors

API Key Error

If there is an error with the API key the system will return an error message.

{

"$id": "1",

"Code": 403,

"Message": "Invalid API Key.",

"SessionId": null,

"IsValidUser": false,

"ResponseObject": null

}

URL Error

If there is an error with the entered URL has an error the system will return a "HTTP Resource not found" message.

{

"$id": "1",

"Message": "No HTTP resource was found that matches the request URI 'http://localhost/api/SOPriceAdd/23456789'.",

"MessageDetail": "No type was found that matches the controller named 'SOPriceAdd'."

}

Parameter Error

If one of the entered parameters is invalid the system will fail to add the item price.

{

"$id": "1",

"Code": 403,

"Message": "Sales Order item with uniqueLn:'' does not exits in SO:'0000000799'.",

"SessionId": null,

"IsValidUser": true,

"ResponseObject": null

}