Crear depósito

Crea un nuevo depósito o almacén en el sistema. Permite gestionar el inventario de mercaderías con niveles de stock mínimo y máximo.

---

Entorno

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

Endpoint

POST /depositos

Ejemplo de solicitud

curl -X POST "https://api.guarani.app/depositos" \
  -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 <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.

---

Encabezados de la Solicitud

Encabezado	Valor	Descripción
Content-Type	application/json	Indica que los datos se envían en formato JSON.
x-api-key	Bearer <access_token>	Token de autenticación necesario para acceder al recurso.

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 de objetos)

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": "201",
  "message": "Recurso creado con éxito.",
  "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": "Mercaderia de ejemplo"
    },
    "establecimiento": {
      "id": "ejemplo-uuid-establecimiento-123",
      "nombre": "MATRIZ"
    }
  }
}

Descripción de Campos de Respuesta

Campos principales

Campo	Tipo	Descripción
id	uuid	Identificador único del depósito creado.
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.