SWS SellRetailNoAccount Method
Creates an assessment for the sale of a retail item without having a Store account. Once you have a response, you will need to call the GetTotalDue method. This will provide the total amount that needs to be paid using the MakePayment method.
Parameters
Name | DataType | Is Required |
---|---|---|
Item | AVAIL_SITE_RETAIL_ITEMS | Required |
Description | The object containing the required item information. | |
OrgID | Long | Required |
Description | The organization’s ID number. | |
Quantity | Integer | Required |
Description | The total number of items to be sold. | |
TaxExemptNumber | String | Optional |
Description | If the company or individual is tax exempt, enter their tax ID number here. |
Returned Parameters
Name | DataType |
---|---|
AccountID | Long |
Description | The account’s ID number. |
AssessmentID | Long |
Description | An assessment ID is created for every assessment set up in store. |
Example
As with every method we need to pass in credentials. We do this with the LookupUser request object.
We will assume you have a web reference, let us name it SWS, in your Visual Studio project. At this point we need to define our objects. We will need the standard service object, a SellRetailNoAccount request object, and a SellRetailNoAccount response object. You will also need an item from the GetAvailablRetailItems method. We can define and create those like this:
// Create a request and response objects
SWS.WSSoapClient service = new SWS.WSSoapClient();
SWS.SellRetailNoAccount_Request request = new SWS.SellRetailNoAccount_Request();
SWS.SellRetailNoAccount_Response response;
SWS.GetAvailableRetailItems_Request retailItemReq =
new SWS.GetAvailableRetailItems_Request();
Here is a sample code of the request object (including some optional parameters):
// SellRetailNoAccount Request
retailItemReq.SiteID = 123456;
request.OrgID = 123456;
request.Quantity = 2;
request.Item = service.GetAvailableRetailItems
(user_request, retailItemReq).Details[0];
Finally we can call the method and pass across the login object and the request object to retrieve our requested information. 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.SellRetailNoAccount(user_request, request);
}
catch (Exception ex)
{
MessageBox.Show(ex.Message);
}
Note that if something goes wrong the service will respond with an exception. You will want to capture the message in the exception so it can be debugged.
For a full list of methods see SWS Methods.