gettour

Returns the complete information of the tour.

💡 Full representation of a circuit. This is the main product that can be booked using this system considering a brochure and a departure date. We can identify a circuit through its itinerary code and brochure code. The same circuit can be repeated in different brochures.

We must distinguish two types of itineraries:

Tourist circuit (excursions): Short trip made for leisure, sport or study.

Circuit: An itinerary is a closed trip, usually predefined, that returns to the starting point when it ends.

Endpoints

https://newapi.vpttours.com/gettour

Postman request

{
  "logindata": {
    "useremail": "{{vpt_login}}",
    "userpass": "{{vpt_pass}}",
    "integrator_token": "XXXXXX"
  },
  "requestdata": {
    "brochure": 185,
    "code": 6971,
    "language": "1"
  }
}

Response

See responsegettour.json

Response fields

• catalog [int] → Catalog code the circuit belongs to.
• brochure [int] → Brochure code the circuit belongs to.
• code [int] → Circuit code.
• name [string] → Circuit name.
• minprice [int] → Minimum price per person in double.
• currency [int] → Currency code of the minimum price.
• length [int] → Duration in days.
• rates [array:rate] → Circuit categories.
• supplements [array:supplement] → Supplements of the circuit.
• discounts [array:discount] → Discounts of the circuit.
• departuredates [array:date] → Circuit departure dates.
• hotels [array:service] → Hotels included in the circuit.
• cities [array:city] → Cities the circuit passes through.
• itinerary [array:itineraryline] → Shows the day-by-day itinerary.
• optionals [array] → Informational list of optional services associated with the circuit. For booking data, use getoptionals.
• pickups [array:pickup] → Pick-up points.
• foodplan [int] → Returns food plan code, food plan name and codetype.
• trfin / trfout → Transfers (values: additional / included / not included).
• iatacitystart / iatacityend → IATA codes of the starting and ending cities.

Circuit optionals

The optionals node returned by gettour is informational only.

Do not use the brochure or code values from this node to book a circuit optional.

To obtain the booking data for an optional service, use getoptionals.

For circuit optional reservations, use the values returned by the same getoptionals item:

• codfovia → booktour.brochure
• coditine → booktour.code
• fechaini → booktour.date

If the same optional service appears more than once in getoptionals, treat each result independently and do not combine brochure, code, date or price values from different results.

Comportamiento

Currently, gettour also returns the codes of supplements (both optional and included) and discounts applied. This new tag groups the different types of supplements/discounts under a common concept code.

For example:

• codconce 15 groups all supplements related to transfers.
• codconce 17 groups supplements of meal plan.
• codconce 4 groups general discounts.

⚠️ Important: This codconce must not be confused with the code used when sending a quotation (getbookprice). In that case, what must be used is the codsuple (code) of each specific supplement or discount. codconce is only a grouping code for concepts; it does not replace the individual code of each item.