本文へスキップ
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などお使いのコーディングエージェントにプロンプトを貼り付けてください。

リンク