Consultar tarifas y disponibilidad

Consultar disponibilidad y costos de los vehículos.

Protocolo soportado:
HTTPS / TLS 1.2 - TLS 1.3
Endpoint:

Solicitud
Encabezados:
Accept-Encoding: gzip
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.goyEtVbG9naW5OYW1lIjoiURTLmqwCRJT05TIEdST1VQIEFTU09DSUFUT05TIFNSTCAyIiwiVWxvZ2luSUQiOiJSKLIMNCVI4MWU2YjUzZTc1ZWQxYzUwMzXXv98UMxYmIxNjliMDlhM2VlZmYxYzIyMDdhOwCvfAM1ZTA5ZjM4NDNq2jJhNGFjMDIwN2JhNGEzN2ZhNWQ3YWNmMzQ4OTQ0YjRmMDU3MTZmNGRmMDA1OGZmNzZhNiIsImlzcyI6ImFwaS5hYmctY2Fycy5jb20iLCJyZW50YWxjb21wYW55IjpbIkFWSVMiLCJCVURHRVQiXSwic2NvcGVzIjpbIlZlaFJldFJlc1JRIiwiVmVoQXZhaWxSYXRlUlEiLCJBdXRoVG9rZW5SUSIsIlZlaFJlc1JRIiwiVmVoTW9kaWZ5UlEiLCJWZWhDYW5jZWxSUSIsIlZlaEZsZWV0UlEiLCJWZWhMb2NhdGlvblJRIl0sImlhdCI6MTUxMTk4NTEzNCwiZXhwI2QASTg1MzE0fQ.Gy8hejPlT3KScb-g1x9KW2LSszESBSQO1zmZD4RTUIMz9e0yn8W6-UkYzxnlSdHsz1Z9Qe2CERCqpiqLUC
ejemplo consulta GET:
          
  https://api.carrental-int.com/v2/vehavailrate/?brand=AVIS&iata=1111111B&pickup_location=MIA&return_location=MIA&pickup_datetime=2020-02-20T10:00:00&return_datetime=2020-02-28T10:00:00&citizen_country_code=AR&age=26&vehicle_sipp_code=ECAR&rate_code=F2&discount_code=11111X0
                    
                           
Parámetros:
campodescripción
brand
string requerido
valores aceptados
  • AVIS
  • BUDGET
iata
string requerido
valores aceptados
Número IATA / Avis Assign / Budget Assign de la agencia.
pickup_location
string requerido
valores aceptados
código alfanumérico de oficina o aeropuerto de inicio de la renta (3 a 5 carácteres).
return_location
string requerido
valores aceptados
código alfanumérico de oficina o aeropuerto de finalización de la renta (3 a 5 carácteres).
pickup_datetime
string requerido
valores aceptados
día y hora de inicio de la renta (estándar ISO 8601 - YYYY-MM-DDThh:mm:ss).
return_datetime
string requerido
valores aceptados
día y hora de finalización de la renta (estándar ISO 8601 - YYYY-MM-DDThh:mm:ss).
citizen_country_code
string requerido
valores aceptados
código del pais de residencia del cliente (código de 2 carácteres - ISO 3166)
age
número requerido
valores aceptados
Edad del cliente.
vehicle_sipp_code
string requerido
valores aceptados
Código de la categoría del vehículo a consultar disponibilidad. (ingresando el valor ALL devolverá disponibilidad de todas las categorías, el uso de este valor deshabilitará la cotización de los equipamientos especiales y no serán mostrados en la respuesta)
rate_code
string requerido
valores aceptados
código de la tarifa. (ingresando el valor ALL devolverá disponibilidad de todas las tarifas de convenio habilitadas)
discount_code
string
valores aceptados
Código de descuento para aplicar a la consulta de disponibilidad.

Respuestas
respuesta HTTP: 200 OK
Ejemplo de respuesta exitosa :
          
