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

# Causales de devolución de bodegas

El servicio permite consultar las causales de devolución de bodegas configuradas por la empresa, es decir, los motivos por los cuales un cliente entrega una bodega, en línea en formato JSON.

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 causales de devolución, 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)

## Consultar causales de devolución

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

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

**CausalDevolucionBodegaID** `int`

Filtro de búsqueda por código único de la causal de devolución (ID).

**Nombre** `string`

Filtro de búsqueda por cualquier parte del nombre de la causal.

**Activo** `bool`

Filtro de búsqueda por estado de la causal: `true` (activas) o `false` (inactivas). Si se omite, retorna las causales activas e inactivas.

**SortColumn** `string`

Nombre de la columna de la respuesta por la cual se ordenan los registros (ej. `Nombre`). Por defecto se ordena por el código de la causal de forma descendente.

**SortDirection** `string`

Dirección del ordenamiento: `ASC` (ascendente) o `DESC` (descendente). Es obligatorio cuando se envía `SortColumn`; si se omite, el servicio retorna `rows` vacío.

**FullSearch** `string`

Campo de consulta múltiple. Busca el texto enviado en cualquier parte del nombre de la causal.

```bash theme={null}
curl --location 'https://portal.sedierp.com/API/api/Storage/CausalesDevolucionesBodegasConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--data '{
	"Page": 1,
	"Rows": 0,
	"CausalDevolucionBodegaID": null,
	"Nombre": null,
	"Activo": true,
	"SortColumn": "Nombre",
	"SortDirection": "ASC",
	"FullSearch": null
}'
```

### Respuesta

El servicio retorna el listado de causales de devolución de la empresa del AccessToken. 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"}`).

Cada registro de `rows` contiene los siguientes campos:

**CausalDevolucionBodegaID** `int`

Código único de la causal de devolución (ID).

**Nombre** `string`

Nombre de la causal de devolución.

**Activo** `bool`

Indica si la causal está activa.

**TotalRows** `int`

Cantidad total de causales que cumplen con los filtros de la consulta.

```json Request theme={null}
{
  "Page": 1,
  "Rows": 0,
  "CausalDevolucionBodegaID": null,
  "Nombre": null,
  "Activo": true,
  "SortColumn": "Nombre",
  "SortDirection": "ASC",
  "FullSearch": null
}
```

```json Exitosa theme={null}
{
    "total": 3,
    "rows": [
        {
            "CausalDevolucionBodegaID": 4,
            "Nombre": "Cambio de ciudad",
            "Activo": true,
            "TotalRows": 3
        },
        {
            "CausalDevolucionBodegaID": 2,
            "Nombre": "Necesita una bodega más grande",
            "Activo": true,
            "TotalRows": 3
        },
        {
            "CausalDevolucionBodegaID": 1,
            "Nombre": "Ya no requiere el servicio",
            "Activo": true,
            "TotalRows": 3
        }
    ],
    "result": 1
}
```

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


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