View source for Add/Modify/Delete of Order Data for POD (Paperless Delivery)

[[Web_Services|<< Back to Web Services]]

=== Overview ===
This service creates Orders (both Pending and Invoiced orders) in the system. 

{{Service Protocol RESTful}}

{{Service Authentication RESTful}}

{{Service Metadata RESTful}}

{{Service Standard Params RESTful}}

=== Validations and Restrictions ===

The following validations are applicable to the data and parameters provided to this service. If one or more of these validations fail, the web service will return a response status code and error message that indicates the source of the failure.

* The username and password provided must be valid
* The XML submitted must conform to the expected schema as outlined in the service metadata.

=== Processing Rules ===
* For pending orders, if an existing order is found in the system matching the order number, the existing order is updated. Otherwise, a new order is created. 
* For invoiced orders, if a delivery record is not found in the system matching the order number and customer, a delivery record is created in the system.
* Deletion is only supported for pending orders. A HTTP DELETE method is used for the deletion.

=== Request Output ===

When all provided data is processed without any errors, the service returns a HTTP status code of 200. When one or more processing errors are encountered, the HTTP status will be set to an HTTP error code. The body of the response will contain text describing the error that occurred. 

=== Usage ===

Production Environment

* '''Web Service URL:''' <nowiki>https://www.trackabout.com/ws/Orders.asmx</nowiki>
* '''Service WADL:''' https://www.trackabout.com/ws/Orders.asmx?meta

Test Environment

* '''Web Service URL:''' <nowiki>https://test.trackabout.com/ws/Orders.asmx</nowiki>
* '''Service WADL:''' https://test.trackabout.com/ws/Orders.asmx?meta