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

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

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

シナリオ

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

仕組み

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

 

ビジネスへの影響   

✅ リアルタイムの配送追跡を顧客に提供します。
✅ 注文ステータスの自動更新を追跡データに基づいて行います。
✅ 安全で構造化された通信を外部APIと行います。

 

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

WSDL契約の設定   

  1. Qntrlにログインします。
  2. ［設定］→［Webサービス］→［アウトバウンド］→［SOAP］を選択します。
  3. ［新しい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システムで使用できます。