お届け日変更

1.基本情報


指定された契約情報のお届け日を変更する。
 
項目名内容
アクション名updateDeliveryDays
リクエストメソッドPOST

2.リクエストに必要な内容


項目名内容必須フォーマット入力例備考
subscriptionId定期購買IDはいgid://shopify/SubscriptionContract/***gid://shopify/SubscriptionContract/123456789
deliveryDaysお届日数はい数値3決済日より3日後をお届け日として指定したい場合。 -1: 指定なし -1以下: ストア設定のdeliveryDaysが優先されます。
deliveryTimeお届け時間帯はい1文字以上2文字以下の文字列、またはnull10アプリの「一般設定 > お届け時間設定」で設定したタグを指定する。 時間帯を指定しない場合は null を指定する。
nextBilling次回決済日はいYYYY-MM-DDTHH:mm:ss:SSSZ2024-09-23T08:00:00.000Zお届け日に合わせて注文日を変更する際に指定したい注文日
deliveryDateお届け日はい文字列2025年1月4日FlowトリガーのdeliveryDateとして設定したい日付
 

3.レスポンス内容


お届け日変更後の契約情報が返却されます。
 
■正常時レスポンス
プロパティ説明
idnumber定期購買アプリ内での定期購買契約管理ID
shopIdnumber定期購買アプリ内でのストア管理ID
createdAttimestamp契約作成日(UTC)
updatedAttimestamp契約更新日(UTC)
billingPolicyIntervalstring契約情報の決済周期(単位)
billingPolicyIntervalCountnumber契約情報の決済周期
billingPolicyMinCyclesnumber | null契約情報の最低購入回数
billingPolicyMaxCyclesnumber | null契約情報の最大購入回数
currencyCodestring契約通貨
deliveryPolicyIntervalstring契約情報のお届周期(単位)※未使用
deliveryPolicyIntervalCountnumber契約情報のお届周期 ※未使用
statusstring契約情報のステータス(ACTIVE、PAUSED、CANNCELLED)
customerDisplayNamestring | null顧客表示名
nextDeliveryDatetimestamp次回お届け日
subscriptionContractIdstring契約情報のShopify管理ID
originOrderIdstring | null初回注文のShopify管理ID
deliveryPriceAmountnumber | null契約情報の決済時配送料金
deliveryPriceCurrencyCodestring契約情報の決済時配送料金通貨
originOrderTokenstring | null初回注文のShopify管理トークン
deliveryAddress1string | null契約情報の配送先住所(住所)
deliveryAddress2string | null契約情報の配送先住所(建物名、部屋番号)
deliveryCompanystring | null契約情報の配送先住所(会社名)
deliveryCountrystring | null契約情報の配送先住所(国)
deliveryCountryCodestring | null契約情報の配送先住所(国コード)
deliveryFirstNamestring | null契約情報の配送先住所(名)
deliveryLastNamestring | null契約情報の配送先住所(姓)
deliveryNamestring | null契約情報の配送先住所(名+姓)
deliveryPhonestring | null契約情報の配送先住所(電話番号)
deliveryProvincestring | null契約情報の配送先住所(都道府県)
deliveryProvinceCodestring | null契約情報の配送先住所(都道府県コード)
deliveryZipstring | null契約情報の配送先住所(郵便番号)
deliveryCitystring | null契約情報の配送先住所(市区町村)
originOrderNamestring | null初回注文のShopify注文名
originOrderTestboolean初回注文がテスト注文か(true:テスト注文)
customerIdnumber | null定期購買アプリ内の顧客ID
customerPaymentMethodIdnumber | null定期購買アプリ内の顧客決済ID
deliveryDaysnumber契約情報のお届けまでに必要な日数
testbooleantrue:テスト契約、false:本契約
cancelledAttimestamp契約解約日(UTC)
cancelReasonstring | null解約理由
cancelExtraTextstring | null解約理由詳細
needToAlterSubscriptionLinebooleantrue:次回決済完了時商品差替あり、false:次回決済完了時商品差替なし
hidebooleantrue:非表示契約、false:表示契約
resumedAttimestamp契約再開日(UTC)
deliveryTimeTextstring | nullお届け日時間帯
notestring | null契約備考
failedAttemptCountnumber | null決済連続失敗回数(3回ごとに+1)
originOrderCheckoutTokenstring | null初回注文のShopify注文チェックアウトトークン
updatedBulkNextBillingDateboolean一括決済機能を利用している場合 true
contractTypestringSTANDARD:通常契約、BULK_PAY:一括支払い定期
bulkPayNextBillingDatestring | null一括払い定期用の次回支払い発生日
bulkPayMinCycleCountnumber最低サイクル回数
bulkPayMaxCycleCountnumber最高サイクル回数
sourceSubscriptionContractIdstring | null分割もとの定期購買契約ID(一括払い機能利用時)
■異常時レスポンス
ステータスコードエラーメッセージ
400stringこの定期購買の契約種別では許可されていない操作です
400string定期購買はすでに解約されています
404string定期購買が存在しません
404stringストアが存在しません
404string顧客が存在しません
409string現在決済処理中のため、しばらく時間をおいてからお試しください
500string内部エラーが発生しています