> 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/torakkinguhabu.md).

# トラッキングハブ

Thales D1 外で製造された物理カードの製造、発送、または返却の更新を受け取るには、トラッキングハブを使用します。

### フロー

<figure><img src="https://312571361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWhgSoXgpjZJxLx4cDHB1%2Fuploads%2FNjRJPrU3dVmG5dtZzkxs%2FFlow%20-%20Tracking%20hub.png?alt=media&amp;token=6f903df1-c583-4b85-bec6-48f7ed04bdf5" alt=""><figcaption></figcaption></figure>

1. イシュアのバックエンドによるカード追跡リクエスト
2. D1 は配送業者に接続して出荷情報を取得します
3. 配送業者は定期的に出荷状況を送信します
4. D1 は状況を整形してイシュアのバックエンドに送信します

### シーケンス図

<figure><img src="https://312571361-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWhgSoXgpjZJxLx4cDHB1%2Fuploads%2FOQVZsRRqt9pc0RP53NUM%2FSequence%20Diagram%20-%20Tracking%20hub.svg?alt=media&amp;token=97f216c7-a1fb-4044-a961-8f81a4fd894a" alt=""><figcaption></figcaption></figure>

### 仕組み

{% tabs %}
{% tab title="製造" %}

* 使用 `trackingType = PRODUCTION` 製造完了の更新を受け取ります。
* Thales D1 は次の内容を含む通知を1件送信します `status = SUCCESSFUL`.
* 通知には次が含まれます `details.status = CARD_SHIPPED`.
  {% endtab %}

{% tab title="発送" %}

* 使用 `trackingType = SHIPMENT` 発送の進捗更新を受け取ります。
* Thales D1 はまず次の内容を含む通知を送信します `status = PENDING`.
* Thales D1 はその後、1件以上の通知を送信します `status = SUCCESSFUL` 出荷データが変化するたびに。
* 利用可能な場合、通知には次が含まれます `details.shipment`。参照: [出荷を追跡](/central-issuance/ja/wosuru/kdono/wo-1.md).
  {% endtab %}

{% tab title="返却" %}

* 使用 `trackingType = RETURN` 返却されたカードの更新を受け取ります。
* Thales D1 は次の内容を含む通知を1件送信します `status = SUCCESSFUL`.
* 通知には次が含まれます `details.status = CARD_RETURNED`.
  {% endtab %}
  {% endtabs %}

### 必要なAPI

