Obtener una lista de los depósitos

Lista todos los depósitos registrados en el sistema. Incluye información del almacén, establecimiento asociado y niveles de stock de mercaderías.

Entorno

URL base: https://api.guarani.app

Endpoint

GET /depositos?page=1&limit=100

Ejemplo de solicitud

curl -X GET "https://api.guarani.app/depositos?page=1&limit=100" \
  -H "x-api-key: Bearer <access_token>" \
  -H "Accept: application/json" | jq

Nota: Asegúrate de reemplazar <access_token> con un token JWT válido proporcionado por el equipo Guarani.
Importante:
Es imprescindible incluir un token de acceso válido en el encabezado x-api-key para autenticar y autorizar el uso de este endpoint. Sin este token, la solicitud será rechazada.

---

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
page	integer	No	Página actual (por defecto: 1).
limit	integer	No	Cantidad de registros por página (100).

Encabezados de la solicitud

Encabezado	Valor	Descripción
x-api-key	Bearer <access_token>	Token JWT válido.
Accept	application/json	Indica que se espera una respuesta en JSON.

Ejemplo de respuesta

{
  "success": true,
  "codigo": "200",
  "message": "Operación realizada correctamente.",
  "data": [
    {
      "id": "33ccbca5-4fe6-457d-aaca-891b297c301b",
      "nombre": "Depósito Central",
      "observacion": "Almacén principal de productos textiles",
      "stock_maximo": 100,
      "stock_actual": 70,
      "stock_minimo": 15,
      "mercaderia": {
        "id": "ejemplo-uuid-mercaderia-123",
        "descripcion": "Zapatillas urbanas unisex"
      },
      "establecimiento": {
        "id": "ejemplo-uuid-establecimiento-123",
        "nombre": "MATRIZ"
      }
    }
  ],
  "pagination": {
    "total_registros": 1,
    "pagina": 1,
    "total_paginas": 1
  }
}

Recursos adicionales

Para obtener más información sobre posibles errores relacionados con los depositos y cómo manejarlos, consulta la sección de errores.