esofitec. CoreDocs

esofitec. CoreDocs

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 un appsettings.json.sample como 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: DODOCENTESCC, ESESTRUCTURA. 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:

  1. 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.
  2. El usuario introduce sus credenciales de WK y completa el inicio de sesión.
  3. 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