API Motor de reservas Transfers

Introducción

Bienvenido a la API de transfers del motor de reservas de Mybooking.

Este API tiene tiene la funcionalidad necesaria para registrar una reserva de una empresa de transfers.

Está diseñada de forma que se pueda utilizar tanto desde el navegador con JAMStack como desde su lenguaje preferido en el lado del servidor.

URL Base

https://micuenta.mybooking.es

Lugares origen y destino

GET Lugares de origen

GET /api/booking-transfer/frontend/origin-points

Obtiene los lugares de origen

Query String

Parámetro	Descripción	Detalle
lang	Idioma	Código ISO 639-1 (en,es,it,...)	Opcional
term	Text búsqueda	Texto para buscar un lugar	Opcional

Resultado

Success

200

Retorna un Array, con los lugares de origen para realizar el transfer.

Object	Descripción
transfer_point		array[object]
	id	Number
	name	String
	point_type	String	location, airport, harbor, bus_station, train_station

GET Lugares de destino

GET /api/booking-transfer/frontend/destination-points

Obtiene los lugares de destino

Query String

Parámetro	Descripción	Detalle
origin_point_id	Lugar de origen	El identificador del lugar de origen	Requerido
lang	Idioma	Código ISO 639-1 (en,es,it,...)	Opcional
term	Text búsqueda	Texto para buscar un lugar	Opcional

Resultado

Success

200

Retorna un Array, con los lugares de destino para realizar el transfer.

Campo	array[object]	Lugar de transfer
id	Number
name	String
point_type	String	location, airport, harbor, bus_station, train_station

Proceso de reserva

POST Crear carrito de reserva

POST /api/booking-transfer/frontend/shopping-cart

Inicia el proceso de reserva seleccionado la fecha y hora, los lugares de origen, destino y el número de personas

Query String

Parámetro	Descripción	Detalle
lang	Idioma	Código ISO 639-1 (en,es,it,...)	Opcional
include_products	Incluye vehículos y tarifas	Boolean	Opcional
include_extras	Incluye extras y tarifas	Boolean	Opcional

Request Body

Parámetro	Descripción	Detalle
date	Fecha	dd/mm/yyyy	Obligatorio
time	Hora	hh:MM	Obligatorio
origin_point_id	Lugar de origen	Identificador (Número)	Obligatorio
destination_point_id	Lugar de destino	Identificador (Número)	Obligatorio
rountrip	¿Ida y vuelta?	false (sólo ida) true (ida y vuelta)	Obligatorio
number_of_adults	Número de adulto	Número	Obligatorio
number_of_children	Número de niños	Número	Obligatorio
number_of_infants	Número de bebés	Número	Obligatorio
return_date	Fecha	dd/mm/yyyy	Obligatorio
return_time	Hora	hh:MM	Obligatorio
return_origin_point_id	Lugar de origen	Identificador (Número)	Obligatorio
return_destination_point_id	Lugar de destino	Identificador (Número)	Obligatorio

Resultado

Success

200

	object[object]	Carrito de la compra
free_access_id	String	Identificador del carrito para múltiples peticiones
date	String YYYY-MM-DD	Fecha
time	String HH:MM	Hora
origin_point_id	Number	Identificador del punto de origen
origin_point_name	String	Nombre del punto de origen
origin_point_name_customer_translation	String	Nombre del punto de origen
destination_point_id	Number	Identificador del punto de origen
destination_point_name_customer_translation	String	Nombre del punto de origen
round_trip	Boolean	Sólo ida (false) Ida y vuelta (true)
return_date	String YYYY-MM-DD	Fecha de la vuelta
return_time	String HH:MM	Hora de la vuelta
return_origin_point_id	Number	Identificador del punto de origen (vuelta)
return_origin_point_name_customer_translation	String	Nombre del punto de origen (vuelta)
return_destination_point_id	Number	Identificador del punto de origen (vuelta)
return_destination_point_name_customer_translation	String	Nombre del punto de origen (vuelta)
item_id	Number	Identificador del vehículo
item_name	String	Nombre del vehículo
item_name_customer_translation	String	Nombre del vehículo (traducción idioma cliente)
item_photo	String	Path con la foto del vehículo (tamaño medio)
item_full_photo	String	Path con la foto del vehículo (tamaño completo)
number_of_adults	Integer	Número de adultos
number_of_children	Integer	Número de niños
number_of_infants	Integer	Nombre de bebés
item_cost	String (amount)	Importe del vehículo
extras_cost	String (amount)	Importe de los extras
total_cost	String (amount)	Importe total
extras	array[object]	Extras
- extra_id	Integer	Identificador del extra
- extra_name	String	Nombre del extra
- extra_name_customer_translation	String	Nombre del extra (traducción idioma cliente)
- extra_photo	String	URL foto extra
- extra_photo_full	String	URL foto extra (tamaño completo)
- quantity	Integer	Número de unidades

	array[object]	Vehículos y tarifas
