본문으로 건너뛰기
TakoAPI
스킬로 돌아가기
—아직 평가 없음
내 평가

요약

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. 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

출력

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 등 사용하는 코딩 에이전트에 붙여넣으세요.

링크