外部配送業者APIとの注文出荷追跡の連携

外部配送業者APIとの注文出荷追跡の連携

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

シナリオ

物流会社のQuickShipは、リアルタイムの配送追跡サービスを提供しています。ECサイトのCell Retailは、QuickShipのSOAPベースの追跡APIとQntrlのアウトバウンドSOAP Webサービスを使用して連携します。

仕組み

注文が出荷されるたびに、QntrlはSOAPリクエストをQuickShipのAPIに送信し、最新の配送状況を取得します。応答はQntrlで処理され、注文ステータスはCell Retailのシステムで更新されます。

 

ビジネスへの効果   

✅ 顧客向けのリアルタイム配送追跡。
✅ 追跡データに基づく注文ステータスの自動更新。
✅ 外部APIとの安全で構造化された通信。

 

アウトバウンドSOAP Webサービスの作成手順   

WSDL定義の設定   

  1. （設定）→［Webサービス］→［アウトバウンド］に移動し、［SOAP］を選択します。
  2. ［新規SOAP］をクリックし、詳細を入力します。
    • ［名前］：QuickShipTrackingService
    • ［WSDLのダウンロード］を選択して定義を取得します。
    • 必要に応じて、［認証情報］（APIキー、Basic認証、OAuth）を入力します。
    • ［Bridgeで実行］：Bridge経由で実行する必要がある場合に選択します。
  1. ［保存］をクリックして設定を完了します。
Notes

WSDLの変更が必要な場合は、［WSDLのダウンロード］の選択を解除し、XMLを手動で編集します。

 

SOAP関数の生成   

  1. ［SOAP関数］セクションに移動します。
  2. ［SOAP関数の生成］をクリックしてWSDLを解析し、利用可能なAPIを一覧表示します。
  3. 必要に応じて、新しいSOAP関数を手動で作成します。
    • 右上の［SOAP関数］をクリックします。
    • SOAPリクエストの項目を手動で設定します。
  1. 一覧からTrackShipment API関数を選択します。
  2. 次の項目が自動入力されます。
    1. ［名前］：TrackShipment

    2. ［バインディング］：QuickShipBinding
    3. ［SOAPアクション］：http://api.quickship.com/TrackShipment

    4. ［オペレーション］：TrackShipment
  1. 追加情報を入力します。
    • ［認証情報］：認証方法を選択します。
    • ［接続タイムアウト］：タイムアウトをミリ秒単位で指定します。
  1. ［送信］をクリックしてリクエストを実行し、XML応答を受信します。
  2. リクエストメッセージでは、ローカル変数または設定ストア値を使用します。
  3. ［更新］アイコンをクリックして、使用可能な変数を読み込みます。
  4. リクエストの実行結果に基づいて値を動的に割り当てます。


NotesWSDLが更新された場合は、［サンプルSOAPメッセージの再生成］をクリックして、関数定義を更新します。

 

SOAPリクエストの送信とレスポンスの受信 

QntrlはTrackShipment関数を、QuickShipの追跡APIにSOAPリクエストを送信して実行します。

サンプルSOAPリクエスト  

<soapenv:Envelope xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/'xmlns:trk='http://api.quickship.com/'><soapenv:Header/> <soapenv:Body> <trk:TrackShipment> <trk:TrackingNumber>123456789</trk:TrackingNumber> <trk:CarrierCode>QSHIP</trk:CarrierCode> </trk:TrackShipment> </soapenv:Body> </soapenv:Envelope>

 

サンプルSOAPレスポンス  

<soapenv:Envelope xmlns:soapenv='http://schemas.xmlsoap.org/soap/envelope/'><soapenv:Body> <trk:TrackShipmentResponse xmlns:trk='http://api.quickship.com/'><trk:Status>In Transit</trk:Status> <trk:ExpectedDelivery>2025-04-05</trk:ExpectedDelivery> </trk:TrackShipmentResponse> </soapenv:Body> </soapenv:Envelope>

 

CodexでのアウトバウンドSOAPの実行   

Codexを使用して、SOAP関数を動的に実行します。

IDによる実行

outboundSOAP.execute('track_shipment_id', { 'TrackingNumber': '123456789', 'CarrierCode': 'QSHIP' });

名前による実行

let response = outboundSOAP.executeByName('QuickShipTrackingService', 'TrackShipment', '{TrackingNumber}:123456789');
Notes

レスポンスを保存し、Cell Retailシステムで発送ステータスを更新するために使用できます。