{
  "appVersion": "2.0",
  "status": true,
  "brand": "AVIS",
  "environment": "QA",
  "availability": {
    "vehicle_group": {
      "A": {
        "vehicle": {
          "vehicle_group_code": "A",
          "vehicle_category_code": "ECAR",
          "vehicle_class_name": "Económico ",
          "vehicle_make_model": "Ford Fiesta or similar",
          "vehicle_details": {
            "name": "Ford Fiesta",
            "image_URL": "https:\/\/www.avis.com\/content\/dam\/cars\/l\/2019\/ford\/2019-ford-fiesta-se-5door-2wd-hatchback-grey.png",
            "seats": "5",
            "doors": "2-4",
            "air_conditioned": "true",
            "transmission": "auto",
            "large_suitcase": "0",
            "medium_suitcase": "1",
            "small_suitcase": "1"
          }
        },
        "Rates": {
          "F2": {
            "status": "Available",
            "rate_name": "F2 - INCLUSIVE + GAS",
            "rate_code": "F2",
            "pickup_datetime": "2020-02-20T10:00:00",
            "return_datetime": "2020-02-28T10:00:00",
            "discount_code": "11111X0",
            "rental_days": "8",
            "rate_distance": {
              "unlimited": "true",
              "distance_unit": "Mile",
              "distance_period": "RentalPeriod"
            },
            "total_charges": {
              "currency": "USD",
              "estimated_total_amount": "471.38",
              "rate_total_amount": "471.38"
            },
            "vehicle_charges": [
              {
                "description": "Minimum 1 Day(s); Maximum 59 Day(s)",
                "currency": "USD",
                "amount": "471.38",
                "included_in_rate": "true",
                "purpose": "1"
              },
              {
                "description": "CUSTOMER FACILITY FEE",
                "currency": "USD",
                "amount": "0.00",
                "included_in_rate": "true",
                "purpose": "6"
              },
              {
                "description": "$10.00    EXTENSION FEE MAY APPLY",
                "currency": "USD",
                "amount": "0.00",
                "included_in_rate": "false",
                "purpose": "28"
              },
              {
                "description": "FUEL POLICY IS FULL TO FULL",
                "currency": "USD",
                "amount": "0.00",
                "included_in_rate": "false",
                "purpose": "28"
              },
              {
                "description": "$15.00    LATE FEE MAY APPLY",
                "currency": "USD",
                "amount": "0.00",
                "included_in_rate": "false",
                "purpose": "28"
              },
              {
                "description": "STATE SURCHARGE",
                "currency": "USD",
                "amount": "0.00",
                "included_in_rate": "true",
                "purpose": "6"
              },
              {
                "description": "TIRE & BATTERY FEE",
                "currency": "USD",
                "amount": "0.00",
                "included_in_rate": "true",
                "purpose": "6"
              },
              {
                "description": "VEH. LICENSE FEE",
                "currency": "USD",
                "amount": "0.00",
                "included_in_rate": "true",
                "purpose": "6"
              },
              {
                "description": "NO SHOW FEE MAY APPLY",
                "currency": "",
                "amount": "",
                "included_in_rate": "false",
                "purpose": "28"
              }
            ],
            "special_equipment": [
              {
                "equipment_id": "9",
                "equipment_GDS_code": "BST",
                "equipment_description": "Asiento elevador para niños",
                "amount": "70.00",
                "currency": "USD",
                "included_in_rate": "false"
              },
              {
                "equipment_id": "7",
                "equipment_GDS_code": "CSI",
                "equipment_description": "Asiento para bebés",
                "amount": "70.00",
                "currency": "USD",
                "included_in_rate": "false"
              },
              {
                "equipment_id": "8",
                "equipment_GDS_code": "CST",
                "equipment_description": "Asiento para niños",
                "amount": "70.00",
                "currency": "USD",
                "included_in_rate": "false"
              },
              {
                "equipment_id": "13",
                "equipment_GDS_code": "GPS",
                "equipment_description": "Sistema de Navegación (GPS)",
                "amount": "116.98",
                "currency": "USD",
                "included_in_rate": "false"
              },
              {
                "equipment_id": "103",
                "equipment_GDS_code": "RSN",
                "equipment_description": "Asistencia en carretera",
                "amount": "56.92",
                "currency": "USD",
                "included_in_rate": "false"
              },
              {
                "equipment_id": "4",
                "equipment_GDS_code": "SKI",
                "equipment_description": "Rack para Esqui",
                "amount": "90.00",
                "currency": "USD",
                "included_in_rate": "false"
              },
              {
                "equipment_id": "55",
                "equipment_GDS_code": "WIF",
                "equipment_description": "WiFi",
                "amount": "175.92",
                "currency": "USD",
                "included_in_rate": "false"
              }
            ],
            "priced_coverages": [
              {
                "coverage_code": "TPL",
                "coverage_description": "Third Party Liability (TPL)",
                "tax_inclusive": "false",
                "included_in_rate": "true",
                "amount": "0.00",
                "currency": "USD"
              },
              {
                "coverage_code": "CDW",
                "coverage_description": "Collision Damage Waiver (CDW)",
                "tax_inclusive": "false",
                "included_in_rate": "true",
                "amount": "0.00",
                "currency": "USD"
              }
            ]
          }
        }
      }
    },
    "rate_inclutions": {
      "F2": [
        "Millaje libre",
        "Coberturas LDW y ALI",
        "Un tanque de gasolina",
        "Impuestos estatales y locales",
        "Recargo de Aeropuerto",
        "Conductor Adicional"
      ]
    },
    "LocationDetail": {
      "PickUpLocation": {
        "LocationName": "Miami Intl Airport",
        "LocationStreet": "3900 Northwest 25th Street, Suite 402",
        "LocationCity": "Miami",
        "LocationPostalCode": "33142",
        "LocationStateCode": "FL",
        "LocationStateName": "Florida",
        "LocationCountry": "US",
        "LocationCountryName": "Estados Unidos",
        "LocationPhoneNumber": "(1) 305-876-1800",
        "LocationCode": "MIA",
        "ExtendedLocationCode": "MIAT01",
        "LocationType": "Corporate",
        "CounterLocation": "S",
        "LocationLatitude": 25.796684,
        "LocationLongitude": -80.262,
        "AtAirport": "true",
        "OperationTime": {
          "Lunes": [
            "Abierto las 24 Horas"
          ],
          "Martes": [
            "Abierto las 24 Horas"
          ],
          "Miércoles": [
            "Abierto las 24 Horas"
          ],
          "Jueves": [
            "Abierto las 24 Horas"
          ],
          "Viernes": [
            "Abierto las 24 Horas"
          ],
          "Sábado": [
            "Abierto las 24 Horas"
          ],
          "Domingo": [
            "Abierto las 24 Horas"
          ]
        }
      },
      "ReturnLocation": {
        "LocationName": "Miami Intl Airport",
        "LocationStreet": "3900 Northwest 25th Street, Suite 402",
        "LocationCity": "Miami",
        "LocationPostalCode": "33142",
        "LocationStateCode": "FL",
        "LocationStateName": "Florida",
        "LocationCountry": "US",
        "LocationCountryName": "Estados Unidos",
        "LocationPhoneNumber": "(1) 305-876-1800",
        "LocationCode": "MIA",
        "ExtendedLocationCode": "MIAT01",
        "LocationType": "Corporate",
        "CounterLocation": "S",
        "LocationLatitude": 25.796684,
        "LocationLongitude": -80.262,
        "AtAirport": "true",
        "OperationTime": {
          "Lunes": [
            "Abierto las 24 Horas"
          ],
          "Martes": [
            "Abierto las 24 Horas"
          ],
          "Miércoles": [
            "Abierto las 24 Horas"
          ],
          "Jueves": [
            "Abierto las 24 Horas"
          ],
          "Viernes": [
            "Abierto las 24 Horas"
          ],
          "Sábado": [
            "Abierto las 24 Horas"
          ],
          "Domingo": [
            "Abierto las 24 Horas"
          ]
        }
      }
    },
    "TID": "310928a5-10b2-4fed-86a7-246e2c58ccec"
  }
}
                
