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
}
|
|