Guardar documento (1) - [saveInternalDocuments]
🧾 Descripción
Registra internamente un documento aceptado o gestionado por un usuario dentro de una terminal específica.
Este servicio guarda un log en la tabla documentos_internos, permitiendo rastrear:
-
Qué usuario aceptó o gestionó un documento.
-
Desde qué terminal lo realizó.
-
Qué tipo de documento fue.
-
En qué fecha y hora se registró.
Es utilizado para auditoría y trazabilidad dentro del sistema.
🚀 Endpoint
POST /save-internal-documents
📥 Parámetros (Request Body)
Campos:
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| usuario | string | ✔️ Sí | ID o username del usuario que realiza la acción |
| terminal | string | ✔️ Sí | Código de la terminal donde se ejecuta la acción |
| tipo | string | ❌ No | Tipo de documento o acción registrada |
🔐 Seguridad
No requiere token de ERP.
Acceso interno del backend usando conexión directa a la base de datos mysql2.
🧠 Flujo del Servicio (resumen)
-
Valida que usuario y terminal existan en la solicitud.
-
Establece zona horaria America/Lima.
-
Inserta un registro en la tabla
documentos_internoscon:-
usuario
-
terminal
-
tipo
-
fecha actual
-
-
Si el registro falla, retorna un error.
-
Si todo es exitoso, responde confirmación de inserción.
🗃 Base de Datos Utilizada
Tabla: documentos_internos (BD: mysql2)
| Campo | Tipo | Descripción |
|---|---|---|
| usuario | varchar | Usuario que registra |
| terminal | varchar | Terminal desde donde registra |
| tipo | varchar | Tipo de documento |
| fecha | datetime | Fecha y hora del registro |