Datos de la respuesta:
La respuesta del servicio será devueltan en formato array/objeto JSON (application/json)
 
campotipodescripción
appVersionstringNúmero de versión de la API
statusbooleanoestado de la respuesta al request, toma los valores "true/false" siendo "true" una respuesta normal positiva y "false" un error o fallo.
brandstringDevuelve la marca con la que se esta trabajando.
environmentstringEntorno en el que se esta trabajando: TEST (QA) o Producción (Production)
availabilityObjetoEngloba todos los datos de la consulta de disponibilidad
vehicle_groupObjetoDatos del grupo/categoría
{A}Objetogrupo correspondiente a la categoría consultada
vehicleObjetoEngloba todos los datos del vehículo
vehicle_group_codestringGrupo del vehículo
vehicle_category_codeObjetoCódigo de la categoría del vehículo(Estándar ACRISS).
vehicle_class_namestring Nombre de la clase a la que pertenece el vehículo
vehicle_make_modelstringMarca y modelo del vehículo reservado (solo a modo orientativo se confirman grupos o categorías, no marcas o modelos)
vehicle_detailsObjeto Detalles de equipamiento del vehículo.
namestringCódigo GDS del equipo/servicio requerido
image_URLstringURL de la imagen ilustrativa del vehículo
seatsstringCantidad de asientos
doorsstringCantidad de puertas
air_conditionedbooleanotoma el valor de true si el vehículo cuenta con aire acondicionado, false en caso de no poseerlo
transmissionstringTipo de caja de cambios (automática / manual)
large_suitcasestringCantidad de maletas grandes
medium_suitcasestringCantidad de maletas medianas
small_suitcasestringCantidad de maletas pequeñas
RatesObjetoEngloba todos los datos de las tarifas disponibles
{F2}Objetocódigo de la tarifa - engloba los datos y valores de la tarifa
statusstringEstado del grupo para reservar (Available/OnRequest)
rate_namestringnombre comercial de la tarifa.
rate_codestringcódigo de la tarifa.
pickup_datetimeTimedía y hora de inicio de la renta (estándar ISO 8601 - YYYY-MM-DDThh:mm:ss)
return_datetimeTimedía y hora de finalización de la renta (estándar ISO 8601 - YYYY-MM-DDThh:mm:ss)
discount_codestringCódigo de descuento aplicado en la consulta (Si hubiera sido suministrado al momento de realizar la consulta).
rental_daysnúmerocantidad total de días a reservar
rate_distanceObjetoInformación sobre las opciones y limitaciones de distancia de la renta.
unlimitedbooleanoToma el valor de true si es ilimitada, false en caso de existir un limite máximo
quantitynúmeroCantidad de distancia a recorrer sin costo adicional incluida en la tarifa (solo si unlimited es igual false)
distance_unitstringUnidad de medida de la distancia
total_chargesObjetoCargos totales de la tarifa
currencystringmoneda de los valores expresados en la tarifa
estimated_total_amountnúmeroTotal estimado de los gastos de la reserva (tarifa + impuestos + cargos obligatorios del vehículo).
rate_total_amountnúmeroTotal estimado de la tarifa.
taxObjetoImpuestos obligatorios de la renta
tax_total_amountnúmeroTotal de los impuestos y cargos obligatorios sobre la renta (si los hubiere)
tax_currencystringMoneda de los valores expresados en los cargos e impuestos
descriptionstringDescripcion del cargo o impuesto
vehicle_chargesArrayDetalle e información de los cargos obligatorios y opcionales del vehículo
descriptionstringdescripción del cargo
amountnúmerocosto del cargo
currencystringMoneda del valor expresado en el cargo
included_in_ratestringIndica si el valor esta incluido en el monto total estimado.
purposenúmero Código OTA númerico especificando:
 
  • 1  Vehicle rental
  • 2  One way fee
  • 5  Upgrade
  • 5  Airport/City/Other Surcharge
  • 5  Airport Concession Fee
  • 5  Under Age Surcharge
  • 6  Additional Distance Charge
  • 6  Vehicle Registration Fee
  • 6  Israel Stamp Duty
  • 7  Local Tax
  • 7  Austrian Contract Tax
  • 7  Goods and Services tax
  • 8  Additional mileage / additional distance charge
  • 9  Additional Week
  • 10  Additional Day
  • 11  Additional Hour
  • 13  Under Age Surcharge
  • 22  Pre Pay Fee
  • 28  Optional Fee
