Ir al contenido principal

Denuncias(Consultar demanda (1)) - [obtener]

🧾 Descripción

Permite consultar una denuncia registrada en el ERP usando un código aleatorio como identificador de búsqueda.

El servicio:

  • Recibe un código único (codigo) enviado al usuario.

  • Busca en el ERP la denuncia asociada.

  • Retorna sus datos principales (estado, creación, fechas de proceso, archivo adjunto, etc.)

  • Ajusta la URL del archivo si existe.

Es un servicio utilizado para que un usuario pueda revisar:

  • El estado de su denuncia,

  • La respuesta del área responsable,

  • Y descargar el archivo asociado (si lo tiene).


🚀 Endpoint

POST /obtener


📥 Request Body

{ "codigo": "string" }

Parámetros

Campo Tipo Obligatorio Descripción
codigo string ✔️ Sí Código aleatorio generado al registrar la denuncia

🔐 Seguridad

Requiere autenticación interna mediante
$this->general->ServiceErp()
(usa cookies o token ya configurado en el backend).


🧠 Flujo del Servicio (resumen real)

  1. Obtiene el código enviado en el request.

  2. Construye el body para consultar la denuncia en el ERP:

    • fields: name, creation, estado_denuncias, fechas, archivo, respuesta.

    • filters: [["codigo_aleatorio","=", $codigo]]

  3. Llama al ERP:
    GET resource/Denuncias

  4. Si no existe denuncia, retorna error.

  5. Si existe:

    • Verifica si archivo_denuncia no está vacío.

    • Si tiene archivo, le agrega la URL base del servidor.

  6. Retorna toda la información encontrada.


📤 Response 200 – Ejemplo exitoso

{ "success": true, "message": "Encontrado", "data": { "name": "DEN-00012", "creation": "2025-01-10 12:40:15", "estado_denuncias": "Atendido", "fecha_atendido": "2025-01-18", "fecha_proceso": "2025-01-15", "archivo_denuncia": "https://dominio.com/files/denuncia_12.pdf", "respuesta_de_denuncia_atendido": "Se realizó la evaluación correspondiente." } }


❗ Posibles Errores

1️⃣ Denuncia no encontrada

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

2️⃣ Error en la comunicación con el ERP

{ "success": false, "message": "Error del servidor: <detalle>" }

3️⃣ Respuesta vacía del ERP

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

📚 Esquema utilizado (Denuncias – GET)

Campos usados:

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

🗃 Lógica en pseudo-código

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