Saltar a contenido

Prepaquetes

Con este método podemos obtener los prepaquetes de actividades disponibles.

Los prepaquetes son estructuras previas a la creación de un paquete y pueden estar compuestos por uno o más recintos (ej. "Oceanogràfic + Bioparc"). Cada prepaquete, a su vez, dispondrá de uno o varios grupos de productos (ProductPaxGroupings).

Es relevante tener en cuenta la geolocalización sugerida. Esta se utiliza en los distintos métodos de catálogo para ubicar una zona a partir de la cual buscar hoteles.

Método de acceso

POST /Activity/Prepackages

Estructura de la petición

Todos los parámetros de la petición son opcionales.

  • ProviderIds: (list) Opcional. Listado de proveedores para filtrar.
    • (string): Opcional. Identificador del proveedor.
  • PrePackageIds: (list) Opcional. Listado de prepaquetes para filtrar.
    • (string): Opcional. Identificador del prepaquete.
  • FromDate: (date) Opcional. Fecha inicial para filtrar prepaquetes. Valor por defecto: día actual. Formato IS0 8601 (YYYY-MM-DD).
  • ToDate: (date) Opcional. Fecha final para filtrar prepaquetes. Valor por defecto: un año a futuro. Formato IS0 8601 (YYYY-MM-DD).
  • PeopleDistributions: (list) Opcional. Listado con la distribución de personas en las distintas habitaciones.
    • PeopleDistribution: (object) Opcional. Información de la distribución en la habitación correspondiente.
      • NumberOfAdults: (int) Opcional. Número de adultos.
      • NumberOfChildren: (int) Opcional. Número de niños.
      • NumberOfSeniors: (int) Opcional. Número de seniors.
      • NumberOfBabies: (int) Opcional. Número de bebés.
      • ChildrenAges: (list) Opcional. Listado con las edades de los bebés y niños.
        • (int): Opcional. Edad del bebe o niño.

Edad de los bebés/niños

Se deberá preguntar la edad de todas aquellas personas que tengan 17 años o menos.

Ejemplo de petición

Examples
{
    "ProviderIds": 
    [
        "djifgbvirefnw",
        "39rh3brfn33gb"
    ]
}
{
    "PrePackageIds": 
    [
        "bvqer8bv3b98s",
        "bf34578gbrb29"
    ]
}
{
    "FromDate": "2022-06-01",
    "ToDate": "2022-08-01"
}
{
    "PeopleDistributions": 
    {
        "NumberOfAdults": 2,
        "NumberOfChildren": 2,
        "ChildrenAges": 
        [
            10,
            12
        ]
    }
}
{
    "ProviderIds": 
    [
        "djifgbvirefnw",
        "39rh3brfn33gb"
    ],
    "FromDate": "2022-06-01",
    "ToDate": "2022-08-01",
    "PeopleDistributions": 
    {
        "NumberOfAdults": 2,
        "NumberOfChildren": 2,
        "ChildrenAges": 
        [
            10,
            12
        ]
    }
}

Estructura de la respuesta

  • Timestamp: (dateTime). Instante de tiempo en el que se procesó la petición. Formato ISO 8601 (yyyy-MM-ddThh:mm:ss.fffffff).
  • PrePackages: (list). Listado de prepaquetes disponibles.

    • PrePackage: (object). Información del prepaquete.
      • Id: (string). Identificador del prepaquete.
      • Order: (int). Orden para ser mostrados.
      • Image: (string). Url de la imagen promocional del prepaquete.
      • Description: (string). Descripción del prepaquete.
      • Name: (string). Nombre del prepaquete.
      • CommercialName: (string). Nombre comercial del prepaquete.
      • ProductPaxGroupings: (list). Listado de agrupación de productos.

        • ProductPaxGrouping: (object). Información de la agrupación de productos.

          • ProviderId: (string). Identificador del proveedor.
          • ProviderName: (string). Nombre del proveedor.
          • ProviderLocation: (string). Localización del proveedor.
            • Lat: (decimal). Coordenadas de latitud.
            • Lng: (decimal). Coordenadas de longitud.
          • DatePolicyKey: (int). Clave de políticas de fecha. Todos los productos con la misma clave, deberán compartir fecha de acceso.
          • TicketEnclosures: (list). Listado de recintos.
            • TicketEnclosure: (object). Información del recinto.
              • Id: (string). Identificador del recinto.
              • Name: (string). Nombre del recinto.
              • Logo: (string). Url de la imagen con el logotipo del recinto.
          • ValidDays: (int). Días de validez.
          • ValidDaysType: (int). Tipo de días de validez.

            Posibles valores
            • 0: Consecutive
            • 1: Non consecutive
          • ProductPaxGroupingId: (string). Identificador del producto agrupado.

          • ProductPaxGroupingName: (string). Nombre del producto agrupado.
        • SuggestedLocation: (object). Localización sugerida para búsqueda de alojamiento. Suele ser unas coordenadas calculadas céntricas entre todos los recintos del prepaquete.

          • Lat: (decimal). Coordenadas de latitud.
          • Lng: (decimal). Coordenadas de longitud.
  • Success: (boolean). Valor que indica si la llamada ha sido procesada correctamente o no.

  • Errors: (list). Array de errores.
    • Error: (object).
      • ErrorMessage: (string). Mensaje de error explicando por qué la petición no ha sido correcta. En caso que haya sido correcta, devolverá null.
      • ErrorCode: (int). Código que identifica al error.
  • ErrorEntityBreakDown (list): Lista que contiene objetos con el nombre e ID en caso de error.
    • Id (string): Identificador
    • Name (string): Nombre relacionado del identificador.

