Crear almacén (solo recuperación)
POST /api/warehouses
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Solo para recuperación. El almacén se crea automáticamente al crear el establecimiento, así que en el uso normal no necesitas este endpoint.
Úsalo únicamente si un establecimiento quedó sin almacén (por ejemplo, establecimientos antiguos o un almacén eliminado por soporte). Antes de llamarlo, comprueba con GET /api/warehouses?establishment_id=<id> que de verdad no tiene uno.
Errores: 409 "Solo es posible registrar un almacén por establecimiento." si el establecimiento ya tiene almacén (que es lo habitual).
Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
description |
string | Sí | Nombre del almacén. |
establishment_id |
integer | No | Establecimiento. Si no se envía, se usa el del usuario autenticado. |
Errores: 409 si el establecimiento ya tiene un almacén; 422 si falta description o el establecimiento no existe.
Cuerpo
Content-Type: application/json
{
"description": "Almacén - Sucursal Miraflores",
"establishment_id": 2
}
Respuestas
201 — Creado
{
"success": true,
"data": {
"id": 2,
"description": "Almacén - Sucursal Miraflores",
"establishment_id": 2,
"establishment_description": "SUCURSAL MIRAFLORES"
},
"message": "Almacén registrado con éxito"
}
409 — Ya tiene almacén
{
"success": false,
"message": "Solo es posible registrar un almacén por establecimiento."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.