Avis - Budget Developers

Protocolo soportado:

HTTPS / TLS 1.2 - TLS 1.3

Endpoint:

POST
https://api.carrental-int.com/v2/vehreservation/

Solicitud

headers:

Content-Type: Requerido
header válido: Content-Type: application/json

Authorization: Requerido
header válido: Authorization: Bearer token_de_acceso

Accept-Encoding: opcional
header valido: Accept-Encoding: gzip
Para minimizar la latencia de la respuesta incluya este header para solicitar una versión comprimida.

Ejemplo

headers:

Content-Type: application/json
Accept-Encoding: gzip
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.goyEtVbG9naW5OYW1lIjoiURTLmqwCRJT05TIEdST1VQIEFTU09DSUFUT05TIFNSTCAyIiwiVWxvZ2luSUQiOiJSKLIMNCVI4MWU2YjUzZTc1ZWQxYzUwMzXXv98UMxYmIxNjliMDlhM2VlZmYxYzIyMDdhOwCvfAM1ZTA5ZjM4NDNq2jJhNGFjMDIwN2JhNGEzN2ZhNWQ3YWNmMzQ4OTQ0YjRmMDU3MTZmNGRmMDA1OGZmNzZhNiIsImlzcyI6ImFwaS5hYmctY2Fycy5jb20iLCJyZW50YWxjb21wYW55IjpbIkFWSVMiLCJCVURHRVQiXSwic2NvcGVzIjpbIlZlaFJldFJlc1JRIiwiVmVoQXZhaWxSYXRlUlEiLCJBdXRoVG9rZW5SUSIsIlZlaFJlc1JRIiwiVmVoTW9kaWZ5UlEiLCJWZWhDYW5jZWxSUSIsIlZlaEZsZWV0UlEiLCJWZWhMb2NhdGlvblJRIl0sImlhdCI6MTUxMTk4NTEzNCwiZXhwI2QASTg1MzE0fQ.Gy8hejPlT3KScb-g1x9KW2LSszESBSQO1zmZD4RTUIMz9e0yn8W6-UkYzxnlSdHsz1Z9Qe2CERCqpiqLUC

Body Request:


 {
	"brand":"BUDGET",
	"iata":"11111111",
	"first_name": "PARTNER",
	"last_name": "ATESTO",
	"citizen_country_name":"AR",
	"age":"26",
	"pickup_datetime":"2020-05-06T10:00:00",
	"return_datetime":"2020-05-13T10:00:00",
	"pickup_location":"MIA",
	"return_location":"MIA",
	"rate_qualifier":"LQ",
	"sipp_code":"ECAR",
	"discount_code":"XXXX9XX",
	"coupon_code":"",
	"avis_budget_rewards":"",
	"membership_code":"",
	"airline_code":"",
	"flight_number":"",
	"frecuent_flyer_number":"",
	"special_equipment": [
		{
		  "equipment_code":"RSN",
		  "quantity":"1"
		},
		{
		  "equipment_code":"GPS",
		  "quantity":"1"
		}
	]
}

Cuerpo de la solicitud (Body)

campo	descripción
brand string requerido	valores aceptados AVIS BUDGET
iata string requerido	valores aceptados Número IATA / Avis Assign / Budget Assign de la agencia.
first_name string requerido	valores aceptados Nombre del titular de la reserva.
last_name string requerido	valores aceptados Apellido del titular de la reserva.
citizen_country_name 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.
pickup_datetime time requerido	valores aceptados día y hora de inicio de la renta (estándar ISO 8601 - YYYY-MM-DDThh:mm:ss).
return_datetime time requerido	valores aceptados día y hora de finalización de la renta (estándar ISO 8601 - YYYY-MM-DDThh:mm:ss).
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).
rate_qualifier string requerido	valores aceptados código de la tarifa a reservar.
sipp_code string requerido	valores aceptados Código de la categoría del vehículo a reservar.
discount_code string	valores aceptados Código de descuento para aplicar a la reserva.
coupon_code string	valores aceptados Cupón promocional para aplicar a la reserva.
avis_budget_rewards string	valores aceptados Código identificador del agente en el programa Unlimited Rewards.
membership_code string	valores aceptados Avis Wizard Number or Budget Fastbreak/rapidRez/Online ID Number.
airline_code string	valores aceptados código IATA de linea aérea (2 carácteres).
flight_number string	valores aceptados Número de identificación asignado por la línea aérea al segmento del vuelo.
frecuent_flyer_number string	valores aceptados Número/ID de viajero frecuente del cliente en la linea aérea.
special_equipment array	valores aceptados Array de equipos/servicios opcionales a requerir en la reserva. Ver tabla de servicios / equipos opcionales equipment_code string requerido Código GDS del equipo/servicio a requerir quantity number requerido Cantidad solicitada del item.

