Skip to main content
El servicio permite a los usuarios radicar una solicitud de PQR (petición, queja, reclamo o sugerencia) desde el portal de clientes, con sus documentos adjuntos, en línea en formato JSON. Al radicar la solicitud, la plataforma le asigna el consecutivo, el estado inicial configurado por la empresa, el canal “página web” y el responsable de la tipificación, calcula la fecha límite de respuesta según la tipificación, la prioridad y el calendario de atención, registra el seguimiento inicial “Hemos recibido tu solicitud” y notifica al responsable (y al cliente, si la empresa lo tiene configurado). El método de solicitud es POST y se requiere un encabezado “Authorization” para la autenticación, que debe contener el AccessToken (JWT) obtenido previamente del servicio de inicio de sesión.

​
Prerequisitos

Antes de radicar la solicitud, se debe contar con los siguientes datos:

​
Radicar solicitud

Request URL: https://portal.sedierp.com/API/api/SolicitudesPQRs/SolicitudesInsertar
Tipo: POST
Content Type: application/json
​
int
required
Código de la tipificación de la solicitud (ID), obtenido del servicio de orígenes de solicitudes. La tipificación define el responsable y el tiempo de respuesta; se puede consultar su detalle con el servicio de tipificación detallada.
​
string
required
Mensaje o cuerpo de la solicitud.
​
GUID
Identificador único del cliente que radica (UniqueID del servicio de datos del cliente). Asocia la solicitud al cliente: las solicitudes radicadas sin este dato no aparecen en la consulta de solicitudes.
​
string
Asunto de la solicitud (máx. 200 caracteres).
​
int
Código del origen de la solicitud.
​
int
Código del inmueble, bodega, fiducia o contrato de trabajo sobre el que se radica la solicitud (ID), obtenido del servicio de orígenes por cliente. Para inmuebles, bodegas y fiducias se usa para asignar la sucursal de la solicitud.
​
int
Código del tipo de requerimiento (ID), obtenido del servicio de orígenes de solicitudes.
​
int
Código de la prioridad de la solicitud (ID), obtenido del servicio de orígenes de solicitudes. Si no se envía, se asigna la prioridad de menor factor configurada por la empresa.
​
int
Código de una solicitud anterior (ID) cuando la nueva solicitud es una réplica de esta.
​
date
Fecha de ocurrencia de los hechos.
​
int
Código del tipo de persona que radica (ID), obtenido del servicio de tipos de persona.
​
string
Nombre de la empresa que radica la solicitud, cuando aplica (máx. 150 caracteres).
​
string
Cargo de la persona que radica la solicitud (máx. 150 caracteres).
​
string
Nombres de la persona que radica la solicitud (máx. 150 caracteres).
​
string
Apellidos de la persona que radica la solicitud (máx. 150 caracteres).
​
int
Código del tipo de documento de la persona que radica (ID), obtenido del servicio de tipos de documentos.
​
string
Número de documento de la persona que radica (máx. 50 caracteres).
​
string
Dirección de la persona que radica (máx. 150 caracteres).
​
string
Teléfono fijo de la persona que radica (máx. 50 caracteres).
​
string
Teléfono móvil o celular de la persona que radica (máx. 50 caracteres).
​
string
Correo electrónico de la persona que radica (máx. 150 caracteres).
​
int
Código de la ciudad de la persona que radica (ID).
​
int
No se tiene en cuenta: el servicio siempre registra una nueva solicitud. Enviar null.
​
array
Documentos adjuntos de la solicitud. Cada archivo se debe cargar primero con el servicio de carga de archivos, que retorna los valores de Ruta, NombreArchivo y Extension.

​
Validaciones

El servicio realiza las siguientes validaciones antes de radicar la solicitud. Si alguna no se cumple, no se registra la solicitud y se retorna el error correspondiente.
  • Mensaje es obligatorio y los campos de texto no deben superar su longitud máxima (HTTP 400 con el detalle de la validación).
  • TipificacionID es obligatorio y la tipificación debe tener un usuario o grupo responsable asignado.
  • Si la empresa exige calificar las solicitudes, el cliente (UniqueID) no debe tener solicitudes cerradas hace más de 3 días sin calificar. Esta validación no aplica cuando se envía ReplicaSolicitudID.
  • La empresa debe tener configurados: un único estado de solicitud por defecto, el calendario de días y horas de atención, y el canal de página web.

​
Respuesta

El servicio retorna un registro con el resultado de la radicación. Si el AccessToken no se envía, es inválido o expiró, el servicio responde HTTP 401 ({"Code": 401, "Message": "El TokenAcceso no es valido"}).
​
string
Resultado de la operación: “OK”.
​
int
Código único de la solicitud registrada (SolicitudID).
​
string
Mensaje con el consecutivo de radicación (ej. “Se radico su solicitud correctamente N° 126.”).
Cuando ocurre un error, el servicio responde HTTP 400 con el campo Message, que contiene el detalle del error precedido de “Error:”.