概要
ルーマニアの請求書発行のためのSmartBill Cloud API:請求書や見積もり(プロフォーマ)をドラフトまたは最終文書として発行し、見積もりから請求書を作成し、支払い状況を確認し、PDFをダウンロードし、クライアントに文書をメールで送信し、文書シリーズ、VAT率、倉庫ごとの在庫を読み取ります。逆転、キャンセル、削除、支払い登録はオフになっています。メールとAPIトークン。
ガイド付きセットアップ
SmartBill を Claude に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで SmartBill を接続して、MCP URL を Claude に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
AnythingMCP は Claude のコネクタディレクトリに掲載されています。ワンクリックで Claude に追加 (新しいタブで開きます)し、サインインして Claude が使える MCP サーバーを選んでください。
こう聞いてみよう
SmartBill のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → SmartBillをクリックし、資格情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
SmartBill + Claude
ルーマニアの請求書発行のためのSmartBill Cloud API:請求書や見積もり(プロフォーマ)をドラフトまたは最終文書として発行し、見積もりから請求書を作成し、支払い状況を確認し、PDFをダウンロードし、クライアントに文書をメールで送信し、文書シリーズ、VAT率、倉庫ごとの在庫を読み取ります。逆転、キャンセル、削除、支払い登録はオフになっています。メールとAPIトークン。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択したときにアプリ内ストアで表示されます)。このコネクタに必要な環境変数は次のとおりです:
SMARTBILL_EMAIL, SMARTBILL_API_TOKEN, SMARTBILL_CIF
ステップ1 — 資格情報を取得する
設定には約2分かかります。
- SmartBill Cloudにサインインし、Contul meu, IntegrariのAPIセクションを開きます(https://cloud.smartbill.ro/core/integrari/)。
- Emailを
SMARTBILL_EMAILに、TokenをSMARTBILL_API_TOKENに、会社のCIFをSMARTBILL_CIFにコピーします。
呼び出しはHTTP Basic認証を使用し、メールをユーザー名、トークンをパスワードとして使用します。コネクタはすべての呼び出しに会社のCIFを追加するため、1つのコネクタは1つの会社で機能します。2つ目の会社用に再インストールしてください。
開始する場所:smartbill_list_series(すべての文書に必要なシリーズ名)およびsmartbill_list_taxes(VAT率名)。次にsmartbill_create_invoiceまたはsmartbill_create_estimateを使用します。
APIができないこと:V1には請求書、クライアント、製品のリストや検索機能がなく、文書のJSONビューもありません。文書はそのシリーズと番号で指定され、ユーザーが提供するか、作成呼び出しが返します。作成したもののseries、number、およびdocumentViewUrlを保持してください。
請求書:smartbill_create_invoiceは、is_draftがfalseでない限りドラフトとして保存されます。最終請求書はシリーズの次の番号を取得し、財務文書となります:SmartBillは、アカウント設定に従ってANAF e-Facturaに送信しますが、このAPIでは制御できません。smartbill_create_invoice_from_estimateはプロフォーマを請求書に変換します。smartbill_get_invoice_payment_statusは支払い済みのものと未払いのものを示し、smartbill_get_invoice_pdfはファイルをダウンロードし、smartbill_send_document_emailは請求書または見積もりをクライアントにメールで送信します。smartbill_reverse_invoice(ストルノ)、smartbill_cancel_invoice、smartbill_restore_invoice、およびsmartbill_delete_invoiceはオフに設定されています。
見積もり(プロフォーマ):smartbill_create_estimate、smartbill_get_estimate_invoices(請求書が発行されたか)、smartbill_get_estimate_pdf;smartbill_cancel_estimate、smartbill_restore_estimate、およびsmartbill_delete_estimateはオフに設定されています。
支払い:smartbill_get_fiscal_receipt_textは財務領収書を読み取ります。smartbill_register_payment(回収を記録するか、領収書を発行)、smartbill_delete_receiptおよびsmartbill_delete_paymentはオフに設定されています。ここではカードを請求したり、資金を移動したりすることはありません:支払いは簿記記録です。
在庫:smartbill_list_stocksは日付ごとの倉庫(gestiune)ごとの数量を返します;倉庫名は大文字と小文字を区別します。
文書の作成:seriesName、taxName、およびmeasuringUnitNameはアカウントと正確に一致する必要があります;決して自分で考え出さないでください。価格はVATを含まないもので、isTaxIncludedがtrueでない限りそうです。taxPercentageはすべての行で必須です(2025年8月以降の標準税率は21です)。アカウントが製品コードを使用している場合、すべての行にcodeが必要です。割引行にはnumberOfItemsと負のdiscountValueが必要で、そうでない場合は静かに無視されるか追加されます。ブカレストのクライアントの場合、cityはセクター1からセクター6でなければならず、そうでないとe-Facturaは請求書を拒否します。すべての文書、ドラフトを含むものは、SmartBillプランの文書としてカウントされます。
エラー:応答のerrorTextは原因であり、ルーマニア語で表示されます(例えば、未知のシリーズの場合はSeria nu a fost gasita!);HTMLを含む可能性があるため、最初の文のみを引用してください。未知のフィールドや誤ったタイプのリクエストには400で応答し、errors[].messageおよびerrors[].paramがフィールドを指定します。401はメールまたはトークンが間違っていることを意味し、403はユーザーが会社またはシリーズに対する権利を持っていないことを示します。
制限:トークンごとに10秒あたり30回の呼び出し;これを超えるとトークンが10分間ブロックされます。ヘッダーX-RateLimit-RemainingおよびX-RateLimit-Resetは残りの回数を示します。
カバーされていないもの:新しいAPI V3(クライアント、製品、倉庫、サプライヤー、商品受領書のリスト)は別のBearerトークンを使用し、このコネクタの一部ではありません。財務領収書(bon fiscal)はレジが必要で、ここでは発行されません。
ステップ2 — アダプターをインストールする
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ3 — Claudeにコネクタを追加する
あなたのサーバーURL:AnythingMCPで、MCP Servers → このコネクタがあるサーバーを開き、そのURLをコピーします(
https://cloud.anythingmcp.com/mcp/…)。このガイドがYOUR_SERVER_IDを示す場所で使用します。
推奨パス:claude.ai webで、設定ファイルを編集せずに動作します。
- Claude で Plugins(一部のプランではまだ Customize)→ Connectors を開きます。
- + Add をクリックし、Add custom connector を選びます。
- 名前(例:
SmartBill)とリモート MCP サーバー URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Continue をクリックし、検出された設定のまま、もう一度 Continue をクリックします。 - Sign in now を選んで Add をクリックし、AnythingMCP にサインイン(OAuth)してアクセスを許可します。
以下のすべてのツールがチャットに表示されます:プロンプトを入力し始めてください。
利用可能なツール
| ツール | 機能 |
|---|---|
smartbill_list_series | SmartBillに設定された文書シリーズをリストします:各シリーズのname、nextNumber、およびtype(請求書はf、見積もりはpなど)を含むlist。 |
smartbill_list_taxes | SmartBillに設定されたVAT率をリストします:各税率のname(例:Normala)とpercentageを含むtaxes。名前をtaxNameとして使用し、… |
smartbill_list_stocks | 日付ごとの在庫レベルを読み取ります:倉庫ごとに1エントリ(warehouseName、warehouseTypeはen grosまたはen detail)とそのproductsを含むlist。 |
smartbill_create_invoice | SmartBillで請求書を作成します。デフォルトではドラフトとして保存され(番号なし)、ユーザーがSmartBillで確認して最終化します;… |
smartbill_create_invoice_from_estimate | 既存の見積もり(プロフォーマ)から請求書を作成します:クライアントと行は見積もりからコピーされます。デフォルトでは請求書はドラフトとして保存されますが… |
smartbill_get_invoice_payment_status | 請求書が支払われているかどうかを確認します:invoiceTotalAmount(VATを含む合計)、paidAmount、unpaidAmount、およびpaid(全額支払われた場合はtrue)。… |
smartbill_get_invoice_pdf | 発行された請求書をPDFファイルとしてダウンロードします。応答はファイル自体で、添付ファイルとして渡されます;APIには文書のJSONビューはありません。 |
smartbill_send_document_email | 発行された請求書または見積もりをクライアントにメールで送信します。添付ファイルとして、メールテンプレートの件名とテキストは… |
smartbill_reverse_invoice | 既存の請求書に対して逆転(ストルノ)請求書を発行します:同じシリーズの負の金額を持つ新しい財務文書です。これもカウントされます… |
smartbill_cancel_invoice | 発行された請求書をキャンセルします。請求書はその番号を保持し、キャンセルされたとマークされます;… |
smartbill_restore_invoice | キャンセルされた請求書を復元し、有効にします。インストール時はオフになっており、呼び出す前にユーザーに確認してください。 |
smartbill_delete_invoice | 請求書を永久に削除します。シリーズの最後の請求書のみが削除でき、これは元に戻せません。インストール時はオフになっており、確認が必要です… |
smartbill_create_estimate | SmartBillで見積もり(プロフォーマ)を作成します。デフォルトではドラフトとして保存され(番号なし)、is_draftがfalseの場合はすぐに発行されます… |
smartbill_get_estimate_invoices | 見積もり(プロフォーマ)が請求書として発行されたかどうかを確認します:areInvoicesCreatedおよび各請求書のseriesとnumberを含むinvoices。… |
smartbill_get_estimate_pdf | 見積もり(プロフォーマ)をPDFファイルとしてダウンロードします。応答はファイル自体で、添付ファイルとして渡されます。誤ったシリーズまたは番号は… |
smartbill_cancel_estimate | 見積もり(プロフォーマ)をキャンセルします。番号は保持され、smartbill_restore_estimateで復元できます。インストール時はオフになっており、確認が必要です… |
smartbill_restore_estimate | キャンセルされた見積もり(プロフォーマ)を復元します。インストール時はオフになっており、呼び出す前にユーザーに確認してください。 |
smartbill_delete_estimate | 見積もり(プロフォーマ)を永久に削除します。これは元に戻せません。インストール時はオフになっており、呼び出す前にユーザーに確認してください。 |
smartbill_register_payment | SmartBillでクライアントから受け取った支払いを記録し、オプションで請求書に対して行います。タイプが作成されるものを決定します:Chitantaは… |
smartbill_get_fiscal_receipt_text | IDによって財務領収書(bon fiscal)の内容を読み取ります:messageは財務プリンター用の領収書テキストをBase64エンコードで保持します。… |
smartbill_delete_receipt | 領収書(chitanta)を永久に削除します。シリーズの最後の領収書のみが削除できます。インストール時はオフになっており、確認が必要です… |
smartbill_delete_payment | 領収書でない記録された支払いを削除します(カード、オルディン・プラタ、CECなど)。それを決済する請求書(invoice_series… |
例のプロンプト
- "SmartBillに設定されている文書シリーズとVAT率は何ですか?"
- "SC Exemplu SRLのために、シリーズFCTで10時間のコンサルタントを200レイプラスVATでドラフト請求書を作成してください。"
- "請求書FCT 0142は支払われていますか?まだ支払うべき金額はいくらですか?"
- "プロフォーマPRF 0031を請求書に変換し、クライアントにメールで送信してください。"
- "今日の倉庫Depozit Centralの在庫はどのくらいですか?"
FAQ
Claude CodeとClaude Desktopの両方で動作しますか? はい、どちらもhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを指します。
資格情報はどこから来ますか? SmartBill Cloud、Contul meu、Integrari、APIセクション:Email、Token、および会社のCIFをコピーします。1つのコネクタは1つの会社で機能します。2つ目の会社用に再インストールしてください。これはV1トークンであり、API V3のBearerトークンではありません。
何をカバーしていますか? 請求書と見積もり(プロフォーマ)をドラフトまたは最終文書として、見積もりからの請求書、支払い状況、PDF、クライアントへの文書のメール送信、財務領収書のテキスト、文書シリーズ、VAT率、および倉庫ごとの在庫。API V1には請求書、クライアント、製品のリストや検索機能がありません:文書はそのシリーズと番号で指定されます。最終請求書は財務文書であり、SmartBillはアカウント設定に従ってANAF e-Facturaに送信します。
どのツールがオフに設定されていますか? smartbill_reverse_invoice、smartbill_cancel_invoice、smartbill_restore_invoice、smartbill_delete_invoice、smartbill_cancel_estimate、smartbill_restore_estimate、smartbill_delete_estimate、smartbill_register_payment、smartbill_delete_receipt、およびsmartbill_delete_payment。AIがそれらを使用する必要がある場合のみ、コネクタページでオンにしてください。どのツールもカードを請求したり、資金を移動したりすることはありません。
次のステップ
このガイドは役に立ちましたか?