mcpField
S
szamlazz-invoicing

szamlazz-invoicing

github.com/davepoonその他3.7k93 回インストール今日更新
リポジトリ

szamlazz-invoicing について

szamlazz-invoicing は、szamlazz.hu Agent API を通じてハンガリーの請求書を作成・管理する Claude Code スキルです。金額計算、企業情報の照会、PDF ダウンロードに対応し、法的書類の発行前に確認を求めます。

主な機能

  1. 01通常請求書とプロフォーマの作成
  2. 02番号を指定した請求書の取消
  3. 03請求書PDFのダウンロード
  4. 04税番号による企業情報の照会
  5. 05DecimalによるVAT計算
  6. 06パートナー情報のローカルキャッシュ

活用シーン

  1. 01顧客への請求書発行
  2. 02プロフォーマ請求書の作成
  3. 03既存請求書の取消
  4. 04税番号を使った企業情報の照会

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/davepoon/buildwithclaude --skill szamlazz-invoicing

インストール後、Claude Code で/szamlazz-invoicingを入力して読み込まれたか確認します。

詳細

Szamlazz.hu のハンガリーの請求書発行

szamlazz.hu Agent API を介して、Claude Code から直接、ハンガリーの請求書の発行、取消（ストルノ）、ダウンロード、管理を行えます。

SocialPro が開発しました。中小企業向けのカスタム AI 連携を専門とする、ハンガリーの AI 自動化・デジタルマーケティング会社です。

このスキルを使う場面

  • ハンガリーの請求書（számla）を発行したい場合
  • プロフォーマ請求書／支払依頼書（díjbekérő）を作成したい場合
  • 既存の請求書を取り消し（ストルノ）したい場合
  • 請求書の PDF をダウンロードしたい場合
  • 税番号を使ってハンガリーの企業を検索したい場合（NAV）
  • ハンガリーの文脈で szamlazz.hu、számlázás、または請求に言及した場合

前提条件

  • プラグイン：socialpro-szamlazz がインストールされていること
  • Python 3.9 以降 と PyYAML（pip install pyyaml）
  • szamlazz.hu アカウントと Agent API キー（szamlazz.hu → Beállítások → Számla Agent kulcsok から生成）

インストール

/plugin marketplace add socialproKGCMG/socialpro-plugins
/plugin install szamlazz@socialpro-plugins

このスキルでできること

  1. 初回セットアップ — 設定がない場合に検出し、3 つの質問（API キー、NAV による自動検索付きの販売者税番号、自動検出付きの銀行口座）を行い、seller.yaml に書き込みます
  2. 請求書の作成 — 自然言語を解析し、パートナーキャッシュまたは NAV から顧客を特定し、Decimal の精度で税抜額／VAT／税込額を計算し、必須の確認を表示してから XML を API に送信し、PDF を保存します
  3. ストルノ — 番号を指定して既存の請求書を取り消します
  4. プロフォーマ — díjbekérő（プロフォーマ請求書）を作成します
  5. PDF のダウンロード — 番号を指定して請求書の PDF を再ダウンロードします
  6. NAV 検索 — 税番号を使って国税庁に企業情報を照会します

使い方

請求書を発行する
/szamlazz állíts ki egy számlát Példa Kft.-nek 150 000 Ft-ról webfejlesztésről
取り消し（ストルノ）
/szamlazz sztornózd a SOC-2026-0042 számlát
プロフォーマ／Díjbekérő
/szamlazz díjbekérő Acme Ltd-nek 500 EUR-ról konzultációért
PDF をダウンロードする
/szamlazz töltsd le a SOC-2026-0042 PDF-jét
NAV で納税者を検索する
/szamlazz ki ez a cég: 12345678-2-42

主な機能

機能詳細
請求書の種類通常、プロフォーマ（díjbekérő）、ストルノ
VAT 税率27%／18%／5%／0%／AAM ＋ KATA 対応
NAV 検索税番号から企業名と住所を自動取得
パートナーキャッシュ顧客を税 ID でローカルの partners.yaml に記憶
クロスプラットフォームmacOS、Linux、Windows
丸め処理Decimal と ROUND_HALF_UP を使って小数点以下 2 桁に丸めます
エラー処理よくある szamlazz.hu のエラー 7 件を、復旧手順とともに翻訳
セキュリティAPI キーは OS の認証情報ストアに保存し、stdout には出力しません

エラーコード

コード意味対処方法
3認証に失敗しましたszamlazz.hu で Agent キーを再生成してください
54, 55e-Számla 証明書eszamla=false を指定して再試行してください
57, 259-264計算の不一致Decimal の丸め処理で再計算してください
136未払い残高szamlazz.hu のサブスクリプション料金を支払ってください

ヒント

  • プラグインはハンガリー語と英語の両方のトリガーワードで起動します
  • 請求書は法的文書であるため、発行前に必ず確認を表示します
  • パートナーキャッシュはローカルにのみ保存され、git にコミットされることはありません
  • 外貨建て請求書の場合は penznem を設定してください。MNB の為替レートが自動的に使用されます
  • 無限ループを防ぐため、1 セッションあたりの再試行は最大 5 回です

リンク

コメント

Markdown 対応