Devuelve los datos de un material y sus existencias en un almacén.
v1/materials/get_entry.php
Parámetros
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| material_id | int | Sí | ID del material |
| storage_id | int | Sí | ID del almacén |
El material se devuelve solo si figura en el almacén storage_id. Las existencias en todos los almacenes a la vez las devuelve v1/materials/get_stocks.
Respuesta
Un objeto material con los campos del material, sus existencias en el almacén storage_id, sus categorías y proveedores. Las categorías y los proveedores de la respuesta se pueden enviar a v1/materials/edit sin cambios.
| Campo | Tipo | Descripción |
|---|---|---|
| id | int | ID del material |
| name | string | Nombre |
| sku | string | SKU |
| unit | string | Unidad de medida, un código de Unidades de medida |
| price | float | Precio por unidad |
| notes | string | Notas |
| archived | int | 1 si el material está archivado |
| stock | float | Existencias en el almacén storage_id |
| minimum | float | Existencias mínimas en el almacén storage_id |
| planned | float | Cambio de existencias por operaciones en estado Planificado. null si no hay ninguna |
| categories | array | Categorías del material: objetos con id y name |
| suppliers | array | Proveedores del material: objetos con id y name |
Ejemplo de solicitud
{
"material_id": 2051,
"storage_id": 3998
}
Ejemplo de respuesta
{
"success": true,
"material": {
"id": 2051,
"name": "Tablón de roble",
"sku": "M010",
"price": 135000,
"notes": "",
"archived": 0,
"stock": 4.2,
"minimum": 1,
"planned": null,
"unit": "m3",
"categories": [
{
"id": 12,
"name": "Madera"
}
],
"suppliers": [
{
"id": 45,
"name": "Maderas García"
}
]
}
}
Errores
| Error | Motivo |
|---|---|
| No material_id in input | Falta un campo obligatorio (en lugar de material_id, el nombre del campo) |
| Storage ID not found | Almacén no encontrado o eliminado |
| Material not found or access denied | Material no encontrado, eliminado o que no figura en el almacén |