Overview 1 分で読めます

PaperOffice AIのインテグレーション：完全ガイド

概要：どの接続が適しているか

  • n8n、Make、Zapierなどの自動化プラットフォーム：APIキーを使用したREST API経由、およびWebhooks経由。n8nはPaperOffice MCPサーバーも使用できます。
  • ERPおよび会計システム：HoldedおよびJTL-Wawiへの既製接続により、注文、請求書、価格が運用ソースとしてミラーリングされます。
  • 運送業者：GLS、DB SchenkerおよびDHLへの既製接続により、配送状況が取得されます。
  • データサービス：VAT ID確認、為替レート、ジオコーディングおよび地図。アプリ内およびAPI経由で利用可能です。

運用ソースはKnowledge Base AIの一部であり、Plusプランから利用可能です。チャットまたは電話エージェントは、顧客が本人確認を完了するまで、注文状況などの顧客データ共有を行いません。

n8n、MakeおよびZapier

これらのツールの標準的なビルディングブロックを使用します：REST APIへのHTTPリクエストおよびWebhooks。

  1. APIキーページでキーを作成し、HTTPノードにベアートークンとして入力します。
  2. アップロードや検索など、REST APIを呼び出します。エンドポイントはAPI ドキュメントに記載されています。
  3. 結果を受け取るには、Workflow AI → Workflow Agentsを開き、保存されたエージェントを編集してWebhooksタブを選択します。
  4. Webhookターゲットを追加をクリックし、n8n、MakeまたはZapierからのWebhookアドレスをターゲット URLとして入力します。
  5. 送信タイミングで、実行完了、実行失敗、またはその両方を選択します。
  • 人間のレビューが必要な場合、フローはレビュータスクを作成しWebhookを待ちます。タスクの完了イベントにより決定が報告されます。
  • PaperOfficeからのWebhookは、X-PaperOffice-Signatureヘッダーで署名されます。フロー内で署名を確認してください。
  • {trigger.pofid}などのプレースホルダーは、パス、クエリ、ヘッダーでは許可されますが、ホスト名では許可されません。
  • ワークフローエージェントのWebhookターゲットはProfessionalプランから利用可能です。各成功したWebhook配信には課金され、API呼び出しにも課金されます。

Holded

PaperOfficeはHoldedから連絡先情報を含む売上注文、請求書、クレジットメモ、製品を読み取り、運用ソースとしてミラーリングします。ミラーリングは読み取り専用です。添付ファイルのみがHoldedに送信され、別途オプトインと書き込みアクセス権を持つ別のキーが必要です。

  1. Knowledge Base AI → 運用ソースを開き、ソースを追加をクリックします。接続としてHoldedを選択します。
  2. 接続タブで、Holded APIキーを入力します。
  3. オプション：ドキュメントのワークスペースを選択し、請求書、クレジットメモまたは売上注文にチェックを入れます。PDF保管は保存後に新規ドキュメントのみを対象とします。
  4. オプション：Holdedへの添付ファイル送信（有料）を有効にし、書き込みアクセス権を持つHolded APIキーを入力します。
  5. 証明書類タブで、顧客の本人確認方法を選択し、保存します。

ドキュメントを添付するには、ドキュメントを開き、Holded に添付をクリックしてターゲットを確認します。PaperOfficeは文書番号でターゲットを検出します。複数の一致または一致がない場合、送信されません。ファイルサイズは最大10MBまで可能で、一度添付されたドキュメントは再送信されません。取得、保管および添付には課金されます。

JTL-Wawi

PaperOfficeは公式JTL APIを通じてJTL-Wawiから注文、追跡番号付き配送伝票、価格付き商品を読み取ります。接続は読み取り専用であり、JTL-Wawiには何も変更されません。

  1. Knowledge Base AI → 運用ソースを開き、ソースを追加をクリックして、接続としてJTL-Wawiを選択します。
  2. 接続タブで、JTL Cloudまたはオンプレミス版JTL-Wawiを選択します。JTL Cloudの場合はテナントIDを入力し、オンプレミス版の場合はHTTPSアドレスとアプリ登録から取得したAPIキーを入力してください。
  3. プレビュー用の実際の注文番号を入力し、証明書類タブで証明方法を選択してください。
  4. プレビュータブで保存せずにプレビューをクリックし、その後今すぐ同期で保存して最初の同期を開始します。

オンプレミス版JTL-Wawiでは、標準ポート443での公開HTTPSアドレスが必要です。内部アドレスやHTTPはブロックされます。アカウントでJTL Cloudが有効になっているかサポートにお問い合わせください。連続3回のフェッチ失敗後、ソースは自動的に一時停止します。フェッチには課金されます。

GLS、DB SchenkerおよびDHLによる配送追跡

お客様が「荷物はどこですか？」と尋ねた際、PaperOfficeはGLS、DB SchenkerまたはDHLから配送状況を取得します。キャリアからの認証情報が必要です。

  1. Knowledge Base AI → 運用ソースを開き、ソースを追加をクリックして、タイプGLS（フェーズ2）、シェンカー（フェーズ2）またはDHLを選択します。
  2. 接続タブに認証情報を入力します。GLSの場合はShipITアドレス、ユーザー名、パスワードを、DB Schenkerの場合はアクセスキーを、DHLの場合はAPIキーを入力します。
  3. プレビュー用の実際の追跡番号を入力し、証明方法を選択してプレビューを確認後、保存してください。
  4. 同期タブで今すぐ同期をクリックします。

その後の同期では既存の追跡番号を自動的に読み取ります。お客様へのSMSまたはメールによる状況通知は、実際の状況が変更された場合のみ、かつメッセージタブで有効にした場合に送信されます（デフォルトはオフ）。SMSには課金されます。

データサービス：VAT ID、為替レート、ジオコーディングおよび地図

PaperOfficeは4つのデータサービスを提供します：EU VIESシステムに対するVAT ID確認、変換機能付き為替レート、ジオコーディングおよび地図です。これらはすべてのプランで利用可能なData AI Playground内のアプリで試すことができ、REST APIまたはMCPコネクタを通じてご自身のシステムで使用できます。APIリクエストには課金されます。

  • VAT ID：確認はVIESに対して実行され、API経由では最大100個の番号を一括でチェックできます。27か国のEU加盟国に対するVAT税率も利用可能です。
  • AI-DMS Ultraでは、PaperOfficeが各文書に対してサプライヤーのVAT IDをVIESに対して自動的にチェックします。これは課金対象です。
  • ジオコーディング：住所から座標へ、座標から住所へ、および住所の提案。API経由では最大1,000件の住所を一括で処理できます。
  • 地図：AI-DMSが文書を処理した後、Analytics AI → 送信者マップで文書の送信者をマップ上で確認できます。Analytics AIはCorporateプラン以降で利用可能です。

よくある質問

  • n8n用の既製ノードはありますか？HTTPリクエスト、Webhook、またはMCPクライアントを通じてn8nに接続します。
  • PaperOfficeはHoldedやJTL-Wawiのデータを変更しますか？JTL-Wawiは読み取り専用です。Holdedでは、別キーで有効にした場合にのみ添付ファイルが送信されます。
  • お客様は証明なしで注文状況を確認できますか？いいえ。エージェントは証明が行われた後にのみ顧客データを共有します。
  • どのキャリアがサポートされていますか？現在、GLS、DB SchenkerおよびDHL用の既製接続が存在します。
  • 複数のVAT IDを一度にチェックできますか？はい、API経由で最大100個の番号を一括でチェックできます。