Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
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.
When to use it
- 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
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Create an invoice for client RO12345678 using the details in invoice.json
- 1Validate the payload with `python scripts/smartbill_cli.py validate-payload --input invoice.json --show-payload`
- 2Run dry-run to inspect normalized output with `python scripts/smartbill_cli.py create-invoice --input invoice.json --dry-run`
- 3Ask user to confirm the payload before proceeding
- 4Issue the final invoice with `python scripts/smartbill_cli.py create-invoice --input invoice.json --allow-final`
- 5Log the returned series, number, and message from the SmartBill response
Invoice created; SmartBill returns series, invoice number, and confirmation message
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.