製造を追跡

生産追跡データは 詳細 のための PRODUCE 操作。

物理カード発行ステータス

物理カード発行のステータス遷移図。

ステータスコード	説明
CARD_PROD_REQUESTED	D1 APIs を通じてカードのパーソナライズが要求されました。
DATA_PREPARED	データは正常に処理されました。
DATA_EXCEPTION	データ処理中にエラーが発生しました。
CARD_PROD_READY	データはパーソナライズセンターに送信され、カードはパーソナライズ可能な状態です。
CARD_PROD_ONGOING	カードのパーソナライズを処理中です。
CARD_PROD_DONE	カードはパーソナライズされ、出荷準備ができています。
CARD_SHIPPED	カードは配送業者に引き渡されました。
CARD_PROD_CANCELED	カードのパーソナライズはイシュアによってキャンセルされました。

未知のものとして扱う details.status 値を後方互換として扱います。

詳細 フィールド

フィールド	説明	存在
理由	データ処理または生成例外に関する追加詳細を提供します。	条件付き
consumerId	非推奨です。使用しないでください。内部のエンドユーザー識別子を使用してください。	非推奨
dueDate	D1 が注文を処理したときに算出される推定出荷日。	条件付き
productionSite	カードのパーソナライズを担当するパーソナライズセンター。	条件付き
shipment	利用可能な場合の出荷追跡の詳細。参照 出荷を追跡.	条件付き
inputFileName	カード発行リクエストを含むファイル名。	条件付き
イシュアRequestId	入力ファイルの相関識別子。	条件付き

例

カードが要求されました

{
  "operations": [
    {
      "operationId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "operation": "PRODUCE",
      "status": "PENDING",
      "startTime": "2025-01-17T06:28:02.492Z",
      "cardId": "271b-6e47-8ec3-7f3f",
      "details": {
        "status": "CARD_PROD_REQUESTED"
      }
    }
  ]
}

データ処理が完了し、正常に終了しました

{
  "operations": [
    {
      "operationId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "operation": "PRODUCE",
      "status": "PENDING",
      "startTime": "2025-01-17T06:28:02.492Z",
      "cardId": "271b-6e47-8ec3-7f3f",
      "details": {
        "status": "DATA_PREPARED",
        "dueDate": "2025-01-21",
        "productionSite": "Gemenos"
      }
    }
  ]
}

データ処理でエラーが発生し、カードは拒否されました

{
  "operations": [
    {
      "operationId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "operation": "PRODUCE",
      "status": "FAILED",
      "startTime": "2025-01-17T06:28:02.492Z",
      "endTime": "2025-01-21T09:28:12.492Z",
      "cardId": "271b-6e47-8ec3-7f3f",
      "details": {
        "status": "DATA_EXCEPTION"
      },
      "errorCode": "FIELD_INVALID_FORMAT",
      "error": "pan"
    }
  ]
}

カード出荷済み — 最初の通知

{
  "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": {
          "estimatedDeliveryDate": "2025-01-21T17:32:28Z"
        }
      }
    }
  ]
}

カード出荷済み — 以降の通知

{
  "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": {
          "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": "Paris",
            "countryName": "France",
            "message": "施設に到着しました"
          }
        }
      }
    }
  ]
}

一括通知

{
  "operations": [
    {
      "operationId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "operation": "PRODUCE",
      "status": "PENDING",
      "startTime": "2025-01-17T06:28:02.492Z",
      "cardId": "271b-6e47-8ec3-7f3f",
      "details": {
        "status": "CARD_PROD_REQUESTED"
      }
    },
    {
      "operationId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "operation": "PRODUCE",
      "status": "PENDING",
      "startTime": "2025-01-17T06:28:02.492Z",
      "cardId": "271b-6e47-8ec3-7f3f",
      "details": {
        "status": "DATA_PREPARED",
        "dueDate": "2025-01-21",
        "productionSite": "Gemenos"
      }
    },
    {
      "operationId": "01c5a05e-e197-11ec-8fea-0242ac120002",
      "operation": "PRODUCE",
      "status": "FAILED",
      "startTime": "2025-01-17T06:28:02.492Z",
      "endTime": "2025-01-21T09:28:12.492Z",
      "cardId": "271b-6e47-8ec3-7f3f",
      "details": {
        "status": "DATA_EXCEPTION"
      },
      "errorCode": "FIELD_INVALID_FORMAT",
      "error": "pan"
    }        
  ]
}