smartbill
由 tokyo-s 提供
Productivity & Tasks简介
Issue SmartBill invoices through the SmartBill.ro API with local automation.
描述
该技能的功能
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.
何时使用
- 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
示例工作流
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
前置要求
- 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
安装
clawhub install tokyo-s/smartbill运行 CLI 命令,或把这段提示词粘贴到 Claude Code、Cursor、Codex 或你在用的任意编程智能体里。