API de presupuestos de alojamiento

Guía y ejemplos para acceder a la API de presupuestos de alojamiento

La API de presupuestos de alojamiento devolverá la información de precio y disponibilidad para los ID de alojamiento de Expedia seleccionados.

Punto de conexión

Método	Punto de conexión
GET	https://apim.expedia.com/lodging/quotes

Encabezados obligatorios

Clave:	Clave de API de Expedia
Autorización:	Cadena de autorización de API de Expedia
Aceptar:	application/vnd.exp-lodging.v3+json
Partner-Transaction-Id:	[Cadena de TransactionID de colaborador]

Ejemplo de solicitud de la API de presupuestos

Solicitud

https://apim.expedia.com/lodging/quotes?links=WS,WD&propertyIds=87704892,46330564,31187403,76252345&checkIn=2024-11-29&checkOut=2024-12-04

Respuesta

{
    "Count": 4,
    "TotalPropertyCount": 4,
    "TransactionId": "0e1d7193-2289-481c-bdf9-b7ac0b0b3bfe",
    "StayDates": {
        "CheckInDate": "2024-11-29",
        "CheckOutDate": "2024-12-04"
    },
    "LengthOfStay": 5,
    "Occupants": [
        {
            "Adults": 2
        }
    ],
    "Properties": [
        {
            "Id": "87704892",
            "Status": "AVAILABLE",
            "RoomTypes": [
                {
                    "RatePlans": [
                        {
                            "CancellationPolicy": {
                                "Refundable": true,
                                "FreeCancellation": true,
                                "FreeCancellationEndDateTime": "2024-11-15T23:59:00-08:00",
                                "CancellationPenaltyRules": [
                                    {
                                        "PenaltyPercentOfStay": "50.00",
                                        "PenaltyStartDateTime": "2024-11-15T23:59:00-08:00",
                                        "PenaltyEndDateTime": "2024-11-22T23:59:00-08:00"
                                    },
                                    {
                                        "PenaltyPercentOfStay": "100",
                                        "PenaltyStartDateTime": "2024-11-22T23:59:00-08:00",
                                        "PenaltyEndDateTime": "2024-11-29T00:00:00-08:00"
                                    }
                                ]
                            }
                        }
                    ],
                    "Price": {
                        "BaseRate": {
                            "Value": "790.00",
                            "Currency": "USD"
                        },
                        "TaxesAndFees": {
                            "Value": "348.48",
                            "Currency": "USD"
                        },
                        "TotalPrice": {
                            "Value": "1138.48",
                            "Currency": "USD"
                        },
                        "AvgNightlyRate": {
                            "Value": "158.00",
                            "Currency": "USD"
                        },
                        "AvgNightlyRateWithFees": {
                            "Value": "198.80",
                            "Currency": "USD"
                        },
                        "TotalPriceWithPropertyFees": {
                            "Value": "1138.48",
                            "Currency": "USD"
                        }
                    },
                    "Links": {
                        "WebSearchResult": {
                            "Method": "GET",
                            "Href": "https://www.vrbo.com/search?selected=87704892&startDate=2024-11-29&endDate=2024-12-04&adults=2&tpid=9001&eapid=1&mpa=790.00&mpb=348.48&mpd=USD"
                        },
                        "WebDetails": {
                            "Method": "GET",
                            "Href": "https://www.vrbo.com/3032772?adults=2&startDate=2024-11-29&endDate=2024-12-04"
                        }
                    }
                }
            ]
        },
        {
            "Id": "46330564",
            "Status": "AVAILABLE",
            "RoomTypes": [
                {
                    "RatePlans": [
                        {
                            "CancellationPolicy": {
                                "Refundable": true,
                                "FreeCancellation": true,
                                "FreeCancellationEndDateTime": "2024-11-15T23:59:00-08:00",
                                "CancellationPenaltyRules": [
                                    {
                                        "PenaltyPercentOfStay": "50.00",
                                        "PenaltyStartDateTime": "2024-11-15T23:59:00-08:00",
                                        "PenaltyEndDateTime": "2024-11-22T23:59:00-08:00"
                                    },
                                    {
                                        "PenaltyPercentOfStay": "100",
                                        "PenaltyStartDateTime": "2024-11-22T23:59:00-08:00",
                                        "PenaltyEndDateTime": "2024-11-29T00:00:00-08:00"
                                    }
                                ]
                            }
                        }
                    ],
                    "Price": {
                        "BaseRate": {
                            "Value": "525.00",
                            "Currency": "USD"
                        },
                        "TaxesAndFees": {
                            "Value": "197.97",
                            "Currency": "USD"
                        },
                        "TotalPrice": {
                            "Value": "722.97",
                            "Currency": "USD"
                        },
                        "AvgNightlyRate": {
                            "Value": "105.00",
                            "Currency": "USD"
                        },
                        "AvgNightlyRateWithFees": {
                            "Value": "130.20",
                            "Currency": "USD"
                        },
                        "TotalPriceWithPropertyFees": {
                            "Value": "722.97",
                            "Currency": "USD"
                        }
                    },
                    "Links": {
                        "WebSearchResult": {
                            "Method": "GET",
                            "Href": "https://www.vrbo.com/search?selected=46330564&startDate=2024-11-29&endDate=2024-12-04&adults=2&tpid=9001&eapid=1&mpa=525.00&mpb=197.97&mpd=USD"
                        },
                        "WebDetails": {
                            "Method": "GET",
                            "Href": "https://www.vrbo.com/1896742?adults=2&startDate=2024-11-29&endDate=2024-12-04"
                        }
                    }
                }
            ]
        },
        {
            "Id": "31187403",
            "Status": "AVAILABLE",
            "RoomTypes": [
                {
                    "RatePlans": [
                        {
                            "CancellationPolicy": {
                                "Refundable": true,
                                "FreeCancellation": true,
                                "FreeCancellationEndDateTime": "2024-10-30T23:59:00-07:00",
                                "CancellationPenaltyRules": [
                                    {
                                        "PenaltyPercentOfStay": "50.00",
                                        "PenaltyStartDateTime": "2024-10-30T23:59:00-07:00",
                                        "PenaltyEndDateTime": "2024-11-15T23:59:00-08:00"
                                    },
                                    {
                                        "PenaltyPercentOfStay": "100",
                                        "PenaltyStartDateTime": "2024-11-15T23:59:00-08:00",
                                        "PenaltyEndDateTime": "2024-11-29T00:00:00-08:00"
                                    }
                                ]
                            }
                        }
                    ],
                    "Price": {
                        "BaseRate": {
                            "Value": "825.00",
                            "Currency": "USD"
                        },
                        "TaxesAndFees": {
                            "Value": "337.65",
                            "Currency": "USD"
                        },
                        "TotalPrice": {
                            "Value": "1162.65",
                            "Currency": "USD"
                        },
                        "AvgNightlyRate": {
                            "Value": "165.00",
                            "Currency": "USD"
                        },
                        "AvgNightlyRateWithFees": {
                            "Value": "203.00",
                            "Currency": "USD"
                        },
                        "TotalPriceWithPropertyFees": {
                            "Value": "1162.65",
                            "Currency": "USD"
                        }
                    },
                    "Links": {
                        "WebSearchResult": {
                            "Method": "GET",
                            "Href": "https://www.vrbo.com/search?selected=31187403&startDate=2024-11-29&endDate=2024-12-04&adults=2&tpid=9001&eapid=1&mpa=825.00&mpb=337.65&mpd=USD"
                        },
                        "WebDetails": {
                            "Method": "GET",
                            "Href": "https://www.vrbo.com/364168?adults=2&startDate=2024-11-29&endDate=2024-12-04"
                        }
                    }
                }
            ]
        },
        {
            "Id": "76252345",
            "Status": "AVAILABLE",
            "RoomTypes": [
                {
                    "RatePlans": [
                        {
                            "CancellationPolicy": {
                                "Refundable": true,
                                "FreeCancellation": true,
                                "FreeCancellationEndDateTime": "2024-11-15T23:59:00-08:00",
                                "CancellationPenaltyRules": [
                                    {
                                        "PenaltyPercentOfStay": "50.00",
                                        "PenaltyStartDateTime": "2024-11-15T23:59:00-08:00",
                                        "PenaltyEndDateTime": "2024-11-22T23:59:00-08:00"
                                    },
                                    {
                                        "PenaltyPercentOfStay": "100",
                                        "PenaltyStartDateTime": "2024-11-22T23:59:00-08:00",
                                        "PenaltyEndDateTime": "2024-11-29T00:00:00-08:00"
                                    }
                                ]
                            }
                        }
                    ],
                    "Price": {
                        "BaseRate": {
                            "Value": "800.00",
                            "Currency": "USD"
                        },
                        "TaxesAndFees": {
                            "Value": "515.12",
                            "Currency": "USD"
                        },
                        "TotalPrice": {
                            "Value": "1315.12",
                            "Currency": "USD"
                        },
                        "AvgNightlyRate": {
                            "Value": "160.00",
                            "Currency": "USD"
                        },
                        "AvgNightlyRateWithFees": {
                            "Value": "227.16",
                            "Currency": "USD"
                        },
                        "TotalPriceWithPropertyFees": {
                            "Value": "1315.12",
                            "Currency": "USD"
                        }
                    },
                    "Links": {
                        "WebSearchResult": {
                            "Method": "GET",
                            "Href": "https://www.vrbo.com/search?selected=76252345&startDate=2024-11-29&endDate=2024-12-04&adults=2&tpid=9001&eapid=1&mpa=800.00&mpb=515.12&mpd=USD"
                        },
                        "WebDetails": {
                            "Method": "GET",
                            "Href": "https://www.vrbo.com/2695601?adults=2&startDate=2024-11-29&endDate=2024-12-04"
                        }
                    }
                }
            ]
        }
    ]
}

