Conectar Opera Cloud (OHIP) con ConectaPUI

En el Developer Portal de OHIP del hotel, navega a Application Management. Hay una guía oficial paso a paso Registering an Application.

1. Click en "Register Application".
2. Application Name: ConectaPUI. Description: "Sincronización automática con padrón PUI México".
3. Selecciona los scopes de lectura para Profiles, Reservations y Configuration. Estos son los APIs que ConectaPUI necesita para extraer huéspedes y reservaciones.
4. Guarda. Oracle genera el Application Key (App Key).
5. Cópialo de inmediato — Oracle también tiene Viewing Application Key y reemisión si lo pierdes.

En el Developer Portal entra a Environments → Viewing Environment Details (la sección depende de OCIM o SSD, pero los datos son los mismos):

• Gateway URL: URL base para llamadas a las APIs. Ejemplo: https://nombredelhotel.hospitality.oracleindustry.com.
• Token URL: URL completa del Identity Server donde se piden los access tokens OAuth 2.0. Ejemplo: https://idcs-xyz.identity.oraclecloud.com/oauth2/v1/token.
• OAuth Client ID y Client Secret: visibles en Viewing/Issuing Client Secret. Distinto del App Key. Si lo pierdes, Oracle ofrece reemisión: Changing Your Client Secret.
• Enterprise ID (sólo OCIM): valor del header obligatorio enterpriseId al pedir el token.
• Integration Username + Password (sólo SSD): se emite junto con el environment.

El Hotel ID (también llamado "Property Code" en algunos UI) es el código de 3-5 caracteres mayúsculas que identifica tu hotel dentro de Opera. Se envía como header x-hotelid en cada llamada API.

Lo encuentras en Opera bajo Property Management → Property Configuration, columna "Code". Ejemplos típicos: ABC01, HMTY.

1. En el dashboard de ConectaPUI, navega a Integraciones → Opera Cloud.
2. Selecciona el esquema de autenticación: OCIM o SSD (Paso 0).
3. Pega tus credenciales: App Key, OAuth Client ID, Client Secret, Gateway URL, Token URL, Hotel ID.
4. Si OCIM, agrega Enterprise ID. Si SSD, agrega Integration Username + Password.
5. Click en "Validar y conectar". ConectaPUI hace una llamada de prueba al Token URL para validar que las credenciales sean correctas. Si falla, te dice exactamente qué corregir.
6. Si la validación pasa, las credenciales se guardan encriptadas (AES-256-GCM) y la integración queda activa.

Opera Cloud no tiene un campo nativo para CURP — los hoteles típicamente lo almacenan en un User Defined Field (UDF) del perfil de huésped. ConectaPUI necesita saber el nombre exacto del UDF para extraer la CURP en cada sync.

1. En Opera, ve a Configuration → Profile → User Defined Fields y verifica el nombre exacto que el hotel asignó al campo de CURP. Ejemplos comunes: CURP, CURP_HUESPED, ID_NACIONAL.
2. En el dashboard de ConectaPUI, en la tarjeta "Campo CURP en Opera", escribe ese nombre y guarda.
3. Si tu hotel todavía no captura CURP, créalo: Configuration → Profile → User Defined Fields → Add con el nombre CURP y tipo "Alphanumeric, 18 chars". Asegúrate de que recepción capture este campo en el check-in.

Con todo configurado, dispara una sincronización manual desde el dashboard. La primera puede tomar varios minutos según el volumen de huéspedes y reservaciones del hotel.

Modo beta: mientras estamos validando la integración con los primeros clientes Opera Cloud, OrigenLabs participa manualmente en la primera sync para validar el mapeo de campos contra las APIs reales de OHIP. Esto es transparente para ti — el sync dispara igual desde el botón, y nosotros verificamos los datos antes de marcar el registro como completo.