This element is used to initiate communication between Arghon and a business (service provider).
1. Sent by Arghon to request taxi/limousine service.
2. It can be sent by Arghon to update or cancel an existing taxi/limousine request.
Your developer key.
This is your transaction ID. It allows your web-service to map Arghon requests to ones in your system.
For new requests, the value will be left blank. We will however, include it in all follow up interactions.
transactionid should be valid across interaction sessions (until the request is canceled or expired).
This ID is generated by our AI Engine and is used to identify all requests in our system.
This ID must be included in ALL communication responses to Arghon..
Text
55
customerid is used by service providers such as doctors to identify an Arghon user in their system.
This could be a customer Number, phone number - it is up to each service provider to determine what this field is used for.
This customerid should be provided to Arghon users so they'll have it when configuring your business as their service provider.
Note: Many business use the user's email or phone number as customerid to uniquely identify their customers or clients.
For businesses such as restaurants, this ID is not needed and will be set to an empty string.
The first name of the Arghon user making the request.
Sent only when servicerequested = transport_request.
The phone number of the Arghon user making the request.
Sent only when servicerequested = transport_request.
The destinationaddress. Could also be the name of an important landmark such as JFK (airport).
Sent only when servicerequested = transport_request or information_request.
This optional value is the location on the map of the destination. Example 28.39485
Sent only when servicerequested=transport_request or information_request if it's available.
This optional value is the location on the map of the destination. Example -73.38938
Sent only when servicerequested=transport_request or information_request if it's available.
The pick up location address. Could also be the name of an important landmark such as JFK (airport).
Sent only when servicerequested = transport_request or information_request.
This optional value is the location on the map of the pick up location.
Example 28.39485.
Note: When servicerequested = status_request this is the current location of the person to be picked up.
This optional value is the location on the map of the pick up location.
Example -73.38938
Note: When servicerequested = status_request this is the current location of the person to be picked up.
A floating point number that represents the total payment amount including tip the passenger paid in local currency.
Example: 12.58
Sent when the servicerequested = payment_request.
A floating point number that represents the tip portion of the payment_total in local currency.
Example: 3.00
Sent when servicerequested = payment_request.
The XML date/time the passenger needs to be picked up. Format YYYY-MM-DDTHH:MM:SS
Sent when servicerequested = information_request or transport_request.
A number in minutes the passenger is willing to wait for the taxi or limousine to get to the pick up location.
If a transport cannot be dispatched in this time then the "vehicle unavailable" error should be returned.
Failure to follow this rule will result in a lowering of your company's rating.
Sent when servicerequested = information_request or transport_request.
This is your transaction/system ID for tracking this interaction.
The transaction will be included in all follow up correspondence between Arghon and your web-service.
The transaction ID should be valid until the appointment,reservation, etc. has expired.
For cancel_request and availablilty_request, this value may be left blank.
This is the ID that was sent in the request. The ID was generated by Arghon and is used to identify all requests in our system.
This ID must be included in this response or it will be rejected.
Text
55
he earliest expected time the taxi/limousine will be at the pick up location,even if one is not availble
within the wait time the passenger specified. Must be send when errorcode equal "0" or "1".
A floating point number that represents the estimated cost of the trip in local currency. Example: 12.58
The phone number of the dispatcher. The user may call this number to get assistance and information.
An optional image of the vehicle that will help the passenger identify the taxi/limousine when it arrives.
This is the exact coordinate/location of the pick up vehicle. Example 28.39485.
Note: Must be included when servicerequested = status_request.
This is the exact coordinate/location of the pick up vehicle. Example -73.38938
Note: Must be included when servicerequested = status_request.
This will allow us to make changes to the xml schema without breaking existing services.
The request was successful.
The pick up time requested is unavailable, The earliest pick up time is provided. (must be in pickup_time).
The trip has completed.
The party making the request is unrecognised. Most likely an invalid developer key.
The time requested is unavailable. no alternatives are suggested.
The transaction ID provided in the request is invalid. This should not really occur as we will
send the transactionid you sent us. The transactionid must be valid until the appointment
reservation has expired.
The transactionid is unknown. no action taken.
The system is unavailable at this time. Please retry the request later.
Request must be sent using SSL.
Data must be sent as xml.
Data must be sent as xml in HTTPS POST.
Data must be sent as xml in HTTPS POST.
One or more elements in the xml is missing or contain invalid values.
The system is unavailable to process your request at this time.
Invalid service request type specified.
Sent to get the earliest time a taxi/limousine will be available.
Sent to request a taxi/limousine pick up.
Sent to request cancel a taxi/limousine pick up.
if the trip has been completed return errorcode 2.
Sent to tell the company the user has paid for the trip. See the payment_total and payment_tip fields for more information.
A. Sent to get the current coordinate/location of the taxi/limousine vehicle.
B. pickup_latitude/pickup_longitude has the exact coordinate/location of the passenger to be picked up.
Note: As the vehicle gets closer to the user's location the status_request will be sent more freequently,
Up to a maximum of once every 30 seconds.
This allows both the taxi company/driver and the passenger to track on a map the location of both parties.