Skip to content
TakoAPI
Back to skills

smartbill-invoicing

by maverick-ai-tech

Productivity & Tasks
413Downloads reported by clawskills.sh
2Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

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

Description

What This Skill Does

Issues and manages SmartBill invoices via the SmartBill.ro API using a local CLI script. Covers payload validation, dry-run inspection, invoice creation with confirmation gates, series lookup, and PDF download.

The CLI enforces a validate-then-dry-run-then-confirm flow that prevents accidental final invoice issuance, which the raw API does not.

When to Use It

  • Creating a client invoice after confirming line items
  • Downloading a PDF copy of an issued invoice by series and number
  • Listing available document series before issuing
  • Validating an invoice JSON payload before sending to the API
  • Dry-running an invoice to inspect the normalized payload without making an API call

Example Workflow

INPUT

User asks: Issue an invoice for client Acme SRL based on invoice.json

AGENT
  1. 1

    Run validate-payload on invoice.json to check structure

  2. 2

    Run create-invoice with --dry-run to inspect normalized payload

  3. 3

    Present payload to user and request explicit confirmation

  4. 4

    Run create-invoice with --allow-final to issue the invoice

  5. 5

    Capture returned series and number verbatim for logging

OUTPUT

Invoice issued; series and zero-padded number stored in run log

Requirements

  • SMARTBILL_USERNAME environment variable (SmartBill login email)
  • SMARTBILL_TOKEN environment variable (SmartBill API token)
  • SMARTBILL_COMPANY_VAT_CODE environment variable (company CIF)
  • SmartBill account at SmartBill.ro

Installation

clawhub install maverick-ai-tech/smartbill-invoicing

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links