SWS VoidRetailAssessments Method
Allows you to void an assessment for a retail item. A void can only be completed on the same day the item was assessed and prior to nightly processing.
Parameters
Name | DataType | Is Required |
---|---|---|
AssessID | Long | Required |
Description | The assessment’s ID number. This can be retrieved using the GetAssessments method. | |
SiteID | Long | Required |
Description | The site’s ID number. This can be found using the GetSiteList method. |
Returned Parameters
Name | DataType |
---|---|
AssessID | Long |
Description | The assessment ID number of the item that was voided. |
ErrorMessage | Boolean |
Description | A message with details about why the void failed. |
Success | Boolean |
Description | Indicates if the retail item was voided successfully (“True”) or not (“False”). |
Example
As with every method we need to pass in credentials. We do this with the LookupUser request object.
We’ll assume you’ve got a web reference, let’s name it SWS, in your Visual Studio project. At this point we need to our objects. We’ll need the standard service object, a VoidRetailAssessment request object and a VoidRetailAssessment response object. We can define and create those like this:
// Create a request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.VoidRetailAssessment_Request request = new SWS.VoidRetailAssessment_Request();
SWS.VoidRetailAssessment_Response response;
Here’s my sample code of the Request object.
// VoidRetailAssessments Request
request.SiteID = 123546;
request.AssessIDs = new long[] { 123456 };
Finally we can call the method and pass across the login object and the request object to void our retail assessment. It’s a good idea to do this in a Try Catch block.
// Call the method that will load the response object
try
{
response = service.VoidRetailAssessments(user_request, request);
}
catch (Exception ex)
{
MessageBox.Show(ex.Message);
}
Note that if something goes wrong the service will respond with an exception. You’ll want to take a look at that message returned in that exception so it can be debugged.
For a full list of methods see SWS Methods.