Registrar seguimiento

{
  "SolicitudID": 5821,
  "Titulo": "Envío de soporte de pago",
  "Comentario": "Adjunto el comprobante de la transferencia realizada el 3 de noviembre.",
  "SeguimientosAdjuntos": [
    {
      "Ruta": "3f9a2c71-8d4e-4b06-a5e2-7c1d90b4f638comprobante-pago.pdf",
      "NombreArchivo": "comprobante-pago.pdf",
      "Eliminar": false
    }
  ]
}

{
    "total": 1,
    "rows": [
        {
            "TipoSalida": "OK",
            "Codigo": 200,
            "Descripcion": "Transacción Exitosa"
        }
    ],
    "result": 1
}

{
    "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
    "title": "One or more validation errors occurred.",
    "status": 400,
    "errors": {
        "SolicitudID": [
            "The SolicitudID field is required."
        ]
    },
    "traceId": "00-6f1c2d9a4b7e3f80c5a1d2e3f4b5c6d7-9a8b7c6d5e4f3a2b-00"
}

{
  "SolicitudID": 5821,
  "Titulo": "Envío de soporte de pago",
  "Comentario": "Adjunto el comprobante de la transferencia realizada el 3 de noviembre.",
  "SeguimientosAdjuntos": [
    {
      "Ruta": "3f9a2c71-8d4e-4b06-a5e2-7c1d90b4f638comprobante-pago.pdf",
      "NombreArchivo": "comprobante-pago.pdf",
      "Eliminar": false
    }
  ]
}

{
    "total": 1,
    "rows": [
        {
            "TipoSalida": "OK",
            "Codigo": 200,
            "Descripcion": "Transacción Exitosa"
        }
    ],
    "result": 1
}

{
    "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
    "title": "One or more validation errors occurred.",
    "status": 400,
    "errors": {
        "SolicitudID": [
            "The SolicitudID field is required."
        ]
    },
    "traceId": "00-6f1c2d9a4b7e3f80c5a1d2e3f4b5c6d7-9a8b7c6d5e4f3a2b-00"
}

El servicio permite a los clientes registrar un seguimiento (título, comentario y archivos adjuntos) sobre una solicitud PQR radicada, en línea en formato JSON. Si la solicitud tiene un responsable asignado, al registrar el seguimiento se le envía una notificación en SEDI-ERP con el comentario del cliente. 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 registrar el seguimiento, se debe contar con los siguientes datos:

AccessToken solicitado mediante el servicio de inicio de sesión
Código único de la solicitud (SolicitudID) obtenido del servicio de solicitudes PQR
Archivos adjuntos cargados previamente con el servicio de carga de archivos, cuando el seguimiento lleva adjuntos

Registrar seguimiento

Request URL: https://portal.sedierp.com/API/api/Seguimientos/SeguimientosInsertar
Tipo: POST
Content Type: application/json

int

required

Código único de la solicitud PQR (ID) a la que se asocia el seguimiento.

string

Título del seguimiento (máx. 150 caracteres).

string

Comentario del seguimiento (máx. 8000 caracteres).

array

Archivos adjuntos del seguimiento.

Show propiedades

string

required

Ruta del archivo retornada por el servicio de carga de archivos (máx. 200 caracteres).

string

required

Nombre original del archivo (máx. 200 caracteres).

bool

required

Se debe enviar false para que el adjunto se registre. Los adjuntos con true o sin este campo no se registran.

curl --location 'https://portal.sedierp.com/API/api/Seguimientos/SeguimientosInsertar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--data '{
	"SolicitudID": 5821,
	"Titulo": "Envío de soporte de pago",
	"Comentario": "Adjunto el comprobante de la transferencia realizada el 3 de noviembre.",
	"SeguimientosAdjuntos": [
		{
			"Ruta": "3f9a2c71-8d4e-4b06-a5e2-7c1d90b4f638comprobante-pago.pdf",
			"NombreArchivo": "comprobante-pago.pdf",
			"Eliminar": false
		}
	]
}'

Validaciones

El servicio realiza las siguientes validaciones antes de registrar el seguimiento. Si alguna no se cumple, no se registra el seguimiento y se retorna HTTP 400 con el detalle de la validación.

SolicitudID es obligatorio.
Titulo no puede superar 150 caracteres y Comentario no puede superar 8000 caracteres.

El servicio siempre registra un seguimiento nuevo con la fecha y hora actual del servidor. Los campos SeguimientoID, FechaOcurrencia y SeguimientosAdjuntos[].SeguimientoAdjuntoID del modelo no se tienen en cuenta, por lo que no permite modificar seguimientos ni adjuntos existentes.

Respuesta

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” o “Error”.

int

Retorna 200 cuando el registro es correcto. No corresponde al código del seguimiento registrado.

string

“Transacción Exitosa” cuando el registro es correcto.

Cuando ocurre un error en el registro, el servicio responde HTTP 400 con el campo Message, que contiene el detalle del error precedido de “Error:”.

{
  "SolicitudID": 5821,
  "Titulo": "Envío de soporte de pago",
  "Comentario": "Adjunto el comprobante de la transferencia realizada el 3 de noviembre.",
  "SeguimientosAdjuntos": [
    {
      "Ruta": "3f9a2c71-8d4e-4b06-a5e2-7c1d90b4f638comprobante-pago.pdf",
      "NombreArchivo": "comprobante-pago.pdf",
      "Eliminar": false
    }
  ]
}

{
    "total": 1,
    "rows": [
        {
            "TipoSalida": "OK",
            "Codigo": 200,
            "Descripcion": "Transacción Exitosa"
        }
    ],
    "result": 1
}

{
    "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
    "title": "One or more validation errors occurred.",
    "status": 400,
    "errors": {
        "SolicitudID": [
            "The SolicitudID field is required."
        ]
    },
    "traceId": "00-6f1c2d9a4b7e3f80c5a1d2e3f4b5c6d7-9a8b7c6d5e4f3a2b-00"
}

Primeros pasos

CRM

Facturación

Custodia

Común

Portal externo (extranet)

Registrar seguimiento

Prerequisitos

Registrar seguimiento

Validaciones

Respuesta

​Prerequisitos

​Registrar seguimiento

​Validaciones

​Respuesta

Prerequisitos

Registrar seguimiento

Validaciones

Respuesta