🧩 Qué resuelve
Cuando contratas a un candidato, sus datos tienen que llegar al equipo de nómina para tramitar el alta. Con esta integración, Viterbit envía esos datos a a3innuva Nómina en el momento de la contratación, sin tener que copiarlos a mano.
Tu equipo de nómina recibe la solicitud en a3innuva y solo tiene que completar los datos laborales (convenio, categoría, cotización…) y confirmarla.
✅ Requisitos previos
Para utilizar la integración necesitas:
a3innuva Nómina, la versión cloud de Wolters Kluwer.
Conectia, el módulo de integraciones de Wolters Kluwer. Se contrata directamente con Wolters Kluwer y, al hacerlo, recibirás un correo con los pasos para activarlo.
Un plan de Viterbit que incluya el Marketplace HRIS.
⚠️ Importante: La integración no es compatible con a3nom, la versión de escritorio.
🔑 Credenciales de Wolters Kluwer
Antes de instalar la integración necesitas tres datos: la API Key, el Client ID y el Client Secret.
API Key
Genérala en Mi Wolters Kluwer › Mis soluciones › Conectia.
Si no ves ese menú, pide al administrador de tu cuenta de a3innuva que te asigne los permisos.
Client OAuth
Solicítalo en ese mismo apartado mediante el formulario a3Developers – Configuración cliente OAuth, con estos datos:
Solución: a3innuva Nómina / a3Equipo
Tipo de solicitud: Necesito crear un nuevo client OAuth
Redirect URI: https://app.viterbit.com/oauth/a3innuva_check/
Tipo de Flow: Authorization code (opción por defecto)
Expiración del Refresh-token: Sliding
CIF y código de cliente: el código de cliente es el IDCDA, que aparece en a3innuva arriba a la derecha, debajo del nombre de usuario
⚠️ Importante: En la expiración del Refresh-token viene marcada por defecto la opción Absolute. Si la mantienes, la conexión con Viterbit caducará cada 30 días. Selecciona Sliding.
✅ Tip útil: Si ya tienes un Client OAuth para otra herramienta, solicita uno nuevo. Modificar el existente puede afectar a la otra integración.
Wolters Kluwer te enviará un correo con la configuración de tu Client OAuth. De ese correo solo necesitas el Client ID (con el formato WK.ES.API.a3innuvaNomina.XXXXXX) y el Client Secret.
📍 Dónde encontrarlo
Accede a Ajustes › Marketplace, abre la pestaña HRIS y localiza a3innuva Nómina.
⚙️ Cómo funciona
Una vez instalada, cada oferta tiene asignado un centro de trabajo de a3innuva. Al contratar a un candidato de esa oferta, Viterbit envía la solicitud de alta a ese centro.
Instala la integración
En la tarjeta a3innuva Nómina, haz clic en Instalar.
Introduce la API Key de Conectia, el Client ID y el Client Secret.
Haz clic en Instalar. Viterbit te redirigirá a Wolters Kluwer.
Inicia sesión con un usuario de a3innuva. Si tiene activada la verificación en dos pasos (MFA), se te pedirá en este momento.
Al volver a Viterbit, se valida la conexión y se cargan automáticamente las empresas y centros de trabajo de a3innuva en el campo Centro de trabajo a3innuva de las ofertas.
⚠️ Importante: Inicia sesión con un usuario que tenga acceso a todas las empresas y centros de trabajo a los que vas a contratar. Viterbit solo podrá ver los que vea ese usuario.
Asigna el centro de trabajo en cada oferta
En cada oferta, selecciona el Centro de trabajo a3innuva al que deben enviarse las contrataciones.
A partir de ese momento, al contratar a un candidato de la oferta se envía la solicitud de alta a ese centro.
Sincroniza los centros de trabajo
Si creas un centro nuevo en a3innuva, abre la configuración de la integración y haz clic en Sincronizar centros para que aparezca en Viterbit.
📋 Datos que se envían
Datos obligatorios
Si falta alguno, la solicitud no se envía y el error indica cuál es:
Nombre y apellidos
Sexo
DNI o NIE
Fecha de nacimiento
País y código postal
Teléfono y email
Fecha de alta: se utiliza la fecha de incorporación de la contratación o, si no existe, la fecha de contratación
Datos opcionales
Se envían si están informados en la ficha del candidato:
Número de la Seguridad Social
Nacionalidad
IBAN español
Dirección completa
Además, en las observaciones de la solicitud se incluyen el nombre de la oferta y el enlace al candidato en Viterbit.
🛠️ Seguimiento y solución de errores
Cada envío queda registrado en Ajustes › Marketplace › Historial de peticiones, con su estado, los datos enviados y la respuesta de a3innuva. Desde ahí puedes reintentar un envío.
Si un envío falla, el usuario que realizó la contratación y los administradores reciben una notificación.
Para más información sobre el historial, consulta el artículo Marketplace y seguimiento de peticiones.
Errores en el envío
“The job has no a3innuva workplace”: La oferta no tiene un centro de trabajo seleccionado. Selecciónalo en la oferta y reintenta el envío desde el historial.
“The a3innuva workplace of the job is not valid”: El centro de trabajo ya no existe en a3innuva. Sincroniza los centros, vuelve a seleccionarlo en la oferta y reintenta el envío.
Falta un dato obligatorio: Completa la ficha del candidato con el dato indicado en el error (sexo, DNI, teléfono…) y reintenta el envío.
“reconnect it from the marketplace”: La conexión con a3innuva ya no es válida. Puede ocurrir si se revocó el acceso, si cambiaron las credenciales o si el Client OAuth está configurado en Absolute y han pasado 30 días. Abre la configuración de la integración y haz clic en Conectar con a3innuva. Si ocurre cada mes, solicita a Wolters Kluwer que cambie la expiración del Refresh-token a Sliding.
Respuesta 400 de a3innuva: Algún dato no es válido para a3innuva, por ejemplo el código postal o el documento de identidad. Revisa los datos enviados en el historial de peticiones. Si no identificas el problema, contacta con el equipo de soporte de Viterbit.
Errores al conectar
“El usuario conectado no tiene acceso a ningún centro de trabajo activo”: El usuario de a3innuva con el que has iniciado sesión no ve ninguna empresa. Conecta con otro usuario o asígnale permisos en a3innuva.
Error de Wolters Kluwer sobre la Redirect URI: Falta la dirección https://app.viterbit.com/oauth/a3innuva_check/ en tu Client OAuth. Solicita el cambio a Wolters Kluwer mediante su formulario.
Solo aparece una empresa o faltan centros: El usuario que realizó la conexión no tiene acceso al resto en a3innuva. Vuelve a conectar con un usuario que vea todas las empresas y haz clic en Sincronizar centros.
🔎 Consideraciones importantes
Solicitud de alta, no alta directa: La integración no da de alta al empleado directamente en nómina. Crea una solicitud que tu equipo de nómina completa y confirma en a3innuva.
Sin confirmación de vuelta: Viterbit no muestra si el equipo de nómina aceptó la solicitud, ya que a3innuva no ofrece esa información.
Documentos: No se envían el CV ni otros documentos del candidato.
Documento de identidad: Solo se admiten DNI y NIE. No se admiten pasaportes.
🚀 Ventajas
Evita errores al trasladar manualmente los datos de la contratación a nómina.
Permite elegir en cada oferta la empresa y el centro de trabajo de destino, algo útil en grupos con varias empresas y centros.
Reduce el trabajo del equipo de nómina, que solo completa los datos laborales.
Registra cada envío en el historial de peticiones, con la posibilidad de reintentarlo.