跳到正文
TakoAPI
返回技能列表

smartbill

由 tokyo-s 提供

Productivity & Tasks
—暂无评分
你的评分

简介

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 或你在用的任意编程智能体里。

链接