Puntos de venta compatibles

Solo se admiten los siguientes puntos de venta:

	POS	Código de moneda	Configuración regional	URL de sitio básico
1	AU	AUD	en_AU	www.stayz.com.au
2	BR	BRL	pt_BR	www.vrbo.com/pt-br
3	CA	CAD	en_CA	www.vrbo.com/en-ca
4	CA	CAD	fr_CA	www.vrbo.com/fr-ca
5	DE	EUR	de_DE	www.fewo-direkt.de
6	ES	EUR	es_ES	www.vrbo.com/es-es
7	FR	EUR	fr_FR	www.abritel.fr
8	UK	GBP	en_GB	www.vrbo.com/en-gb
9	IT	EUR	it_IT	www.vrbo.com/it-it
10	NL	EUR	nl_NL	www.vrbo.com/nl-nl
11	US	USD	en_US	www.vrbo.com
12	AT	EUR	de_AT	www.vrbo.com/de-at
13	DK	DKK	da_DK	www.vrbo.com/da-dk
14	FI	EUR	fi_FI	www.vrbo.com/fi-fi
15	GR	EUR	el_GR	www.vrbo.com/el-gr
16	JP	JPY	ja_JP	www.vrbo.com/ja-jp
17	NO	NOK	nb_NO	www.vrbo.com/no-no
18	NZ	NZD	en_NZ	www.bookabach.co.nz
19	PT	EUR	pt_PT	www.vrbo.com/pt-pt
20	SE	SEK	sv_SE	www.vrbo.com/sv-se
21	SG	SGD	en_SG	www.vrbo.com/en-sg
22	MX	MXN	es_MX	www.vrbo.com/es-mx
23	PL	PLN	pl_PL	www.vrbo.com/pl-pl