Ejemplo de respuesta

Example
{
    "PrePackages": 
    [
        {
            "Id": "bvqer8bv3b98s",
            "Order": 0,
            "Image": "https://api.cliente.experticket.com/api/prepackage/image?id=dfbwbbwbw",
            "Description": "Experiencia completa que incluye visita al parque de atracciones y visita guiada",
            "Name": "Experiencia completa",
            "CommercialName": "Expetiencia Completa",
            "ProductPaxGroupings": 
            [
                {
                    "ProviderId": "djifgbvirefnw",
                    "ProviderName": "Parque de atracciones",
                    "ProviderLocation": 
                    {
                        "Lat": 40.0000000,
                        "Lng": -5.1234567
                    },
                    "TicketEnclosures": 
                    [
                        {
                            "Id": "sdfjnbvisdbn5",
                            "Name": "Recinto Parque",
                            "Logo": "https://api.cliente.experticket.com/api/ticketenclosure/logo?id=7823biub7fb"
                        },
                        {
                            "Id": "isd7u7y1uft4c",
                            "Name": "Recinto visita",
                            "Logo": "https://api.cliente.experticket.com/api/ticketenclosure/logo?id=4th24hbwgbnw"
                        }
                    ],
                    "ValidDays": 1,
                    "ValidDaysType": 0,
                    "ProductPaxGroupingId": "ehrbmjhxhzo9n",
                    "ProductPaxGroupingName": "Experiencia completa: Parque + Visita Guiada"
                }
            ],
            "SuggestedLocation": 
            {
                "Lat": 35.878036,
                "Lng": -10.3826333
            }
        },
        {
            "Id": "bf34578gbrb29",
            "Order": 0,
            "Image": "https://api.cliente.experticket.com/api/prepackage/image?id=hedfbvhubvfi",
            "Description": "Entrada de Cine 4D, parque y pase express para evitar colas",
            "Name": "Entrada parque + cine + express",
            "CommercialName": "Entrada completa premium",
            "ProductPaxGroupings": 
            [
                {
                    "ProviderId": "39rh3brfn33gb",
                    "ProviderName": "Aventura Park",
                    "ProviderLocation": 
                    {
                        "Lat": 25.0000000,
                        "Lng": 20.1234567
                    },
                    "TicketEnclosures": 
                    [
                        {
                            "Id": "wrthw3rh35j4h",
                            "Name": "Cine 4D",
                            "Logo": "https://api.cliente.experticket.com/api/ticketenclosure/logo?id=asedhbtehb"
                        },
                        {
                            "Id": "wrj35yj35jw4t",
                            "Name": "Parque",
                            "Logo": "https://api.cliente.experticket.com/api/ticketenclosure/logo?id=tjyjnenrn"
                        }
                    ],
                    "ValidDays": 2,
                    "ValidDaysType": 0,
                    "ProductPaxGroupingId": "ehrbmjhxhzo9n",
                    "ProductPaxGroupingName": "Completo premium"
                }
            ],
            "SuggestedLocation": 
            {
                "Lat": 25.0000000,
                "Lng": 20.1234567
            }
        }
    ],
    "Success": true,
    "Timestamp": "2022-03-10T13:52:32.0509684"
}