İçeriğe geç
TakoAPI
Becerilere dön

smartbill

tokyo-s tarafından

Productivity & Tasks
—Henüz değerlendirilmedi
Puanınız

Özet

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

Açıklama

Bu Beceri Ne Yapar

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.

Ne Zaman Kullanılır

  • 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

Örnek İş Akışı

GİRİŞ

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

AJAN
  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

ÇIKIŞ

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

Gereksinimler

  • 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

Kurulum

clawhub install tokyo-s/smartbill

CLI komutunu çalıştırın ya da istemi Claude Code, Cursor, Codex veya kullandığınız kodlama ajanına yapıştırın.

Bağlantılar