{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Basic car booking concepts","meta":[{"name":"robots","content":"noindex"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"basic-car-booking-concepts","__idx":0},"children":["Basic car booking concepts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page describes the basic concepts used by Spotnana APIs for car rental bookings."," ","Review this page before starting work with the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi"},"children":["Car APIs"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-is-a-car-booking","__idx":1},"children":["What is a car booking?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A car booking on the Spotnana platform represents a car rental reservation made by the traveler, an arranger, or by an agent."," ","Each booking is created through a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/spotnana/car_booking_workflow"},"children":["workflow"]}," that searches for available cars,"," ","retrieves rate details and pickup context (when specified), verifies the price, and finally creates the booking."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi"},"children":["Car APIs"]}," are designed for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["car rentals"]}," (i.e., the traveler picks up the car, drives it themselves, and returns it)."," ","These APIs do not support taxi/cab, ride-hailing, or chauffeured (e.g., Black car) transport bookings."," ","Chauffeured services are handled separately as black car bookings on the Spotnana Online Booking Tool."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-is-a-car-booking-related-to-a-trip","__idx":2},"children":["How is a car booking related to a trip?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every car booking on Spotnana must be associated with a ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/spotnana/basic_trip_concepts"},"children":["trip"]},"."," ","When a new car booking is created, a unique ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pnrId"]}," is generated by Spotnana,"," ","and this PNR ID is linked to a trip using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tripId"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the car booking is part of an existing trip (e.g., the traveler has already booked a flight or a hotel for the same trip),"," ","use the existing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tripId"]}," when creating the booking."," ","Otherwise, use the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/tripapi/trips/createtrip"},"children":["create trip"]}," API to create a new trip first."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To learn more about trips, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/spotnana/basic_trip_concepts"},"children":["basic trip concepts"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-difference-between-rate-details-and-rate-information","__idx":3},"children":["The difference between rate details and rate information"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi"},"children":["Car APIs"]}," use two terms that sound similar but mean very different things: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["rate details"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["rate information"]},"."," ","Understanding the distinction between them is essential for working with the APIs correctly."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"rate-details-context-around-a-selected-car","__idx":4},"children":["Rate details: context around a selected car"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rate details"]}," refers to the response from the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi/car/carratedetails"},"children":["get car rate details"]}," endpoint."," ","It returns detailed information about a specific car (e.g., vendor information) selected by the traveler."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi/car/carratedetails"},"children":["get car rate details"]}," response includes:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"35%","data-label":"Field"},"children":["Field "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickupLocation"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dropOffLocation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full location details including address, coordinates, counter location type (in-terminal, off-airport shuttle, etc.), operating schedule, and contact info."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vendor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The rental company's details (e.g., name, phone number, etc.)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["additionalDetails"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Free-text descriptions including driver age requirements, fuel policy, drop-off restrictions, fees, geographic restrictions, insurance notes, and shuttle information."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["co2Emission"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sustainability data (i.e., the CO2 emission value for the rental in kilograms)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isFlightNumberMandatoryForPickup"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates whether the traveler must provide their flight number when ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/spotnana/car_booking_workflow"},"children":["making a booking"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkoutApprovalInfo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/spotnana/process_approval_workflow"},"children":["Approval workflow"]}," details, including who needs to approve this booking and ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/spotnana/basic_approval_concepts"},"children":["what type of approval"]}," is required."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"rate-information-the-price-breakdown","__idx":5},"children":["Rate information: the price breakdown"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Rate information refers to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rateInfo"]}," field in the API response, which contains the actual price breakdown for a specific car offer."," ","This ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rateInfo"]}," field is returned in the following API responses:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For each offer in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi/car/carsearch"},"children":["car search"]}," response (under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cars"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rateInfo"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi/car/carpricecheck"},"children":["car price check"]}," response."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi/car/carpricecheck"},"children":["car price check"]}," API response contains ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rateInfo"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["finalRateInfo"]},". See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/car_guides/car_modification_guide#rate-difference-components"},"children":["rate difference components"]}," to learn more about their differences."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rateInfo"]}," field contains:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"30%","data-label":"Field"},"children":["Field "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carRateComponents"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The rate is broken down into components such as base rate, taxes, mandatory charges, total price, and modification rate differences (when applicable)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carExtras"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional add-ons available with the rental, such as child seats, GPS, ski racks, or additional drivers. Pricing for each add-on is displayed in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carExtras"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rateType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates whether the rate is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GUARANTEED"]}," (pay at the counter) or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PREPAID"]}," (pay upfront when the booking is made)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fareType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates one of the following fare types: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUBLISHED"]},": The retail rate set by the car vendor for all customers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CORPORATE"]},": Rates negotiated by the company on behalf of their travelers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SPOTNANA"]}," : Rates negotiated by Spotnana on behalf of its customers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TMC"]},": Rates negotiated by the TMC on behalf of their customer organizations."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refundable"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Indicates whether the rate is refundable."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dailyRates"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Per-day rate breakdown across the rental duration."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedPaymentTypes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payment method types (e.g., card payment) that can be used to book this rate."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pickup-and-drop-off-locations","__idx":6},"children":["Pickup and drop-off locations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/car_guides/car_search_guide"},"children":["Car rental search"]}," depends on where the traveler plans to pick up and return the car."," ","The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi"},"children":["Car APIs"]}," model this with rich location data, since the practical difference between"," ","an in-terminal counter and an off-airport shuttle pickup can significantly affect a traveler's plans."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"specifying-pickup-and-drop-off-in-a-search","__idx":7},"children":["Specifying pickup and drop-off in a search"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi/car/carsearch"},"children":["car search"]}," API request, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickup"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dropOff"]}," objects each contain a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["location"]}," and a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["datetime"]},"."," ","The location can be specified in one of the following ways:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"25%","data-label":"Field"},"children":["Field "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["airportCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The 3-letter IATA airport code (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SFO"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JFK"]},"). Returns rentals available at or near the specified airport."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cityCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.iata.org/en/publications/directories/code-search/"},"children":["IATA"]}," city code. Returns rentals available within the specified city's IATA code."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["coordinates"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Latitude and longitude coordinates. Returns rentals available near the specified geographic point."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The pickup and drop-off locations can be the same (round-trip rentals) or different (one-way rentals)."," ","For one-way rentals, the vendor may charge a drop-off fee, which appears in the rate components as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DROP_OFF_CHARGE"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"counter-location-types","__idx":8},"children":["Counter location types"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cars"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickupParams"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickupLocation"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["counterLocation"]}," field on the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi/car/carsearch"},"children":["car search"]}," API response"," ","indicates how the traveler accesses the rental counter."," ","This is important for trip planning because shuttle-based pickups can add extra time to the journey."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"width":"40%","data-label":"Field"},"children":["Field "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IN_TERMINAL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The counter is located inside the airport terminal. Travelers can walk directly from the gate to the counter."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ON_AIRPORT_RENTAL_SHUTTLE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The counter is located on airport property but requires a rental-company shuttle from the terminal."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OFF_AIRPORT_RENTAL_SHUTTLE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The counter is located off airport property and requires a shuttle. Travelers should expect additional travel time."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ON_AIRPORT_AIRPORT_SHUTTLE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The counter is on airport property and is reached via the airport's own shuttle service."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IN_TERMINAL_RENTAL_SHUTTLE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The counter is located inside the airport terminal but the cars themselves require a shuttle (provided by the rental company) to reach."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TWO_SHUTTLES_AIRPORT_AND_RENTAL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The pickup requires two shuttle rides: one airport shuttle from the terminal to the car check-in counter followed by a second rental-company shuttle that takes you to the car location."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CALL_FOR_SHUTTLE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The traveler must phone the vendor to arrange a shuttle pickup."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NON_AIRPORT_LOCATION"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The pickup is at a non-airport location (e.g., a downtown branch). The traveler must travel to this location from the airport on their own (e.g., using public transport or cab)."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"vendor-operating-hours","__idx":9},"children":["Vendor operating hours"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each location includes an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operatingSchedule"]}," and a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["weeklyOperatingSchedule"]}," describing when the vendor is open."," ","The operating schedule contains an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["interval"]}," with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DateTimeLocal"]},","," ","and the weekly schedule provides per-day-of-week operating hours."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Travelers should be informed of operating hours in advance, especially for late-night arrivals or early-morning returns."," ","If the traveler is arriving outside operating hours, the rental may not be possible without prior arrangement."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"contact-information","__idx":10},"children":["Contact information"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pickupLocation"]}," > ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contactInfo"]}," object on the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/openapi/carapi/car/carsearch"},"children":["car search"]}," API"," ","provides arrays of phone numbers, fax numbers, email addresses, and emergency phone numbers for the vendor at that specific location."," ","This information is useful for the traveler and should be kept accessible during the rental period."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sample-use-case","__idx":11},"children":["Sample use case"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Consider a traveler arriving at SFO airport. The search response might include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Vendor A with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["counterLocation"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IN_TERMINAL"]},". The traveler walks straight to the counter from baggage claim."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Vendor B with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["counterLocation"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OFF_AIRPORT_RENTAL_SHUTTLE"]},". The traveler must take a shuttle to reach the counter, adding 20 to 30 minutes travel time to their arrival."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Even if Vendor B's rate is cheaper, the in-terminal pickup may be preferable for travelers with tight schedules or heavy luggage."," ","Displaying the counter location prominently in the user interface helps the traveler make an informed choice."]}]},"headings":[{"value":"Basic car booking concepts","id":"basic-car-booking-concepts","depth":1},{"value":"What is a car booking?","id":"what-is-a-car-booking","depth":2},{"value":"How is a car booking related to a trip?","id":"how-is-a-car-booking-related-to-a-trip","depth":2},{"value":"The difference between rate details and rate information","id":"the-difference-between-rate-details-and-rate-information","depth":2},{"value":"Rate details: context around a selected car","id":"rate-details-context-around-a-selected-car","depth":3},{"value":"Rate information: the price breakdown","id":"rate-information-the-price-breakdown","depth":3},{"value":"Pickup and drop-off locations","id":"pickup-and-drop-off-locations","depth":2},{"value":"Specifying pickup and drop-off in a search","id":"specifying-pickup-and-drop-off-in-a-search","depth":3},{"value":"Counter location types","id":"counter-location-types","depth":3},{"value":"Vendor operating hours","id":"vendor-operating-hours","depth":3},{"value":"Contact information","id":"contact-information","depth":3},{"value":"Sample use case","id":"sample-use-case","depth":3}],"frontmatter":{"toc":{"enable":true,"maxDepth":3},"seo":{"title":"Basic car booking concepts"}},"lastModified":"2026-06-01T12:56:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/spotnana/basic_car_concepts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}