Skip to main content

​
Visión general

La gestión de activos es el núcleo del sistema. Este módulo permite controlar todos los activos fijos de la organización con información detallada y trazabilidad completa.

​
Modelo de datos de un activo

Cada activo en el sistema contiene:
​
codigo
integer
Código numérico del activo
​
placa_de_activo
string
required
Identificador único del activo (clave primaria)
​
descripcion_completa_articulo
string
Descripción detallada del activo
​
id_ubicacion
integer
ID de la ubicación física del activo
​
id_estado
integer
ID del estado actual del activo
​
id_clasificacion
integer
ID de la clasificación del activo
​
id_responsable
integer
ID de la persona responsable del activo
​
avaluo
integer
Valor del activo en pesos colombianos
​
observaciones
string
Notas adicionales sobre el activo

​
Crear un activo

Para crear un nuevo activo, envíe una petición POST al endpoint de inventario: 
curl -X POST http://localhost:8000/api/inventario/ \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "codigo": 1001,
    "placa_de_activo": "ACT-001",
    "descripcion_completa_articulo": "Escritorio ejecutivo",
    "id_ubicacion": 1,
    "id_estado": 1,
    "id_clasificacion": 1,
    "id_responsable": 1,
    "avaluo": 500000,
    "observaciones": "En buen estado"
  }'
Antes de crear activos, debe crear los catálogos de referencia (ubicaciones, estados, clasificaciones, responsables).

​
Actualizar un activo

Actualice un activo existente usando PUT o PATCH: 
curl -X PUT http://localhost:8000/api/inventario/ACT-001/ \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "codigo": 1001,
    "placa_de_activo": "ACT-001",
    "descripcion_completa_articulo": "Escritorio ejecutivo de madera",
    "id_ubicacion": 2,
    "id_estado": 1,
    "avaluo": 550000
  }'
Todos los cambios quedan registrados en el historial gracias a django-simple-history.

​
Eliminar activos

Solo usuarios con rol sys_admin pueden eliminar activos: 
curl -X DELETE http://localhost:8000/api/inventario/ACT-001/ \
  -H "Authorization: Bearer YOUR_TOKEN"
El activo se elimina de la tabla principal, pero se guarda un snapshot completo en inventario_eliminado para auditoría.

​
Buscar y filtrar activos

El sistema ofrece múltiples opciones de búsqueda:

​
Por placa exacta

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

​
Por ubicación

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

​
Por estado

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

​
Por responsable

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

​
Combinando filtros

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

​
Ver historial de cambios

Consulte todos los cambios realizados a un activo: 
curl -X GET http://localhost:8000/api/historial/ACT-001/ \
  -H "Authorization: Bearer YOUR_TOKEN"
La respuesta incluye cada versión del activo con:
  • Qué cambió
  • Quién lo cambió
  • Cuándo se cambió
  • Valores anteriores y nuevos
Ver detalles en Registro de auditoría.

​
Mejores prácticas

1

Use placas únicas y descriptivas

Las placas son identificadores únicos. Use un formato consistente como AREA-TIPO-NUMERO.
2

Complete todos los campos

Mientras más información registre, más útil será el sistema para reportes y auditorías.
3

Actualice ubicaciones regularmente

Cuando un activo se mueva, actualice su ubicación inmediatamente.
4

Use observaciones para contexto

Registre información adicional que pueda ser útil en el futuro.

​
Recursos adicionales

API de inventario

Documentación completa de la API

Modelo de datos

Estructura completa del modelo Inventario

Build docs developers (and LLMs) love

Get started for freeTalk to us