fizko-cli 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +94 -0
  2. package/dist/index.js +1561 -0
  3. package/package.json +43 -0
package/README.md ADDED
@@ -0,0 +1,94 @@
1
+ # Fizko CLI
2
+
3
+ CLI para consultar datos tributarios y contables desde la API de Fizko.
4
+
5
+ ## Instalación
6
+
7
+ ```bash
8
+ npm install -g fizko-cli
9
+ # o sin instalar:
10
+ npx fizko-cli <command>
11
+ ```
12
+
13
+ ## Autenticación
14
+
15
+ ```bash
16
+ fizko login
17
+ ```
18
+
19
+ 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).
20
+
21
+ También puedes usar una API key directamente:
22
+
23
+ ```bash
24
+ export FIZKO_API_KEY=fizko_xxxxx
25
+ ```
26
+
27
+ ## Uso
28
+
29
+ ```bash
30
+ # Empresas
31
+ fizko companies list
32
+ fizko companies get <company-uuid>
33
+
34
+ # Documentos tributarios
35
+ fizko tax purchases --company <uuid>
36
+ fizko tax sales --company <uuid> --period-year 2026 --period-month 1
37
+ fizko tax documents --company <uuid> --period 2026-01
38
+ fizko tax f29 --company <uuid>
39
+ fizko tax summary --company <uuid> --period 2026-01
40
+ fizko tax iva --company <uuid> --period 2026-01
41
+ fizko tax timeline --company <uuid>
42
+ fizko tax honorarios --company <uuid>
43
+ fizko tax ddjj --company <uuid> --year 2025
44
+ fizko tax checker-tributario --company <uuid> --period 2026-01
45
+ fizko tax checker-impuestos --company <uuid> --period 2026-01
46
+
47
+ # Contabilidad
48
+ fizko accounting accounts --company <uuid>
49
+ fizko accounting journal-entries --company <uuid> --period 2026-01
50
+ fizko accounting balance-report --company <uuid> --period-from 2026-01 --period-to 2026-12
51
+ fizko accounting income-statement --company <uuid> --period-from 2026-01 --period-to 2026-12
52
+ fizko accounting general-journal --company <uuid> --period 2026-01
53
+ fizko accounting general-ledger --company <uuid> --period-from 2026-01 --period-to 2026-12
54
+ fizko accounting classified-balance --company <uuid> --period 2026-12
55
+ fizko accounting rli-balance --company <uuid> --period-from 2026-01 --period-to 2026-12
56
+ fizko accounting progress --company <uuid> --period 2026-01
57
+
58
+ # Obligaciones
59
+ fizko accounting obligations --company <uuid> --status pending
60
+ fizko accounting obligation <obligation-uuid>
61
+ fizko accounting contabilizar <obligation-uuid>
62
+ fizko accounting descontabilizar <obligation-uuid>
63
+ fizko accounting abonar <obligation-uuid> --amount 50000 --payment-type cash
64
+
65
+ # Movimientos bancarios
66
+ fizko banking movements --company <uuid> --status pending
67
+ fizko banking movement <movement-uuid>
68
+ fizko banking classify <movement-uuid> --classification 'Gasto Operacional'
69
+ fizko banking contabilizar <movement-uuid> --account-code 5101
70
+ fizko banking contabilizar-reconciliaciones <movement-uuid> --entries '[{"reconciliation_id":"UUID","lines":[{"account_code":"5101","debit":1000,"credit":0}]}]'
71
+ fizko banking descontabilizar <movement-uuid>
72
+
73
+ # Conciliación bancaria
74
+ fizko banking reconcile --movement-id <uuid> --obligation-id <uuid>
75
+ fizko banking reconcile-multi --movement-id <uuid> --obligation-ids UUID1,UUID2
76
+ fizko banking unmatch <reconciliation-uuid>
77
+ fizko banking list-reconciliations --company <uuid> --period 2026-01
78
+ fizko banking suggestions --company <uuid> --movement-id <uuid>
79
+ fizko banking status --company <uuid> --period 2026-01
80
+ fizko banking obligation-from-movement <movement-uuid> --classification 'Gasto Operacional'
81
+
82
+ # Schema para agentes AI
83
+ fizko schema
84
+
85
+ # Estado de sesión
86
+ fizko status
87
+ fizko logout
88
+ ```
89
+
90
+ Todos los comandos devuelven JSON a stdout. Errores van a stderr como JSON. Usa `--compact` para output sin indentación.
91
+
92
+ ## Requisitos
93
+
94
+ Node.js 18+