id	Number	Identificador del vehículo
name	String	Nombre del vehículo
price	String (amount)	Coste
available	Boolean	Si está disponible

	array[object]	Vehículos y tarifas
id	Number	Identificador del vehículo
name	String	Nombre del vehículo
unit_price	String (amount)	Coste unitario
max_quantity	Number	Cantidad máxima
max_sellable_quantity	Number	Cantidad máxima que puede venderse

POST Cambiar datos del carrito de reserva

POST /api/booking-transfer/frontend/shopping-cart/{free_access_id}

Cambio los datos del proceso de reserva de un transfer: la fecha y hora, los lugares de origen, destino y el número de personas

Resultado

Success

200

Resultado

Error

404 Carrito de reserva no existe

GET Obtener carrito de reserva

GET /api/booking-transfer/frontend/shopping-cart/{free_access_id}

Obtiene el carrito de la resera a partir de su identificador

Parámetros del path

Parámetro	Descripción	Detalle
free_access_id	Identificador del carrito	String	Requerido

Query String

Parámetro	Descripción	Detalle
lang	Idioma	Código ISO 639-1 (en,es,it,...)	Opcional
include_products	Incluye vehículos y tarifas	Boolean	Opcional
include_extras	Incluye extras y tarifas	Boolean	Opcional

Resultado

Success

200

Resultado

Error

404 Carrito de reserva no existe

POST Seleccionar vehículo

POST /api/booking-transfer/frontend/shopping-cart/{free_access_id}/set-product

Permite seleccionar el vehículo

Path Parameters

Parámetro	Descripción	Detalle
free_access_id	Identificador del carrito de la compra obtenido al iniciar el proceso de venta	String	Obligatorio

Query String

Parámetro	Descripción	Detalle
lang	Idioma	String Código ISO 639-1 (en,es,it, …)	Opcional

Request Body:

Parámetro	Descripción	Detalle
product	Código del producto	String Código	Obligatorio

Resultado

Success

200

Resultado

Error

404 Carrito de reserva no existe

POST Añadir/modificar extra

POST /api/booking-transfer/frontend/shopping-cart/{free_access_id}/set-extra

Permite añadir un extra a la reserva o modificar la cantidad

Path Parameters

Parámetro	Descripción	Detalle
free_access_id	Identificador del carrito de la compra obtenido al iniciar el proceso de venta	String	Obligatorio

Query String

Parámetro	Descripción	Detalle
lang	Idioma	String Código ISO 639-1 (en,es,it, …)	Opcional

Request Body:

Parámetro	Descripción	Detalle
extra	Código del extra	String Código	Obligatorio
quantity	Cantidad del producto	Integer	Opcional

Resultado

Success

200

Resultado

Error

404 Carrito de reserva no existe

POST Eliminar extra

POST /api/booking-transfer/frontend/shopping-cart/{free_access_id}/remove-extra

Permite eliminar un extra

Path Parameters

Parámetro	Descripción	Detalle
free_access_id	Identificador del carrito de la compra obtenido al iniciar el proceso de venta	String	Obligatorio

Query String

Parámetro	Descripción	Detalle
lang	Idioma	String Código ISO 639-1 (en,es,it, …)	Opcional

Request Body:

Parámetro	Descripción	Detalle
extra	Código del extra	String	Obligatorio

Resultado

Success

200

Resultado

Error

404 Carrito de reserva no existe

POST Checkout carrito reserva

POST /api/booking-transfer/frontend/shopping-cart/{free_access_id}/checkout

Permite crear la reserva a partir del carrito de la reserva

