alegra

alegra

Alegra accounting system CLI

Synopsis

alegra is a command-line interface for the Alegra accounting API (https://developer.alegra.com).

It manages contacts, invoices, items, payments, taxes, and the full Alegra resource surface, with table/json/yaml/csv output, profiles, and a dry-run mode.

Authenticate with: alegra auth login # stores your API token in the OS keyring or set ALEGRA_EMAIL and ALEGRA_TOKEN in the environment.

Options

      --base-url string             Override the API base URL (env: ALEGRA_BASE_URL)
      --columns strings             Comma-separated columns for table/csv output
      --dry-run                     Print the equivalent curl request without sending it
  -h, --help                        help for alegra
      --no-color                    Disable colored output (also respects the NO_COLOR env var)
  -o, --output string               Output format: table, json, yaml, csv (env: ALEGRA_OUTPUT)
      --profile string              Configuration profile to use (env: ALEGRA_PROFILE)
      --requests-per-second float   Client-side rate limit (default from config)
      --show-token                  In --dry-run, do not redact the Authorization header
  -v, --verbose                     Enable verbose (debug) logging to stderr

SEE ALSO

• alegra additional-charges - Manage additional charges (tips and parafiscal contributions)
• alegra alias - Save and manage command aliases
• alegra auth - Manage Alegra API authentication
• alegra bank-accounts - Manage bank accounts (bank, credit card, and cash accounts)
• alegra bills - Manage provider bills (facturas de proveedor)
• alegra catalog - Country reference catalogs (units, identification types, taxes, ...)
• alegra categories - Manage chart-of-accounts accounts (cuentas contables)
• alegra company - View and update the account's company (empresa)
• alegra config - Manage alegra-cli configuration and profiles
• alegra contacts - Manage contacts (clients and providers)
• alegra cost-centers - Manage cost centers
• alegra credit-notes - Manage credit notes
• alegra currencies - Manage currencies (monedas)
• alegra custom-fields - Manage custom fields (campos adicionales)
• alegra debit-notes - Manage debit notes
• alegra doctor - Diagnose configuration, credentials, and account health
• alegra estimates - Manage estimates (cotizaciones / sales quotes)
• alegra global-invoices - Manage global invoices (facturas globales)
• alegra income-debit-notes - Manage customer debit notes
• alegra init - Guided setup: authenticate, detect your country, and save a profile
• alegra inventory-adjustment-numerations - Manage inventory adjustment numerations
• alegra inventory-adjustments - Manage inventory adjustments (manual stock corrections)
• alegra invoices - Manage sales invoices
• alegra item-categories - Manage item categories
• alegra items - Manage items (products and services)
• alegra journals - Manage accounting journal entries (comprobantes contables)
• alegra mcp - MCP server management
• alegra number-templates - Manage document numberings (numeraciones de facturación)
• alegra payments - Manage payments (incomes and expenses)
• alegra price-lists - Manage price lists
• alegra purchase-orders - Manage purchase orders (órdenes de compra)
• alegra reconciliations - Manage bank reconciliations
• alegra recurring-invoices - Manage recurring invoices (facturas recurrentes)
• alegra recurring-payments - View recurring payments (pagos recurrentes)
• alegra remissions - Manage remissions (delivery notes)
• alegra reports - Read-only Alegra reports
• alegra retentions - Manage retentions (withholdings)
• alegra sellers - Manage sellers (vendedores)
• alegra skills - Install this CLI's AI-agent skill into Claude, Cursor, and other agents
• alegra taxes - Manage taxes (e.g. IVA)
• alegra terms - Manage payment terms (términos de pago)
• alegra transportation-receipts - Manage transportation receipts (documentos de traslado)
• alegra users - Manage account users
• alegra variant-attributes - Manage item variant attributes (e.g. Color, Talla)
• alegra version - Print version information
• alegra warehouse-transfers - Manage inventory transfers between warehouses
• alegra warehouses - Manage inventory warehouses (bodegas)
• alegra webhook-subscriptions - Manage webhook subscriptions (event notifications)