Skip to main content

​
Endpoint

GET /api/inventario/
Retorna una lista de todos los activos del inventario. Soporta filtros por múltiples criterios.

​
Autenticación

Requerida. Todos los roles pueden acceder (ver roles de usuario).

​
Query Parameters

​
id_ubicacion
integer
Filtrar por ubicación específica
​
id_estado
integer
Filtrar por estado
​
id_clasificacion
integer
Filtrar por clasificación
​
id_responsable
integer
Filtrar por responsable
​
placa
string
Buscar por placa exacta
​
codigo
integer
Filtrar por código

​
Request Examples

​
Listar todos los activos

curl -X GET http://localhost:8000/api/inventario/ \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Filtrar por ubicación

curl -X GET "http://localhost:8000/api/inventario/?id_ubicacion=1" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Filtrar por múltiples criterios

curl -X GET "http://localhost:8000/api/inventario/?id_ubicacion=1&id_estado=2" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Buscar por placa

curl -X GET "http://localhost:8000/api/inventario/?placa=ACT-001" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response

​
Success (200 OK)

Retorna un array de objetos activo. Cada activo incluye información expandida de sus relaciones.
​
codigo
integer
Código numérico del activo
​
placa_de_activo
string
Identificador único (primary key)
​
descripcion_completa_articulo
string
Descripción detallada del activo
​
avaluo
integer
Valor del activo en pesos
​
observaciones
string
Notas adicionales
​
acta_firmada
string
Estado del acta
​
ubicacion
object
Objeto con información de la ubicación
​
estado
object
Objeto con información del estado
​
clasificacion
object
Objeto con información de la clasificación
​
responsable
object
Objeto con información del responsable
​
referencia
object
Objeto con información de la referencia/serial
[
  {
    "codigo": 1001,
    "placa_de_activo": "ACT-001",
    "descripcion_completa_articulo": "Escritorio ejecutivo de madera",
    "avaluo": 500000,
    "observaciones": "En buen estado",
    "acta_firmada": "Firmada",
    "ubicacion": {
      "id_ubicacion": 1,
      "descripcion": "Oficina principal"
    },
    "estado": {
      "id_estado": 1,
      "descripcion": "Buen estado"
    },
    "clasificacion": {
      "id_clasificacion": 1,
      "descripcion": "Muebles y enseres"
    },
    "responsable": {
      "id_responsable": 1,
      "nombre": "Juan Pérez",
      "cargo": "Gerente",
      "area": "Administración"
    },
    "referencia": {
      "id_referencia": 1,
      "descripcion": "ESC-2024-001"
    },
    "id_ubicacion": 1,
    "id_estado": 1,
    "id_clasificacion": 1,
    "id_responsable": 1,
    "id_referencia_serial": 1
  }
]
La respuesta incluye tanto objetos expandidos (ubicacion, estado, etc.) como IDs simples (id_ubicacion, id_estado, etc.) para facilitar lectura y escritura.

​
Ver también

Crear activo

Crear un nuevo activo

Actualizar activo

Modificar un activo existente

Historial

Ver cambios históricos

Guía de gestión

Guía completa de gestión de activos

Build docs developers (and LLMs) love

Get started for freeTalk to us