This web service operation enables you to retrieve all information associated with an existing Estes pickup request via the unique pickup ID.
Request/Reply – This is a communication pattern where the service requester sends a request to the service provider. The service provider processes the request and returns a reply to the requester. This is an on-time operation, which means that there are no (long) time intervals between sending the request, processing of the request and sending the reply.
A valid request number is required.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:est="http://estespickup.base.ws.provider.soapws.pickupRequest">
User authentication and authorization work the same for all web service operations. See Errors & Exceptions below for failures.
If the pickup request cancellation is successful, a message with the unique pickup request number will be returned that confirms this success. Below is an example of such a response:
<ser-root:cancelPickupRequestWSResponse xmlns:ser-root="http://estespickup.base.ws.provider.soapws.pickupRequest" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<result>Pickup request 50396 has been cancelled.</result>
The web service authentication will fail if the user is not authorized. Authentication will also fail if the username and password are not from a valid and active My Estes profile.
An error code and description in the following format will be returned to the user in the event that a business validation rule is violated:
<description>Shipper state must be a valid state abbreviation.</description>
Business validation error codes have 3 letters followed by 4 numbers.
Several error conditions will cause exceptions (faults) in the web service. You can view these error codes and their associated descriptions as a PDF or downloaded as a CSV.