Categorías Movimiento

Categorías Movimiento

Prefijo: /api/categorias-movimiento
Requiere Auth: Sí
Permiso requerido: categorias_movimiento, *

Módulo de categorías de movimiento de inventario. Cada categoría describe un tipo de movimiento (ej: “Entrada”, “Salida”, “Ajuste”, “Merma”) usado para clasificar los inventario_movimientos.

---

GET /api/categorias-movimiento/

Descripción: Lista las categorías de movimiento con paginación
Requiere Auth: Sí
Permiso requerido: categorias_movimiento, leer

Parámetros query:

Parámetro	Tipo	Obligatorio	Descripción
skip	int	❌	Número de registros a saltar (default 0)
limit	int	❌	Máximo de registros a retornar (default 100)

Respuesta exitosa: 200 OK

Response:

[
  {
    "id": 1,
    "nombre": "Entrada",
    "tenant_id": "uuid-tenant"
  }
]

cURL:

curl "http://localhost/api/categorias-movimiento/?skip=0&limit=20" -H "Authorization: Bearer <token>"

---

GET /api/categorias-movimiento/:categoria_id

Descripción: Obtiene una categoría de movimiento por ID
Requiere Auth: Sí
Permiso requerido: categorias_movimiento, leer

Respuesta exitosa: 200 OK
Errores: 404 (no encontrada)

cURL:

curl http://localhost/api/categorias-movimiento/1 -H "Authorization: Bearer <token>"

---

POST /api/categorias-movimiento/

Descripción: Crea una nueva categoría de movimiento
Requiere Auth: Sí
Permiso requerido: categorias_movimiento, crear

Request:

{
  "nombre": "Merma"
}

Respuesta exitosa: 201 Created

cURL:

curl -X POST http://localhost/api/categorias-movimiento/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{"nombre":"Merma"}'

---

PUT /api/categorias-movimiento/:categoria_id

Descripción: Actualiza una categoría de movimiento. Todos los campos son opcionales.
Requiere Auth: Sí
Permiso requerido: categorias_movimiento, actualizar

Request:

{
  "nombre": "Merma Interna"
}

Respuesta exitosa: 200 OK
Errores: 404 (no encontrada)

cURL:

curl -X PUT http://localhost/api/categorias-movimiento/1 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{"nombre":"Merma Interna"}'

---

DELETE /api/categorias-movimiento/:categoria_id

Descripción: Elimina una categoría de movimiento
Requiere Auth: Sí
Permiso requerido: categorias_movimiento, eliminar

Respuesta exitosa: 204 No Content
Errores: 404 (no encontrada)

cURL:

curl -X DELETE http://localhost/api/categorias-movimiento/1 -H "Authorization: Bearer <token>"