Warning
WARNING: The TrackAbout MetaWiki has been deprecated and is no longer being updated.

Please visit our new TrackAbout Knowledge Base at https://supportkb.trackabout.com for the most-up-to-date documentation on TrackAbout and TrackAbout Mobile.

Receive From Customer Service

From TrackAbout MetaWiki
Revision as of 18:40, 23 February 2010 by Jtaber (talk | contribs)
Jump to navigation Jump to search

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.