تخطَّ إلى المحتوى
TakoAPI
العودة إلى المهارات

smartbill-invoicing

بواسطة maverick-ai-tech

Productivity & Tasks
413التنزيلات وفق ما يذكره clawskills.sh
2النجوم
0المشاهدات
لا إعجاباتسجّل الدخول للإعجاب بهذه المهارة
—لم يُقيَّم بعد
تقييمك

موجز

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

الوصف

ما الذي تفعله هذه المهارة

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.

متى تستخدمها

  • 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

مثال على سير العمل

الإدخال

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

الوكيل
  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

الإخراج

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

المتطلبات

  • 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

التثبيت

clawhub install maverick-ai-tech/smartbill-invoicing

شغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.

الروابط