Monedas aceptadas

Para la primera versión de la API de presupuestos, solo se admiten las siguientes monedas:

ARS	AUD	BRL	CAD	CHF	CNY	COP
CZK	DKK	EUR	GBP	HKD	HRK	HUF
IDR	ILS	INR	JPY	KRW	MXN	MYR
NOK	NZD	PLN	RUB	SEK	SGD	THB
USD	ZAR	TRY

Códigos de error

Códigos de error frecuentes

Código de estado HTTP	Código de error	Respuesta de error	Causa
500	APPLICATION_ERROR	Error de la aplicación.	Error de la aplicación.
200	NO_RESULTS_FOUND	La consulta se ha completado correctamente, pero no ha devuelto ningún inventario. Modifica los parámetros de búsqueda e inténtalo de nuevo.	No se han encontrado alojamientos.
400	COTIZACIONES_SEARCH_CRITERIA_INCOMPLETE	Los criterios de búsqueda de presupuesto están incompletos. Especifica los siguientes criterios de búsqueda juntos: [propertyIds, checkIn, checkOut]	Falta el parámetro de solicitud requerido.
400	INVALID_PROPERTYIDS	El valor "propertyIds" no es válido; contienen un ID no válido [%s].	Especifica los ID de alojamiento de Expedia correctos. La lista de ID de alojamientos de Expedia disponible se puede encontrar en la sección de enlaces relacionados a continuación.
400	TOO_MANY_PROPERTYIDS	Demasiados ID de alojamiento. Especifica hasta 1000 ID de alojamiento de Expedia.	Se han solicitado demasiados alojamientos.
400	INVALID_CHECKIN	El valor checkIn no es válido. El formato debe ser "AAAA-MM-DD".	El formato de checkIn no es válido.
400	INVALID_PRICE	El precio no es válido. El valor permitido es un número.	El precio no es un número.
400	INVALID_CHECKOUT	El valor de checkOut no es válido. El formato debe ser "AAAA-MM-DD".	El formato de checkOut no es válido.
400	CHECKOUT_EARLIER_THAN_CHECKIN	La fecha de salida debe ser posterior a la fecha de entrada.	La fecha de salida debe ser posterior a la fecha de entrada.
400	CHECKIN_IN_THE_PAST	La fecha de entrada no debe ser pasada.	La fecha de entrada no debe ser pasada.
400	SEARCH_WINDOW_OUT_OF_RANGE	La ventana de búsqueda es demasiado grande. La duración máxima de la estancia es %d días.	La ventana de búsqueda es demasiado grande.
400	CHECKOUT_OUT_OF_RANGE	La fecha de salida está fuera de rango. La fecha de salida solo puede ocurrir hasta 500 días en el futuro.	La fecha de salida está fuera de rango.
400	UNSUPPORTED_CURRENCY	La moneda no es válida. La moneda solicitada no es compatible.	La moneda indicada no es compatible.
400	TOO_MANY_ROOMS	Se han solicitado demasiadas habitaciones. Se puede buscar un máximo de 8 habitaciones.	Se han solicitado demasiadas habitaciones.
400	INVALID_ADULTS	Se ha detectado un número de adultos no válido. El valor permitido es un número.	Especifica el número de adultos correcto.
400	ADULTS_OUT_OF_RANGE	Demasiados adultos. El número de adultos no debe ser superior a 99.	Se han solicitado demasiados adultos.
400	ROOM_NUMBER_NOT_IN_SEQUENTIAL	Números de habitaciones de adultos no válidos. Los números de las habitaciones deben expresarse en secuencia numérica y comenzar a partir de 1.	Especifica el número de adultos para cada habitación deseada. Por ejemplo, no se puede especificar solo room1.adults=2&room3.adults=3 sin especificar room2.adults.
400	INVALID_ROOM_OCCUPANTS	Solo se especifican edades de niños. La información de adultos es obligatoria para cada habitación.	Los niños deben estar acompañados por adultos en cada habitación.
400	INVALID_CHILDAGES	Se han detectado ocupantes infantiles no válidos. La edad de cada niño debe ser inferior a 17 años y el número de niños de cualquier habitación debe ser inferior a %d.	La edad del niño no es un número, o la edad del niño está fuera del rango, o el número de niños excede el número máximo permitido.
400	INVALID_LINKS	El valor "links" no es válido. Los enlaces pueden ser cualquier conjunto de WD o WS separados por comas.	Especifica los enlaces correctos.
400	INVALID_CLIENT_KEY	Clave de cliente no válida: %s.	La clave en el encabezado de la solicitud no es válida o hay demasiadas claves en el encabezado.
400	INVALID_ACCEPT	Proporciona un encabezado "Aceptar" válido.	El valor "Aceptar" en el encabezado de la solicitud no es válido o hay demasiados "Aceptar" en el encabezado.
400	INVALID_PARTNER_TRANSACTION_ID	Falta el parámetro "Partner-Transaction-Id".	El campo "Partner-Transaction-Id" en el encabezado de la solicitud está vacío.