| API                                                                                                                                             | 受信/送信             | 説明                                   |
| ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ------------------------------------ |
| [トラッキングハブ](/central-issuance/ja/d1-api-wosuru/d1-api-rifarensu/apid1-heno/tracking-hub-api.md#post-issuers-issuerid-physicalcards-cardid-track) | イシュア -> Thales D1 | 物理カードの製造、発送、または返却の追跡を要求します。          |
| [通知](/central-issuance/ja/d1-api-wosuru/d1-api-rifarensu/apid1-karano/kdo-api.md#post-notifications-d1-v2-issuers-issuerid-cards)               | イシュア <- Thales D1 | 次の通知を受信します `STANDALONE_TRACKING` 操作。 |

### API入力

必須の D1 API 入力:

* `issuerId`: イシュアの一意の識別子。
* `cardId`: カードの一意の識別子。
* `trackingType`：実行する追跡の種類。サポートされている値は `製造`, `発送`、および `返却`.

#### 例

**追跡タイプ = PRODUCTION**

```json
{
  "trackingType": "PRODUCTION",
  "productionSite": "London"
}
```

**追跡タイプ = SHIPMENT**

```json
{
  "trackingType": "SHIPMENT",
  "trackingNumber": "61293150000079650811",
  "shipmentDate": "2023-01-21T17:32:28Z",
  "productionSite": "London",
  "postalCode": "WC2N5DU",
  "countryCode": "GB"
}
```

**追跡タイプ = RETURN**

```json
{
  "trackingType": "RETURN",
  "productionSite": "London"
}
```

### 結果を追跡する

通知を受信するのは `STANDALONE_TRACKING` 操作。

主要フィールド：

* `operation`：常に `STANDALONE_TRACKING`.
* `status`：オペレーションのステータス。値は `PENDING`, `SUCCESSFUL`、または `FAILED`.
* `cardId`：リクエストで使用されるカード識別子。
* `details.trackingType`: `製造`, `発送`、または `返却`.
* `details.productionSite`：利用可能な場合の製造サイト識別子。
* `details.status`：次のような追跡結果： `CARD_SHIPPED` または `CARD_RETURNED`.
* `details.shipment`：次の配送追跡の詳細 `発送` 更新。参照 [出荷を追跡](/central-issuance/ja/wosuru/kdono/wo-1.md).

最上位 `status` はオペレーションのステータスです。

`details.status` はビジネス追跡ステータスです。

{% hint style="info" %}
通知は複数回届くことがあり、順不同で届くこともあります。 `operationId` 重複排除するために使用します。
{% endhint %}

追跡タイプ別の通知順序：

| trackingType | 送信される通知                                                                                     |
| ------------ | ------------------------------------------------------------------------------------------- |
| `製造`         | 次を含む1件の通知 `status = SUCCESSFUL` と `details.status = CARD_SHIPPED`.                          |
| `返却`         | 次を含む1件の通知 `status = SUCCESSFUL` と `details.status = CARD_RETURNED`.                         |
| `発送`         | 次を含む1件の通知 `status = PENDING`、その後、次を含む1件以上の通知 `status = SUCCESSFUL` が、配送更新が利用可能になるたびに送信されます。 |

#### 通知の例

**追跡タイプ = PRODUCTION**

```json
{
  "操作ID": "op-7a3f2c1e-9b4d-4f8a-bc12-1a2b3c4d5e6f",
  "操作": "単独トラッキング",
  "状態": "成功",
  "イシュアID": "イシュア-001",
  "カードID": "c-9f8e7d6c5b4a",
  "タイムスタンプ": "2026-05-22T09:38:00Z",
  "詳細": {
    "trackingType": "PRODUCTION",
    "生産サイト": "PERSO-CENTER-FR-01",
    "状態": "カード発送済み"
  }
}
```

**トラッキング種別 = SHIPMENT — 初回通知**&#x20;

```json
{
  "操作ID": "op-7a3f2c1e-9b4d-4f8a-bc12-1a2b3c4d5e6f",
  "操作": "単独トラッキング",
  "status": "PENDING",
  "イシュアID": "イシュア-001",
  "カードID": "c-9f8e7d6c5b4a",
  "timestamp": "2026-05-22T09:38:05Z",
  "詳細": {
    "trackingType": "SHIPMENT",
    "生産サイト": "PERSO-CENTER-FR-01",
    "状態": "カード発送済み"
  }
}
```

**トラッキングタイプ = SHIPMENT — 後続の通知（出荷詳細付き）**

```json
{
  "操作ID": "op-7a3f2c1e-9b4d-4f8a-bc12-1a2b3c4d5e6f",
  "操作": "単独トラッキング",
  "状態": "成功",
  "イシュアID": "イシュア-001",
  "カードID": "c-9f8e7d6c5b4a",
  "timestamp": "2026-05-22T14:12:33Z",
  "詳細": {
    "trackingType": "SHIPMENT",
    "生産サイト": "PERSO-CENTER-FR-01",
    "status": "CARD_SHIPPED",
    "shipment": {
      "carrier": "fedex",
      "trackingNumber": "1234567890",
      "status": "IN_TRANSIT",
      "message": "輸送中", 
      "trackingUrl": "https://www.fedex.com/track?trk=1234567890",
      "estimatedDeliveryDate": "2026-05-24T00:00:00Z",
      "lastUpdatedAt": "2026-05-22T13:55:00Z",
      "lastCheckpoint": {
        "checkpointTime": "2026-05-22T13:55:00Z",
        "city": "パリ",
        "countryName": "フランス",
        "message": "施設に到着しました"
      }
    }
  }
}
```

**追跡タイプ = RETURN**

```json
{
  "操作ID": "op-7a3f2c1e-9b4d-4f8a-bc12-1a2b3c4d5e6f",
  "操作": "単独トラッキング",
  "状態": "成功",
  "イシュアID": "イシュア-001",
  "カードID": "c-9f8e7d6c5b4a",
  "timestamp": "2026-05-25T10:02:11Z",
  "詳細": {
    "trackingType": "RETURN",
    "生産サイト": "PERSO-CENTER-FR-01",
    "status": "CARD_RETURNED"
  }
}
```


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.payments.thalescloud.io/central-issuance/ja/wosuru/torakkinguhabu.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.