Crear una llave de la API
Crea una llave para que otro sistema (contabilidad, ERP, cerraduras, BI) se conecte con tu hotel en Revenia, con los permisos que tú eliges.
Para: Dueño, Administrador, Revenue ManagerActualizado el 02/11/2026
En este artículo
Con la API de Revenia otros sistemas leen y crean reservas, consultan disponibilidad y precios, cargan consumos al folio y reciben avisos (webhooks) cuando algo cambia. Cada sistema usa su propia llave, con los permisos que le das en Configuración → API. Este artículo explica la parte del hotel; los detalles técnicos para el programador están en la documentación de la API.
Antes de empezar
- Pueden hacerlo el Dueño, el Administrador y el Revenue Manager.
- La API está incluida en los planes Pro y AI Premium. En otros planes la pantalla muestra "La API está incluida en los planes Pro y AI Premium." y el enlace Ver planes.
- Cada llave pertenece a una sola propiedad y solo ve esa propiedad. Una propiedad puede tener hasta 20 llaves.
Paso a paso
- Entra a Configuración → API.
- En Nueva llave escribe un Nombre que diga quién la usa, por ejemplo "ERP contabilidad". Ese nombre aparece en el historial de cada reserva que cambie el sistema.
- En Permisos marca solo lo que el sistema necesita (ver la tabla). Los permisos de lectura vienen marcados.
- Pulsa Crear llave.
- Aparece la llave completa (empieza con
rvk_). Pulsa Copiar y entrégala al programador por un medio seguro. - Pulsa Listo. La llave aparece en Llaves y conexiones.
Importante: la llave se muestra una sola vez. Revenia solo guarda una huella y no la puede volver a mostrar. Si se pierde, crea otra y revoca la anterior.
Qué permite cada permiso
| Permiso | Qué permite |
|---|---|
| Propiedad | Ver datos de la propiedad, tipos de habitación y habitaciones. |
| Disponibilidad y precios | Ver habitaciones libres por noche y cotizar con el precio final. |
| Ver reservas | Ver reservas con su huésped y totales; recibir avisos de reservas. |
| Manejar reservas | Crear, cambiar y cancelar reservas, check-in y check-out (incluye verlas). |
| Ver huéspedes | Ver los huéspedes que tienen reservas en esta propiedad. |
| Ver folios | Ver cargos, pagos y saldos; recibir avisos de pagos. |
| Cargar al folio | Agregar consumos y servicios al folio. No cobra ni reembolsa. |
| Tarifas y restricciones | Cambiar precios por fechas y restricciones; se publica en los canales. Solo funciona desde un asistente de IA (MCP). |
| Webhooks | Registrar direcciones que reciben avisos de cambios. |
Las reservas y cargos que hace un sistema siguen las mismas reglas que recepción (disponibilidad, restricciones, política de cancelación, saldo en cero para el check-out) y el huésped recibe los mismos correos. Los pagos y reembolsos siempre se registran en recepción.
Uso del mes y revocar una llave
En Uso este mes ves cuántas llamadas se hicieron, sumando todas las llaves de la propiedad (también las revocadas). La cuota se renueva el día 1 de cada mes. En Llaves y conexiones ves cada llave con sus permisos, sus llamadas del mes, cuándo se creó, su última consulta y sus webhooks.
Para cortar el acceso de un sistema, pulsa Revocar en su llave y luego Revocar el acceso. Deja de funcionar en el acto y se borran sus webhooks. No se puede deshacer. Para quitar solo un webhook que ya no sirve, pulsa Quitar junto a su dirección.
Preguntas frecuentes
Perdí la llave. ¿Puedo volver a verla?
No. Revenia no guarda la llave completa. Crea una nueva, dásela al sistema y revoca la anterior.
Me sale "Tu plan no incluye la API".
La API está en los planes Pro y AI Premium. Revisa tu plan en Configuración → Plan.
Me sale "Elige al menos un permiso" o "Ponle un nombre a la llave".
Toda llave necesita un nombre y al menos un permiso marcado.
Me sale "Una propiedad puede tener hasta 20 llaves".
Revoca las llaves que ya no se usan y crea la nueva.
El programador dice que la API responde "429".
Hay dos límites: llamadas por minuto por llave, y una cuota de llamadas por mes. Si se llegó a la cuota del mes, la API responde 429 hasta el día 1 del mes siguiente. Revisa Uso este mes.
¿Cómo sé qué cambió un sistema externo?
Cada cambio queda en el historial de la reserva con el nombre de la llave.
¿Un sistema puede cobrar o reembolsar con la API?
No. Puede agregar cargos al folio (con el permiso Cargar al folio), pero los pagos y reembolsos se registran en recepción.
¿Qué es una "Conexión con inicio de sesión" en la lista?
Es un asistente de IA (por ejemplo claude.ai o ChatGPT) que alguien del equipo conectó entrando con su cuenta de Revenia. Se revoca igual que una llave. Ver Conectar un asistente de IA.
Relacionado
¿Te quedó alguna duda? En Revenia, abre Ayuda en el menú y escríbenos.