概要
ルーマニアの請求書発行のためのSmartBill Cloud API: 請求書と見積もり(プロフォーマ)をドラフトまたは最終文書として発行し、見積もりから請求書を作成し、支払い状況を確認し、PDFをダウンロードし、クライアントに文書をメールで送信し、文書シリーズ、VAT率、倉庫ごとの在庫を読み取ります。逆転、キャンセル、削除、支払い登録はオフになっています。メールとAPIトークン。
ガイド付きセットアップ
SmartBill を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで SmartBill を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
SmartBill のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → SmartBillをクリックし、資格情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
SmartBill
ルーマニアの請求書発行のためのSmartBill Cloud API: 請求書と見積もり(プロフォーマ)をドラフトまたは最終文書として発行し、見積もりから請求書を作成し、支払い状況を確認し、PDFをダウンロードし、クライアントに文書をメールで送信し、文書シリーズ、VAT率、倉庫ごとの在庫を読み取ります。逆転、キャンセル、削除、支払い登録はオフになっています。メールとAPIトークン。
セットアップ
セットアップには約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)はレジが必要で、ここでは発行されません。
前提条件: SMARTBILL_EMAIL、SMARTBILL_API_TOKEN、SMARTBILL_CIF
コネクタをローカルにインストールする
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
http://localhost:3000/connectors/storeを開き、SmartBillを選択し、前提条件に記載されている環境変数を貼り付けます。
利用可能なツール
| ツール | 機能 |
|---|---|
smartbill_list_series | SmartBillに設定された文書シリーズをリスト表示します: listには各シリーズのname、nextNumber、およびtype(請求書はf、見積もりはpなど)が含まれます。 |
smartbill_list_taxes | SmartBillに設定されたVAT率をリスト表示します: taxesには各率のname(例: Normala)とpercentageが含まれます。名前をtaxNameとして使用します。 |
smartbill_list_stocks | 日付ごとの在庫レベルを読み取ります: listには倉庫ごとに1つのエントリ(warehouseName、warehouseTypeはen grosまたはen detail)とそのproductsが含まれます。 |
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_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 | 財務レシート(bon fiscal)の内容をそのIDで読み取ります: 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の在庫はどうなっていますか?"
次のステップ
このガイドは役に立ちましたか?