A post reservation sell request is sent when a Travel user attempts to book a ground transportation reservation.
application/xml
The Ground Transportation direct connect sends the relevant information to a URI that the travel supplier maintains. The standard location is:
https://{servername}/concur/groundtransportation
The URI is configured by the supplier when registering the partner application.
Authentication header with Base64 encoded basic authentication credentials (login ID and password) is required. The basic authentication credentials are established during the application review process.
Authorization: Basic {Base64 encoded LoginID:Password}
The request will contain a CC_LimoSellRequest parent element, containing the following child elements.
The corporate client the booking is on behalf of. This parent element contains the following child element:
The user booking the reservation. This parent element contains the following child elements:
The passenger contact name for the reservation. This parent element contains the following child elements:
The type of service requested. Will contain one of the following values:
The requested service class. Will contain one of the following values:
If this value is not provided by the user, it will default to 100
The pick up location. This parent element contains the following child elements:
The drop off location. This parent element contains the following child elements:
The time, in GMT, that the reservation must begin. Format: 2015-05-19T18:00:00
The time, in GMT that the reservation will end. Provided for hourly reservations. Format: 2015-05-19T18:00:00
Additional instructions about the pick up request.
Additional instructions about the drop off request.
The language of the traveler. Will be one of the following options:
The 3-letter ISO 4217 currency code for the reservation amount.
The number of passengers.
The discount code information. This parent element contains the following child elements:
The booked rate. This parent element contains the following child elements:
The vehicle details. This parent element contains the following child elements:
VehicleType: One of the following values:
VehicleID: Information to identify the specific vehicle.
The reservation vendor. This parent element contains the following child element:
The form of payment for the reservation. This parent element contains one of the following child elements:
The name of the requested driver, if available.
The details of the special service request, if available.
The details of the pickup arrangement, if available.
The details of the dropoff arrangement, if available.
####ExtraStopArrangement The details of the extra stop arrangement, if available.
The name of the requested driver, if available.
The IATA code for the airport.
Flight: The flight information. This parent element contains the following child elements:
The station code.
The name of the station.
The city the station is located in.
The state the station is located in. Preferably 2 characters, max 10 characters.
The train information. This parent element contains the following child elements:
The card type.
The card number.
The card expiration date. Format: 2013-02-19
The name on the card.
The street information of the billing address of the car.
The city of the billing address of the car.
The state of the billing address of the car. Preferably 2 characters, max 10 characters.
The country of the billing address of the car.
The postal code of the billing address of the car.
POST /concur/groundtransportation HTTPS/1.1
Host: example.com
Authorization: Basic ...
Content-Type: application/xml
Content-Length: {length of content body}
<CC_LimoSellRequest>
<CorporateClient>
<CompanyCode>339</CompanyCode>
</CorporateClient>
<Booker>
<UserID>55414</UserID>
<EmailAddress>cmiller@example.com</EmailAddress>
<Phone>5551234567</Phone>
</Booker>
<PrimaryPassenger>
<FirstName>Chris</FirstName>
<LastName>Miller</LastName>
<Phone>5551234567</Phone>
<Phone2>5551234568</Phone2>
<CellPhone>5551234569</CellPhone>
<EmailAddress>cmiller@example.com</EmailAddress>
</PrimaryPassenger>
<ServiceType>110</ServiceType>
<ClassOfService>100</ClassOfService>
<StartDateTime>2012-02-19T09:00:00</StartDateTime>
<EndDateTime />
<PickupInstructions>pick me up</PickupInstructions>
<DropoffInstructions>None</DropoffInstructions>
<LanguageCode>en-us</LanguageCode>
<RateInfo>
<RateID>1</RateID>
<Rate>42.50</Rate>
<RateTypeCode>100</RateTypeCode>
<CategoryCode />
<Currency>USD</Currency>
</RateInfo>
<Vehicle>
<VehicleType>Sedan</VehicleType>
<Description>This is a Sedan.</Description>
<MaxPassengers>1</MaxPassengers>
<VehicleID>12</VehicleID>
</Vehicle>
<Vendor>
<VendorCode>LML</VendorCode>
<VendorName>LimoVendor</VendorName>
<PhoneNumber>4354654654</PhoneNumber>
</Vendor>
<FormOfPayment>
<CreditCard>
<Type>VI</Type>
<Number>xxxxxxxxxxxx1111</Number>
<Expiration>2013-02-19</Expiration>
<NameOnCard />
<Address>209 MADISON ST. #400</Address>
<City>ALEXANDRIA</City>
<State>VA</State>
<Country>US</Country>
<PostalCode>22314</PostalCode>
</CreditCard>
</FormOfPayment>
<RequestedDriver />
<AccountingInfo>
<AccountingField1>715</AccountingField1>
<AccountingField2>temp@outtask.com</AccountingField2>
<AccountingField3>11</AccountingField3>
<AccountingField4>Development</AccountingField4>
<AccountingField5/>
</AccountingInfo>
</CC_LimoSellRequest>
The supplier responds to the Sell request by returning the details of the booked reservation.
application/xml
The response will include a CC_LimoSellReply parent element, with the following child elements:
Element | Required? | Description |
---|---|---|
Error | Y | The error information, if an error occurred. For information about the child elements of this parent element, see the Error elements table below. |
ReservationID | N | The identifier for the reservation. |
Status | N | The status of the reservation. The value will be one of the following: RB: Reservation Pending RA: Reservation Accepted (Reserved) RD: Reservation Declined |
ConfNum | N | The confirmation number for the reservation. |
CancelPolicy | N | The cancellation policy for the reservation. |
CancelNum | N | The cancellation number for the reservation. |
PrimaryPassenger | Y | The passenger contact name for the reservation. For information about the child elements of this parent element, see the PrimaryPassenger elements table below. |
ServiceType | Y | The type of service requested. Will contain one of the following values: 100: Point to point 110: One way to airport 111: One way from airport 120: One way to train station 121: One way from train station 200: Hourly 300: Airport to airport |
ClassOfService | N | The requested service class. Will contain one of the following values: 100: Normal 200: High 300: Highest If this value is not provided by the user, it will default to 100. |
PickupLocation | Y | The pick up location. For information about the child elements of this parent element, see the PickupLocation elements table below. |
DropoffLocation | Y | The drop off location. For information about the child elements of this parent element, see the DropoffLocation elements table below. |
StartDateTime | Y | The time, in GMT, that the reservation must begin. Format: 2015-05-19T18:00:00 |
EndDateTime | N | The time, in GMT that the reservation will end. Provided for hourly reservations. Format: 2015-05-19T18:00:00 |
PickupInstructions | N | Additional instructions about the pick up request. |
DropoffInstructions | N | Additional instructions about the drop off request. |
LanguageCode | Y | The language of the traveler. Will be one of the following options: en: English en-us: English (US) en-gb: English (UK) fr: French fr-ca: French (Canadian) de: German pt: Portuguese es: Spanish nl: Dutch it: Italian ja: Japanese pl: Polish pt-br: Portuguese (Brazilian) ru: Russian hu: Hungarian ko: Korean sv: Swedish zh-cn: Chinese zh-tw: Traditional Chinese |
Currency | Y | The 3-letter ISO 4217 currency code for the reservation amount. |
NumPassengers | N | The number of passengers. |
RequestedDriver | N | The name of the requested driver, if available. |
SpecialServiceRequest | N | The details of the special service request, if available. |
PickupServiceArrangement | N | The details of the pickup arrangement, if available. |
DropoffServiceArrangement | N | The details of the dropoff arrangement, if available. |
ExtraStopArrangement | N | The details of the extra stop arrangement, if available. |
RateInfo | Y | The booked rate details. Refer to the Rate Information elements table below for more information. |
Vehicle | Y | The vehicle details. For information about the child elements of this parent element, see the Vehicle elements table below. |
Vendor | Y | The reservation vendor. For information about the child elements of this parent element, see the Vendor elements table below. |
FormOfPayment | Y | The form of payment for the reservation. For information about the child elements of this parent element, see the FormOfPayment elements table below. |
RateDisclaimer | N | Disclaimer text about the rate. |
ProviderFeedback | N | Any additional feedback from the supplier. |
AccountingInfo | N | The accounting information for the reservation. This parent element contains one or more AccountingField elements: AccountingField1 through AccountingField5. These fields contain detailed accounting information. |
Element | Description |
---|---|
ErrorCode | The code for the error. Will contain one of the following values: 100: Pickup/dropoff location related error 200: Pickup/dropoff time related error 300: Other request parameters related error 400: Credential related error 500: No rate/service available 600: FOP related error 900: Unknown error |
ErrorSource | The source of the error. |
ErrorDescription | The additional error information. |
Element | Description |
---|---|
FirstName | The contact’s first name. |
LastName | The contact’s last name. |
Phone | The contact’s phone number. |
Phone2 | The contact’s backup phone number. |
CellPhone | The contact’s cell phone number. |
EmailAddress | The contact’s email address. |
Element Name | Required? | Data Type | Description |
---|---|---|---|
RateID | Y | The rate identifier. | |
Rate | Y | The BasePrice + ServiceCharge + SurCharge + Tax | |
RateTypeCode | Y | The code for the rate type. Will be one of the following options: F: Flat rate H: Hourly E: Estimated amount N: Currently not available |
|
CategoryCode | N | Extra information that will be passed back during sell request to help identify the rate. | |
Currency | Y | The 3-letter ISO 4217 currency code for the rate amount. | |
NoRateText | N | Explanation of rate type. Provided if RateTypeCode = N | |
MinHours | N | The minimum number of hours for the reservation. | |
DiscountType | N | The type of discount applied. | |
BasePrice | N | The reservation price without taxes, surcharges or service charges. | |
ServiceCharge | N | The service charge for the reservation. | |
SurCharge | N | This element contains the desc attribute, with text describing the reason for the surcharge. Example: <SurCharge desc="fuel"> |
|
Tax | N | The reservation tax. | |
ExtraPickupCharge | N | Any additional fees for the pickup service. | |
ExtraDropoffCharge | N | Any additional fees for the drop off service. | |
OptionalExtraStopCharge | N | The charge for any additional stops. | |
OptionalExtraTimeCharge | N | The charge for each additional hour. |
Element | Description |
---|---|
VehicleType | One of the following values: 100: Sedan 200: Limo 250: Stretch Limo 300: SUV 350: Stretch SUV 400: Van 450: Mini-Bus 500: Motor Coach 600: Shuttle 700: Trolley 800: Carriage 900: Any |
VehicleID | Information to identify the specific vehicle. |
Element | Description |
---|---|
VendorCode | The vendor code for the vendor. |
VendorName | The vendor’s name. |
PhoneNumber | The vendor’s phone number. |
Element | Description |
---|---|
CreditCard | If present, the passenger will pay with credit card. Refer to the Reply Credit Card elements table for the child elements. |
Cash | If present, the passenger will pay cash. |
Check | If present, the passenger will pay with a check. |
DirectBilling | If present, the passenger will pay through direct billing. |
Element Name | Required? | Description |
---|---|---|
Type | Y | The card type. |
Number | Y | The card number. |
Expiration | Y | The card expiration date. Format: 2013-02-19 |
HTTPS/1.1 200 OK
Content-Type: application/xml
Content-Length: {length of content body}
<CC_LimoSellReply>
<Error>
<ErrorCode />
<ErrorSource />
<ErrorDescription />
</Error>
<ReservationID>1234</ReservationID>
<Status>RB</Status>
<ConfNum>4444</ConfNum>
<CancelPolicy />
<CancelNum>55555</CancelNum>
<PrimaryPassenger>
<FirstName>Chris</FirstName>
<LastName>Miller</LastName>
<Phone>5551234567</Phone>
<Phone2>5551234568</Phone2>
<CellPhone>5551234569</CellPhone>
<EmailAddress>cmiller@example.com</EmailAddress>
</PrimaryPassenger>
<ServiceType>110</ServiceType>
<ClassOfService />
<PickupLocation>
<LocationType>100</LocationType>
<Airport>
<AirportCode />
<Flight>
<CarrierCode />
<FlightNumber />
<ArrivalDateTime />
</Flight>
</Airport>
<TrainStation>
<StationCode />
<StationName />
<City />
<State />
<Train>
<CarrierCode />
<CarrierName />
<TrainNumber />
<ArrivalDateTime />
</Train>
</TrainStation>
<Address>209 Madison St</Address>
<City>Alexandria</City>
<State>VA</State>
<Country>US</Country>
<PostalCode>22314</PostalCode>
<ExtraNotes />
</PickupLocation>
<DropoffLocation>
<LocationType>200</LocationType>
<Airport>
<AirportCode>DCA</AirportCode>
<Flight>
<CarrierCode>UA</CarrierCode>
<FlightNumber>333</FlightNumber>
<DepartureDateTime>2012-02-19T11:29:00</DepartureDateTime>
</Flight>
</Airport>
<TrainStation>
<StationCode />
<StationName />
<City />
<State />
<Train>
<CarrierCode />
<CarrierName />
<TrainNumber />
<DepartureDateTime />
</Train>
</TrainStation>
<Address />
<City />
<State />
<Country />
<PostalCode />
<ExtraNotes />
</DropoffLocation>
<StartDateTime>2012-02-19T09:00:00</StartDateTime>
<EndDateTime />
<PickupInstructions>pick me up</PickupInstructions>
<DropoffInstructions>None</DropoffInstructions>
<LanguageCode>en-us</LanguageCode>
<Currency>USD</Currency>
<NumPassengers>1</NumPassengers>
<RequestedDriver />
<SpecialServiceRequest />
<PickupServiceArrangement />
<DropoffServiceArrangement />
<ExtraStopArrangement />
<RateInfo>
<RateID>5</RateID>
<Rate>42.50</Rate>
<RateTypeCode>E</RateTypeCode>
<CategoryCode />
<MinHours />
<Currency>US</Currency>
<NoRateText />
<DiscountType />
<BasePrice>35.00</BasePrice>
<ServiceCharge>5.00</ServiceCharge>
<SurCharge desc="fuel">1.00</SurCharge>
<Tax>1.50</Tax>
<ExtraPickupCharge />
<ExtraDropoffCharge />
<OptionalExtraStopCharge />
<OptionalExtraTimeCharge />
<Message />
</RateInfo>
<RateDisclaimer />
<Vehicle>
<VehicleType>100</VehicleType>
<Description>This is a Sedan.</Description>
<MaxPassengers>1</MaxPassengers>
<VehicleID>12</VehicleID>
</Vehicle>
<Vendor>
<VendorCode>LML</VendorCode>
<VendorName>LimoVendor</VendorName>
<PhoneNumber>4354654654</PhoneNumber>
</Vendor>
<ProviderFeedback />
<FormOfPayment>
<Cash />
<Check />
<DirectBilling />
<CreditCard>
<Type>VI</Type>
<Number>XXXXXXXXXXXX1111</Number>
<Expiration>2013-02-19</Expiration>
</CreditCard>
</FormOfPayment>
<AccountingInfo>
<AccountingField1>715</AccountingField1>
<AccountingField2>temp@outtask.com</AccountingField2>
<AccountingField3>11</AccountingField3>
<AccountingField4>Development</AccountingField4>
<AccountingField5/>
</AccountingInfo>
</CC_LimoSellReply>