Addons a medida / 5585 FEMXA / Sit.Imp.Fmx
Instalación y activación
Requisitos del sistema#
- Windows.
- .NET Framework 4.8.
- Runtime de Microsoft WebView2. Es imprescindible: la autenticación con Wolters Kluwer se hace en un navegador embebido. Sin él, la pantalla de login no carga.
Despliegue#
Los ficheros del módulo (instalador, binarios y fichero de configuración de ejemplo) se distribuyen desde el repositorio de entregas del proyecto. La instalación estándar deja la aplicación en:
C:\SIT\services\Sit_Imp_Femxa
Antivirus del cliente
En FEMXA el antivirus ha llegado a bloquear el instalador. Por eso la entrega incluye también un .zip con el contenido ya preparado de C:\SIT\services\Sit_Imp_Femxa: si el instalador no puede ejecutarse, basta con descomprimir ese zip en la ruta indicada.
La entrega contiene:
- Los binarios de la aplicación.
- El fichero de configuración
appsettings.json(se incluye también unappsettings.json.samplecomo plantilla).
Configuración (appsettings.json)#
La aplicación lee su configuración del appsettings.json que acompaña al ejecutable. Estructura:
{
"A3Laboral": {
"SubscriptionKey": "",
"ClientID": "",
"ClientSecret": "",
"AuthorizeEndPoint": "https://login.wolterskluwer.eu/auth/core/connect/authorize",
"TokenEndPoint": "https://login.wolterskluwer.eu/auth/core/connect/token"
},
"AppSettings": {
"PayTypeCorrelations": [
{ "InputType": "Paga Mensual", "OutputType": "Mes" },
{ "InputType": "Paga Finiquito", "OutputType": "Finiquito" }
],
"SheetCostAttributionRelations": [
{ "SheetName": "DOCENTESCC", "CostAttributionNodeCodes": [ "DO" ] },
{ "SheetName": "ESTRUCTURA", "CostAttributionNodeCodes": [ "ES" ] }
]
},
"Logging": {
"File": {
"Path": "C:/Logs/Sit.Imp.Fmx.log",
"Append": true,
"MinLevel": "Trace",
"FileSizeLimitBytes": 5000000,
"MaxRollingFiles": 5
},
"LogLevel": {
"Default": "Warning",
"A3LaboralConnector": "Error"
}
}
}
Sección A3Laboral#
Credenciales OAuth de la conexión con la API de Wolters Kluwer.
| Campo | Descripción |
|---|---|
SubscriptionKey |
Clave de suscripción a la API |
ClientID |
Identificador de cliente OAuth |
ClientSecret |
Secreto de cliente OAuth |
AuthorizeEndPoint |
Endpoint de autorización. Dejar el valor por defecto |
TokenEndPoint |
Endpoint de token. Dejar el valor por defecto |
Credenciales
SubscriptionKey, ClientID y ClientSecret son datos sensibles. No se incluyen en esta documentación; solicítalos por el canal seguro del proyecto y no los compartas en tickets ni correos.
Sección AppSettings#
| Campo | Descripción |
|---|---|
PayTypeCorrelations |
(Opcional) Traduce el tipo de paga de a3Innuva (InputType) al tipo mostrado en el Excel (OutputType). Si un tipo no figura, se vuelca tal cual. Admite MandatoryInternalConcepts para condicionar la traducción a la presencia de ciertos conceptos |
SheetCostAttributionRelations |
(Opcional) Asigna cada código de centro de coste de nivel 1 (CostAttributionNodeCodes) a una hoja del Excel (SheetName). Para FEMXA: DO → DOCENTESCC, ES → ESTRUCTURA. Si se omite, todo va a una única hoja |
Tipos de paga excluidos
La exclusión de ciertos tipos de paga (Paga Mensual Atrasos, …Diferencias, temporal, simulacion) está fija en la aplicación, no se configura aquí. Si el appsettings.json incluye una lista PayTypeIdWhiteList, ten en cuenta que la versión actual no la aplica; puede dejarse como venga en la plantilla.
Sección Logging#
Se aconseja mantener la configuración de la plantilla. Puntos a conocer para soporte:
| Campo | Descripción |
|---|---|
File.Path |
Ruta del fichero de log (por defecto C:/Logs/Sit.Imp.Fmx.log) |
LogLevel.Default |
Nivel del código externo. Se aconseja Warning |
LogLevel.A3LaboralConnector |
Nivel de la conexión con la API. Se aconseja Error |
Ver todas las llamadas a la API
Subir A3LaboralConnector (o Default) a Trace hace que el log registre todas las peticiones y respuestas contra la API de Wolters Kluwer. Útil para diagnosticar descuadres o errores puntuales; conviene volver a Error después, porque genera mucho volumen.
Activación: primer inicio de sesión#
La aplicación no necesita "activarse" con licencia, pero sí autenticarse contra Wolters Kluwer:
- Al pulsar Cargar Empresas A3Innuva por primera vez (o cuando la sesión ha caducado), se abre el login de Wolters Kluwer en un navegador embebido.
- El usuario introduce sus credenciales de WK y completa el inicio de sesión.
- La sesión (incluido el token) se guarda para reutilizarla en próximas ejecuciones en:
text
%APPDATA%\Esofitec\Sit.Imp.Fmx\usersettings.json
Este mismo fichero guarda también la última carpeta de salida y el último nombre de fichero usados.
Caducidad de la sesión (28 días)
La sesión guardada caduca a los 28 días desde su creación. Pasado ese plazo, la aplicación no renueva automáticamente y el usuario debe volver a iniciar sesión manualmente en Wolters Kluwer. Mientras la sesión sea válida, se renueva de forma transparente entre ejecuciones.
Troubleshooting#
| Síntoma | Causa probable / actuación |
|---|---|
| El instalador no se ejecuta o lo bloquea el antivirus | Usar el .zip de la entrega y descomprimirlo en C:\SIT\services\Sit_Imp_Femxa |
| La pantalla de login no carga o sale en blanco | Falta el runtime de WebView2; instalarlo |
| Mensaje sobre que "han pasado 28 días" o no conecta | La sesión ha caducado; volver a iniciar sesión manualmente (ver arriba) |
| "No hay pagas para exportar" | Revisar mes/año seleccionados; recordar que hay tipos de paga que se excluyen siempre |
| Importes descuadrados en el Excel | Cotejar las nóminas contra los conceptos de la tabla de columnas en Funcionalidad; subir el log a Trace para ver las respuestas de la API |
| Errores intermitentes en la generación | Usar Copiar al portapapeles en el detalle del error y adjuntarlo al ticket; el log en C:/Logs complementa el diagnóstico |