---
title: "Crear hotel desde Kissflow"
method: POST
path: "/api/kissflow/hotels"
tags: ["Kissflow Webhook - V1"]
---

# Crear hotel desde Kissflow

`POST /api/kissflow/hotels`

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.

## Request body

- object
  - `Name_AOS` string — Nombre del hotel. Requerido para planes distintos a `basic`.
  - `User_Name_AOS` string — Nombre del usuario administrador del hotel. Requerido para planes distintos a `basic`.
  - `User_Last_Name_AOS` string — Apellido del usuario administrador.
  - `User_Email_AOS` string, email — Email del usuario administrador. Si contiene `'SingleLine TextValue'` activa el test de conectividad.
  - `Distribution_Name_AOS` string — Nombre de distribución del hotel (slug base). Si se omite, usa `Name_AOS`.
  - `Latitude_AOS` string — Latitud geográfica del hotel.
  - `Longitude_AOS` string — Longitud geográfica del hotel.
  - `Person_type_AOS` string — Tipo de persona del perfil fiscal. Si se omite, usa `natural`.
  - `Document_type_AOS` string — Tipo de documento del perfil fiscal.
  - `Regime_AOS` string — Régimen fiscal del hotel.
  - `Tax_AOS` string — Nombre del impuesto a aplicar. Si se omite, usa `IVA (19%)`.
  - `Person_Name_AOS` string — Nombre de la persona o empresa en el perfil fiscal.
  - `Document_number_AOS` string — Número de documento del perfil fiscal.
  - `Address_AOS` string — Dirección del hotel.
  - `Email_Reservas_AOS` string, email — Email de contacto para reservas. Se usa como email del usuario admin si `User_Email_AOS` está vacío.
  - `Phone_AOS` string — Teléfono del hotel.
  - `Tope_de_Ventas_AOS` string — Mínimo garantizado de ventas del hotel.
  - `Neighborhood_AOS` string — Nombre del barrio. Se busca por nombre exacto; si no existe, usa el primero disponible.
  - `Currency_AOS` string — Moneda del hotel.
  - `Zona_Horaria_AOS` string — Zona horaria del hotel. Si se omite, usa `America/Bogota`.
  - `Country_Code_AOS` string — Código de país. Requerido para planes distintos a `basic`.
  - `Cost_per_room_AOS` string — Costo por habitación.
  - `Email_Liquidacion_AOS` string, email — Email para liquidaciones. Si se omite, usa `Email_Reservas_AOS`.
  - `ID_Booking` string — ID de la propiedad en Booking.com. Requerido cuando `Plan` es `basic`.
  - `Plan` string — Plan del hotel. Valores conocidos — `basic`, `medium`, `plus`. Si se omite, usa `plus`.
  - `Cantidad_de_habitaciones` integer — Cantidad de habitaciones del hotel. Si se omite, usa `999`.

## Response `200`

ok — test de conectividad de Kissflow

- object
  - `message` string

## Other responses

- `201` — created — hotel encolado para creación
- `400` — bad request — params insuficientes para el plan indicado

---

[API](https://skmtc.net/loggro/apis/documentos-electr-nicos.md) · [All operations](https://skmtc.net/loggro/apis/documentos-electr-nicos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loggro/documentos-electr-nicos/revisions/f390b90daf37/schema)