APIとERP連携
DGAssistantを貴社のERP、倉庫管理システム（WMS）又は出荷プラットフォームに組み込む方法をご説明します。
APIを利用するには、専用のモジュールが必要ですか？
はい。APIは、標準のライセンスとは別にライセンスを取得するモジュールです。連携を決めた時点で、サブスクリプションに追加していただきます。
APIの利用量はどのように計測され、料金はどのように決まりますか？
APIの利用量はライセンス単位で計測されます。ライセンス1件につき、年間1,500件の送り荷と10,000回のサービス呼び出しが含まれ、データベースには、製品や関係者（荷受人、仕入先、運転者など）といった送り荷以外のオブジェクトを最大5,000件まで保存できます。これを超える利用が見込まれる場合は、ライセンスを追加するだけで対応できます。APIモジュールの正確な単価は、当社のストアで他の製品とともに表示しており、個別のお見積りに含めることもできます。
APIの二つの利用方法、一括処理と対話型処理の違いは何ですか？
一括処理方式では、1回のサービス呼び出しで送り荷の完全な仕様を受け取ります。ERPが貨物、関係者及び数量をすでに把握している場合に最適です。対話型処理方式では、貨物を追加するたびに検証しながら、送り荷を段階的に組み立てることができます。ウェブアプリケーションの動作に近く、APIの上に利用者が操作するワークフローを構築する必要がある場合に便利です。
製品と関係者はあらかじめ作成しておくべきですか、それとも「その場で」定義すべきですか？
どちらにも対応しています。推奨するのは「事前登録データ」による方法です。貨物と関係者をウェブアプリケーションで一度作成（又はインポート）し、APIの呼び出しではそのコードを参照します。「その場で定義する」方法では、呼び出しのたびにすべてのデータを送信します。貴社のERPがそれらのデータのマスターであり、事前に読み込んでおきたくない場合に便利です。
作成されたPDFをAPIで取得するにはどうすればよいですか？
方法は二つあります。APIの応答で、書類（運送書類、危険物申告書、チェックリスト、輸送物の表示など）をbase64でエンコードされたPDFとして受け取ることも、プラットフォームから指定のアドレスへ電子メールで自動送信させることもできます。
APIで作成した書類を自動的に印刷できますか？
はい。次の二つの方法が有効です。(a) 貴社のERPがAPIからPDFをダウンロードし、自らの印刷キューに送る方法。(b) DGAssistantが専用のメールボックスに書類を電子メールで送信し、貴社側の小さな自動印刷ユーティリティが適切なプリンターで印刷する方法。ERP側に追加のコードが不要なため、多くのお客様が電子メールによる方法を利用しています。
APIの仕様はどこにありますか？
OpenAPIの完全な仕様は、危険物APIのドキュメントで公開しています。また、実際に近いテスト呼び出しをあらかじめ組み込んだSoapUIプロジェクトもご用意しているため、開発者の方は数分でAPIを試すことができます。
requestGuidとは何ですか？なぜ必要なのですか？
APIの呼び出しには、必ず一意のrequestGuidを含める必要があります。requestGuidは当社のログでリクエストを識別するもので、問題をご報告いただいた際に、サポートチームが該当する処理を正確に特定するために使用します。一意の英数字であれば任意の値を使用できますが、クライアント側で標準的なUUID/GUIDを生成することをお勧めします。
APIの呼び出しが最初に失敗する最も一般的な原因は何ですか？
サービスが受け付けない認証情報です。具体的には、HTTPのBasic Authorizationヘッダーがないか誤っている場合、又は呼び出しをOAuth2で認証している場合に、アクセストークンを取得していない、別の環境のものである、若しくはすでに有効期限が切れている場合です。APIが稼働していることと認証情報が有効であることを確認するための、サポート専用のURLもご用意しています。解決しない場合は、HTTPのリクエストと応答の全文（requestGuidを含む）と、期待される動作の説明をお送りください。それが問題を最も早く解決する方法です。