Functions
The Sales Order (SO) Edit Item Price is used to modify a price or price-related information for the items on an SO.
URL
{Root URL}/API/SO/PriceEdit/{API Key} |
Parameters
| Parameter | Description | Required | Comment | |
| 1 | SoNo | Sales order number | Y | |
| 2 | price | Sales order price | Y | |
| 3 | taxable | Is the SO taxable | N | Can be "true" or "false." |
| 4 | flat | |||
| 5 | recordType | |||
| 6 | salesTypeID | Sales type ID | N | Can be “CABLE/Harn”, “CONSULTING”, “LABOR”, “OTHER”, “PC ASSEMB.”, “PRIORITY”, “REPAIR”, “RESTOCKING”, “REWORK”, “SPARE PART”, “STENCILS”, or “SYSTEM.” |
| 7 | extended | |||
| 8 | uniqueLn | Unique sales order item identifier | Y | Must be unique, and you cannot use a line number (i.e., line_no). |
| 9 | plpricelink | Price link key | Y | Must be unique. |
Example Strings
SO Edit the Item Price
URL
?SoNo=SONO&UNIQUELN=UNIQUELN&PLPRICELNK=PLPRICELNK&price=1.2&taxable=1&flat=1&saletypeid=RESTOCKING |
JSON
{ “SoNo”:”SONO”, “UNIQUELN”:”UNIQUELN”, “PLPRICELNK”:”PLPRICELNK”, “price”:”1.2”, “taxable”:”1”, “flat”:”1”, “saletypeid”:”RESTOCKING” } |
A successful request should return the following:
{ "$id": "1", "Code": "403", "Message": "Sales Order Price edited 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, the system will return an "HTTP Resource not found" message:
{ "$id": "1", "Message": "No HTTP resource was found that matches the request URI 'http://localhost/api/SOPriceEdit/23456789'.", "MessageDetail": "No type was found that matches the controller named 'SOPriceEdit'." } |
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" } |
Missing Required Parameter
If a required parameter is missing, the system will return an error message describing the parameter missing:
{ "$id": "1", "Code": "403", "Message": "PlPriceLnk not provided.", "SessionId": "null", "IsValidUser": "true", "ResponseObject": "null" } |