> ## Documentation Index
> Fetch the complete documentation index at: https://tech.sedierp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Registrar seguimiento

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](https://tech.sedierp.com/inicio-de-sesion.md).

## Prerequisitos

Antes de registrar el seguimiento, se debe contar con los siguientes datos:

* AccessToken solicitado mediante el servicio de [inicio de sesión](https://tech.sedierp.com/inicio-de-sesion.md)
* Código único de la solicitud (SolicitudID) obtenido del servicio de [solicitudes PQR](https://tech.sedierp.com/consulta-general-pqrs.md)
* Archivos adjuntos cargados previamente con el servicio de [carga de archivos](https://tech.sedierp.com/carga-de-archivos.md), cuando el seguimiento lleva adjuntos

## Registrar seguimiento

**Request URL:** [https://portal.sedierp.com/API/api/Seguimientos/SeguimientosInsertar](https://portal.sedierp.com/API/api/Seguimientos/SeguimientosInsertar)\
**Tipo:** POST \
**Content Type:** application/json

**SolicitudID** `int` *required*

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

**Titulo** `string`

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

**Comentario** `string`

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

**SeguimientosAdjuntos** `array`

Archivos adjuntos del seguimiento.

**propiedades**

**Ruta** `string` *required*

Ruta del archivo retornada por el servicio de [carga de archivos](https://tech.sedierp.com/extranet/cargar-archivos-upload) (máx. 200 caracteres).

**NombreArchivo** `string` *required*

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

**Eliminar** `bool` *required*

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

```bash theme={null}
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.

> [!NOTE]
>
> 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"}`).

**TipoSalida** `string`

Resultado de la operación: "OK" o "Error".

**Codigo** `int`

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

**Descripcion** `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:".

```json Request theme={null}
{
  "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
    }
  ]
}
```

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

```json Error theme={null}
{
    "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"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.