Please visit our new TrackAbout Knowledge Base at https://supportkb.trackabout.com for the most-up-to-date documentation on TrackAbout and TrackAbout Mobile.
Difference between revisions of "Receive From Customer Service"
(Created page with '=== Overview === This service accepts a request to verify that a cylinder is currently with a customer. A response will be sent back containing an error code and error message if…') |
|||
| Line 9: | Line 9: | ||
{{Web Service Metadata}} | {{Web Service Metadata}} | ||
| + | |||
| + | === Service Parameters === | ||
| + | |||
| + | The exact format and order of parameters can be retrieved from the service metadata. There are a number of standard web service parameters that most TrackAbout web services accept that are outlined in the metadata that are not included in the table below | ||
| + | |||
| + | {{Web Service SkipAutoVerify Param Table}} | ||
Revision as of 18:40, 23 February 2010
Overview
This service accepts a request to verify that a cylinder is currently with a customer. A response will be sent back containing an error code and error message if the validation fails.
You can also force a record to be created for the cylinder in TrackAbout by setting 'ContinueThroughErrors and Save' to true in the submitted request.
Service Protocol
TrackAbout has chosen to implement and architect this web service using what is typically referred to as REST style architecture. This is a resource oriented architecture that uses standard HTTP actions (i.e. GET, POST, DELETE, etc...) to manipulate resources exposed as URLs. Standard HTTP Status Codes are used for success and error codes.
More information on REST architecture can be found at the following resources:
Template:Web Service Authentication
Service Metadata
TrackAbout creates Web Application Description Language (WADL) documents for all web services that make use of REST architecture. The WADL for a service is accessible via the web service's URL with the word 'meta' appended as a query string parameter. For example, to access the WADL for the simple 'Echo' web service, you would use the following URL: https://www.trackabout.com/ws/Echo.asmx?meta
You can also specify a particular version of a web service to retrieve metadata for by including the major, minor, and revision numbers of the desired version in the query string. For example, to get the WADL for version 2.0.0 of the 'Echo' service, the URL becomes: https://www.trackabout.com/ws/Echo.asmx?v2.0.0&meta
More information on WADL can be found at the following resources:
Service Parameters
The exact format and order of parameters can be retrieved from the service metadata. There are a number of standard web service parameters that most TrackAbout web services accept that are outlined in the metadata that are not included in the table below
Other Service Parameters
In addition to the standard service parameters, this service also accepts the following parameters:
| Friendly Name | Query String Name | Description |
|---|---|---|
| Skip Auto Verify | skipAutoVerify | 'True' or 'False' value indicating whether or not the service should automatically verify any accounting adjustment records that may have been created in the process of performing the cylinder validation. This is an optional parameter and will default to 'false' if not provided. This means that, by default, any request to this service will automatically verify account adjustment records that get created. |