> ## 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.

# Archivos de fiducias

El servicio permite a los usuarios del portal de clientes consultar el listado de archivos publicados para una fiducia (reportes, certificaciones y demás documentos), en línea en formato JSON.

El código de la fiducia (FiduciaID) se obtiene del servicio de [fiducias](https://tech.sedierp.com/consultar-fiducias.md).

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 realizar la consulta de archivos de una fiducia, 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 fiducia (FiduciaID) obtenido del servicio de [fiducias](https://tech.sedierp.com/consultar-fiducias.md)

## Consultar archivos de fiducia

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

**FiduciaID** `int` *required*

Código único de la fiducia (ID) de la cual se consultan los archivos.

**ReporteTrimestral** `bool`

Filtro de búsqueda por tipo de archivo: `true` retorna solo los reportes trimestrales y `false` solo los demás archivos. Si se omite, retorna todos.

**Page** `int`

Página de consulta, por defecto (1).

**Rows** `int`

Cantidad de registros por página de consulta, por defecto (10). Si se envía 0, se retornan todos los registros sin paginar.

**SortColumn** `string`

Nombre de la columna de la respuesta por la cual se ordenan los registros (ej. `FiduciaArchivoNombre`). Por defecto se ordena por el nombre del archivo de forma ascendente.

**SortDirection** `string`

Dirección del ordenamiento: `ASC` (ascendente) o `DESC` (descendente). Es obligatorio cuando se envía `SortColumn`.

**FullSearch** `string`

Filtro de búsqueda por cualquier parte del nombre del archivo.

```bash theme={null}
curl --location 'https://portal.sedierp.com/API/api/Inmobiliaria/FiduciasArchivosConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--data '{
	"FiduciaID": 14,
	"ReporteTrimestral": true,
	"Page": 1,
	"Rows": 10,
	"SortColumn": null,
	"SortDirection": null,
	"FullSearch": null
}'
```

> [!NOTE]
>
> Si no se envía `FiduciaID`, o si se envía `SortColumn` sin `SortDirection`, el servicio no retorna error: responde `rows` vacío.

### Respuesta

El servicio retorna el listado de archivos de la fiducia. El campo `total` corresponde a la cantidad de registros retornados en la página consultada. Cada registro de `rows` contiene los siguientes campos:

**FiduciaArchivoID** `int`

Código único del archivo (ID).

**FiduciaArchivoNombre** `string`

Nombre del archivo.

**FiduciaArchivoRuta** `string`

Ruta del archivo, tal como está almacenada en la plataforma (puede ser una referencia `cdn://`).

Si `SortColumn` no corresponde a una columna de la respuesta, el servicio responde HTTP 400 con el error de base de datos en `Message`.

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"}`).

```json Request theme={null}
{
  "FiduciaID": 14,
  "ReporteTrimestral": true,
  "Page": 1,
  "Rows": 10,
  "SortColumn": null,
  "SortDirection": null,
  "FullSearch": null
}
```

```json Exitosa theme={null}
{
    "total": 2,
    "rows": [
        {
            "FiduciaArchivoID": 305,
            "FiduciaArchivoNombre": "Reporte trimestral enero - marzo 2026",
            "FiduciaArchivoRuta": "cdn://a41f7c2e-9d38-4b65-8e10-6f2b9c7d4e53"
        },
        {
            "FiduciaArchivoID": 341,
            "FiduciaArchivoNombre": "Reporte trimestral abril - junio 2026",
            "FiduciaArchivoRuta": "cdn://5c8e2d14-7a96-4f3b-b2c0-e9d14a6f8b27"
        }
    ],
    "result": 1
}
```

```json Sin resultados theme={null}
{
    "total": 0,
    "rows": [],
    "result": 1
}
```

```json Error theme={null}
{
    "Message": "Invalid column name 'Nombre'., "
}
```


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