Ir al contenido principal

Boleta Mensual(Obtener Proceso de Descarga (1)) - [obtener]

🧾 Descripción

Este servicio permite buscar y obtener información detallada de una denuncia registrada en el ERP, usando un código aleatorio generado para consulta pública.

La función:

  • Busca la denuncia usando el campo codigo_aleatorio.

  • Retorna información clave como:

    • estado de la denuncia,

    • fecha de creación,

    • fecha de atención,

    • fecha de proceso,

    • respuesta,

    • y un archivo asociado (si existe).

  • Construye la URL completa del archivo para ser descargado por el cliente.

Es un servicio de consulta directa, sin dependencias entre módulos.

🚀 Endpoint

POST /obtener

📥 Request Body

{ "codigo": "ABC12345" }

🔐 Seguridad

No requiere token especial más allá del utilizado internamente por apiService() o ServiceErp().
La autenticación se maneja dentro del sistema ERP.

🧠 Flujo del Servicio (resumen real)

  1. Recibe el parámetro: codigo = $request->codigo

  2. Construye un request hacia el ERP: GET Denuncias?fields=[...]&filters=[["codigo_aleatorio","=",codigo]]

Campos obtenidos:

  • name

  • creation

  • estado_denuncias

  • fecha_atendido

  • fecha_proceso

  • archivo_denuncia

  • respuesta_de_denuncia_atendido

  1. Si no existe la denuncia → se responde:

{ "success": false, "message": "No se encontró la denuncia" }

  1. Si existe y tiene archivo, se concatena la URL base:


archivo_denuncia = BASE_CAPACITACION . archivo_denuncia

  1. Se devuelve la primera denuncia encontrada, ya que el código es único.

📤 Response 200 – Ejemplo

{ "success": true, "message": "Encontrado", "data": { "name": "DEN-00045", "creation": "2025-01-15 09:12:20", "estado_denuncias": "Atendido", "fecha_atendido": "2025-01-20", "fecha_proceso": "2025-01-18", "archivo_denuncia": "https://servidor.com/files/denuncias/archivo.pdf", "respuesta_de_denuncia_atendido": "Se revisó la información y se procedió..." } }

❗ Posibles Errores

1. No se encuentra la denuncia

{ "success": false, "message": "No se encontró la denuncia" }

2. Error del ERP

{ "success": false, "message": "Error message from ERP" }

3. Código vacío o inválido

{ "success": false, "message": "No se encontró la denuncia" }

📚 Schemas Usados

Denuncias (GET)

Campos usados:

{ "name": "string", "creation": "datetime", "estado_denuncias": "string", "fecha_atendido": "date", "fecha_proceso": "date", "archivo_denuncia": "string|null", "respuesta_de_denuncia_atendido": "string|null" }

🗃 Lógica del Servicio (Pseudo-código)

codigo = request.codigo body = { limit = None fields = [name, creation, estado_denuncias, fecha_atendido, fecha_proceso, archivo_denuncia, respuesta...] filters = [["codigo_aleatorio", "=", codigo]] } response = GET Denuncias using ServiceErp if !response.valor or response.response is empty: return error "No se encontró la denuncia" denuncia = response.response[0] if denuncia.archivo_denuncia != "": denuncia.archivo_denuncia = BASE_CAPACITACION + denuncia.archivo_denuncia return success with denuncia

No hay comentarios para mostrar

Volver arriba