Aquí puedes explorar las definiciones de punto de conexión de esta API, ir a API Explorer para probar todos los puntos de conexiones de XAP, descargar las especificaciones de OpenAPI y descargar nuestras colecciones de Postman. Hacer pruebas con una de estas opciones o con todas te permitirá comprender qué diferencia hay entre los ejemplos y las definiciones del esquema y los resultados reales.

ARS	AUD	BRL	CAD	CHF	CNY	COP
CZK	DKK	EUR	GBP	HKD	HRK	HUF
IDR	ILS	INR	JPY	KRW	MXN	MYR
NOK	NZD	PLN	RUB	SEK	SGD	THB
USD	ZAR	TRY

ARS	AUD	BRL	CAD	CHF	CNY	COP
CZK	DKK	EUR	GBP	HKD	HRK	HUF
IDR	ILS	INR	JPY	KRW	MXN	MYR
NOK	NZD	PLN	RUB	SEK	SGD	THB
USD	ZAR	TRY

ARS	AUD	BRL	CAD	CHF	CNY	COP
CZK	DKK	EUR	GBP	HKD	HRK	HUF
IDR	ILS	INR	JPY	KRW	MXN	MYR
NOK	NZD	PLN	RUB	SEK	SGD	THB
USD	ZAR	TRY