Editar depósito

Actualiza la información de un depósito existente. Permite actualizar datos del almacén y ajustar los niveles de stock de las mercaderías.

---

Entorno

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

Endpoint

PUT /depositos/{id}

Ejemplo de solicitud

curl -X PUT "https://api.guarani.app/depositos/{id}" \
  -H "Content-Type: application/json" \
  -H "x-api-key: Bearer <access_token>" \
  -d '{
    "nombre": "Depósito Central",
    "observacion": "Almacén principal de productos textiles",
    "establecimiento_id": "ejemplo-uuid-establecimiento-123",
    "items": [
      {
        "mercaderia_id": "ejemplo-uuid-mercaderia-123",
        "stock_actual": 70,
        "stock_minimo": 15,
        "stock_maximo": 100
      }
    ]
  }' | jq

Nota: Asegúrate de reemplazar {id} por el ID del deposito y <access_token> por 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
id	uuid	Sí	ID del deposito que se desea editar. (ver depositos)

Encabezados de la Solicitud

Encabezado	Valor	Descripción
Content-Type	application/json	Indica que se envían datos en JSON.
x-api-key	Bearer <access_token>	Token JWT válido.

Descripción de Campos

Campo	Tipo	Requerido	Descripción
nombre	string	Sí	Nombre del depósito o almacén.
observacion	string	No	Observación o descripción adicional del depósito.
establecimiento_id	uuid	Sí	Identificador único del establecimiento al que pertenece el depósito. ver (establecimientos)
items	array	Sí	Lista de mercaderías con su stock correspondiente en este depósito.

items (array)

Campo	Tipo	Requerido	Descripción
mercaderia_id	uuid	Sí	Identificador único de la mercadería o producto. ver (mercaderias)
stock_actual	number	Sí	Cantidad actual disponible del producto en el depósito.
stock_minimo	number	Sí	Stock mínimo permitido antes de emitir alerta o reabastecimiento.
stock_maximo	number	Sí	Stock máximo permitido en el depósito para esta mercadería.

Ejemplo de respuesta

{
  "success": true,
  "codigo": "200",
  "message": "Recurso actualizado con éxito.",
  "data": {
    "id": "33ccbca5-4fe6-457d-aaca-891b297c301b",
    "nombre": "Depósito ejemplo",
    "observacion": "Almacén ejemplo",
    "stock_maximo": 100,
    "stock_actual": 70,
    "stock_minimo": 15,
    "mercaderia": {
      "id": "ejemplo-uuid-mercaderia-123",
      "descripcion": "Mercaderia de ejemplo"
    },
    "establecimiento": {
      "id": "ejemplo-uuid-establecimiento-123",
      "nombre": "establecimiento ejemplo"
    }
  }
}

Descripción de Campos de Respuesta

Campos principales

Campo	Tipo	Descripción
id	uuid	Identificador único del depósito.
nombre	string	Nombre del depósito o almacén.
observacion	string	Observación o descripción adicional del depósito.
stock_maximo	number	Stock máximo permitido en el depósito para esta mercadería.
stock_actual	number	Cantidad actual disponible del producto en el depósito.
stock_minimo	number	Stock mínimo permitido antes de emitir alerta.
mercaderia	objeto	Información básica de la mercadería asociada.
establecimiento	objeto	Información del establecimiento al que pertenece el depósito.

Campos de mercaderia

Campo	Tipo	Descripción
id	uuid	Identificador único de la mercadería.
descripcion	string	Descripción de la mercadería.

Campos de establecimiento

Campo	Tipo	Descripción
id	uuid	Identificador único del establecimiento.
nombre	string	Nombre del establecimiento.

Recursos adicionales

Para más información sobre posibles errores relacionados, consulta la sección errores.