Generación del Documento Electrónico#
La generación del mensaje JSON debe realizarse desde el ERP, respetando la estructura específica para este tipo de documento, y transmitirse a SOVOS-Saphety a través de nuestros servicios API REST.
Important
Las nóminas deben reportarse dentro de los primeros 10 días hábiles del mes siguiente al periodo de pago.
Ejemplo: Las nóminas correspondientes a pagos realizados en enero deben ser transmitidas durante los primeros 10 días hábiles de febrero.
Emisores de Nómina Electrónica#
El proceso de transmisión de la nómina electrónica inicia con la generación de un mensaje JSON por parte del emisor, ya sea desde su ERP o desarrollo propio. Este mensaje debe contener la estructura mínima requerida para consumir el servicio de emisión de nuestra API.
Note
Nota:
La estructura y los campos requeridos del JSON están especificados en la documentación técnica de integración.
1. Guía de integración estándar NI
2. Guía de integración estándar NAR
3. Guía de integración estándar NAE
Ejemplo de mensaje JSON (DTO):
Autenticación del Emisor#
Antes de realizar la transmisión del mensaje JSON, el emisor debe autenticarse mediante nuestro servicio de autenticación basado en el estándar JSON Web Token (JWT).
Enviar un correo electrónico y contraseña válidos a través del servicio de autenticación.
Recibir un Token JWT, el cual deberá ser incluido en el encabezado (Authorization) de todas las solicitudes posteriores a los servicios de nuestra API.
Este token garantiza un acceso seguro y controlado a los recursos protegidos del ecosistema.