Sign in

v1

latestOpenAPI 3.0.32026-07-2410639570.9 KB
Kissflow Webhook - V1

Crear hotel desde Kissflow

Endpoint invocado por Kissflow (herramienta interna de workflow de onboarding) cuando el equipo comercial de Ayenda aprueba la creación de un nuevo hotel en el canal Ayenda.

A diferencia de Loggro Sales, crea solo un Hotel (sin Company). El hotel queda listo para operar en la plataforma Ayenda con usuario admin, plan, comisiones y contrato.

El procesamiento es asíncrono: el controller valida los params, encola el job Kissflow::CreateHotelJob y responde 201 inmediatamente.

Campos requeridos según plan:

  • Plan basic: solo ID_Booking es obligatorio (el hotel se construye desde Booking.com).
  • Otros planes: Name_AOS, User_Name_AOS y Country_Code_AOS son obligatorios.

Test de conectividad: si User_Email_AOS contiene 'SingleLine TextValue', Kissflow está verificando la conexión — el endpoint responde 200 sin crear nada.

Sin autenticación ⚠️ — este endpoint no valida ningún token.

post/api/kissflow/hotels

Request body

Name_AOSstring

Nombre del hotel. Requerido para planes distintos a basic.

User_Name_AOSstring

Nombre del usuario administrador del hotel. Requerido para planes distintos a basic.

User_Last_Name_AOSstring

Apellido del usuario administrador.

User_Email_AOSstring email

Email del usuario administrador. Si contiene 'SingleLine TextValue' activa el test de conectividad.

Distribution_Name_AOSstring

Nombre de distribución del hotel (slug base). Si se omite, usa Name_AOS.

Latitude_AOSstring

Latitud geográfica del hotel.

Longitude_AOSstring

Longitud geográfica del hotel.

Person_type_AOSstring

Tipo de persona del perfil fiscal. Si se omite, usa natural.

Document_type_AOSstring

Tipo de documento del perfil fiscal.

Regime_AOSstring

Régimen fiscal del hotel.

Tax_AOSstring

Nombre del impuesto a aplicar. Si se omite, usa IVA (19%).

Person_Name_AOSstring

Nombre de la persona o empresa en el perfil fiscal.

Document_number_AOSstring

Número de documento del perfil fiscal.

Address_AOSstring

Dirección del hotel.

Email_Reservas_AOSstring email

Email de contacto para reservas. Se usa como email del usuario admin si User_Email_AOS está vacío.

Phone_AOSstring

Teléfono del hotel.

Tope_de_Ventas_AOSstring

Mínimo garantizado de ventas del hotel.

Neighborhood_AOSstring

Nombre del barrio. Se busca por nombre exacto; si no existe, usa el primero disponible.

Currency_AOSstring

Moneda del hotel.

Zona_Horaria_AOSstring

Zona horaria del hotel. Si se omite, usa America/Bogota.

Country_Code_AOSstring

Código de país. Requerido para planes distintos a basic.

Cost_per_room_AOSstring

Costo por habitación.

Email_Liquidacion_AOSstring email

Email para liquidaciones. Si se omite, usa Email_Reservas_AOS.

ID_Bookingstring

ID de la propiedad en Booking.com. Requerido cuando Plan es basic.

Planstring

Plan del hotel. Valores conocidos — basic, medium, plus. Si se omite, usa plus.

Cantidad_de_habitacionesinteger

Cantidad de habitaciones del hotel. Si se omite, usa 999.

Example request

{
  "Name_AOS": "Hotel Prueba Ayenda",
  "User_Name_AOS": "Juan",
  "User_Last_Name_AOS": "Pérez",
  "User_Email_AOS": "juan.perez@hotel.com",
  "Distribution_Name_AOS": "Hotel Prueba Ayenda",
  "Latitude_AOS": "4.710989",
  "Longitude_AOS": "-74.072090",
  "Person_type_AOS": "juridica",
  "Document_type_AOS": "NIT",
  "Regime_AOS": "comun",
  "Tax_AOS": "IVA (19%)",
  "Person_Name_AOS": "Empresa Prueba S.A.S.",
  "Document_number_AOS": "900123456",
  "Address_AOS": "Calle 78 # 12-34",
  "Email_Reservas_AOS": "reservas@hotel.com",
  "Phone_AOS": "3001234567",
  "Tope_de_Ventas_AOS": "500000",
  "Neighborhood_AOS": "Chapinero",
  "Currency_AOS": "COP",
  "Zona_Horaria_AOS": "America/Bogota",
  "Country_Code_AOS": "CO",
  "Cost_per_room_AOS": "15000",
  "Email_Liquidacion_AOS": "liquidacion@hotel.com",
  "ID_Booking": "1234567",
  "Plan": "plus",
  "Cantidad_de_habitaciones": 20
}

Response

ok — test de conectividad de Kissflow

messagestring

Example response

{
  "message": "Successful connection"
}