Reconocimiento de deuda( Url Reconocimiento de deuda PDF (1) ) - [debtRecognition]
🧾 Descripción
Este servicio valida si un empleado tiene un Reconocimiento de Deuda pendiente de firma, y en caso afirmativo, genera y descarga el archivo PDF del documento, incluyendo el detalle de cuotas asociadas.
El servicio consume directamente información del ERP, consultando tanto el documento principal como sus tablas hijas (detalles de deuda por mes).
🚀 Endpoint
POST /debt-recognition
📥 Parámetros
Recibe como parámetro directo el ID del empleado:
🔐 Seguridad
El servicio requiere autenticación interna vía dbErp() para consultas SQL y usa PDF::loadView() para generar el documento final.
🧠 Flujo del Servicio (resumen real)
1. Verifica si existe un Reconocimiento de Deuda pendiente
Consulta en el ERP:
-
Documento: Reconociemientos de Deuda
-
Condiciones:
-
docstatus = 0(borrador) -
empleado = <employee> -
El archivo firmado no existe →
reconocimiento_escaneado_firmado IS NULL or = ''
-
Si no encuentra ningún registro:
2. Obtiene los datos del Reconocimiento de Deuda
Si existe un documento pendiente:
-
Recupera el primer registro encontrado.
-
Extrae datos generales del reconocimiento.
3. Obtiene el detalle (tabla hija) del reconocimiento
Consulta:
-
Tabla hija: tabtable_reconocimiento_deuda
-
Llaves:
-
parent: ID del reconocimiento -
parentfield = table_21 -
parenttype = Reconociemientos de Deuda
-
Los campos recuperados:
4. Construye la data final
Une:
-
Información principal del reconocimiento (
dataEmployee) -
Detalle de cuotas (
dataTable)
5. Genera el documento PDF
Renderiza la vista:
pdf/Doctype/ReconocimientoDeDeuda/reconocimiento_de_deuda.blade.php
Y retorna la descarga del PDF.
📤 Response – Archivo PDF
El servicio retorna directamente un PDF generado con domPDF:
No devuelve un JSON en caso de éxito, sino una descarga directa del documento.