PPDcommissionable_itembooleanoIndica si el cargo puede ser comisionable. Toma el valor true en caso afirmativo. El cargo marcado como true solo será comisionable si se hace prepago.
special_equipmentArrayEquipamiento y servicios opcionales del vehículo y la reserva a requerir (Esta clave no se mostrará si el campo "vehicle_sipp_code" en la consulta fue seteado en "ALL"
equipment_idnúmeroNúmero identificatorio del servicio/equipo
equipment_GDS_codenúmeroCódigo GDS del equipo/servicio requerido
equipment_descriptionnúmeroDescripción del equipo/servicio requerido
amountnúmerocosto del cargo
currencystringMoneda del valor expresado del equipo/servicio
included_in_ratestringIndica si el valor esta incluido en el monto total estimado.
priced_coveragesArrayInformación de las coberturas básicas incluidas en la tarifa
rate_inclutionsArrayInclusiones de las tarifas
LocationDetailObjetoDatos de las oficinas de inicio y retorno de la renta
PickUpLocationObjetoOficina de inicio de la renta (Nombre, Dirección, Código de oficina, Latitud, Longitud, Horarios, etc).
ReturnLocationObjetoOficina de retorno de la renta (Nombre, Dirección, Código de oficina, Latitud, Longitud, Horarios, etc).
TIDstringidentificador de transacción que se utiliza para individualizar una solicitud determinada. Se puede utilizar para revisar problemas con una solicitud en particular.
Errores de solicitud
respuesta HTTP: 400 Bad Request
Si se encuentra algún tipo de error en la solicitud (parámetros / headers / expiración del token de acceso) recibirá un error similar al siguiente:
 
{
  "appVersion": "2.0",
  "status": "false",
  "brand": "AVIS",
  "environment": "QA",
  "error": "invalid_request",
  "error_description": "Missing parameters. Please check required parameters"
}
                            
respuesta HTTP: 404 Not Found
Si hubiera algún error en el rate code / categoria de vehículo o algún otro error general, recibirá un mensaje similar al siguiente:

{
  "appVersion": "2.0",
  "status": false,
  "error": "rate_error",
  "error_description": "Rate code error, check available rate codes with your sales executive",
  "brand": "AVIS",
  "environment": "QA",
  "availability": null
}