Respuestas

respuesta HTTP: 200 OK

Ejemplo de respuesta exitosa :

          
{
  "appVersion": "2.0",
  "status": true,
  "message": "Success - The reservation was successfully created",
  "brand": "BUDGET",
  "environment": "QA",
  "reservation_response": {
    "customer": {
      "first_name": "PARTNER",
      "last_name": "ATESTO",
      "citizen_country_code": "AR"
    },
    "reservation": {
      "confirmation_number": "08769913AR5",
      "pickup_location": "MIA",
      "return_location": "MIA",
      "pickup_datetime": "2020-05-06T10:00:00",
      "return_datetime": "2020-05-13T10:00:00",
      "rate": {
        "rate_code": "LQ",
        "rate_name": "LQ - Inclusive Light",
        "currency": "USD",
        "rate_total_amount": "187.00",
        "estimated_total_amount": "187.00",
        "discount_code": "XXXX9XX",
        "rental_days": "7",
        "rate_inclutions": [
          "Millaje Libre",
          "Cobertura LDW",
          "Cobertura SLI",
          "Impuestos Estatales y Locales",
          "Cargos de Aeropuerto",
          "Primer Conductor Adicional"
        ]
      },
      "vehicle_charges": [
        {
          "description": "Maximum 59 Day(s)",
          "amount": "187.00",
          "currency": "USD",
          "included_in_rate": "true",
          "purpose": "1"
        },
        {
          "description": "TIRE & BATTERY FEE",
          "amount": "0.00",
          "currency": "USD",
          "included_in_rate": "true",
          "purpose": "6"
        },
        {
          "description": "VEH. LICENSE FEE",
          "amount": "0.00",
          "currency": "USD",
          "included_in_rate": "true",
          "purpose": "6"
        },
        {
          "description": "CUSTOMER FACILITY FEE",
          "amount": "0.00",
          "currency": "USD",
          "included_in_rate": "true",
          "purpose": "6"
        },
        {
          "description": "$10.00    EXTENSION FEE MAY APPLY",
          "amount": "0.00",
          "currency": "USD",
          "included_in_rate": "false",
          "purpose": "28"
        },
        {
          "description": "FUEL POLICY IS FULL TO FULL",
          "amount": "0.00",
          "currency": "USD",
          "included_in_rate": "false",
          "purpose": "28"
        },
        {
          "description": "$20.00    LATE FEE MAY APPLY",
          "amount": "0.00",
          "currency": "USD",
          "included_in_rate": "false",
          "purpose": "28"
        },
        {
          "description": "STATE SURCHARGE",
          "amount": "0.00",
          "currency": "USD",
          "included_in_rate": "true",
          "purpose": "6"
        }
      ],
      "priced_coverages": [
        {
          "coverage_type": "63",
          "coverage_code": "TPL",
          "coverage_description": "Third Party Liability (TPL)",
          "tax_inclusive": "false",
          "included_in_rate": "true",
          "amount": "0.00",
          "currency": "USD"
        },
        {
          "coverage_type": "7",
          "coverage_code": "CDW",
          "coverage_description": "Collision Damage Waiver (CDW)",
          "tax_inclusive": "false",
          "included_in_rate": "true",
          "amount": "0.00",
          "currency": "USD"
        }
      ],
      "special_equipment": [
        {
          "equipment_id": "13",
          "equipment_GDS_code": "GPS",
          "quantity": "1",
          "currency": "USD",
          "amount": "99.99",
          "equipment_description": "Sistema de Navegación (GPS)"
        },
        {
          "equipment_id": "103",
          "equipment_GDS_code": "RSN",
          "quantity": "1",
          "currency": "USD",
          "amount": "48.93",
          "equipment_description": "Asistencia en carretera"
        }
      ]
    },
    "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.budget.com\/content\/dam\/cars\/l\/2019\/ford\/2019-ford-fiesta-se-5door-2wd-hatchback-silver.png",
        "seats": "5",
        "doors": "2-4",
        "air_conditioned": "true",
        "transmission": "auto",
        "large_suitcase": "0",
        "medium_suitcase": "1",
        "small_suitcase": "1"
      }
    },
    "RequestorAgent": {
      "RequestorID": "11111111"
    },
    "LocationDetail": {
      "PickUpLocation": {
        "LocationName": "Miami Intl Airport",
        "LocationStreet": "3900 Nw 25th Street, Suite 403 Miami International Airport",
        "LocationCity": "Miami",
        "LocationPostalCode": "33142",
        "LocationStateCode": "FL",
        "LocationStateName": "Florida",
        "LocationCountry": "US",
        "LocationCountryName": "Estados Unidos",
        "LocationPhoneNumber": "305-876-1820",
        "LocationCode": "MIA",
        "ExtendedLocationCode": "MIAT01",
        "LocationType": "Corporate",
        "CounterLocation": "S",
        "LocationLatitude": 25.796997,
        "LocationLongitude": -80.25969,
        "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 Nw 25th Street, Suite 403 Miami International Airport",
        "LocationCity": "Miami",
        "LocationPostalCode": "33142",
        "LocationStateCode": "FL",
        "LocationStateName": "Florida",
        "LocationCountry": "US",
        "LocationCountryName": "Estados Unidos",
        "LocationPhoneNumber": "305-876-1820",
        "LocationCode": "MIA",
        "ExtendedLocationCode": "MIAT01",
        "LocationType": "Corporate",
        "CounterLocation": "S",
        "LocationLatitude": 25.796997,
        "LocationLongitude": -80.25969,
        "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": "96b41f0c-2cc1-4e47-a178-8a33b8f46be3--75c4e023-f179-4728-8d5d-7164e8023408",
    "RHMAC": "e7a0c68a142389aea08aebca7560fb580c419534f95133c175f4c3f7f0534ec4"
  }
}

