---
title: "Consultar Proveedor"
method: GET
path: "/proveedor/{identificacion}"
tags: ["Contabilidad"]
---

# Consultar Proveedor

`GET /proveedor/{identificacion}`

## Request

- Base URL: `https://api.loggro.com/apik/loggro-enterprise`
- URL: `https://api.loggro.com/apik/loggro-enterprise/proveedor/{identificacion}`
- Auth: HTTP bearer

Este endpoint permite consultar la información de uno o varios terceros proveedor. Si se envía **identificacion** (como segmento de la ruta, ej. /proveedor/123), retorna todos los establecimientos de ese proveedor (sin paginar, ya que normalmente son pocos): primero se busca en las tablas definitivas y, si no se encuentra allí, se consulta en las tablas de entrada. Si se omite (ej. /proveedor), se listan los proveedores de la compañía ordenados por identificación. En este caso, si se envían **pagina** y/o **limite**, el listado se pagina (tamaño de página por defecto 50, máximo 200); si NINGUNO de los dos se envía, se retorna la información completa sin paginar, bajo responsabilidad del cliente en cuanto al tiempo de respuesta. Estos dos parámetros no tienen efecto si se envía **identificacion**. Cuando aplica paginación, la página y el tamaño efectivamente usados se informan en los encabezados de respuesta `X-Pagina` y `X-Tamano-Pagina` (que muestran `todas` cuando no se paginó). El resultado incluirá la información del proveedor y el origen donde fue hallado.

**Ejemplo con identificación:** `GET /proveedor/900123456` retorna todos los establecimientos del proveedor 900123456.

**Ejemplo sin identificación, paginado:** `GET /proveedor?pagina=0&limite=50` retorna la primera página (50 registros) de proveedores de la compañía del usuario autenticado.

**Ejemplo sin identificación, sin paginar:** `GET /proveedor` (sin parámetros) retorna todos los proveedores de la compañía.

## Path parameters

- `identificacion` string, required

## Query parameters

- `pagina` integer, required
- `limite` integer, required

## Response `200`

Proveedor encontrado

- RespuestaConsulta[]
  - `identificacion` string
  - `operacionExitosa` boolean
  - `data` object

## Other responses

- `404`: Proveedor no encontrado
- `500`: Error interno inesperado al consultar el proveedor

---

[API](https://skmtc.dev/loggro/apis/enterprise-api-s.md) - [All operations](https://skmtc.dev/loggro/apis/enterprise-api-s/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/enterprise-api-s/revisions/933dac40ea9c?raw)
