Documentación de Endpoints API v1

Base URL: http://177.222.54.59:8000/api/v1/

⚙️ Endpoints Generales

Método Ruta Completa Descripción
DELETE .../multimedia/{id} Elimina un archivo multimedia específico, identificado por su ID.

📦 Módulo de Productos

Método Ruta Completa Descripción
GET .../productos Lista todos los productos. Soporta filtros de búsqueda. **Ejemplo:** .../productos?buscar=aceite
POST .../productos Crea un nuevo producto en el inventario.
GET .../productos/{id} Obtiene los detalles de un producto específico.
PUT .../productos/{id} Actualiza la información completa de un producto existente.
DELETE .../productos/{id} Elimina un producto del sistema.
POST .../productos/{id}/ajustar-stock Ajusta manualmente la cantidad de stock de un producto (entrada/salida).
GET .../productos/bajo-stock/list Obtiene una lista de productos que están en nivel de alerta por bajo stock.
GET .../productos/mas-vendidos/list Obtiene el ranking de los productos más vendidos.
POST .../productos/buscar-codigo Busca un producto utilizando su código de barras o código interno.

🏷️ Módulo de Categorías

Método Ruta Completa Descripción
GET .../categorias Lista todas las categorías de productos.
POST .../categorias Crea una nueva categoría.
GET .../categorias/{id} Obtiene los detalles de una categoría específica.
PUT .../categorias/{id} Actualiza la información de una categoría.
DELETE .../categorias/{id} Elimina una categoría.

📐 Módulo de Unidades

Método Ruta Completa Descripción
GET .../unidades Lista todas las unidades de medida.
POST .../unidades Crea una nueva unidad de medida.
GET .../unidades/{id} Obtiene los detalles de una unidad de medida.
PUT .../unidades/{id} Actualiza la información de una unidad de medida.
DELETE .../unidades/{id} Elimina una unidad de medida.

👤 Módulo de Clientes

Método Ruta Completa Descripción
GET .../clientes Lista todos los clientes registrados.
POST .../clientes Crea un nuevo cliente.
GET .../clientes/stats Obtiene estadísticas resumidas sobre los clientes.
GET .../clientes/{id} Obtiene los detalles de un cliente específico.
PUT .../clientes/{id} Actualiza la información del cliente.
DELETE .../clientes/{id} Elimina un registro de cliente.
GET .../clientes/con-deuda/list Lista los clientes que tienen deudas o saldos pendientes.
GET .../clientes/{id}/prestamos Obtiene el historial de préstamos asociados a un cliente.
GET .../clientes/{id}/historial-compras Obtiene el historial de ventas/compras de un cliente.

🚚 Módulo de Proveedores

Método Ruta Completa Descripción
GET .../proveedores Lista todos los proveedores registrados.
POST .../proveedores Crea un nuevo proveedor.
GET .../proveedores/stats Obtiene estadísticas resumidas sobre los proveedores.
GET .../proveedores/{id} Obtiene los detalles de un proveedor.
PUT .../proveedores/{id} Actualiza la información de un proveedor.
DELETE .../proveedores/{id} Elimina un registro de proveedor.
GET .../proveedores/{id}/compras Obtiene el historial de órdenes de compra realizadas a este proveedor.
GET .../proveedores/{id}/compras-mes Reporte de las compras realizadas al proveedor en el mes actual.

📊 Listados y Módulos de Reportes (Rutas Activas)

Método Ruta Completa Descripción
GET .../compras Lista todas las órdenes de compra registradas.
GET .../cajas Lista todos los registros de movimientos de caja (aperturas y cierres).
GET .../ventas Lista todas las transacciones de ventas realizadas.
GET .../inventario Obtiene la vista principal del módulo de inventario.
GET .../reportes Obtiene el índice del módulo de reportes.
GET .../configuracion Obtiene el índice del módulo de configuración del sistema.