Fizko CLI

CLI para consultar datos tributarios y contables desde la API de Fizko.

Instalación

npm install -g fizko-cli
# o sin instalar:
npx fizko-cli <command>

Autenticación

fizko login

Se abrirá tu navegador para iniciar sesión con tu cuenta Fizko. Las credenciales se guardan en ~/.config/fizko/credentials.json (compatible con la versión Python).

También puedes usar una API key directamente:

export FIZKO_API_KEY=fizko_xxxxx

Uso

# Empresas
fizko companies list
fizko companies get <company-uuid>

# Documentos tributarios
fizko tax purchases --company <uuid>
fizko tax sales --company <uuid> --period-year 2026 --period-month 1
fizko tax documents --company <uuid> --period 2026-01
fizko tax f29 --company <uuid>
fizko tax summary --company <uuid> --period 2026-01
fizko tax iva --company <uuid> --period 2026-01
fizko tax timeline --company <uuid>
fizko tax honorarios --company <uuid>
fizko tax ddjj --company <uuid> --year 2025
fizko tax checker-tributario --company <uuid> --period 2026-01
fizko tax checker-impuestos --company <uuid> --period 2026-01

# Contabilidad
fizko accounting accounts --company <uuid>
fizko accounting journal-entries --company <uuid> --period 2026-01
fizko accounting balance-report --company <uuid> --period-from 2026-01 --period-to 2026-12
fizko accounting income-statement --company <uuid> --period-from 2026-01 --period-to 2026-12
fizko accounting general-journal --company <uuid> --period 2026-01
fizko accounting general-ledger --company <uuid> --period-from 2026-01 --period-to 2026-12
fizko accounting classified-balance --company <uuid> --period 2026-12
fizko accounting rli-balance --company <uuid> --period-from 2026-01 --period-to 2026-12
fizko accounting progress --company <uuid> --period 2026-01

# Obligaciones
fizko accounting obligations --company <uuid> --status pending
fizko accounting obligation <obligation-uuid>
fizko accounting contabilizar <obligation-uuid>
fizko accounting descontabilizar <obligation-uuid>
fizko accounting abonar <obligation-uuid> --amount 50000 --payment-type cash

# Movimientos bancarios
fizko banking movements --company <uuid> --status pending
fizko banking movement <movement-uuid>
fizko banking classify <movement-uuid> --classification 'Gasto Operacional'
fizko banking contabilizar <movement-uuid> --account-code 5101
fizko banking contabilizar-reconciliaciones <movement-uuid> --entries '[{"reconciliation_id":"UUID","lines":[{"account_code":"5101","debit":1000,"credit":0}]}]'
fizko banking descontabilizar <movement-uuid>

# Conciliación bancaria
fizko banking reconcile --movement-id <uuid> --obligation-id <uuid>
fizko banking reconcile-multi --movement-id <uuid> --obligation-ids UUID1,UUID2
fizko banking unmatch <reconciliation-uuid>
fizko banking list-reconciliations --company <uuid> --period 2026-01
fizko banking suggestions --company <uuid> --movement-id <uuid>
fizko banking status --company <uuid> --period 2026-01
fizko banking obligation-from-movement <movement-uuid> --classification 'Gasto Operacional'

# Schema para agentes AI
fizko schema

# Estado de sesión
fizko status
fizko logout

Todos los comandos devuelven JSON a stdout. Errores van a stderr como JSON. Usa --compact para output sin indentación.

Requisitos

Node.js 18+