saudi-vat-pro

Name: saudi-vat-pro
Author: Morouna1

ローカル

github.com/Morouna1金融データ08 週間前に更新

リポジトリ

saudi-vat-pro について

Saudi VAT Pro の MCP サーバーは、AI エージェントから API を通じて ZATCA 準拠のサウジ電子インボイスを扱えるようにします。インボイスやクレジットノートの操作、失敗時の再試行と状態説明に対応し、送信前に内容を検証します。

主な機能

01インボイスの一覧と詳細確認
02標準・簡易インボイスの作成
03冪等性キー付きクレジットノート発行
04失敗したインボイスの再試行と説明
05加盟店情報と証明書準備状況の確認
06ダッシュボード概要の確認

活用シーン

01エージェントから ZATCA インボイスを作成
02返金用のクレジットノートを発行
03失敗したインボイスを調査して再試行
04証明書の準備状況を確認

MCP 対応

MCP クライアントに Saudi VAT Pro API の操作を提供し、インボイス作成・管理、クレジットノート、失敗処理、加盟店情報、ダッシュボードデータを扱います。項目を検証し、実際の処理ステータスを返します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "morouna1-saudi-vat-pro": {
      "command": "npx",
      "args": [
        "-y",
        "saudi-vat-pro-mcp"
      ],
      "env": {
        "SAUDI_VAT_PRO_API_KEY": "<SAUDI_VAT_PRO_API_KEY>"
      }
    }
  }
}

起動コマンドnpx -y saudi-vat-pro-mcp

設定が必要な環境変数

SAUDI_VAT_PRO_API_KEYシークレットSaudi VAT Pro API key from https://saudivatpro.com/settings

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmsaudi-vat-pro-mcp1.0.1stdio

ツール

掲載時のツール一覧 · 3 週間前に更新

パラメーター	型	必須	説明
page	integer	いいえ	ページ番号（デフォルト：1）
search	string	いいえ	請求書番号、購入者名、または注文参照番号で検索します
status	string	いいえ	ステータスで絞り込みます。例：pending、pending_submission、generated、signed、reported、cleared、failed、needs_data、awaiting_buyer_data
pageSize	integer	いいえ	ページあたりの結果数（デフォルト：20、最大：100）
invoiceType	string	いいえ	タイプで絞り込みます。B2B の場合は 'standard'、B2C（消費者）請求書の場合は 'simplified' を使用します

詳細

Saudi VAT Pro — ZATCA Phase 2 電子請求書

saudivat.pro は、サウジアラビアの事業者向けに ZATCA Phase 2 電子請求書を自動化します。WooCommerce ストア、Shopify の事業者、REST API 経由のカスタム連携に対応しています。

有料注文はすべて ZATCA 準拠の請求書になります。返金はすべてクレジットノートになります。開発者は必要ありません。

このリポジトリの内容

フォルダー	内容
`woocommerce-plugin/`	GPLv2 WooCommerce プラグイン — WooCommerce の注文ごとに ZATCA 請求書を自動発行
`zatca-qr-helpers/`	無料の ZATCA QR ツールを支えるオープンソースの TLV エンコード／デコードライブラリ
`docs/`	サポートガイド：ZATCA Phase 2 の概要、QR コードの解説、よくあるエラー
`mcp-server/`	Claude、Cursor、Windsurf、その他の AI エージェント向け MCP サーバー

プラットフォーム

→ saudivat.pro で無料登録

Saudi VAT Pro が ZATCA Phase 2 準拠の複雑な手続きを代行するため、手間がかかりません。

CSID オンボーディング — 無料の CSID ウィザードを使って、5 分で暗号スタンプ識別子を生成します
B2B クリアランス — 標準請求書は配信前に ZATCA によってリアルタイムでクリアされます
B2C 報告 — 簡易請求書は 24 時間以内に報告されます
クレジットノート — 返金時に ZATCA 準拠のクレジットノートが自動生成されます
問題ダッシュボード — ZATCA による却下の内容をわかりやすく説明し、修正案を提示します
再試行と修復 — コードに触れずに、失敗した請求書を再送信できます

対応プラットフォーム

プラットフォーム	方法
WooCommerce	このリポジトリのプラグイン — インストールして API キーを入力すれば完了
Shopify	Webhook 連携 — saudivat.pro/docs に説明があります
カスタム／ERP	REST API — API ドキュメントを参照してください
AI エージェント	Saudi VAT Pro MCP — Claude、Cursor、Windsurf、汎用の MCP クライアント

AI エージェントと Model Context Protocol

Saudi VAT Pro MCP サーバーを使うと、MCP 対応の AI アシスタントが Saudi VAT Pro API を介して ZATCA 請求書を作成・管理できます。

{
  "mcpServers": {
    "saudi-vat-pro": {
      "command": "npx",
      "args": ["saudi-vat-pro-mcp"],
      "env": {
        "SAUDI_VAT_PRO_API_KEY": "svp_live_YOUR_KEY_HERE"
      }
    }
  }
}

利用可能なツールでは、請求書の一覧表示と詳細確認、標準請求書および簡易請求書の作成、冪等性を備えたクレジットノートの作成、失敗した請求書の再試行と説明、事業者情報、ダッシュボードの概要、ZATCA 証明書の準備状況を扱えます。

