Servicio de Documentos PDF

Remuneraciones · Documentos PDF

Contador AuditorDocumentos laboralesOrchestrator

El Servicio de Documentos PDF centraliza la emisión documental del ciclo laboral. Su función es transformar datos aprobados de contratos, liquidaciones y finiquitos en respaldos descargables, trazables y consistentes para revisión laboral, contable y operativa.

La página no define el cálculo de remuneraciones ni reemplaza los servicios de dominio. Documenta el punto común donde el sistema convierte resultados ya validados en documentos: contrato laboral, comprobante mensual de liquidación y finiquito.

Documentos Soportados

Documento	Servicio origen	Momento de emisión	Evidencia esperada
Contrato laboral	ContractService	Después de aprobar datos del trabajador, jornada, sueldo y condiciones pactadas.	PDF contractual y registro de generación.
Liquidación de sueldo	PayrollService	Después de guardar la liquidación definitiva del periodo.	PDF de liquidación con detalle de haberes, descuentos y líquido.
Finiquito	FiniquitoService	Después de simular, aprobar y generar el término laboral.	PDF de finiquito para firma o ratificación.

Flujo Común

1. El servicio de dominio valida que el documento tenga datos mínimos completos.

2. Se construye un contexto documental con empresa, trabajador, contrato, periodo, montos y cláusulas aplicables.

3. La plantilla HTML transforma el contexto en una representación imprimible sin lógica de negocio.

4. El motor PDF renderiza el HTML con formato de papel, márgenes y estilos definidos.

5. El archivo se almacena o se transmite al cliente según la ruta usada.

6. La descarga queda asociada al usuario, periodo o documento de origen para trazabilidad.

flowchart LR
  Domain["Servicio de dominio"] --> Context["Contexto documental"]
  Context --> Template["Plantilla HTML"]
  Template --> Pdf["Motor PDF"]
  Pdf --> Storage["Almacenamiento"]
  Storage --> Download["Descarga autenticada"]

Reglas por Documento

Documento	Validaciones antes de emitir	Riesgo cubierto
Contrato	Empleado existente, contrato vigente o borrador aprobado, jornada, cargo, sueldo base, salud y previsión.	Emitir respaldo contractual incompleto o inconsistente.
Liquidación	Periodo cerrado, contrato usado por el cálculo, detalle por concepto, totales y líquido a pago.	Descargar una liquidación distinta del cálculo aprobado.
Finiquito	Causal, fecha de término, vacaciones, indemnizaciones, descuentos y resultado definitivo.	Emitir un documento de término sin base de cálculo revisada.

Documento definitivo

El PDF debe representar el estado aprobado del servicio origen. Si cambia un contrato, una liquidación o un finiquito después de emitir el documento, la regeneración debe quedar controlada y trazable.

Trazabilidad y Regeneración

El sistema puede descargar un archivo existente o regenerarlo cuando el archivo físico no está disponible. La regeneración debe distinguirse de la creación funcional del documento: no recalcula por sí misma una liquidación, no cambia un contrato y no modifica el finiquito aprobado.

Caso	Tratamiento esperado
Descarga normal	Se entrega el archivo asociado al documento aprobado.
Archivo faltante	Se reconstruye desde el contexto persistido si los datos siguen disponibles.
Regeneración forzada	Se permite sólo con autorización y registro de motivo.
Cambio de plantilla	Debe conservarse la trazabilidad entre documento original, nueva emisión y usuario responsable.

Control contable

Para contabilidad, el PDF es evidencia documental. El reconocimiento del gasto, pasivo o pago se define en liquidaciones, imposiciones y finiquitos; el motor PDF sólo materializa el respaldo.

Estándares del Documento

Criterio	Estándar
Formato	Tamaño carta o A4 según configuración del tenant.
Márgenes	Márgenes suficientes para impresión, firma y archivo.
Estilo	Diseño sobrio, legible en blanco y negro y sin elementos decorativos pesados.
Datos sensibles	Acceso autenticado y controlado por permisos del usuario.
Plantillas	Separadas de la lógica de cálculo para evitar divergencias entre dato y presentación.

Ver También

Servicio de Contratos Origen del PDF contractual y de las condiciones laborales pactadas.

Servicio de Liquidaciones Origen del PDF mensual de haberes, descuentos y líquido a pago.

Servicio de Finiquitos Origen del PDF de término laboral y sus respaldos de cálculo.

ContractService Servicio backend que valida y emite documentos contractuales.

PayrollService Servicio backend que genera y expone PDF de liquidaciones.

FiniquitoService Servicio backend para simulación, generación y PDF de finiquitos.

API de Remuneraciones Rutas HTTP para descargar contratos, liquidaciones y finiquitos.