smartbill-invoicing
от maverick-ai-tech
Productivity & TasksКратко
Issue SmartBill invoices through the SmartBill.ro API with local automation.
Описание
Что делает этот навык
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.
Когда его использовать
- 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
Пример сценария
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
Требования
- 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
Установка
clawhub install maverick-ai-tech/smartbill-invoicingВыполните команду CLI или вставьте промпт в Claude Code, Cursor, Codex — любой кодинг-агент, которым пользуетесь.