Datos de la respuesta:

La respuesta del servicio será devueltan en formato array/objeto JSON (application/json)

campo	tipo	descripción
appVersion	string	Número de versión de la API
status	booleano	estado de la respuesta al request, toma los valores "true/false" siendo "true" una respuesta normal positiva y "false" un error o fallo.
brand	string	Devuelve la marca con la que se esta trabajando.
environment	string	Entorno en el que se esta trabajando: TEST (QA) o Producción (Production)
reservation_response	Objeto	Engloba todos los datos de la reserva
customer	Objeto	Datos del cliente
first_name	string	Nombre del cliente
last_name	string	Apellido del cliente
citizen_country_code	string	código del pais de residencia del cliente (código de 2 carácteres - ISO 3166)
arrival_details	Objeto	datos del vuelo de arribo del cliente (si hubieran sido suministrados al momento de realizar la reserva).
airline_code	string	código IATA de linea aérea (2 carácteres)
flight_number	string	Número de identificación asignado por la línea aérea al segmento del vuelo
reservation	Objeto	datos de la reserva.
confirmation_number	string	Número de confirmación de la reserva.
pickup_location	string	código alfanumérico de oficina o aeropuerto de inicio de la renta (3 a 5 carácteres).
return_location	string	código alfanumérico de oficina o aeropuerto de finalización de la renta (3 a 5 carácteres).
pickup_datetime	Time	día y hora de inicio de la renta (estándar ISO 8601 - YYYY-MM-DDThh:mm:ss).
return_datetime	Time	día y hora de finalización de la renta (estándar ISO 8601 - YYYY-MM-DDThh:mm:ss).
rate	Objeto	Datos de la tarifa
rate_code	string	código de la tarifa reservada
rate_name	string	nombre comercial de la tarifa reservada
currency	string	moneda de los valores expresados en la tarifa
rate_total_amount	número	Total estimado de la tarifa reservada
estimated_total_amount	número	Total estimado de los gastos de la reserva (tarifa + impuestos + cargos obligatorios del vehículo)
discount_code	string	Código de descuento utilizado en la reserva (Si hubiera sido suministrado al momento de realizar la reserva).
rate_distance	Objeto	Información sobre las opciones y limitaciones de distancia de la renta.
unlimited	booleano	Toma el valor de true si es ilimitada, false en caso de existir un limite máximo
quantity	número	Cantidad de distancia a recorrer sin costo adicional incluida en la tarifa (solo si unlimited es igual false)
distance_unit	string	Unidad de medida de la distancia
rental_days	número	cantidad total de días reservados
tax	Objeto	Impuestos obligatorios de la renta
tax_total_amount	número	Total de los impuestos y cargos obligatorios sobre la renta
tax_currency	string	Moneda de los valores expresados en los cargos e impuestos
description	string	Descripcion del cargo o impuesto
rate_inclutions	Array	Inclusiones de la tarifa reservada
vehicle_charges	Array	Detalle e información de los cargos obligatorios y opcionales del vehículo
description	string	descripción del cargo
amount	número	costo del cargo
currency	string	Moneda del valor expresado en el cargo
included_in_rate	string	Indica si el valor esta incluido en el monto total estimado de la reserva
purpose	nú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_item	booleano	Indica 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.
priced_coverages	Array	Información de las coberturas básicas incluidas en la tarifa
special_equipment	Array	Equipamiento y servicios opcionales del vehículo y la reserva a requerir
equipment_id	número	Número identificatorio del servicio/equipo
quantity	número	Cantidad reservada del ítem
currency	string	Moneda del valor expresado del equipo/servicio
amount	número	costo del cargo
equipment_GDS_code	número	Código GDS del equipo/servicio requerido
equipment_description	número	Descripción del equipo/servicio requerido
vehicle	Objeto	Datos del vehículo reservado
vehicle_group_code	string	Grupo del vehículo reservado.
vehicle_category_code	string	Código de la categoría del vehículo reservado (Estándar ACRISS)
vehicle_class_name	string	Nombre de la clase del vehículo reservado
vehicle_make_model	string	Marca y modelo del vehículo reservado (solo a modo orientativo se confirman grupos o categorías, no marcas o modelos)
vehicle_details	Objeto	Detalles de equipamiento del vehículo
name	string	Código GDS del equipo/servicio requerido
image_URL	string	URL de la imagen ilustrativa del vehículo
seats	string	Cantidad de asientos
doors	string	Cantidad de puertas
air_conditioned	booleano	toma el valor de true si el vehículo cuenta con aire acondicionado, false en caso de no poseerlo
transmission	string	Tipo de caja de cambios (automática / manual)
large_suitcase	string	Cantidad de maletas grandes
medium_suitcase	string	Cantidad de maletas medianas
small_suitcase	string	Cantidad de maletas pequeñas
RequestorAgent	Objeto	Datos del Agente/Agencia que realizó la reserva(IATA, Unlimited Rewards Number,etc)
LocationDetail	Objeto	Datos de las oficinas de inicio y retorno de la renta
PickUpLocation	Objeto	Oficina de inicio de la renta (Nombre, Dirección, Código de oficina, Latitud, Longitud, Horarios, etc).
ReturnLocation	Objeto	Oficina de retorno de la renta (Nombre, Dirección, Código de oficina, Latitud, Longitud, Horarios, etc).
TID	string	Identificador de transacción que se utiliza para individualizar una solicitud determinada. Se puede utilizar para revisar problemas con una solicitud en particular.
RHMAC	string	Hash verificador de la reserva.

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 / datos varios) recibirá un error similar al siguiente:

 
{
  "appVersion": "2.0",
  "status": false,
  "error": "Missing minimun required data",
  "error_description": "You must supply all minimum required data to make a reservation iata,first_name,last_name,citizen_country_name,pickup_datetime,return_datetime,pickup_location,return_location,rate_qualifier,sipp_code",
  "brand": "BUDGET",
  "environment": "QA"
}

Realizar la reserva de un vehículo.

Protocolo soportado:

HTTPS / TLS 1.2 - TLS 1.3

Endpoint:

POST https://api.carrental-int.com/v2/vehreservation/

Solicitud

headers:

Ejemplo

Cuerpo de la solicitud (Body)

Respuestas

respuesta HTTP: 200 OK

Datos de la respuesta:

Errores de solicitud

respuesta HTTP: 400 Bad Request

POST
https://api.carrental-int.com/v2/vehreservation/