> ## 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. # Consulta de visitas El servicio permite consultar el historial de visitas a las bodegas de los contratos de bodegaje del cliente que inició sesión en el portal, en línea en formato JSON. Cada visita indica la persona autorizada que ingresó, la bodega y las fechas de ingreso y salida. 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 visitas, 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 del contrato o de la bodega (opcional), obtenidos del servicio de [mis bodegas](https://tech.sedierp.com/consulta-de-bodegas.md) ## Consultar visitas **Request URL:** [https://portal.sedierp.com/API/api/Storage/VisitasBodegasConsultar](https://portal.sedierp.com/API/api/Storage/VisitasBodegasConsultar)\ **Tipo:** POST \ **Content Type:** application/json El cliente y la empresa se toman del AccessToken, por lo que el servicio solo retorna las visitas de los contratos no anulados del cliente que inició sesión. **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. **ContratoID** `int` Filtro de búsqueda por código único del contrato de bodegaje (ID). **BodegaID** `int` Filtro de búsqueda por código único de la bodega (ID). **BodegaCodigo** `string` Filtro de búsqueda por número exacto de la bodega (ej. "416-357"). **FechaInicial** `date` Filtro de búsqueda por fecha de ingreso de la visita, desde la fecha indicada (inclusive). Solo se tiene en cuenta la fecha, no la hora. Acepta los formatos `yyyy-MM-dd`, `dd/MM/yyyy` y `yyyy-MM-ddTHH:mm:ss`; si la fecha no tiene un formato válido, el filtro se ignora. **FechaFinal** `date` Filtro de búsqueda por fecha de ingreso de la visita, hasta la fecha indicada (inclusive). Solo se tiene en cuenta la fecha, no la hora. Acepta los mismos formatos de `FechaInicial`. **SortColumn** `string` Columna por la cual se ordenan los registros. Valores admitidos: `CPAV.FechaIngreso`, `CPAV.FechaSalida` o `CPAV.Finalizada`. Por defecto se ordena por la fecha de ingreso 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 número de la bodega o de su metraje comercial. ```bash theme={null} curl --location 'https://portal.sedierp.com/API/api/Storage/VisitasBodegasConsultar' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer ' \ --data '{ "Page": 1, "Rows": 10, "ContratoID": 32549, "BodegaID": null, "BodegaCodigo": null, "FechaInicial": "2026-10-01", "FechaFinal": "2026-10-31", "SortColumn": null, "SortDirection": null, "FullSearch": null }' ``` > [!NOTE] > > El historial no incluye las visitas de personas autorizadas que también son usuarios de la plataforma SEDI-ERP. ### Respuesta El servicio retorna el listado de visitas ordenado por fecha de ingreso de forma descendente. 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: **FechaIngreso** `datetime` Fecha y hora de ingreso a la bodega. **FechaSalida** `datetime` Fecha y hora de salida de la bodega. Es `null` mientras la visita no se haya finalizado. **Finalizada** `bool` Indica si la visita ya finalizó (se registró la salida). **BodegaCodigo** `string` Número de la bodega visitada. **M3Comercial** `string` Metraje comercial de la bodega. **ComplejoNombre** `string` Nombre del complejo de bodegas. **ComplejoPisoNombre** `string` Piso del complejo donde está la bodega. **TipoDocumentoAbreviatura** `string` Abreviatura del tipo de documento de la persona que realizó la visita (ej. "CC"). **Documento** `string` Número de documento de la persona que realizó la visita. **NombreCompleto** `string` Nombre completo de la persona que realizó la visita. **TotalRows** `int` Cantidad total de visitas que cumplen con los filtros de la consulta. ```json Request theme={null} { "Page": 1, "Rows": 10, "ContratoID": 32549, "BodegaID": null, "BodegaCodigo": null, "FechaInicial": "2026-10-01", "FechaFinal": "2026-10-31", "SortColumn": null, "SortDirection": null, "FullSearch": null } ``` ```json Exitosa theme={null} { "total": 2, "rows": [ { "FechaIngreso": "2026-10-24T10:12:40", "FechaSalida": null, "Finalizada": false, "BodegaCodigo": "416-357", "M3Comercial": "24", "ComplejoNombre": "Complejo Norte", "ComplejoPisoNombre": "3", "Documento": "52987654", "NombreCompleto": "ANA LUCIA ROJAS DIAZ", "TipoDocumentoAbreviatura": "CC", "TotalRows": 2 }, { "FechaIngreso": "2026-10-03T15:47:05", "FechaSalida": "2026-10-03T16:30:18", "Finalizada": true, "BodegaCodigo": "416-357", "M3Comercial": "24", "ComplejoNombre": "Complejo Norte", "ComplejoPisoNombre": "3", "Documento": "1032456789", "NombreCompleto": "LAURA MARTINEZ ROJAS", "TipoDocumentoAbreviatura": "CC", "TotalRows": 2 } ], "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.