Lista de comprobación para la puesta en producción

Usa esta lista de comprobación antes de habilitar una integración de socio para instalaciones en producción.

Configuración de la Partner Console

Tu perfil de socio está completo.
La URL del logotipo, el sitio web, la categoría y la descripción son correctos.
El método de vinculación de datos está configurado: Direct Link o Linking Identifier.
La vinculación de instalaciones se probó con al menos una instalación real.
Se usa el tipo de clave adecuado:
- Dryrun para pruebas de escritura no destructivas.
- Read-only para consumir datos de forma segura.
- Live solo cuando estés listo para afectar los datos de producción.

Autenticación y administración de claves

Las claves secretas se guardan solo en el servidor.
Las claves no están incrustadas en aplicaciones del lado del cliente, aplicaciones móviles, repositorios públicos ni tickets de soporte.
Se probaron la rotación y la revocación de claves.
Tu equipo sabe qué clave usa cada entorno.

Validación de datos

Los campos obligatorios están presentes en cada endpoint al que llamas.
Los identificadores de instalación coinciden con el método de vinculación configurado.
Los ID de tu sistema son estables y no cambian entre sincronizaciones.
Las importaciones grandes se dividen en lotes que respetan los límites documentados.
Los elementos de lote fallidos se pueden identificar y volver a enviar.

Pruebas de endpoints

Antes del lanzamiento, prueba todos los endpoints de los que depende tu integración:

Se pueden leer las organizaciones y las instalaciones.
Se pueden guardar y actualizar miembros.
Los planes de membresía, las zonas de acceso y los horarios de acceso se sincronizan correctamente.
Los registros de entrada se aceptan y se pueden relacionar con tu sistema.
Las instantáneas de informes usan el período de informe y las métricas previstos.
Los flujos del controlador de puertas y portones se prueban con hardware real, cuando corresponde.

Preparación de Access Time Windows

Si la integración proporciona Access Time Windows:

Los ejemplos absolutos y semanales superan la lista de comprobación de certificación del productor.
Las épocas son segundos Unix enteros sin comillas; se probaron los límites exactos [from, to).
Se verificaron los valores predeterminados en UTC, las zonas horarias IANA personalizadas de la integración y los cambios de horario de verano pertinentes.
Una única secuencia de revisiones duradera y monótona por miembro y fuente coordina las actualizaciones incrementales, la conciliación y los reintentos.
Los operadores entienden el comportamiento de los valores omitidos, el reemplazo completo, las repeticiones idempotentes, los conflictos, los datos obsoletos y el [] explícito.
Cada scope_key, incluido default, tiene una asignación aprobada en el Performance Hub; se probó que las claves desconocidas deniegan el acceso.
Están configurados la frecuencia de actualización prevista de la integración, la antigüedad máxima de la fuente, el comportamiento ante fuentes obsoletas y las alertas.
Se comprobó que un error en la consulta a la fuente de origen no emite una instantánea vacía ni parcial.
La convergencia de la secuencia en el entorno de pruebas, la cancelación o revocación y los límites de inicio y fin en las puertas físicas cumplen los objetivos acordados.
Se verificaron las reglas habituales y los permisos permanentes como vías alternativas, y las ventanas no pueden omitir la desactivación del usuario, blockAllAccess, el mantenimiento ni la geovalla.

Preparación del control de acceso

En las integraciones de control de acceso:

Tu sistema toma la decisión de acceso antes de llamar al Performance Hub.
La integración gestiona device_offline, maintenance_mode_active y unlock_confirmation_timeout.
Los operadores entienden que un tiempo de espera agotado significa que el desbloqueo no se confirmó.
Tus registros guardan el event_id y el command_id devueltos.
Tienes un proceso alternativo manual para el personal de la instalación.

Gestión de errores y reintentos

Las respuestas 400, 401, 403, 404, 409 y 422 se muestran a los operadores o a los equipos de soporte en lugar de reintentarse a ciegas.
Las respuestas 429, 500, 502, 503 y 504 usan una lógica de reintento acotada con retroceso.
Los errores repetidos generan una alerta en tu sistema.
La integración nunca descarta registros fallidos de forma silenciosa.

Observabilidad

Tus registros incluyen el endpoint, la marca de tiempo, el identificador de instalación, el ID del registro de origen, el resultado de la solicitud y el cuerpo de la respuesta.
Tu equipo de soporte puede buscar por ID de miembro, ID de instalación, ID de registro de entrada o ID de evento de desbloqueo.
Tienes una forma de repetir o conciliar las sincronizaciones fallidas.

Lanzamiento en producción

El Performance Hub confirmó tu acceso a producción.
Al menos una instalación de producción habilitó tu integración.
Tu clave de producción está activa.
Tus contactos operativos y técnicos están actualizados.
Tu proceso de soporte está documentado para los clientes.

Una vez completadas estas comprobaciones, tu integración configurada aparecerá en el directorio de socios del Performance Hub, dentro de la plataforma principal del Performance Hub.