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-invoicingCLI 명령을 실행하거나, 프롬프트를 Claude Code, Cursor, Codex 등 사용하는 코딩 에이전트에 붙여넣으세요.