# Avvican - Viviendas Vacacionales en Gran Canaria

## About
Avvican is a professional vacation rental management company based in Gran Canaria, Canary Islands, Spain. We manage holiday homes (viviendas vacacionales) for property owners and offer them to travelers looking for authentic accommodation experiences.

## Services
- Vacation rental management for property owners
- Holiday home booking for travelers
- Professional cleaning and maintenance
- Guest support 24/7
- Revenue management and dynamic pricing
- Legal compliance (VV licenses, tourist tax, traveler registration)

## Location
Gran Canaria, Canary Islands, Spain
Zones: Las Palmas de Gran Canaria, Maspalomas, Mogán, Agaete, Tejeda

## Agent API Endpoints (for AI agents)

### Discovery
- GET /.well-known/actions.json — Machine-readable OpenAPI 3.1 manifest
- GET /agent-api/health — Health check and endpoint directory

### Properties
- GET /agent-api/properties — List all available properties
  - Query params: location, guests, min_price, max_price
  - Returns: { data: [...], total: number }
  - Each property includes bookingUrl: AvaiBook checkout deep-link (https://www.avaibook.com/reservas/nueva_reserva.php?cod_alojamiento={id})
    Append &f_ini=YYYY-MM-DD&f_fin=YYYY-MM-DD&lang=es when dates are known. Do NOT append guest count.
- GET /agent-api/properties/{slug} — Get full property details
  - Returns: { data: { slug, title, description, location, city, guests, bedrooms, bathrooms, pricePerNight, amenities, coverImage, bookingUrl } }

### Availability & Booking
- POST /agent-api/check-availability — Check property availability for given dates
  - Body: { property_slug, check_in, check_out, guests }
  - Returns: { available, check_in, check_out, nights, guests, pricing: { price_per_night, total, currency } }
- POST /agent-api/create-booking — Create a reservation hold and return AvaiBook payment URL (requires API key)
  - Body: { property_id, check_in, check_out, guests, guest_name, guest_email, guest_phone }
  - Authentication: X-API-Key header required — contact info@avvican.com
  - Returns: { status: "pending_payment", reservationId, payment_url, next_step }
  - IMPORTANT: This endpoint creates a hold (PENDING_PAYMENT) in AvaiBook. Payment and final
    confirmation are completed by the guest at payment_url on AvaiBook's own checkout. This API
    never processes card data and never returns a confirmed/paid status.

### AI Orchestration
- POST /agent-api/guarded-run — Natural-language booking orchestration with safety guardrails (requires API key)
  - Body: { intent, context?, max_steps?, confirm_booking? }
  - Returns: { status: "success"|"requires_confirmation"|"blocked", reasoning, tool_calls_used, result }

## Structured Data
All property pages include JSON-LD with Schema.org VacationRental type.
Homepage includes Organization schema.
Blog posts include Article schema.

## Booking Engine
Reservations are processed through AvaiBook (PMS).
Direct integration via Owner API — bookings are created in real time.
Each property has a booking URL for immediate reservation.

## Contact
- Website: https://avvican.com
- Email: info@avvican.com
- Instagram: https://www.instagram.com/avvican
- Facebook: https://www.facebook.com/avvican

## Languages
Content available in: Spanish (primary), English, German, French, Norwegian, Swedish, Danish, Russian
API responses in: English (data fields) with multilingual content

## Technical
- Framework: Next.js 14 (App Router)
- CMS: Sanity.io
- Hosting: Vercel
- Booking Engine: AvaiBook by Idealista