Path Parameters

Parámetro	Descripción	Detalle
free_access_id	Identificador del carrito de la compra obtenido al iniciar el proceso de venta	String	Obligatorio

Query String

Parámetro	Descripción	Detalle
lang	Idioma	String Código ISO 639-1 (en,es,it, …)	Opcional

Request Body:

Parámetro	Descripción	Detalle
customer_name	Nombre del cliente	String(40)	Obligatorio
customer_surname	Apellidos del cliente	String(40)	Obligatorio
customer_email	Email del cliente	String(40)	Obligatorio
customer_phone	Teléfono alternativo del cliente	String(15)	Opcional
comments	Comentarios	String	Opcional
address_1	Dirección línea 1	String(256)	Opcional
address_2	Dirección línea 2	String(256)	Opcional
city	Dirección ciudad	String(256)	Opcional
state	Dirección provincia o estado	String(256)	Opcional
country	Dirección país	String(256)	Opcional
zip	Dirección código postal	String(256)	Opcional
fligth_airport_origin	Aeropuerto origen	String(100)	Opcional
flight_company	Compañía aérea	String(80)	Opcional
flight_number	Número de vuelo	String(10)	Opcional
flight_time	Hora prevista de llegada	String(5)	Opcional
fligth_airport_destination	Aeropuerto destino	String(100)	Opcional
flight_company_departure	Compañía aérea regreso	String(80)	Opcional
flight_number_departure	Número de vuelo regreso	String(10)	Opcional
flight_time_departure	Hora prevista de regreso	String(5)	Opcional

Resultado

Success

200

Resultado

Object	Descripción
booking		object[object]
	free_access_id	String	Identificador reserva
	pay_now	Boolean	Pagar ahora
	payment	String	Cantidad a pagar “total” o “deposit”
	payment_method_id	String	Forma de pago
	total_cost	String	Coste total
	customer_email	String	Correo electrónico del cliente
	customer_name	String	Nombre del cliente
	customer_surname	String	Apellidos del cliente

En el caso que la operación se lleve a cabo correctamente se puede hacer un POST a /transfer/pagar

# API Motor de reservas Transfers

# Introducción

# URL Base

# Lugares origen y destino

# GET Lugares de origen

GET /api/booking-transfer/frontend/origin-points

Query String

Resultado

Success

# GET Lugares de destino

GET /api/booking-transfer/frontend/destination-points

Query String

Resultado

Success

# Proceso de reserva

# POST Crear carrito de reserva

POST /api/booking-transfer/frontend/shopping-cart

Query String

Request Body

Resultado

Success

# POST Cambiar datos del carrito de reserva

POST /api/booking-transfer/frontend/shopping-cart/{free_access_id}

Resultado

Success

Error

# GET Obtener carrito de reserva

GET /api/booking-transfer/frontend/shopping-cart/{free_access_id}

Parámetros del path

Query String

Resultado

Success

Error

# POST Seleccionar vehículo

POST /api/booking-transfer/frontend/shopping-cart/{free_access_id}/set-product

Path Parameters

Query String

Request Body:

Resultado

Success

Error

# POST Añadir/modificar extra

POST /api/booking-transfer/frontend/shopping-cart/{free_access_id}/set-extra

Path Parameters

Query String

Request Body:

Resultado

Success

Error

# POST Eliminar extra

POST /api/booking-transfer/frontend/shopping-cart/{free_access_id}/remove-extra

Path Parameters

Query String

Request Body:

Resultado

Success

Error

# POST Checkout carrito reserva

POST /api/booking-transfer/frontend/shopping-cart/{free_access_id}/checkout

Path Parameters

Query String

Request Body:

Resultado

Success

Error

# Consultar reserva

# GET reserva

POST /api/booking-transfer/frontend/reservation/{free_access_id}

Resultado

Success

API Motor de reservas Transfers

Introducción

URL Base

Lugares origen y destino

GET Lugares de origen

GET Lugares de destino

Proceso de reserva

POST Crear carrito de reserva

POST Cambiar datos del carrito de reserva

GET Obtener carrito de reserva

POST Seleccionar vehículo

POST Añadir/modificar extra

POST Eliminar extra

POST Checkout carrito reserva

Consultar reserva

GET reserva