発送を追跡

D1 は物理カードが発送された後に配送追跡を提供できます。

配送状況の更新は次の場所で受け取れます:

• イシュアのバックエンドに送信される通知内で。
• 利用可能な場合、オンデマンドのステータス応答内で。

配送追跡が利用可能なとき

配送追跡は通常、次の後に利用可能になります details.status = CARD_SHIPPED.

参照 カード注文の追跡 エンドツーエンドのフローについて。

配送業者の追跡フィールドは任意です。利用可否は配送業者の統合に依存します。

対応している配送業者

配送業者コード	配送業者名
chronopost-france	Chronopost France
dhl	DHL Express
dhl-global-mail	DHL eCommerce
deutsch-post	Deutsche Post Mail
estafeta	Etafeta
fedex	FedEx®
la-poste-colissimo	La Poste
nacex	NACEX
spanish-seur	Spanish Seur
singapore-post	Singapore Post
spain-correos-es	Correos de España
ups	UPS
usps-iv-api	USPS Informed Visibility

配送オブジェクト

存在する場合、 details.shipment には次を含めることができます:

• carrier：配送業者コード（例: fedex).
• trackingNumber：配送業者の追跡参照番号。
• status：配送業者の配送ステータス。
• message：表示用に正規化された配送業者メッセージ。
• trackingUrl：配送業者の追跡ページへの直接URL。
• redirectUrl：配送アクション用の配送業者ランディングページURL。
• pickupDate：配送業者が荷物を引き取った時刻の ISO 8601 タイムスタンプ。
• estimatedDeliveryDate：配達予定時刻の ISO 8601 タイムスタンプ。
• lastUpdatedAt：最後のイベントの ISO 8601 タイムスタンプ。
• deliveryDate：提供される場合、配達時刻の ISO 8601 タイムスタンプ。
• signedBy：署名受取人（提供される場合）。
• failedDeliveryAttempts：配達失敗回数（提供される場合）。
• lastCheckpoint:

  • checkpointTime：配送業者が提供するチェックポイントイベントの日時。チェックポイントのタイムゾーンを使用します。形式は配送業者の提供方法によって異なる場合があります。
  • city：配送業者が提供する都市情報。
  • countryName：チェックポイントの国名。その他の位置情報が含まれることもあります。
  • message：チェックポイントメッセージ。

例

{
  "operations": [
    {
      "operationId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "operation": "PRODUCE",
      "status": "SUCCESSFUL",
      "startTime": "2025-01-17T06:28:02.492Z",
      "endTime": "2025-01-21T09:28:12.492Z",
      "cardId": "271b-6e47-8ec3-7f3f",
      "details": {
        "status": "CARD_SHIPPED",
        "dueDate": "2025-01-21",
        "productionSite": "Gemenos",
        "shipment": {
          "pickupDate": "2025-01-21T17:32:28Z",
          "carrier": "fedex",
          "trackingNumber": "61293150000079650811",
          "status": "IN_TRANSIT",
          "message": "輸送中",
          "trackingUrl": "https://www.fedex.com/apps/fedextrack/?tracknumbers=61293150000079650811&cntry_code=US",
          "redirectUrl": "https://www.fedex.com/apps/fedextrack/?action=track&tracknumbers=61293150000079650811&cntry_code=US",
          "estimatedDeliveryDate": "2025-01-21T17:32:28Z",
          "lastUpdatedAt": "2025-01-21T17:32:28Z",
          "lastCheckpoint": {
            "checkpointTime": "2025-01-21T17:32:28Z",
            "city": "New York",
            "countryName": "United States",
            "message": "施設に到着"
          }
        }
      }
    }
  ]
}

配送ステータス

ステータスコード	説明
INFO_RECEIVED	配送業者が発送依頼を受け取り、荷物を引き取ります。
IN_TRANSIT	荷物は配送業者のネットワーク内を移動中です。
OUT_FOR_DELIVERY	荷物は配達中、または受取可能な状態です。
FAILED_ATTEMPT	配送業者が配達を試みました。通常は再試行されます。
DELIVERED	荷物は配達済みです。
AVAILABLE_FOR_PICKUP	荷物は受取地点で受け取り可能です。
EXCEPTION	荷物は保留中、未配達、または返送中です。
EXPIRED	追加から30日間追跡情報がありません。
PENDING	追跡情報はまだ利用できません。

配送メッセージ（サブステータス）

message は正規化された表示文字列です。値は時間の経過とともに変わることがあります。配送ステータスに関する追加情報を提供します。

例 message 値

配送ステータス	メッセージ（サブステータス）	説明
DELIVERED	配達済み	配達を確認する。
DELIVERED	顧客が受け取り済み	受け取りを確認する。
DELIVERED	顧客署名	署名付き配達を確認する。
DELIVERED	配達済み、代金引換を受領	COD 配達を確認する。
AVAILABLE_FOR_PICKUP	受け取り可能	受け取り可能であることを示す。
EXCEPTION	例外	配達例外が発生したことを示す。
EXCEPTION	顧客が転居	受取人の転居を示す。
EXCEPTION	顧客が配達を拒否	拒否を示す。
EXCEPTION	遅延（通関手続き）	通関遅延を示す。
EXCEPTION	遅延（外的要因）	外的要因による遅延を示す。
EXCEPTION	支払い保留	支払い保留を示す。
EXCEPTION	住所が不正確	住所の問題を示す。
EXCEPTION	受け取りに失敗	受け取り失敗を示す。
EXCEPTION	配送業者により拒否	配送業者による拒否を示す。
EXCEPTION	差出人へ返送中	返送処理中であることを示す。
EXCEPTION	差出人へ返送済み	返送完了を確認する。
EXCEPTION	配送損傷	破損した荷物を示す。
EXCEPTION	荷物紛失	紛失した荷物を示す。
EXCEPTION	配送業者の集荷失敗	配送業者の集荷失敗を示す。
FAILED_ATTEMPT	配達失敗	配達失敗を示す。
FAILED_ATTEMPT	宛先人不在	受取人不在を示す。
FAILED_ATTEMPT	営業終了	営業終了を示す。
IN_TRANSIT	輸送中	輸送中の移動を示す。
IN_TRANSIT	受領スキャン	配送業者による受領を確認する。
IN_TRANSIT	到着スキャン	ハブへの到着を確認する。
IN_TRANSIT	目的国/地域に到着	目的地への到着を確認する。
IN_TRANSIT	通関完了	通関完了を確認する。
IN_TRANSIT	通関開始	通関開始を確認する。
IN_TRANSIT	出発スキャン	施設出発を確認する。
IN_TRANSIT	問題解決	問題の解決を確認する。
IN_TRANSIT	別の配達先へ転送	転送を示す。
INFO_RECEIVED	情報受領	発送情報の受領を確認する。
OUT_FOR_DELIVERY	配達中	配達中であることを示す。
OUT_FOR_DELIVERY	顧客に連絡済み	配送業者の連絡 प्रयासを示す。
OUT_FOR_DELIVERY	配達予約済み	予約済みであることを示す。
PENDING	保留中	追跡情報が利用できないことを示す。
PENDING	配送業者アカウントが接続されていません	配送業者接続の不足を示す。
PENDING	ラベル作成済み、まだ更新なし	ラベルが作成されたことを示す。
PENDING	配送業者が不正	配送業者の不一致を示す。
PENDING	最近の更新なし	追跡情報が古いことを示す。
PENDING	認識できない配送業者	未対応の配送業者を示す。
EXPIRED	期限切れ	追跡期限切れを示す。