Sk 04 React Query Custom Hooks

Movimientos (10 hooks)

• use-movimientos.ts:
  • useMovimientos(filters)
  • useMovimientoDetalle(id, negocioId)
  • useMovimientoPendientesCount()
  • useCreateMovimiento()
  • useAprobarMovimiento()
  • useRechazarMovimiento()
  • useReenviarMovimiento()
  • useDeleteMovimiento()
  • useMarcarPagado()
  • useCancelarMovimiento()

Negocios

• use-negocios.ts:
  • useNegocios({ negocioId?, enabled? })
  • useNegocioDetail({ id, enabled?, negocioId? })
  • useCrearNegocio()
  • useActualizarNegocio()
  • useEliminarNegocio()

Cuentas banco

• use-cuentas-banco.ts:
  • useCuentasBanco({ negocioId })
  • useCuentaBancoDetail({ id, negocioId })
  • useCreateCuentaBanco({ negocioId })
  • useUpdateCuentaBanco({ negocioId })
  • useDeleteCuentaBanco({ negocioId })
  • useUpdateSaldoReal({ negocioId })
  • useAsignarNegocio({ negocioId })
  • useRemoverNegocio({ negocioId })

Divisiones / Centros de costo

• use-centros-costo.ts: useCentrosCosto({ negocioId }), useCentrosCostoTree({ negocioId })
• use-division-resumen.ts: useDivisionResumen({ centroCostoId, fechaDesde, fechaHasta })

Arqueo / Consolidado / Reportes

• use-arqueo.ts: useArqueoNegocio({ negocioId, fechaCorte? }), useArqueoCuenta({ cuentaBancoId, fechaCorte? })
• use-consolidado.ts: useConsolidado({ enabled? })
• use-reportes.ts: useReportes({ ... })
• use-pending-count.ts: usePendingCount()

Usuarios / Roles

• use-usuarios.ts: useUsuarios(...), useUsuarioDetail(...), useRoles(...), useCreateUsuario(...), useUpdateUsuario(...), useDeleteUsuario(...)

Patrón de parsing JSON (estado actual)

• Actualmente varios hooks definen un helper local apiJson(apiFetch, url, { json }) para parsear JSON y levantar Error(message) si !res.ok.
• Si se crea un nuevo hook, mantener el patrón consistente con el archivo existente y evitar duplicar helpers con variaciones.

Convención de query keys

• Lista: ['recurso', negocioId]
• Detalle: ['recurso', id] o ['recurso', negocioId, id] si depende del tenant
• Con filtros: ['recurso', negocioId, { ...filtros }]
• Global: ['recurso']