fiscalapi 0.1.0

Primera versión de fiscalapi, el CLI de FiscalAPI para webhooks y eventos desde la terminal.

Qué trae

• login / logout: guarda o borra la API key y la tenant key en el almacén de credenciales del sistema.
• webhooks: administra los webhooks del tenant (list, retrieve, create, update, delete, rotate-secret).
• events: consulta y reenvía los eventos de los últimos 30 días (list, retrieve, resend).
• listen: recibe los eventos en la terminal y los reenvía a tu servidor local con --forward-to.
• trigger <type>: dispara un evento de prueba hacia tu listen o hacia un webhook (solo en pruebas).
• Aviso en stderr cuando hay una versión nueva.

Plataformas

Sistema	Empaque	Requisito
Windows x64	fiscalapi-win-x64.zip	Windows 10 u 11, o Windows Server 2012 o más nuevo
Linux x64	fiscalapi-linux-x64.tar.gz	glibc 2.28 o más nueva; no corre en Alpine (musl)
macOS Apple Silicon	fiscalapi-osx-arm64.tar.gz	macOS 15 o más nuevo
macOS Intel	fiscalapi-osx-x64.tar.gz	macOS 15 o más nuevo

Un solo ejecutable, sin dependencias. No tiene firma de código: SmartScreen y Gatekeeper avisan la primera vez.

Importante

La API con las rutas /api/v4/webhooks todavía no está desplegada en test ni en live. Por ahora el CLI solo funciona contra un back local:

fiscalapi login --api-base http://localhost:5001
fiscalapi listen --api-base http://localhost:5001 --forward-to http://localhost:3000/webhooks

Instalar y verificar

Descarga tu empaque y SHA256SUMS, y compara el SHA-256 antes de ejecutarlo.

Linux (en macOS cambia el empaque y usa shasum -a 256 -c - en lugar de sha256sum -c -):

base=https://github.com/FiscalAPI/fiscalapi-cli/releases/latest/download
curl -fsSLO "$base/fiscalapi-linux-x64.tar.gz"
curl -fsSLO "$base/SHA256SUMS"
grep ' fiscalapi-linux-x64.tar.gz$' SHA256SUMS | sha256sum -c -   # debe decir: OK
tar -xzf fiscalapi-linux-x64.tar.gz
sudo install -m 0755 fiscalapi /usr/local/bin/fiscalapi
fiscalapi --version

Windows (PowerShell):

$base = 'https://github.com/FiscalAPI/fiscalapi-cli/releases/latest/download'
Invoke-WebRequest "$base/fiscalapi-win-x64.zip" -OutFile fiscalapi-win-x64.zip
Invoke-WebRequest "$base/SHA256SUMS" -OutFile SHA256SUMS
$expected = (Select-String -Path SHA256SUMS -Pattern ' fiscalapi-win-x64\.zip$').Line.Split(' ')[0]
$actual = (Get-FileHash fiscalapi-win-x64.zip -Algorithm SHA256).Hash.ToLowerInvariant()
if ($actual -ne $expected) { throw "El SHA-256 no coincide: $actual" } else { 'SHA-256 OK' }
Expand-Archive fiscalapi-win-x64.zip -DestinationPath (Join-Path $env:LOCALAPPDATA 'Programs\fiscalapi') -Force

Para esta versión fija, cambia releases/latest/download por releases/download/v0.1.0.

Documentación

• README: inicio rápido.
• Instalación: PATH, Gatekeeper, SmartScreen, actualizar y desinstalar.
• Todas las guías: autenticación, listen, webhooks y eventos, trigger, salida y códigos, solución de problemas.

Full Changelog: https://github.com/FiscalAPI/fiscalapi-cli/commits/v0.1.0

fiscalapi 0.1.0-rc.1

Versión candidata de fiscalapi, el CLI de FiscalAPI para webhooks y eventos desde la terminal. Sirve para probar antes de 0.1.0; puede cambiar.

Qué trae

• login / logout: guarda o borra la API key y la tenant key en el almacén de credenciales del sistema.
• webhooks: administra los webhooks del tenant.
• events: consulta y reenvía los eventos de los últimos 30 días.
• listen: recibe los eventos en la terminal y los reenvía a tu servidor local.
• trigger <type>: dispara un evento de prueba hacia tu listen o hacia un webhook (solo en pruebas).

Plataformas

Sistema	Empaque
Windows x64	fiscalapi-win-x64.zip
Linux x64 (glibc 2.28 o más nueva)	fiscalapi-linux-x64.tar.gz
macOS Apple Silicon	fiscalapi-osx-arm64.tar.gz
macOS Intel	fiscalapi-osx-x64.tar.gz

Un solo ejecutable, sin dependencias.

Importante

La API con las rutas /api/v4/webhooks todavía no está desplegada en test ni en live. Por ahora el CLI solo funciona contra un back local:

fiscalapi login --api-base http://localhost:5001
fiscalapi listen --api-base http://localhost:5001 --forward-to http://localhost:3000/webhooks

Verificar la descarga

Descarga tu empaque y SHA256SUMS, y compara el SHA-256 antes de ejecutarlo.

Linux (en macOS usa shasum -a 256 -c - en lugar de sha256sum -c -):

base=https://github.com/FiscalAPI/fiscalapi-cli/releases/download/v0.1.0-rc.1
curl -fsSLO "$base/fiscalapi-linux-x64.tar.gz"
curl -fsSLO "$base/SHA256SUMS"
grep ' fiscalapi-linux-x64.tar.gz$' SHA256SUMS | sha256sum -c -   # debe decir: OK

Windows (PowerShell):

$base = 'https://github.com/FiscalAPI/fiscalapi-cli/releases/download/v0.1.0-rc.1'
Invoke-WebRequest "$base/fiscalapi-win-x64.zip" -OutFile fiscalapi-win-x64.zip
Invoke-WebRequest "$base/SHA256SUMS" -OutFile SHA256SUMS
$expected = (Select-String -Path SHA256SUMS -Pattern ' fiscalapi-win-x64\.zip$').Line.Split(' ')[0]
$actual = (Get-FileHash fiscalapi-win-x64.zip -Algorithm SHA256).Hash.ToLowerInvariant()
if ($actual -ne $expected) { throw "El SHA-256 no coincide: $actual" } else { 'SHA-256 OK' }

Instalación, PATH, Gatekeeper y SmartScreen: docs/instalacion.md.

Full Changelog: https://github.com/FiscalAPI/fiscalapi-cli/commits/v0.1.0-rc.1