> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/central-issuance/ja/wosuru/kdono/wo-1.md).

# 発送を追跡

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

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

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

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

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

参照 [カード注文の追跡](/central-issuance/ja/wosuru/kdono.md) エンドツーエンドのフローについて。

{% hint style="info" %}
配送業者の追跡フィールドは任意です。利用可否は配送業者の統合に依存します。
{% endhint %}

### 対応している配送業者

| 配送業者コード            | 配送業者名                    |
| ------------------ | ------------------------ |
| 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`：チェックポイントメッセージ。

#### 例

```json
{
  "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": "施設に到着"
          }
        }
      }
    }
  ]
}
```

#### 配送ステータス

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

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

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

<details>

<summary>例 <code>message</code> 値</summary>

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

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payments.thalescloud.io/central-issuance/ja/wosuru/kdono/wo-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
