Arcanum ドキュメント

Arcanum は、ARCA の SOAP Web サービスの面倒な作業 — TRA の構築、署名、WSAA へのログイン、キャッシュ、SOAP エンベロープのラップ、XML の解析 — を クリーンな REST 呼び出し に変えます。あなたは JSON で問い合わせ、残りは Arcanum が処理します。

curl -X POST https://your-arcanum/api/ws/padron_a5/getPersona_v2 \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{ "cuit": "20111111112", "params": { "idPersona": "20999999993" } }'

仕組み

100% ローカルな WSAA 署名

TRA は コンテナ内のメモリ上で、node-forge を使って CMS/PKCS#7 で署名されます — 第三者を呼び出す SDK はありません。秘密鍵は Postgres に AES-256-GCM で暗号化して保存され、マスターキーは環境にのみ存在します。

キャッシュされ、自己修復するトークン

アクセスチケット（Token + Sign）は CUIT + サービス + 環境ごとにキャッシュされ、アドバイザリロックにより同時の 2 つのリクエストが 2 回ログインを発生させることは決してありません。デーモンが失効前に更新し、万一 ARCA が失効したトークンを拒否した場合は、Arcanum が透過的に再試行します。

編集可能なカタログ + 汎用エンジン

すべての ARCA サービスは宣言的なカタログに存在します。POST /api/ws/{service}/{operation} は、JSON ボディで あらゆる サービスの あらゆる 操作を呼び出します。ARCA はエンドポイントを頻繁に変更しますが、スーパー管理者は UI から編集でき、保存・監査され、再デプロイは不要です。

マルチクライアント、マルチ環境

ひとつのインスタンスから複数の CUIT を管理し、ホモロゲーション と本番をインターフェースから切り替えられます — ホットで永続化され、変数に触れることも再デプロイすることもありません。

REST 面

汎用エンジン — POST /api/ws/{service}/{operation} はカタログのあらゆる操作に到達します。Arcanum がエンベロープを構築し、認証を解決します。
リッチモジュール — 最もよく使われるサービス（請求、登録照会など）は、検証とクリーンな JSON レスポンスを備えた、人間工学的な REST エンドポイントも公開します。
API キー — すべての呼び出しは X-API-Key を持ちます。Arcanum は、自分のネットワーク上、または TLS 付きのリバースプロキシの背後に置くことを想定しています。

請求

請求モジュールは、自動採番で CAE を発行・取得し、関連伝票付きの貸方・借方票を扱い、事前に金額を検証し、冪等性（CAE の二重取得なし）を強制し、ARCA の QR 付きの法的 PDF を生成します。再印刷と照会はわずか 1 回の呼び出しで行えます。

証明書のライフサイクル

Arcanum が CSR を生成するので、それを ARCA にアップロードし、.crt を貼り戻します。それ以降、秘密鍵は保存時に暗号化されたまま保たれ、まもなく失効する証明書についてはパネルが警告します。

n8n から自動化

面はシンプルな REST と API キーなので、ARCA を n8n フロー（あるいは任意のシステム）に組み込むのは、ひとつの HTTP リクエストで済みます — SOAP も SDK もありません。