smartbill
par tokyo-s
Productivity & TasksRésumé
Issue SmartBill invoices through the SmartBill.ro API with local automation.
Description
Ce que fait ce skill
Automates SmartBill invoice operations via the SmartBill.ro API using a local CLI script. Covers payload validation, dry-run inspection, invoice creation, series listing, and PDF download.
The CLI enforces a validate-then-dry-run-then-confirm flow, reducing the chance of issuing incorrect final invoices that cannot be easily reversed.
Quand l'utiliser
- Issuing a client invoice after confirming line items
- Downloading a PDF copy of an existing invoice by series and number
- Checking available document series before creating an invoice
- Validating an invoice payload locally before sending it to the API
- Running a dry-run to inspect the normalized payload without hitting the API
Exemple de workflow
User asks: Create an invoice for client RO12345678 using the details in invoice.json
- 1
Validate the payload with
python scripts/smartbill_cli.py validate-payload --input invoice.json --show-payload - 2
Run dry-run to inspect normalized output with
python scripts/smartbill_cli.py create-invoice --input invoice.json --dry-run - 3
Ask user to confirm the payload before proceeding
- 4
Issue the final invoice with
python scripts/smartbill_cli.py create-invoice --input invoice.json --allow-final - 5
Log the returned series, number, and message from the SmartBill response
Invoice created; SmartBill returns series, invoice number, and confirmation message
Prérequis
- SMARTBILL_USERNAME environment variable (SmartBill login email)
- SMARTBILL_TOKEN environment variable (SmartBill API token)
- SMARTBILL_COMPANY_VAT_CODE environment variable (company CIF)
- SmartBill.ro account
Installation
clawhub install tokyo-s/smartbillExécute la commande CLI, ou colle l'instruction dans Claude Code, Cursor, Codex ou l'agent de code que tu utilises.