このサーバーは、エージェント向けに ZATCA の明示的な安全対策を備えています。

標準 B2B 請求書には、購入者名、市区町村、有効な 15 桁の VAT 番号が必要です
VAT カテゴリー、税率、VATEX 免税理由、明細値引きは、送信前に検証されます
サンドボックス環境と本番環境は明確に区別されます
重複した返金を防ぐため、クレジットノートの再試行には冪等性キーが必要です
クリアランスや報告が成功したと仮定せず、各結果で実際のライフサイクルステータスを確認できます

公式リンク

ソース：mcp-server/
セットアップと API キー：saudivatpro.com/docs#aiagents
npm：saudi-vat-pro-mcp
公式 MCP レジストリ：io.github.Morouna1/saudi-vat-pro

無料ツール

ZATCA QR ツール

ZATCA Phase 1 または Phase 2 の QR コードをデコードして調べたり、請求書の項目から有効な Phase 1 QR コードを生成したりできます。登録は不要です。

base64 の QR 文字列を貼り付けると、すべての TLV フィールドがデコードされます
請求書の項目を入力すると、有効な QR コードをすぐに取得できます
検証エラーはわかりやすい英語で表示されます
PNG としてダウンロードするか、base64 をコピーできます

TLV のエンコード／デコードロジックは zatca-qr-helpers/ でオープンソースとして公開されています。

無料 CSID ウィザード

ZATCA 暗号スタンプ識別子（CSID）を 5 分で取得できます。アカウント登録は不要です。手順に沿って、VAT 番号を入力し、CSR を生成して、Fatoora ポータルから OTP を取得し、証明書をダウンロードします。

VAT 計算ツール

サウジアラビアの請求書の VAT をすぐに計算できます。15％、5％、0％の税率に対応し、4 つすべての VAT 処理区分（S/Z/E/O）をサポートしています。

料金

請求書 10,000 件あたり 999 SAR — 使用した分だけお支払いいただきます。

60 日間の無料トライアル。クレジットカードは不要です
1 アカウントあたりの加盟店数は無制限です
月額料金はありません

→ 料金の詳細を見る

ナレッジセンター

サウジアラビアの加盟店や開発者向けの無料ガイドです。

ZATCA Phase 2 の概要 — 変更点、影響を受ける対象、クリアランスと報告のフロー
QR コードの解説 — すべての TLV タグを解説
ZATCA のよくあるエラー — BR-KSA エラーコードと解決方法
VAT 区分 S/Z/E/O — 各コードの使い分け
標準請求書と簡易請求書 — B2B と B2C の判断ガイド
クレジットノートと返金 — 正しい発行方法

→ ナレッジセンターの全ページを見る

WooCommerce プラグイン

woocommerce-plugin/ フォルダーには、Saudi VAT Pro の WooCommerce 連携機能の GPLv2 ソースコード一式が含まれています。

簡単なインストール手順：

このリポジトリをダウンロードまたはクローンします
woocommerce-plugin/ フォルダーを /wp-content/plugins/saudi-vat-pro-woocommerce/ にアップロードします
WordPress → プラグインでプラグインを有効化します
WooCommerce → 設定 → Saudi VAT Pro に移動し、Saudi VAT Pro ダッシュボードの Webhook URL と API Key を貼り付けます

WooCommerce 7.0 以降、PHP 8.0 以降が必要です。ドキュメント全文：saudivat.pro/docs

ZATCA QR ヘルパー（オープンソース）

zatca-qr-helpers/ フォルダーには、依存関係のない、ZATCA TLV QR コードをエンコードおよびデコードする JavaScript/TypeScript ライブラリが含まれています。

import { encodeTlvPhaseOne, decodeTlv, validateQr } from './zatca-qr-helpers/index.js';

// Generate a Phase 1 QR code
const base64 = encodeTlvPhaseOne({
  sellerName: 'Riyadh Gadgets Trading Co.',
  vatNumber:  '310000000000006',
  timestamp:  '2024-01-15T10:30:00Z',
  invoiceTotal: '1725.00',
  vatAmount:    '225.00',
});

// Decode any QR string
const parsed = decodeTlv(base64);
parsed.fields.forEach(f => console.log(f.tag, f.label, f.rawValue));

// Validate
const { valid, errors } = validateQr(base64);

API の詳細については、zatca-qr-helpers/README.md をご覧ください。

サポートと問題報告

バグ報告： 問題を報告する
サポートに関する質問： サポートに関する質問を投稿する
ドキュメント： saudivat.pro/knowledge
プラットフォームのサポート： saudivat.pro/support

ライセンス

WooCommerce プラグイン：GNU GPL v2.0
ZATCA QR ヘルパー：MIT
ドキュメント：CC BY 4.0

Morouna Business Services が開発 • saudivat.pro

Markdown 対応

ログインしてコメント

基本情報

作者: Morouna1
言語: node
バージョン: 1.0.1
トランスポート: stdio
掲載日: 2026年9月7日
最終更新: 8 週間前
公式 Registry: io.github.Morouna1/saudi-vat-pro

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。