---
title: "順序削除データモデル"
slug: "order-delete-data-model"
abstract: "注文削除の標準データモデル(Sitecore CDPバッチAPI)を説明します。"
---
# 順序削除データモデル

Order Delete APIは、referenceId値とorderedAt値の組み合わせを使って[注文を削除](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-offline-orders/using-order-delete.html "Using order delete")します。これは、一部の組織がreferenceId値をリサイクルするため、orderedAt値を同時に提供することで、削除の正しい順序を特定していることが保証されます。Sitecore CDP、リクエストで送信されたorderedAt値から24時間以内に、orderedAt値が24時間以内にあってreferenceId値が同じであれば、削除命令を識別します。

まれなケースでは、リクエスト内でorderRef属性を使って正しい削除順序を特定する必要があります。削除したい注文のorderedAt値が他の注文と24時間以内で、かつ両方の注文が同じreferenceId値を持っている場合にのみ、この操作が必要です。例えば、orderedAt値が17:16.000Z"の注文を削除したい場合"2023-09-25T16:、orderedAt値が47:55.000Z""2023-09-25T20:別の注文がある場合。両方の注文が同じreferenceId値"B94TXY-1"であれば、リクエスト内でorderRef属性も使用しなければなりません。これは2つ目のJSON例に示されているようにです。

orderRef値を取得するには、[デバッグモードで](https://doc.sitecore.com/cdp/en/users/sitecore-cdp/en/use-debug-mode-in-sitecore-cdp.html)ゲストプロファイルのJSONを確認し、ordersオブジェクトからref値をコピーできます。または、[Data Lakeのエクスポートサービスを使って](https://doc.sitecore.com/cdp/ja/developers/api/data-lake-export-service/data-entities-reference/orders.html "Orders")orderRef値と同じmeta\_ref値を取得することもできます。また、Audience Exportを使ってorderRef値を取得することもできます。

バッチファイルを作成する際は、以下の表の属性に加えて [、必要なすべての属性](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-offline-orders/batch-file-formatting-requirements.html#UUID-4499e082-be7d-9ebb-4936-c178936c1e06_para-idm1903351877649584) を含めてください。

:::tab{title="2.1"}

属性

概要

種類

例

ref

アップロードプロセス中にJSONレコードを識別する一意IDです。このIDはSitecore CDP内でゲストやレコードを識別するためには使われません。アップロードプロセス専用です。

ストリング  
  
バージョン4 UUID

"056621C2-C955-492D-B7EE-C77C6BDDFDEE"

schema

インポート中の value フィールドに含まれるレコードの種類。注文を削除する際にはこれを "order" に設定する必要があります。

ストリング

"order"

mode

バッチAPIモード。これは "delete"に設定されている必要があります。

ストリング

"delete"

value

Sitecore CDPから削除されるエンティティを含みます。

JSON オブジェクト

該当なし

orderRef

注文を参照するためにSitecore CDPによって生成される固有のIDです。

ストリング

"1202a558-5de3-46fc-8e45-eac7420f8c55"

referenceId

あなたの組織が発行する唯一のIDで、その注文を参照します。

ストリング

"B94TXY-1"

orderedAt

注文が行われた日時。

ISO 8601 日付/時刻 UTC

"2026-03-07T16:15:11.000Z"

こちらは "referenceId" 属性と "orderedAt" 属性を使って注文を削除するJSON例です:

{
 "ref":"056621C2-C955-492D-B7EE-C77C6BDDFDEE",
 "schema":"order",
 "mode":"delete",
 "value":{
 "referenceId":"B94TXY-1",
 "orderedAt":"2026-03-07T16:\`15:11\`.000Z"
 }
}

以下は "orderRef"、"referenceId"、"orderedAt" 属性を使ってオーダーを削除するJSON例です。

{
 "ref":"056621C2-C955-492D-B7EE-C77C6BDDFDEE",
 "schema":"order",
 "mode":"delete",
 "value":{
 "orderRef":"1202a558-5de3-46fc-8e45-eac7420f8c55",
 "referenceId":"B94TXY-1",
 "orderedAt":"2026-03-07T16:\`15:11\`.000Z"
 }
}

:::