データスキーマ
配送先住所
AddressData · スキーマ · データスキーマ: 注文
address_line_1文字列 null必須住所の1行目。
address_line_2文字列 null必須住所の追加情報。
city文字列 null必須市区町村。
country_code文字列 null必須国コード。
first_name文字列 null必須名。
house_number文字列 null必須建物番号・番地。
last_name文字列 null必須姓。
phone文字列 null必須電話番号。
postal_code文字列 null必須郵便番号。
region文字列 null必須都道府県などの行政区域。
street文字列 null必須通りの名前。
追加フィールド: いいえ
一覧取得 — 注文 — レスポンス
ApiResponse_list_OrderSummaryData__ · API が受け取る、または返すデータのフィールド、型、制約。
data配列 <OrderSummaryData> 必須レスポンス例 · ApiResponse_list_OrderSummaryData__.
metaContextPageMetaContextMetaPageMetaRequestMeta必須レスポンスのメタデータ。
追加フィールド: いいえ
取得 — 注文 — レスポンス
ApiResponse_OrderDetailData_ · API が受け取る、または返すデータのフィールド、型、制約。
dataOrderDetailData必須レスポンス例 · OrderDetailData.
metaContextPageMetaContextMetaPageMetaRequestMeta必須レスポンスのメタデータ。
追加フィールド: いいえ
このリソースに記録された顧客情報
CustomerData · スキーマ · データスキーマ: 注文
email文字列必須メールアドレス。
first_name文字列 null必須名。
last_name文字列 null必須姓。
phone文字列 null必須電話番号。
追加フィールド: いいえ
発送日と配送予定日
DeliveryDatesData · 注文一覧と詳細には delivery.dates が含まれます。YYYY-MM-DD 形式の日付は予定であり、発送済みを示しません。現在の日付が優先され、古い注文には保存された予測が使われます。削除済みまたは不明な値は null です。詳細にはすべての注文明細と商品画像も含まれます。
dispatch_timezone文字列 null必須発送のタイムゾーン (IANA; null).
estimated_delivery_from文字列 null必須配送予定期間の開始日 (YYYY-MM-DD; null).
文字列:format:"date"estimated_delivery_to文字列 null必須配送予定期間の終了日 (YYYY-MM-DD; null).
文字列:format:"date"planned_dispatch_on文字列 null必須発送予定日 (YYYY-MM-DD; null).
文字列:format:"date"
追加フィールド: いいえ
DeliveryPickupPointData
DeliveryPickupPointData · API が受け取る、または返すデータのフィールド、型、制約。
addressPickupPointAddressData必須配送先住所。
code文字列必須安定した機械可読コード。
制約
pattern"^[A-Za-z0-9_-]{1,63}$"
coordinatesPickupPointCoordinatesDatanull必須周囲のスキーマで説明される値。
country_code文字列必須国コード。
制約
pattern"^[A-Z]{2}$"
environment文字列必須レコードに付随する環境情報。
制約
enum["live", "sandbox"]
kind文字列必須許可された値で示されるデータ構造の種類。
制約
enum["locker", "pickup_point"]
location_description文字列 null必須選択した言語での説明。
文字列:maxLength:1000name文字列必須該当コンテキストでのリソース名。
minLength:1maxLength:160opening_hours文字列 null必須Opening hours
文字列:maxLength:500operator文字列必須該当コンテキストでのリソース名。
minLength:1maxLength:63verified_at文字列必須最終更新時刻。
format:"date-time"
追加フィールド: いいえ
請求書情報
InvoiceData · スキーマ · データスキーマ: 注文
address_line_1文字列 null必須住所の1行目。
address_line_2文字列 null必須住所の追加情報。
city文字列 null必須市区町村。
company_name文字列 null必須会社名。
country_code文字列 null必須国コード。
house_number文字列 null必須建物番号・番地。
postal_code文字列 null必須郵便番号。
region文字列 null必須都道府県などの行政区域。
street文字列 null必須通りの名前。
tax_identifier文字列 null必須納税者識別番号。
tax_scheme文字列 null必須税計算方式。
追加フィールド: いいえ
配送 · 割引
OrderDeliveryDiscountData · 金額と税率は、項目の訂正を含む保存済み注文に基づきます。履歴が欠けている場合は null となり、現在の商品カタログの税率では補完しません。金額は十進数の文字列のまま扱います。
amountMoneyData必須税込金額 · 配送 · 割引.
campaign_id文字列必須リソース識別子。返された値をそのまま保持してください。
code文字列 null必須安定した機械可読コード。
kind文字列必須許可された値で示されるデータ構造の種類。
制約
enum["coupon", "promotion"]
name文字列必須該当コンテキストでのリソース名。
sequence整数 null必須順序付きコレクション内の位置。
version整数必須同時更新制御に使うリソースバージョン。
追加フィールド: いいえ
取得 — 注文 — レスポンス
OrderDetailData · API が受け取る、または返すデータのフィールド、型、制約。
created_at文字列必須作成時刻。
format:"date-time"customerCustomerData必須このリソースに記録された顧客情報。
deliveryShippingDetailData必須配送方法と関連情報。
discount_amountMoneyData必須JSON 文字列として表した10進数の金額。null は許可される場合のみ。
discounts配列 <OrderDiscountData> 必須割引
id文字列必須リソース識別子。返された値をそのまま保持してください。 (OrderDetailData).
invoiceInvoiceDatanull必須請求書情報。
invoice_requested真偽値必須請求書が要求されたかどうか。
lifecycle_stateOrderLifecycleState必須業務上のライフサイクル状態。
lines配列 <OrderLineData> 必須注文明細のスナップショット。
locale文字列必須このリクエストで選択した言語。
market_id文字列必須コンテキストエンドポイントが返した市場識別子。
number文字列必須人向けの注文番号または申請番号。
paymentPaymentData必須注文に記録された支払い詳細。
pickup_pointPickupPointDatanull必須受取場所
prices_include_tax真偽値必須表示価格が税込みかどうか。
shipping_addressAddressDatanull必須配送先住所。
shipping_discount_amountMoneyData必須JSON 文字列として表した10進数の金額。null は許可される場合のみ。
statusOrderStatusData必須この操作で受け付けるステータス。
subtotalMoneyData必須レスポンスに示す追加項目を含める前の金額。
taxMoneyData必須税情報。
tax_breakdownOrderTaxBreakdownData必須税グループ · source + tax_rate; unallocated_tax.
tax_country_code文字列 null必須課税国 · 保存された注文データ · ISO 3166-1 alpha-2; null.
totalMoneyData必須合計金額。
totalsOrderTotalsData必須合計 · net / tax / gross; 割引前 / 割引後.
追加フィールド: いいえ
画像のメタデータと URL
OrderImageData · スキーマ · データスキーマ: 注文
alt文字列 null必須画像の代替テキスト。
source文字列任意記録された活動の発生元。
const:"current_catalog"url文字列必須リソースの URL。
追加フィールド: いいえ
業務上のライフサイクル状態
OrderLifecycleState · スキーマ · データスキーマ: 注文
文字列制約
enum["placed", "cancelled", "fulfilled", "returned"]
追加フィールド: はい
注文明細のスナップショット
OrderLineData · スキーマ · データスキーマ: 注文
discount_amountMoneyData必須JSON 文字列として表した10進数の金額。null は許可される場合のみ。
discount_grossMoneyData必須税込金額 · 割引; 不明: null、既知のゼロ: 0.
discount_netMoneyDatanull必須税抜金額 · 割引; 不明: null、既知のゼロ: 0.
discount_taxMoneyDatanull必須税額 · 割引; 不明: null、既知のゼロ: 0.
discounts配列 <OrderDiscountData> 必須割引 · net / tax / gross.
identifiersオブジェクト追加フィールド: 文字列必須商品識別コード。
imageOrderImageDatanull必須画像のメタデータと URL。
line_id文字列必須注文項目の固定識別子.
manual_discountOrderManualDiscountDatanull必須手動割引; null.
name文字列必須該当コンテキストでのリソース名。
original_totalMoneyData必須合計金額。
original_total_grossMoneyData必須税込金額 · 商品 · 割引前; 不明: null、既知のゼロ: 0.
original_total_netMoneyDatanull必須税抜金額 · 商品 · 割引前; 不明: null、既知のゼロ: 0.
original_total_taxMoneyDatanull必須税額 · 商品 · 割引前; 不明: null、既知のゼロ: 0.
position整数必須順序付きコレクション内の位置。
product_id文字列必須商品識別子。
quantity整数必須数量。
sku文字列必須在庫管理単位のコード。
taxMoneyDatanull必須税額 · 1単位 · 保存された注文データ; tax ≠ unit_tax; 不明: null、既知のゼロ: 0.
tax_category_id文字列 null必須税区分の識別子 · 保存された注文データ; null.
tax_category_name文字列 null必須保存された税区分名; null.
tax_rate文字列 null必須tax_rate · 保存された注文データ: "0.23" = 23%; "0" ≠ null.
totalMoneyData必須合計金額。
total_grossMoneyData必須税込金額 · 商品 · 割引後; 不明: null、既知のゼロ: 0.
total_netMoneyDatanull必須税抜金額 · 商品 · 割引後; 不明: null、既知のゼロ: 0.
total_taxMoneyDatanull必須税額 · 商品 · 割引後 · 保存された注文データ; 不明: null、既知のゼロ: 0.
unit_grossMoneyData必須税込金額 · 1単位 · 割引前; 不明: null、既知のゼロ: 0.
unit_netMoneyDatanull必須税抜金額 · 1単位 · 割引前; 不明: null、既知のゼロ: 0.
unit_priceMoneyData必須単価。
unit_taxMoneyDatanull必須税額 · 1単位 · 割引前; 不明: null、既知のゼロ: 0.
variant_id文字列 null必須商品バリエーション識別子。
variant_options配列 <shopently_engine__domains__orders__adapters__public_http__orders__schemas__VariantOptionData> 必須商品またはスナップショットに関連するバリエーションオプション。
追加フィールド: いいえ
手動割引
OrderManualDiscountData · 金額と税率は、項目の訂正を含む保存済み注文に基づきます。履歴が欠けている場合は null となり、現在の商品カタログの税率では補完しません。金額は十進数の文字列のまま扱います。
amountMoneyData必須税込金額 · 手動割引 · 保存された注文データ.
kind文字列必須割引の種類: percentage / fixed.
制約
enum["percentage", "fixed"]
value文字列必須設定値: percentage "10" = 10%; fixed = 税込金額.
追加フィールド: いいえ
この操作で受け付けるステータス
OrderPaymentStatus · スキーマ · データスキーマ: 注文
文字列制約
enum["unpaid", "paid", "failed", "refunded"]
追加フィールド: はい
この操作で受け付けるステータス
OrderStatusData · スキーマ · データスキーマ: 注文
id文字列必須リソース識別子。返された値をそのまま保持してください。 (OrderStatusData).
name文字列必須該当コンテキストでのリソース名。
updated_at文字列必須最終更新時刻。
format:"date-time"version整数必須同時更新制御に使うリソースバージョン。
追加フィールド: いいえ
一覧取得 · ステータス一覧 — 注文 — レスポンス
shopently_engine__domains__orders__adapters__public_http__orders__schemas__StatusDefinitionData · API が受け取る、または返すデータのフィールド、型、制約。
created_at文字列必須作成時刻。
format:"date-time"id文字列必須リソース識別子。返された値をそのまま保持してください。 (shopently_engine__domains__orders__adapters__public_http__orders__schemas__StatusDefinitionData).
is_initial真偽値必須初期ステータスかどうか。
name文字列必須該当コンテキストでのリソース名。
position整数必須順序付きコレクション内の位置。
追加フィールド: いいえ
一覧取得 · ステータス一覧 — 注文 — レスポンス
shopently_engine__runtime__public_api_http__responses__models__ApiResponse_list_StatusDefinitionData____1 · API が受け取る、または返すデータのフィールド、型、制約。
data配列 <shopently_engine__domains__orders__adapters__public_http__orders__schemas__StatusDefinitionData> 必須レスポンス例 · shopently_engine__runtime__public_api_http__responses__models__ApiResponse_list_StatusDefinitionData____1.
metaContextPageMetaContextMetaPageMetaRequestMeta必須レスポンスのメタデータ。
追加フィールド: いいえ
更新 · ステータス — 注文 — リクエスト本文
OrderStatusUpdate · API が受け取る、または返すデータのフィールド、型、制約。
expected_version整数必須書き込み前に取得したバージョン。不一致の場合は更新を拒否します。
minimum:1maximum:9223372036854775807status_id文字列必須対応するステータス辞書から取得した識別子。
制約
pattern"^[a-z0-9][a-z0-9_-]{0,62}$"
追加フィールド: いいえ
一覧取得 — 注文 — レスポンス
OrderSummaryData · API が受け取る、または返すデータのフィールド、型、制約。
created_at文字列必須作成時刻。
format:"date-time"customerCustomerData必須このリソースに記録された顧客情報。
deliveryShippingData必須配送方法と関連情報。
discount_amountMoneyData必須JSON 文字列として表した10進数の金額。null は許可される場合のみ。
id文字列必須リソース識別子。返された値をそのまま保持してください。 (OrderSummaryData).
lifecycle_stateOrderLifecycleState必須業務上のライフサイクル状態。
locale文字列必須このリクエストで選択した言語。
market_id文字列必須コンテキストエンドポイントが返した市場識別子。
number文字列必須人向けの注文番号または申請番号。
paymentPaymentData必須注文に記録された支払い詳細。
prices_include_tax真偽値必須表示価格が税込みかどうか。
shipping_discount_amountMoneyData必須JSON 文字列として表した10進数の金額。null は許可される場合のみ。
statusOrderStatusData必須この操作で受け付けるステータス。
subtotalMoneyData必須レスポンスに示す追加項目を含める前の金額。
taxMoneyData必須税情報。
tax_country_code文字列 null必須課税国 · 保存された注文データ · ISO 3166-1 alpha-2; null.
totalMoneyData必須合計金額。
追加フィールド: いいえ
注文 · 税グループ
OrderTaxBreakdownData · 金額と税率は、項目の訂正を含む保存済み注文に基づきます。履歴が欠けている場合は null となり、現在の商品カタログの税率では補完しません。金額は十進数の文字列のまま扱います。
groups配列 <OrderTaxGroupData> 必須税グループ · source + tax_rate; 不明: null、既知のゼロ: 0.
unallocated_taxMoneyData必須未配分の税額 = order.tax − Σ groups.tax; ±.
追加フィールド: いいえ
税グループ
OrderTaxGroupData · 金額と税率は、項目の訂正を含む保存済み注文に基づきます。履歴が欠けている場合は null となり、現在の商品カタログの税率では補完しません。金額は十進数の文字列のまま扱います。
grossMoneyData必須税込金額 · 割引後; 不明: null、既知のゼロ: 0.
netMoneyDatanull必須税抜金額 · 割引後; 不明: null、既知のゼロ: 0.
source文字列必須発生元: products (商品), shipping (配送).
制約
enum["products", "shipping"]
taxMoneyDatanull必須税額 · 割引後; 不明: null、既知のゼロ: 0.
tax_rate文字列 null必須tax_rate · 保存された注文データ: "0.23" = 23%; "0" ≠ null.
追加フィールド: いいえ
注文 · 合計
OrderTotalsData · 金額と税率は、項目の訂正を含む保存済み注文に基づきます。履歴が欠けている場合は null となり、現在の商品カタログの税率では補完しません。金額は十進数の文字列のまま扱います。
before_discountsOrderAmountBreakdownData必須注文 · 割引前 · net / tax / gross.
discountsOrderAmountBreakdownData必須割引 · net / tax / gross.
orderOrderAmountBreakdownData必須注文 · 割引後 · net / tax / gross.
product_discountsOrderAmountBreakdownData必須商品 · 割引 · net / tax / gross.
productsOrderAmountBreakdownData必須商品 · 割引後 · net / tax / gross.
products_before_discountsOrderAmountBreakdownData必須商品 · 割引前 · net / tax / gross.
shippingOrderAmountBreakdownData必須配送 · 割引後 · net / tax / gross.
shipping_before_discountsOrderAmountBreakdownData必須配送 · 割引前 · net / tax / gross.
shipping_discountsOrderAmountBreakdownData必須配送 · 割引 · net / tax / gross.
追加フィールド: いいえ
商品またはスナップショットに関連するバリエーションオプション
shopently_engine__domains__orders__adapters__public_http__orders__schemas__VariantOptionData · スキーマ · データスキーマ: 注文
name文字列必須該当コンテキストでのリソース名。
value文字列必須周囲のスキーマで説明される値。
追加フィールド: いいえ
OrderDiscountData
OrderDiscountData · API が受け取る、または返すデータのフィールド、型、制約。
amountMoneyData必須税込金額 · 商品 · 割引.
campaign_id文字列必須リソース識別子。返された値をそのまま保持してください。
code文字列 null必須安定した機械可読コード。
kind文字列必須許可された値で示されるデータ構造の種類。
制約
enum["coupon", "promotion"]
name文字列必須該当コンテキストでのリソース名。
sequence整数 null任意適用順序; null.
shipping_amountMoneyDatanull任意税込金額 · 配送 · 割引; null.
version整数必須同時更新制御に使うリソースバージョン。
追加フィールド: いいえ
注文に記録された支払い詳細
PaymentData · スキーマ · データスキーマ: 注文
amountMoneyData必須payment.amount は注文合計です。支払状態から支払済み額、返金額、未払額は確定できません。
environment文字列必須レコードに付随する環境情報。
制約
enum["live", "sandbox"]
method_code文字列 null必須配送方法または支払い方法のコード。
method_name文字列 null必須配送方法または支払い方法の名前。
paid_at文字列 null必須支払いを支払済みとして記録した日時。
文字列:format:"date-time"statusOrderPaymentStatus必須この操作で受け付けるステータス。
updated_at文字列必須最終更新時刻。
format:"date-time"version整数必須同時更新制御に使うリソースバージョン。
追加フィールド: いいえ
更新 · 支払いステータス — 注文 — リクエスト本文
PaymentStatusUpdate · API が受け取る、または返すデータのフィールド、型、制約。
expected_version整数必須書き込み前に取得したバージョン。不一致の場合は更新を拒否します。
minimum:0maximum:9223372036854775807reason文字列必須変更の記録理由。
minLength:1maxLength:500statusPaymentStatus必須この操作で受け付けるステータス。
追加フィールド: いいえ
この操作で受け付けるステータス
PaymentStatus · スキーマ · データスキーマ: 注文
文字列制約
enum["unpaid", "paid", "failed", "refunded"]
追加フィールド: はい
PickupPointAddressData
PickupPointAddressData · API が受け取る、または返すデータのフィールド、型、制約。
address_line_1文字列必須住所の1行目。
minLength:1maxLength:240city文字列必須市区町村。
minLength:1maxLength:160postal_code文字列必須郵便番号。
minLength:1maxLength:32
追加フィールド: いいえ
PickupPointCoordinatesData
PickupPointCoordinatesData · API が受け取る、または返すデータのフィールド、型、制約。
latitude数値必須WGS84 φ (°)
minimum:-90.0maximum:90.0longitude数値必須WGS84 λ (°)
minimum:-180.0maximum:180.0
追加フィールド: いいえ
PickupPointData
PickupPointData · API が受け取る、または返すデータのフィールド、型、制約。
address_line1文字列必須住所の1行目。
city文字列必須市区町村。
code文字列必須安定した機械可読コード。
country_code文字列必須国コード。
kind文字列必須許可された値で示されるデータ構造の種類。
制約
enum["locker", "pickup_point"]
latitude数値 null必須WGS84 φ (°)
location_description文字列 null必須選択した言語での説明。
longitude数値 null必須WGS84 λ (°)
name文字列必須該当コンテキストでのリソース名。
opening_hours文字列 null必須Opening hours
operator文字列必須該当コンテキストでのリソース名。
postal_code文字列必須郵便番号。
追加フィールド: いいえ
PickupPointSummaryData
PickupPointSummaryData · API が受け取る、または返すデータのフィールド、型、制約。
code文字列必須安定した機械可読コード。
制約
pattern"^[A-Za-z0-9_-]{1,63}$"
country_code文字列必須国コード。
制約
pattern"^[A-Z]{2}$"
environment文字列必須レコードに付随する環境情報。
制約
enum["live", "sandbox"]
kind文字列必須許可された値で示されるデータ構造の種類。
制約
enum["locker", "pickup_point"]
operator文字列必須該当コンテキストでのリソース名。
minLength:1maxLength:63
追加フィールド: いいえ
このリソースに記録された顧客情報
RequestCustomerData · スキーマ · データスキーマ: 注文
email文字列必須メールアドレス。
name文字列必須該当コンテキストでのリソース名。
追加フィールド: いいえ
配送方法と関連情報
ShippingData · スキーマ · データスキーマ: 注文
amountMoneyData必須注文にMoneyDataとして記録された税込配送料です。後の税率変更によって、この過去の金額は変わりません。
datesDeliveryDatesData必須発送日と配送予定日. 注文一覧と詳細には delivery.dates が含まれます。YYYY-MM-DD 形式の日付は予定であり、発送済みを示しません。現在の日付が優先され、古い注文には保存された予測が使われます。削除済みまたは不明な値は null です。詳細にはすべての注文明細と商品画像も含まれます。
method_code文字列 null必須配送方法または支払い方法のコード。
method_name文字列 null必須配送方法または支払い方法の名前。
pickup_pointPickupPointSummaryDatanull必須受取場所
recipient_mode文字列必須許可された値で示されるデータ構造の種類。
制約
enum["full_address", "pickup_contact"]
追加フィールド: いいえ
ShippingDetailData
ShippingDetailData · API が受け取る、または返すデータのフィールド、型、制約。
amountMoneyData必須注文にMoneyDataとして記録された税込配送料です。後の税率変更によって、この過去の金額は変わりません。
datesDeliveryDatesData必須発送日と配送予定日. 注文一覧と詳細には delivery.dates が含まれます。YYYY-MM-DD 形式の日付は予定であり、発送済みを示しません。現在の日付が優先され、古い注文には保存された予測が使われます。削除済みまたは不明な値は null です。詳細にはすべての注文明細と商品画像も含まれます。
discount_grossMoneyData必須税込金額 · 割引; 不明: null、既知のゼロ: 0.
discount_netMoneyDatanull必須税抜金額 · 割引; 不明: null、既知のゼロ: 0.
discount_taxMoneyDatanull必須税額 · 割引; 不明: null、既知のゼロ: 0.
discounts配列 <OrderDeliveryDiscountData> null必須配送 · 割引; []: 0; null: 不明: null、既知のゼロ: 0.
grossMoneyData必須税込金額 · 割引後; 不明: null、既知のゼロ: 0.
method_code文字列 null必須配送方法または支払い方法のコード。
method_name文字列 null必須配送方法または支払い方法の名前。
netMoneyDatanull必須税抜金額 · 割引後; 不明: null、既知のゼロ: 0.
original_grossMoneyData必須税込金額 · 配送 · 割引前; 不明: null、既知のゼロ: 0.
original_netMoneyDatanull必須税抜金額 · 配送 · 割引前; 不明: null、既知のゼロ: 0.
original_taxMoneyDatanull必須税額 · 配送 · 割引前; 不明: null、既知のゼロ: 0.
pickup_pointDeliveryPickupPointDatanull必須受取場所
recipient_mode文字列必須許可された値で示されるデータ構造の種類。
制約
enum["full_address", "pickup_contact"]
taxMoneyDatanull必須税額 · 割引後; 不明: null、既知のゼロ: 0.
tax_category_id文字列 null必須税区分の識別子 · 保存された注文データ; null.
tax_category_name文字列 null必須保存された税区分名; null.
tax_rate文字列 null必須tax_rate · 保存された注文データ: "0.23" = 23%; "0" ≠ null.
追加フィールド: いいえ