Gastos Island

Propósito

GastosIsland opera el ciclo frontend de gastos: registra gastos manuales o vinculados a compras SII, mantiene categorias de gasto, contabiliza, reversa, elimina pendientes, genera contabilizacion por grupo y consulta resumen anual. Consume /api/gastos y la lectura de plan de cuentas desde /api/admin/chart-of-accounts.

Ubicación

• Directorysevastopol/src/components/islands/contabilidad/

  • GastosIsland.tsx
• Directorysevastopol/src/pages/api/gastos/

  • […path].ts
• Directorysevastopol/src/pages/api/admin/

  • chart-of-accounts.ts

Composición

Pestaña	Función	Endpoint base
gastos	Lista, crea, contabiliza, reversa y elimina gastos.	/api/gastos/gastos
categorias	Mantiene categorias con cuenta de gasto asociada.	/api/gastos/categorias
resumen	Consulta agregados anuales por periodo y categoria.	/api/gastos/resumen

const GAS_API = "/api/gastos";
const COA_API = "/api/admin/chart-of-accounts";
const [tab, setTab] = createSignal<"gastos" | "categorias" | "resumen">("gastos");

Hooks y Estado Global

Hook	Aporta	Reactividad
useActiveTenant	Tenant activo para gastos, categorias y proveedores.	Recarga datos del tenant al cambiar seleccion.
useActivePeriod	Periodo contable global.	Ajusta filtros y resumen anual.

El estado local incluye filtros de estado y categoria, listas de proveedores, cuentas, conceptos de impuestos, formularios y modales.

Flujo de Gasto

1. Cargar categorias, proveedores y cuentas contables del tenant.

2. Crear un gasto con POST /api/gastos/gastos, opcionalmente vinculado a una compra SII.

3. Contabilizar con PUT /api/gastos/gastos/:id/contabilizar o por grupo con PUT /api/gastos/contabilizar-grupo.

4. Reversar con PUT /api/gastos/gastos/:id/reversar cuando el gasto este contabilizado.

Acciones Auxiliares

Acción	Endpoint	Uso
Importar IVA no recuperable	POST /api/gastos/iva-no-recuperable/importar	Genera gastos desde conceptos tributarios no recuperables.
Cargar proveedores	GET /api/gastos/proveedores	Alimenta selectores y vinculos con compras.
Cargar conceptos de impuestos	GET /api/gastos/conceptos-impuestos	Parametriza la importacion de IVA no recuperable.

Reglas de UI

Regla	Motivo
Exigir categoria y cuenta	El gasto debe tener imputacion contable antes de contabilizar.
Separar pendiente y contabilizado	Las acciones visibles dependen del estado.
Permitir reversa explicita	La reversa cambia estado y asiento asociado.
Recargar listas tras cada accion	Evita que la UI muestre estados antiguos.
Revisar compras significativas	Una compra puede corresponder a inventario o activo fijo antes de ser gasto.

Ver También

ProveedoresInventarioIsland Clasificacion que orienta compras hacia gasto, inventario o activo fijo.

InventarioIsland Destino alternativo para compras cuyo beneficio se mantiene como activo corriente.