Residentes
- Oliver Martin
- jlverguizas
Introducción
El siguiente documento recoge las medidas tomadas a nivel de Lleego API ante la nueva Disposición Adicional 28ª de la Ley 11/2020, de Presupuestos Generales del Estado para el año 2021 que se publicó en el BOE el pasado 31 de diciembre de 2020.
En ella se establece un cambio en la forma de aplicar descuento de residentes al transporte de viajeros marítimo y aéreo para residentes de Canarias, Baleares, Ceuta y Melilla:
“Con independencia del medio utilizado para la comercialización de los billetes en los trayectos bonificados, no se solicitará al pasajero información sobre su condición de residente hasta la fase final del proceso de compra, justo antes de que, en el caso de residencia en los territorios no peninsulares, deba procederse a verificar el cumplimiento de dicho requisito para realizar el pago y emitir el billete.». El sentido de esta obligación es que se ofrezca el mismo precio tanto si se es residente (en Canarias, Baleares, Ceuta y Melilla) como si no. La citada norma legal incorpora desde hace unos días esta exigencia en la venta de billetes y da dos meses (enero y febrero) para que lo apliquen las plataformas de comercialización de billetes.”
A continuación se recogen los cambios llevados a cabo a nivel de Lleego API en sus 2 versiones:
AvailabilityPrice (v1) / Avail (v2)
La nueva legislación impide la solicitud de disponibilidad aplicando desde este momento el descuento de residente.
Por lo tanto, la opción de búsqueda resident en API, será marcada como obsoleta (deprecated).
Pricing (v1) / Pricing (v2)
Request
A nivel de pricing se añadirá un nuevo parámetro resident con el mismo formato que el utilizado hasta ahora en disponibilidad:
Response
La respuesta ofrecida en este pricing con residente tiene el mismo formato que un pricing normal.
Nota 1: Un nuevo identificador de transport será devuelto en la respuesta.
Si ya estás leyendo este identificador de la respuesta, no necesitarás hacer ningún cambio más.
Si no lo estás recogiendo, lo necesitarás para las siguientes peticiones del flujo de reserva.
"id": "VZ602c053cd462f0002_RESIDENT",
"solution_id": "VZ602c053cd462f0002",
"origin_destinations": [
{
"journeys": [
Nota 2: A tener en cuenta, que pueden aplicarse fees configurados para reservas con residentes. Esto es, que en la búsqueda NO se haya aplicado ningún fee, pero al hacer el pricing con el indicador de residente, se apliquen fees según configuración.
Ejemplo de petición:
https://{{url}}/api/v2/transport/pricing?token={{token}}&solutionID0={{solution}}&journey00={{journey0}}&journey01={{journey1}}&resident=CN
Booking (v1) / Booking (v2)
Una vez indicado en el pricing la solicitud de residente, la petición de reserva es la misma que hasta ahora.
Esto es, indicando la documentación del pasajero y su municipio de residencia en el campo document/city.
{
"query": {
"fees": [
{
"amount": 3,
"amount_emission_fee": 2,
"amount_markup": 0,
"pax_type": "ADT"
}
],
"holder": {
"contact": {
"mails": [
"jose.lleego@gmail.com"
],
"phones": [
{
"country_pref": "34",
"number": "677777777"
},
{
"country_pref": "66699",
"number": "34"
}
]
},
"name": "JOSE",
"surnames": [
"LLEEGO"
]
},
"solutions": [
{
"id": "fp633d50888c64f0000_RESIDENT",
"journeys": [
"UX905920221117"
]
}
],
"token": "Q0633d5086c77d7",
"travellers": [
{
"documents": [
{
"city": "380012",
"number": "12345678Z",
"type": "NI"
}
],
"name": "MIGUEL",
"surnames": [
"PEREZUNO"
],
"title": "Mr",
"type": "ADT"
}
]
}
}Recuerda utilizar el identificador de transport devuelto en la respuesta de pricing si quieres completar la reserva con el descuento de residente.
Standalonecatalogue (v1) / Standalonecatalogue (v2)
Al igual que ocurre en reserva, el formato de la petición será el mismo que hasta ahora.
Tan sólo recuerda utilizar el identificador de transport devuelto en pricing si quieres continuar con la reserva en modo residente.
Amadeus
Galileo
Iberia
Travelfusion
Vueling