Setup de RENAPER

Detalle

Campo	Valor
Manual de Usuario	Setup de RENAPER
Módulo	Herramientas
Formulario	FormRenaper_Setup
Tipo de pantalla	Configuración de integración (validación de identidad)

Introducción

RENAPER (Registro Nacional de las Personas) es el servicio de validación de identidad que Plenario v14 utiliza para el onboarding digital de personas: alta de operación, captura de imágenes del documento (frente y dorso), selfie, lectura de código de barras y consulta de datos de la persona. La integración se realiza mediante el proveedor de onboarding (VU Security) y se divide en paquetes de servicio (1, 2 y 3), cada uno con su propia API Key.

La pantalla Setup de RENAPER centraliza el dominio del servicio, las API Keys por paquete y los interruptores que habilitan la validación.

Acceso al módulo

Se ingresa desde el menú Herramientas → Renaper → Setup de la aplicación de escritorio. El botón valida el permiso correspondiente antes de abrir el formulario; si el usuario no lo tiene, la pantalla no se abre.

Pantalla principal

Formulario modal titulado "Renaper Setup". Carga automáticamente la configuración existente. Presenta los campos de identificación de la persona de prueba, las tres API Keys, el dominio y dos casillas de control (Activo y Validar). Los cambios se confirman con Aceptar.

Parámetros

Campo	Descripción
Numero	Número de documento (usado como dato de referencia/prueba de la configuración).
Genero	Género de la persona, en el formato que espera RENAPER (por ejemplo M / F).
ApiKey	API Key del paquete 1 (onboarding: alta de operación, frente, dorso, selfie, código de barras, fin de operación).
ApiKey Paq3	API Key del paquete 3 (consulta de datos de la persona — personData).
ApiKey Paq2	API Key del paquete 2 (login biométrico facial).
Dominio	URL/dominio base del servicio de onboarding de RENAPER contra el que se envían las solicitudes.
Activo	Habilita o deshabilita la configuración.
Validar	Interruptor "ValidarRenaper": cuando está activo, el sistema ejecuta realmente las llamadas contra RENAPER. Si está desactivado, los métodos no validan contra el servicio.

Nota: Las API Keys son credenciales sensibles entregadas por el proveedor de RENAPER/onboarding. No deben divulgarse.

Resultado del proceso

Al presionar Aceptar, el sistema valida el formulario y guarda la configuración. Si el guardado es exitoso, la ventana se cierra. Si falla, se muestra "No se pudo guardar renaper setup". Ante un error inesperado, se registra en el log de la aplicación y se muestra el aviso genérico para avisar a Sistemas.

Acciones disponibles

Cargar dominio y API Keys por paquete (1, 2 y 3).
Activar / desactivar la configuración con la casilla Activo.
Habilitar la validación real con la casilla Validar (ValidarRenaper).
Guardar: botón Aceptar.

Ejemplo práctico

El proveedor de onboarding entrega el dominio del servicio y las API Keys de los paquetes contratados.
El operador ingresa a Herramientas → Renaper → Setup.
Completa Dominio, ApiKey (paquete 1) y, según lo contratado, ApiKey Paq2 y ApiKey Paq3.
Marca Activo y Validar.
Presiona Aceptar. El onboarding de identidad queda operativo.

Consejos útiles

Validar controla si las llamadas se ejecutan realmente: para pruebas de configuración sin consumir el servicio, dejalo desmarcado.
Cargá la API Key del paquete que vayas a usar; el paquete 1 cubre el onboarding básico, el 2 el login facial y el 3 la consulta de datos personales.
Verificá que el Dominio corresponda al ambiente productivo antes de validar identidades reales.
Existe una única fila de configuración: al guardar se actualiza la existente.

Preguntas frecuentes

¿Cuál es la diferencia entre Activo y Validar?

Activo marca la fila de configuración como vigente; Validar (ValidarRenaper) es el interruptor que el cliente REST consulta para decidir si ejecuta las llamadas reales contra RENAPER.

¿Para qué sirven las tres API Keys?

Cada una corresponde a un paquete de servicios: paquete 1 (onboarding/documento), paquete 2 (login biométrico facial) y paquete 3 (consulta de datos de la persona).

¿Qué cargo en Numero y Genero?

Son datos de identificación de la persona que se usan como referencia de la configuración. La operatoria real toma el documento y género de cada operación de onboarding.

¿Puedo dejar de validar sin borrar las API Keys?

Sí. Desmarcá Validar (y/o Activo) y guardá; las API Keys se conservan.

Permisos

Para abrir el formulario el usuario debe tener habilitado el permiso Herramientas.Renaper.Setup (categoría padre Herramientas.Renaper). Descripción del permiso en el sistema: "Permite el ingreso al formulario Setup de Renaper".

Información técnica

Basada en el análisis del formulario real de la v14

Formularios principales

Form	Rol
FormRenaper_Setup	Pantalla de configuración de dominio, API Keys por paquete e interruptores de validación

Permisos reales

Permiso	Acción
Herramientas.Renaper.Setup	Permite el ingreso al formulario Setup de Renaper

Tablas de base de datos principales

Tabla	Uso
Renaper_Setup	Almacena la configuración: Numero, Genero, ApiKey, ApiKey_Paq2, ApiKey_Paq3, Dominio, Activo, ValidarRenaper
Renaper_Log	Log de operaciones de onboarding contra RENAPER (consumido por el cliente REST, no por este form)

Relación con otros módulos / manuales

Manual relacionado	Vínculo operativo
Configuración SETUP (NOSIS/VERAZ/AFIP/SMS) - Herramientas	Amplía el circuito, la configuración o los datos que utiliza esta funcionalidad.

Notas para soporte

El cliente REST (Rest_RENAPER) lee la fila con Activo = true y solo ejecuta las llamadas cuando ValidarRenaper está en verdadero.
Los endpoints de onboarding (newOperation, addFront, addBack, register, scanBarcode, endOperation, login facial, personData) se construyen sobre el Dominio configurado.
Formulario de tecnología legacy (WinForms/DevExpress sobre EF). Verificar contra el binario instalado en el cliente.

Ver también

Configuración SETUP (NOSIS/VERAZ/AFIP/SMS) - Herramientas