お届け日変更
１．基本情報
指定された契約情報のお届け日を変更する。
| 項目名 | 内容 |
|---|---|
| アクション名 | updateDeliveryDays |
| リクエストメソッド | POST |
２．リクエストに必要な内容
| 項目名 | 内容 | 必須 | フォーマット | 入力例 | 備考 |
|---|---|---|---|---|---|
| subscriptionId | 定期購買ID | はい | gid://shopify/SubscriptionContract/*** | gid://shopify/SubscriptionContract/123456789 | |
| deliveryDays | お届日数 | はい | 数値 | 3 | 決済日より3日後をお届け日として指定したい場合。 -1: 指定なし -1以下: ストア設定のdeliveryDaysが優先されます。 |
| deliveryTime | お届け時間帯 | はい | 1文字以上2文字以下の文字列、またはnull | 10 | アプリの「一般設定 > お届け時間設定」で設定したタグを指定する。 時間帯を指定しない場合は null を指定する。 |
| nextBilling | 次回決済日 | はい | YYYY-MM-DDTHH:mm:ss:SSSZ | 2024-09-23T08:00:00.000Z | お届け日に合わせて注文日を変更する際に指定したい注文日 |
| deliveryDate | お届け日 | はい | 文字列 | 2025年1月4日 | FlowトリガーのdeliveryDateとして設定したい日付 |
３．レスポンス内容
お届け日変更後の契約情報が返却されます。
■正常時レスポンス
| プロパティ | 型 | 説明 |
|---|---|---|
| id | number | 定期購買アプリ内での定期購買契約管理ID |
| shopId | number | 定期購買アプリ内でのストア管理ID |
| createdAt | timestamp | 契約作成日（UTC） |
| updatedAt | timestamp | 契約更新日（UTC） |
| billingPolicyInterval | string | 契約情報の決済周期（単位） |
| billingPolicyIntervalCount | number | 契約情報の決済周期 |
| billingPolicyMinCycles | number | null | 契約情報の最低購入回数 |
| billingPolicyMaxCycles | number | null | 契約情報の最大購入回数 |
| currencyCode | string | 契約通貨 |
| deliveryPolicyInterval | string | 契約情報のお届周期（単位）※未使用 |
| deliveryPolicyIntervalCount | number | 契約情報のお届周期 ※未使用 |
| status | string | 契約情報のステータス（ACTIVE、PAUSED、CANNCELLED） |
| customerDisplayName | string | null | 顧客表示名 |
| nextDeliveryDate | timestamp | 次回お届け日 |
| subscriptionContractId | string | 契約情報のShopify管理ID |
| originOrderId | string | null | 初回注文のShopify管理ID |
| deliveryPriceAmount | number | null | 契約情報の決済時配送料金 |
| deliveryPriceCurrencyCode | string | 契約情報の決済時配送料金通貨 |
| originOrderToken | string | null | 初回注文のShopify管理トークン |
| deliveryAddress1 | string | null | 契約情報の配送先住所（住所） |
| deliveryAddress2 | string | null | 契約情報の配送先住所（建物名、部屋番号） |
| deliveryCompany | string | null | 契約情報の配送先住所（会社名） |
| deliveryCountry | string | null | 契約情報の配送先住所（国） |
| deliveryCountryCode | string | null | 契約情報の配送先住所（国コード） |
| deliveryFirstName | string | null | 契約情報の配送先住所（名） |
| deliveryLastName | string | null | 契約情報の配送先住所（姓） |
| deliveryName | string | null | 契約情報の配送先住所（名＋姓） |
| deliveryPhone | string | null | 契約情報の配送先住所（電話番号） |
| deliveryProvince | string | null | 契約情報の配送先住所（都道府県） |
| deliveryProvinceCode | string | null | 契約情報の配送先住所（都道府県コード） |
| deliveryZip | string | null | 契約情報の配送先住所（郵便番号） |
| deliveryCity | string | null | 契約情報の配送先住所（市区町村） |
| originOrderName | string | null | 初回注文のShopify注文名 |
| originOrderTest | boolean | 初回注文がテスト注文か（true：テスト注文） |
| customerId | number | null | 定期購買アプリ内の顧客ID |
| customerPaymentMethodId | number | null | 定期購買アプリ内の顧客決済ID |
| deliveryDays | number | 契約情報のお届けまでに必要な日数 |
| test | boolean | true：テスト契約、false：本契約 |
| cancelledAt | timestamp | 契約解約日（UTC） |
| cancelReason | string | null | 解約理由 |
| cancelExtraText | string | null | 解約理由詳細 |
| needToAlterSubscriptionLine | boolean | true：次回決済完了時商品差替あり、false：次回決済完了時商品差替なし |
| hide | boolean | true：非表示契約、false：表示契約 |
| resumedAt | timestamp | 契約再開日（UTC） |
| deliveryTimeText | string | null | お届け日時間帯 |
| note | string | null | 契約備考 |
| failedAttemptCount | number | null | 決済連続失敗回数（3回ごとに+1） |
| originOrderCheckoutToken | string | null | 初回注文のShopify注文チェックアウトトークン |
| updatedBulkNextBillingDate | boolean | 一括決済機能を利用している場合 true |
| contractType | string | STANDARD：通常契約、BULK_PAY：一括支払い定期 |
| bulkPayNextBillingDate | string | null | 一括払い定期用の次回支払い発生日 |
| bulkPayMinCycleCount | number | 最低サイクル回数 |
| bulkPayMaxCycleCount | number | 最高サイクル回数 |
| sourceSubscriptionContractId | string | null | 分割もとの定期購買契約ID（一括払い機能利用時） |
■異常時レスポンス
| ステータスコード | 型 | エラーメッセージ |
|---|---|---|
| 400 | string | この定期購買の契約種別では許可されていない操作です |
| 400 | string | 定期購買はすでに解約されています |
| 404 | string | 定期購買が存在しません |
| 404 | string | ストアが存在しません |
| 404 | string | 顧客が存在しません |
| 409 | string | 現在決済処理中のため、しばらく時間をおいてからお試しください |
| 500 | string | 内部エラーが発生しています |