Servicios

Guía completa de servicios de cenotes y tours, incluyendo opciones de transporte.

Vista General

Los servicios son ofertas adicionales que pueden ser:

Tipo	Descripción	Precio
`included`	Incluido en precio base	$0
`optional`	Se puede agregar por costo extra	Variable
`not_available`	No disponible para este item	N/A

Categorías de Servicio

Categoría	Ejemplos
`transportation`	Recogida en hotel, transporte privado
`equipment`	Snorkel, chaleco, traje de neopreno
`guide`	Guía bilingüe, instructor de buceo
`food`	Desayuno, almuerzo, snacks
`photo`	Fotos profesionales, video
`other`	Casillero, ducha, toalla

Obtener Servicios de Cenote

GET /cenotes/:id/services

Listar todos los servicios disponibles para un cenote específico.

curl -X GET "https://service-gateway.loscenotes.com/cenotes/cenote-uuid/services" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: es"

Parámetros de Consulta:

Parámetro	Tipo	Descripción
`bookableOnly`	boolean	Solo mostrar servicios reservables por separado

Respuesta:

{
  "success": true,
  "message": "cenote_services.list_retrieved_successfully",
  "data": [
    {
      "id": "service-uuid-1",
      "serviceId": "global-service-uuid",
      "name": {
        "es": "Chaleco salvavidas",
        "en": "Life jacket"
      },
      "description": {
        "es": "Chaleco salvavidas para todas las edades",
        "en": "Life jacket for all ages"
      },
      "category": "equipment",
      "inclusionType": "included",
      "price": 0,
      "isBookable": false,
      "isActive": true,
      "displayOrder": 1
    },
    {
      "id": "service-uuid-2",
      "serviceId": "global-service-uuid-2",
      "name": {
        "es": "Equipo de snorkel",
        "en": "Snorkel equipment"
      },
      "description": {
        "es": "Máscara, snorkel y aletas",
        "en": "Mask, snorkel and fins"
      },
      "category": "equipment",
      "inclusionType": "optional",
      "price": 5000,
      "isBookable": true,
      "isActive": true,
      "displayOrder": 2
    },
    {
      "id": "service-uuid-3",
      "serviceId": "global-service-uuid-3",
      "name": {
        "es": "Transporte desde hotel",
        "en": "Hotel pickup"
      },
      "description": {
        "es": "Recogida y regreso a tu hotel en la zona hotelera",
        "en": "Pickup and return to your hotel in the hotel zone"
      },
      "category": "transportation",
      "inclusionType": "included",
      "price": 0,
      "isBookable": false,
      "isActive": true,
      "displayOrder": 3,
      "transportConfig": {
        "vehicleTypes": ["van", "bus"],
        "maxCapacity": 15,
        "pricePerKm": 150
      }
    }
  ],
  "currency": {
    "code": "MXN",
    "symbol": "$"
  }
}

Opciones de Transporte de Tours

GET /booking/tours/:tourId/transportation-options

Obtener opciones de transporte disponibles para un tour.

curl -X GET "https://service-gateway.loscenotes.com/booking/tours/tour-uuid/transportation-options" \
  -H "Content-Type: application/json"

Respuesta:

{
  "success": true,
  "message": "tour_transportation_options.retrieved_successfully",
  "data": {
    "tourId": "tour-uuid",
    "options": [
      {
        "type": "meeting_point",
        "name": {
          "es": "Punto de encuentro",
          "en": "Meeting point"
        },
        "description": {
          "es": "Llega directamente al punto de encuentro",
          "en": "Arrive directly at the meeting point"
        },
        "price": 0,
        "available": true,
        "meetingPoints": [
          {
            "id": "mp-1",
            "name": "Entrada principal del cenote",
            "address": "Carretera Tulum-Coba km 15",
            "latitude": 20.2345,
            "longitude": -87.4567
          }
        ]
      },
      {
        "type": "hotel_pickup",
        "name": {
          "es": "Recogida en hotel",
          "en": "Hotel pickup"
        },
        "description": {
          "es": "Te recogemos en el lobby de tu hotel",
          "en": "We pick you up at your hotel lobby"
        },
        "price": 15000,
        "available": true,
        "zones": ["Cancun", "Playa del Carmen", "Riviera Maya"],
        "pickupTimes": ["07:00", "07:30", "08:00"]
      },
      {
        "type": "private_transfer",
        "name": {
          "es": "Transporte privado",
          "en": "Private transfer"
        },
        "description": {
          "es": "Vehículo exclusivo para tu grupo",
          "en": "Exclusive vehicle for your group"
        },
        "price": 45000,
        "available": true,
        "vehicles": [
          {
            "type": "suv",
            "capacity": 6,
            "price": 45000
          },
          {
            "type": "van",
            "capacity": 12,
            "price": 65000
          }
        ]
      }
    ]
  }
}

Tipos de Transporte

meeting_point

El huésped llega al punto de encuentro designado por su cuenta.

Precio: Generalmente gratis
Requiere: Sin info adicional

hotel_pickup

Recogida y regreso al hotel del huésped.

Precio: Fijo o basado en distancia
Requiere:
- pickupLocation - Nombre del hotel
- pickupLatitude - Latitud
- pickupLongitude - Longitud

private_transfer

Vehículo exclusivo para el grupo.

Precio: Basado en tipo de vehículo
Requiere: Igual que hotel_pickup más selección de vehículo

Tipos de Inclusión de Servicio

included

El servicio ya está incluido en el precio base. Sin cargo adicional.

{
  "inclusionType": "included",
  "price": 0,
  "isBookable": false
}

optional

El servicio puede agregarse por un costo adicional. Debe seleccionarse explícitamente.

{
  "inclusionType": "optional",
  "price": 5000,
  "isBookable": true
}

not_available

El servicio no está disponible para este cenote/tour.

{
  "inclusionType": "not_available",
  "price": null,
  "isBookable": false
}

Usando Servicios en Precios

Al llamar /pricing/calculate-complete, incluye los IDs de servicios opcionales:

{
  "itemType": "cenote",
  "itemId": "cenote-uuid",
  "ageBreakdown": {
    "adult": 2,
    "child": 1
  },
  "selectedServices": [
    "optional-service-uuid-1",
    "optional-service-uuid-2"
  ],
  "transportationType": "hotel_pickup",
  "pickupLocation": "Hotel Xcaret",
  "pickupLatitude": 20.4567,
  "pickupLongitude": -87.1234
}

La respuesta incluirá:

services.included - Lista de servicios incluidos (sin cargo extra)
services.selected - Lista de servicios opcionales seleccionados (con costos)
services.totalServicesCost - Costo total de servicios opcionales

Códigos de Error

Código	Mensaje	Descripción
`SERVICE_NOT_FOUND`	error.service.not_found	ID de servicio no encontrado
`SERVICE_NOT_AVAILABLE`	error.service.not_available	Servicio no disponible para este item
`SERVICE_NOT_BOOKABLE`	error.service.not_bookable	El servicio no puede reservarse por separado

Vista General​

Categorías de Servicio​

Obtener Servicios de Cenote​

GET /cenotes/:id/services​

Opciones de Transporte de Tours​

GET /booking/tours/:tourId/transportation-options​

Tipos de Transporte​

meeting_point​

hotel_pickup​

private_transfer​

Tipos de Inclusión de Servicio​

included​

optional​

not_available​

Usando Servicios en Precios​

Códigos de Error​