@builtbystack/sq-shopify-theme-sdk 0.0.33 → 0.0.36

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -51,6 +51,24 @@ SDKは名前空間 `SQ` 内に存在するため、SDKの初期化は `new SQ.SD
51
51
 
52
52
  ### Methods
53
53
 
54
+ #### DiscountUsageCreate()
55
+
56
+ > **DiscountUsageCreate**(`orderPriceAdjustmentRuleID`): `Promise`\<`null` \| `object`\>
57
+
58
+ DiscountUsageCreate は指定した注文価格調整の利用履歴を作成します。
59
+
60
+ ##### Parameters
61
+
62
+ • **orderPriceAdjustmentRuleID**: `string`
63
+
64
+ 利用する注文価格調整ルールのID
65
+
66
+ ##### Returns
67
+
68
+ `Promise`\<`null` \| `object`\>
69
+
70
+ ***
71
+
54
72
  #### getEstimatedShopifyCartLineItemPoint()
55
73
 
56
74
  > **getEstimatedShopifyCartLineItemPoint**(`currencyCode`, `taxesIncluded`, `sku`, `quantity`, `unitPrice`): `Promise`\<`null` \| [`EstimatedPoint`](#type-aliasesestimatedpointmd)\>
@@ -439,6 +457,38 @@ getPurchasingCustomerMetafield は渡されたnamespaceとkeyに一致する現
439
457
 
440
458
  ***
441
459
 
460
+ #### getPurchasingCustomerRetailOrders()
461
+
462
+ > **getPurchasingCustomerRetailOrders**(`first`?, `after`?, `isReverse`?, `sortKeys`?): `Promise`\<`null` \| [`PurchasingCustomerRetailOrders`](#type-aliasespurchasingcustomerretailordersmd)\>
463
+
464
+ getPurchasingCustomerRetailOrders は顧客の店舗受取注文一覧を取得します。
465
+
466
+ ##### Parameters
467
+
468
+ • **first?**: `number`
469
+
470
+ 取得する注文数の上限
471
+
472
+ • **after?**: `string`
473
+
474
+ ページネーション用のカーソル
475
+
476
+ • **isReverse?**: `boolean`
477
+
478
+ 並び順を逆にするかどうか
479
+
480
+ • **sortKeys?**: `RetailOrderSortKey`
481
+
482
+ ソートキー
483
+
484
+ ##### Returns
485
+
486
+ `Promise`\<`null` \| [`PurchasingCustomerRetailOrders`](#type-aliasespurchasingcustomerretailordersmd)\>
487
+
488
+ 顧客の店舗受取注文一覧、または顧客が存在しない場合はnull
489
+
490
+ ***
491
+
442
492
  #### getPurchasingCustomerSMS()
443
493
 
444
494
  > **getPurchasingCustomerSMS**(): `Promise`\<`null` \| [`PurchasingCustomerSMS`](#type-aliasespurchasingcustomersmsmd)\>
@@ -666,6 +716,7 @@ LocationType はロケーションの種別を表す
666
716
  - [MileOrder](#type-aliasesmileordermd)
667
717
  - [MileOrders](#type-aliasesmileordersmd)
668
718
  - [Miles](#type-aliasesmilesmd)
719
+ - [Money](#type-aliasesmoneymd)
669
720
  - [PageInfo](#type-aliasespageinfomd)
670
721
  - [PointCampaignOrderRule](#type-aliasespointcampaignorderrulemd)
671
722
  - [PointCampaignOrderRuleTargetCustomerRank](#type-aliasespointcampaignorderruletargetcustomerrankmd)
@@ -681,8 +732,11 @@ LocationType はロケーションの種別を表す
681
732
  - [PurchasingCustomerDiscount](#type-aliasespurchasingcustomerdiscountmd)
682
733
  - [PurchasingCustomerDiscounts](#type-aliasespurchasingcustomerdiscountsmd)
683
734
  - [PurchasingCustomerMetafield](#type-aliasespurchasingcustomermetafieldmd)
735
+ - [PurchasingCustomerRetailOrder](#type-aliasespurchasingcustomerretailordermd)
736
+ - [PurchasingCustomerRetailOrders](#type-aliasespurchasingcustomerretailordersmd)
684
737
  - [PurchasingCustomerSMS](#type-aliasespurchasingcustomersmsmd)
685
738
  - [PurchasingCustomerSharing](#type-aliasespurchasingcustomersharingmd)
739
+ - [RetailLocation](#type-aliasesretaillocationmd)
686
740
  - [Tenant](#type-aliasestenantmd)
687
741
 
688
742
  # Type Aliases
@@ -1170,7 +1224,7 @@ location は在庫のLocationを表す。
1170
1224
 
1171
1225
  > **LocationFilter**: `object`
1172
1226
 
1173
- LocationType はロケーションのフィルタリング条件を表現するオブジェクト
1227
+ LocationType はロケーションのフィルタリング条件
1174
1228
 
1175
1229
  ### Type declaration
1176
1230
 
@@ -1506,6 +1560,35 @@ Miles は SDK から取得できるマイルの情報を表す。
1506
1560
  Miles は保有マイルを表す。
1507
1561
 
1508
1562
 
1563
+ <a name="type-aliasesmoneymd"></a>
1564
+
1565
+ [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
1566
+
1567
+ ***
1568
+
1569
+ [@builtbystack/sq-shopify-theme-sdk](#globalsmd) / Money
1570
+
1571
+ ## Type Alias: Money
1572
+
1573
+ > **Money**: `object`
1574
+
1575
+ Money は金額と通貨コードを表す
1576
+
1577
+ ### Type declaration
1578
+
1579
+ #### amount
1580
+
1581
+ > **amount**: `number`
1582
+
1583
+ amount は金額を表す
1584
+
1585
+ #### currencyCode
1586
+
1587
+ > **currencyCode**: [`CurrencyCode`](#enumerationscurrencycodemd)
1588
+
1589
+ currencyCode は通貨コードを表す
1590
+
1591
+
1509
1592
  <a name="type-aliasespageinfomd"></a>
1510
1593
 
1511
1594
  [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
@@ -2118,6 +2201,184 @@ PurchasingCustomerMetafield は購入者のカスタムメタフィールドを
2118
2201
  > **value**: `string`
2119
2202
 
2120
2203
 
2204
+ <a name="type-aliasespurchasingcustomerretailordermd"></a>
2205
+
2206
+ [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
2207
+
2208
+ ***
2209
+
2210
+ [@builtbystack/sq-shopify-theme-sdk](#globalsmd) / PurchasingCustomerRetailOrder
2211
+
2212
+ ## Type Alias: PurchasingCustomerRetailOrder
2213
+
2214
+ > **PurchasingCustomerRetailOrder**: `object`
2215
+
2216
+ PurchasingCustomerRetailOrder は、顧客の店舗受取注文に関する情報を表す。
2217
+
2218
+ ### Type declaration
2219
+
2220
+ #### cancelledAt
2221
+
2222
+ > **cancelledAt**: `Date` \| `null`
2223
+
2224
+ cancelledAt は注文のキャンセル日時(キャンセルされていない場合はnull)
2225
+
2226
+ #### createdAt
2227
+
2228
+ > **createdAt**: `Date`
2229
+
2230
+ createdAt は注文が作成された日時
2231
+
2232
+ #### currentPointApplicationPrice
2233
+
2234
+ > **currentPointApplicationPrice**: [`Money`](#type-aliasesmoneymd)
2235
+
2236
+ currentPointApplicationPrice は現在の利用ポイント金額
2237
+
2238
+ #### currentSubtotalPrice
2239
+
2240
+ > **currentSubtotalPrice**: [`Money`](#type-aliasesmoneymd)
2241
+
2242
+ currentSubtotalPrice は注文作成時の注文明細の合計金額から商品割引の金額を差し引き返金を考慮した価格
2243
+
2244
+ #### currentTotalQuantity
2245
+
2246
+ > **currentTotalQuantity**: `number`
2247
+
2248
+ currentTotalQuantity は返金を考慮した商品の総数量
2249
+
2250
+ #### currentTotalTaxPrice
2251
+
2252
+ > **currentTotalTaxPrice**: [`Money`](#type-aliasesmoneymd)
2253
+
2254
+ currentTotalTaxPrice は現在の注文の合計税金額
2255
+
2256
+ #### fulfilledAt
2257
+
2258
+ > **fulfilledAt**: `Date` \| `null`
2259
+
2260
+ fulfilledAt は注文の出荷日時(未出荷の場合はnull)
2261
+
2262
+ #### id
2263
+
2264
+ > **id**: `string`
2265
+
2266
+ id は注文の一意識別子
2267
+
2268
+ #### isCancelled
2269
+
2270
+ > **isCancelled**: `boolean`
2271
+
2272
+ isCancelled は注文がキャンセル済みかどうかを表すフラグ
2273
+
2274
+ #### managementCode
2275
+
2276
+ > **managementCode**: `string`
2277
+
2278
+ managementCode は注文の管理コード
2279
+
2280
+ #### paymentStatus
2281
+
2282
+ > **paymentStatus**: `string`
2283
+
2284
+ paymentStatus は注文の決済ステータス
2285
+
2286
+ #### pointApplicationPrice
2287
+
2288
+ > **pointApplicationPrice**: [`Money`](#type-aliasesmoneymd)
2289
+
2290
+ pointApplicationPrice は利用ポイント金額
2291
+
2292
+ #### purchasedAt
2293
+
2294
+ > **purchasedAt**: `Date`
2295
+
2296
+ purchasedAt は注文が購入された日時
2297
+
2298
+ #### retailLocation
2299
+
2300
+ > **retailLocation**: [`RetailLocation`](#type-aliasesretaillocationmd)
2301
+
2302
+ retailLocation はこの注文が発生した店舗ロケーション
2303
+
2304
+ #### source
2305
+
2306
+ > **source**: `string`
2307
+
2308
+ source は注文の発生元
2309
+
2310
+ #### subtotalPrice
2311
+
2312
+ > **subtotalPrice**: [`Money`](#type-aliasesmoneymd)
2313
+
2314
+ subtotalPrice は注文の小計
2315
+
2316
+ #### tags
2317
+
2318
+ > **tags**: `string`[]
2319
+
2320
+ tags は注文に付与されているタグの一覧
2321
+
2322
+ #### totalOrderDiscountPrice
2323
+
2324
+ > **totalOrderDiscountPrice**: [`Money`](#type-aliasesmoneymd)
2325
+
2326
+ totalOrderDiscountPrice は注文レベルと注文明細レベルの割引の合計金額
2327
+
2328
+ #### totalPrice
2329
+
2330
+ > **totalPrice**: [`Money`](#type-aliasesmoneymd)
2331
+
2332
+ totalPrice は注文の合計金額
2333
+
2334
+ #### totalQuantity
2335
+
2336
+ > **totalQuantity**: `number`
2337
+
2338
+ totalQuantity は注文時の注文明細の総数量
2339
+
2340
+ #### totalTaxPrice
2341
+
2342
+ > **totalTaxPrice**: [`Money`](#type-aliasesmoneymd)
2343
+
2344
+ totalTaxPrice は注文作成時の送料明細の税の合計金額
2345
+
2346
+ #### updatedAt
2347
+
2348
+ > **updatedAt**: `Date`
2349
+
2350
+ updatedAt は注文が最後に更新された日時
2351
+
2352
+
2353
+ <a name="type-aliasespurchasingcustomerretailordersmd"></a>
2354
+
2355
+ [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
2356
+
2357
+ ***
2358
+
2359
+ [@builtbystack/sq-shopify-theme-sdk](#globalsmd) / PurchasingCustomerRetailOrders
2360
+
2361
+ ## Type Alias: PurchasingCustomerRetailOrders
2362
+
2363
+ > **PurchasingCustomerRetailOrders**: `object`
2364
+
2365
+ PurchasingCustomerRetailOrders は顧客の店舗受取注文一覧を表す
2366
+
2367
+ ### Type declaration
2368
+
2369
+ #### nodes
2370
+
2371
+ > **nodes**: [`PurchasingCustomerRetailOrder`](#type-aliasespurchasingcustomerretailordermd)[]
2372
+
2373
+ nodes は店舗受取注文の配列
2374
+
2375
+ #### pageInfo
2376
+
2377
+ > **pageInfo**: [`PageInfo`](#type-aliasespageinfomd)
2378
+
2379
+ pageInfo はページネーション情報
2380
+
2381
+
2121
2382
  <a name="type-aliasespurchasingcustomersmsmd"></a>
2122
2383
 
2123
2384
  [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
@@ -2174,6 +2435,41 @@ PurchasingCustomerSMS は、顧客のSMS認証情報を表す。
2174
2435
  > **purchasingCustomers**: [`PurchasingCustomer`](#type-aliasespurchasingcustomermd)[]
2175
2436
 
2176
2437
 
2438
+ <a name="type-aliasesretaillocationmd"></a>
2439
+
2440
+ [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
2441
+
2442
+ ***
2443
+
2444
+ [@builtbystack/sq-shopify-theme-sdk](#globalsmd) / RetailLocation
2445
+
2446
+ ## Type Alias: RetailLocation
2447
+
2448
+ > **RetailLocation**: `object`
2449
+
2450
+ RetailLocation は店舗のロケーション情報を表す。
2451
+
2452
+ ### Type declaration
2453
+
2454
+ #### displayName
2455
+
2456
+ > **displayName**: `string`
2457
+
2458
+ 店舗ロケーションの表示名(顧客向けの名称)
2459
+
2460
+ #### id
2461
+
2462
+ > **id**: `string`
2463
+
2464
+ 店舗ロケーションの一意識別子
2465
+
2466
+ #### name
2467
+
2468
+ > **name**: `string`
2469
+
2470
+ 店舗ロケーションの内部名称
2471
+
2472
+
2177
2473
  <a name="type-aliasestenantmd"></a>
2178
2474
 
2179
2475
  [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
@@ -209,7 +209,7 @@ export declare type LocationAvailability = {
209
209
  };
210
210
 
211
211
  /**
212
- * LocationType はロケーションのフィルタリング条件を表現するオブジェクト
212
+ * LocationType はロケーションのフィルタリング条件
213
213
  */
214
214
  export declare type LocationFilter = {
215
215
  /**
@@ -384,6 +384,20 @@ export declare type Miles = {
384
384
  miles: number;
385
385
  };
386
386
 
387
+ /**
388
+ * Money は金額と通貨コードを表す
389
+ */
390
+ export declare type Money = {
391
+ /**
392
+ * amount は金額を表す
393
+ */
394
+ amount: number;
395
+ /**
396
+ * currencyCode は通貨コードを表す
397
+ */
398
+ currencyCode: CurrencyCode;
399
+ };
400
+
387
401
  /**
388
402
  * PageInfo はページングを伴って一覧を取得したときに、その一覧のページングの情報を表す。
389
403
  */
@@ -662,6 +676,114 @@ export declare type PurchasingCustomerMetafield = {
662
676
  value: string;
663
677
  };
664
678
 
679
+ /**
680
+ * PurchasingCustomerRetailOrder は、顧客の店舗受取注文に関する情報を表す。
681
+ */
682
+ export declare type PurchasingCustomerRetailOrder = {
683
+ /**
684
+ * id は注文の一意識別子
685
+ */
686
+ id: string;
687
+ /**
688
+ * managementCode は注文の管理コード
689
+ */
690
+ managementCode: string;
691
+ /**
692
+ * source は注文の発生元
693
+ */
694
+ source: string;
695
+ /**
696
+ * purchasedAt は注文が購入された日時
697
+ */
698
+ purchasedAt: Date;
699
+ /**
700
+ * fulfilledAt は注文の出荷日時(未出荷の場合はnull)
701
+ */
702
+ fulfilledAt: Date | null;
703
+ /**
704
+ * isCancelled は注文がキャンセル済みかどうかを表すフラグ
705
+ */
706
+ isCancelled: boolean;
707
+ /**
708
+ * cancelledAt は注文のキャンセル日時(キャンセルされていない場合はnull)
709
+ */
710
+ cancelledAt: Date | null;
711
+ /**
712
+ * tags は注文に付与されているタグの一覧
713
+ */
714
+ tags: string[];
715
+ /**
716
+ * paymentStatus は注文の決済ステータス
717
+ */
718
+ paymentStatus: string;
719
+ /**
720
+ * retailLocation はこの注文が発生した店舗ロケーション
721
+ */
722
+ retailLocation: RetailLocation;
723
+ /**
724
+ * totalQuantity は注文時の注文明細の総数量
725
+ */
726
+ totalQuantity: number;
727
+ /**
728
+ * currentTotalQuantity は返金を考慮した商品の総数量
729
+ */
730
+ currentTotalQuantity: number;
731
+ /**
732
+ * pointApplicationPrice は利用ポイント金額
733
+ */
734
+ pointApplicationPrice: Money;
735
+ /**
736
+ * currentPointApplicationPrice は現在の利用ポイント金額
737
+ */
738
+ currentPointApplicationPrice: Money;
739
+ /**
740
+ * totalOrderDiscountPrice は注文レベルと注文明細レベルの割引の合計金額
741
+ */
742
+ totalOrderDiscountPrice: Money;
743
+ /**
744
+ * subtotalPrice は注文の小計
745
+ */
746
+ subtotalPrice: Money;
747
+ /**
748
+ * totalTaxPrice は注文作成時の送料明細の税の合計金額
749
+ */
750
+ totalTaxPrice: Money;
751
+ /**
752
+ * currentTotalTaxPrice は現在の注文の合計税金額
753
+ */
754
+ currentTotalTaxPrice: Money;
755
+ /**
756
+ * currentSubtotalPrice は注文作成時の注文明細の合計金額から商品割引の金額を差し引き返金を考慮した価格
757
+ */
758
+ currentSubtotalPrice: Money;
759
+ /**
760
+ * totalPrice は注文の合計金額
761
+ */
762
+ totalPrice: Money;
763
+ /**
764
+ * createdAt は注文が作成された日時
765
+ */
766
+ createdAt: Date;
767
+ /**
768
+ * updatedAt は注文が最後に更新された日時
769
+ */
770
+ updatedAt: Date;
771
+ };
772
+
773
+ /**
774
+ * PurchasingCustomerRetailOrders は顧客の店舗受取注文一覧を表す
775
+ */
776
+ export declare type PurchasingCustomerRetailOrders = {
777
+ /**
778
+ * nodes は店舗受取注文の配列
779
+ */
780
+ nodes: PurchasingCustomerRetailOrder[];
781
+ /**
782
+ * pageInfo はページネーション情報
783
+ */
784
+ pageInfo: PageInfo;
785
+ };
786
+
665
787
  export declare type PurchasingCustomerSharing = {
666
788
  id: string;
667
789
  purchasingCustomers: PurchasingCustomer[];
@@ -682,6 +804,30 @@ export declare type PurchasingCustomerSMS = {
682
804
  smsVerifiedPhone: string;
683
805
  };
684
806
 
807
+ /**
808
+ * RetailLocation は店舗のロケーション情報を表す。
809
+ */
810
+ export declare type RetailLocation = {
811
+ /**
812
+ * 店舗ロケーションの一意識別子
813
+ */
814
+ id: string;
815
+ /**
816
+ * 店舗ロケーションの内部名称
817
+ */
818
+ name: string;
819
+ /**
820
+ * 店舗ロケーションの表示名(顧客向けの名称)
821
+ */
822
+ displayName: string;
823
+ };
824
+
825
+ /** 実店舗での注文のソート順を表す列挙型 */
826
+ declare enum RetailOrderSortKey {
827
+ CreatedAt = "CREATED_AT",
828
+ PurchasedAt = "PURCHASED_AT"
829
+ }
830
+
685
831
  export declare class SDK {
686
832
  private api;
687
833
  constructor(apiURL: string);
@@ -808,6 +954,15 @@ export declare class SDK {
808
954
  * getPurchasingCustomerSMS は顧客のSMS認証情報を返します。
809
955
  */
810
956
  getPurchasingCustomerSMS(): Promise<PurchasingCustomerSMS | null>;
957
+ /**
958
+ * getPurchasingCustomerRetailOrders は顧客の店舗受取注文一覧を取得します。
959
+ * @param first 取得する注文数の上限
960
+ * @param after ページネーション用のカーソル
961
+ * @param isReverse 並び順を逆にするかどうか
962
+ * @param sortKeys ソートキー
963
+ * @returns 顧客の店舗受取注文一覧、または顧客が存在しない場合はnull
964
+ */
965
+ getPurchasingCustomerRetailOrders(first?: number, after?: string, isReverse?: boolean, sortKeys?: RetailOrderSortKey): Promise<PurchasingCustomerRetailOrders | null>;
811
966
  /**
812
967
  * mileItemExchange は指定したマイル商品を交換します。
813
968
  *
@@ -827,6 +982,15 @@ export declare class SDK {
827
982
  * @param {string} verificationCode SMS認証用コード
828
983
  */
829
984
  purchasingCustomerVerifySMS(phone: string, verificationCode: string): Promise<PurchasingCustomerSMS | null>;
985
+ /**
986
+ * DiscountUsageCreate は指定した注文価格調整の利用履歴を作成します。
987
+ *
988
+ * @param {string} orderPriceAdjustmentRuleID 利用する注文価格調整ルールのID
989
+ */
990
+ DiscountUsageCreate(orderPriceAdjustmentRuleID: string): Promise<{
991
+ __typename?: "OrderPriceAdjustmentRule";
992
+ id: string;
993
+ } | null>;
830
994
  }
831
995
 
832
996
  declare enum ShopifyMileItemSortKey {