smartbill-invoicing
por maverick-ai-tech
Productivity & TasksResumen
Issue SmartBill invoices through the SmartBill.ro API with local automation.
Descripción
Qué hace esta skill
Issues and manages SmartBill invoices via the SmartBill.ro API using a local CLI script. Covers payload validation, dry-run inspection, invoice creation with confirmation gates, series lookup, and PDF download.
The CLI enforces a validate-then-dry-run-then-confirm flow that prevents accidental final invoice issuance, which the raw API does not.
Cuándo usarla
- Creating a client invoice after confirming line items
- Downloading a PDF copy of an issued invoice by series and number
- Listing available document series before issuing
- Validating an invoice JSON payload before sending to the API
- Dry-running an invoice to inspect the normalized payload without making an API call
Flujo de trabajo de ejemplo
User asks: Issue an invoice for client Acme SRL based on invoice.json
- 1
Run validate-payload on invoice.json to check structure
- 2
Run create-invoice with --dry-run to inspect normalized payload
- 3
Present payload to user and request explicit confirmation
- 4
Run create-invoice with --allow-final to issue the invoice
- 5
Capture returned series and number verbatim for logging
Invoice issued; series and zero-padded number stored in run log
Requisitos
- SMARTBILL_USERNAME environment variable (SmartBill login email)
- SMARTBILL_TOKEN environment variable (SmartBill API token)
- SMARTBILL_COMPANY_VAT_CODE environment variable (company CIF)
- SmartBill account at SmartBill.ro
Instalación
clawhub install maverick-ai-tech/smartbill-invoicingEjecuta el comando de la CLI o pega el prompt en Claude Code, Cursor, Codex o el agente de programación que uses.