Serial Number, Update
Updates an existing Serial Number using the supplied data and returns the details of the updated Serial Number.
URL
/api/serial-number-update
Request Method
POST
Expandable Program
Serial Number Editor (SOESN)
Required Fields
PART_ID
SERIAL_NUMBER
(at least one field to update)
AUTH_TOKEN
SERIAL_NUMBER
(at least one field to update)
AUTH_TOKEN
Auth Token
This API call requires an Authentication Token ("Auth Token") for the required field AUTH_TOKEN. Auth Tokens are obtained from Auth Token, Get.
Example Request JSON
{
"PART_ID": "MOTOR003",
"SERIAL_NUMBER": "GC00004057",
"ON_WARRANTY": "2015-06-05",
"NOTES": "Notes can be up to 32,765 characters long.",
"ATTACHMENTS": "http://www.expandable.com/|C:\\Expandable.docx",
"AUTH_TOKEN": ""
}Full Request JSON
{
"PART_ID": "",
"SERIAL_NUMBER": "",
"LOT_ID": "",
"SHIP_TO_CUST": "",
"SN_STATUS": "",
"STORES_CODE": "",
"STOCK_LOCATION": "",
"SO_ID": "",
"SO_LINE_NO": "",
"SHIPMENT_NO": "",
"SOLD_TO_CUST": "",
"BILL_TO_CUST": "",
"SHIPPED_DATE": "",
"SHIP_TYPE": "",
"RETURNED_DATE": "",
"DATE_SCRAPPED": "",
"RA_REASON": "",
"DWG_REV": "",
"ECN": "",
"ON_WARRANTY": "",
"OFF_WARRANTY": "",
"SERV_CONTRACT": "",
"CONTACT": "",
"LOCATION": "",
"REFERENCE": "",
"LAST_SERVICE": "",
"NEXT_SERVICE": "",
"SOFSN_USER_1": "",
"SOFSN_USER_2": "",
"SOFSN_USER_3": "",
"SOFSN_USER_4": "",
"SOFSN_USER_5": "",
"SOFSN_USER_6": "",
"SOFSN_USER_7": "",
"SOFSN_USER_8": "",
"SOFSN_USER_9": "",
"SOFSN_USER_10": "",
"SOFSN_USER_11": "",
"SOFSN_USER_12": "",
"NOTES": "",
"ATTACHMENTS": "",
"AUTH_TOKEN": ""
}Success Response
Returned HTTP status indicates success:
200/OK
Returned JSON contains the successfully updated Serial Number:
200/OK
Returned JSON contains the successfully updated Serial Number:
{
"PART_ID": "",
"SERIAL_NUMBER": "",
"LOT_ID": "",
"SHIP_TO_CUST": "",
"SN_STATUS": "",
"STORES_CODE": "",
"STOCK_LOCATION": "",
"FROM_STORES": "",
"FROM_LOCATION": "",
"SO_ID": "",
"SO_LINE_NO": "",
"SHIPMENT_NO": "",
"SOLD_TO_CUST": "",
"BILL_TO_CUST": "",
"SHIPPED_DATE": "",
"SHIP_TYPE": "",
"RETURNED_DATE": "",
"DATE_SCRAPPED": "",
"DATE_CONSIGNED": "",
"RA_REASON": "",
"DWG_REV": "",
"ECN": "",
"ON_WARRANTY": "",
"OFF_WARRANTY": "",
"SERV_CONTRACT": "",
"CONTACT": "",
"LOCATION": "",
"REFERENCE": "",
"LAST_SERVICE": "",
"NEXT_SERVICE": "",
"ORDER_ID": "",
"LINE_NUMBER": "",
"ORDER_REFERENCE": "",
"BATCH_NUMBER": "",
"PROGRAM_ID": "",
"ORIG_SO_ID": "",
"ORIG_SHIP_TO": "",
"ORIG_SHIP_DATE": "",
"LAST_INVOICE": "",
"SOFSN_USER_1": "",
"SOFSN_USER_2": "",
"SOFSN_USER_3": "",
"SOFSN_USER_4": "",
"SOFSN_USER_5": "",
"SOFSN_USER_6": "",
"SOFSN_USER_7": "",
"SOFSN_USER_8": "",
"SOFSN_USER_9": "",
"SOFSN_USER_10": "",
"SOFSN_USER_11": "",
"SOFSN_USER_12": "",
"CREATED_BY": "",
"DATE_CREATED": "",
"MODIFIED_BY": "",
"DATE_MODIFIED": "",
"OPERATOR_ID": "",
"DATE_LAST_UPDT": "",
"TIME_LAST_UPDT": "",
"NOTES": "",
"ATTACHMENTS": ""
}Failure Response
Returned HTTP status indicates failure:
400/Request JSON is invalid.
401/Auth Token was not provided.
401/Auth Token is malformed.
401/Auth Token login failure.
405/Request method must be POST.
500/(Error Message)
Returned JSON contains error information for the failed Serial Number update:
400/Request JSON is invalid.
401/Auth Token was not provided.
401/Auth Token is malformed.
401/Auth Token login failure.
405/Request method must be POST.
500/(Error Message)
Returned JSON contains error information for the failed Serial Number update:
{
"MESSAGE": "",
"MESSAGE_CODE": ""
}