Bỏ qua tới nội dung
TakoAPI
Quay lại kỹ năng

smartbill

bởi tokyo-s

Productivity & Tasks
—Chưa có đánh giá
Đánh giá của bạn

Tóm tắt

Issue SmartBill invoices through the SmartBill.ro API with local automation.

Mô tả

Kỹ năng này làm gì

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.

Khi nào nên dùng

  • 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

Quy trình ví dụ

ĐẦU VÀO

User asks: Create an invoice for client RO12345678 using the details in invoice.json

AGENT
  1. 1

    Validate the payload with python scripts/smartbill_cli.py validate-payload --input invoice.json --show-payload

  2. 2

    Run dry-run to inspect normalized output with python scripts/smartbill_cli.py create-invoice --input invoice.json --dry-run

  3. 3

    Ask user to confirm the payload before proceeding

  4. 4

    Issue the final invoice with python scripts/smartbill_cli.py create-invoice --input invoice.json --allow-final

  5. 5

    Log the returned series, number, and message from the SmartBill response

ĐẦU RA

Invoice created; SmartBill returns series, invoice number, and confirmation message

Yêu cầu

  • 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

Cài đặt

clawhub install tokyo-s/smartbill

Chạy lệnh CLI, hoặc dán prompt vào Claude Code, Cursor, Codex hay coding agent bạn đang dùng.

Liên kết