@builtbystack/sq-shopify-theme-sdk 0.0.34 → 0.0.37

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
@@ -384,6 +384,18 @@ getPoints は、Points は SDK から取得できるポイントの情報を返
384
384
 
385
385
  ***
386
386
 
387
+ #### getPurchasingCustomerBarcode()
388
+
389
+ > **getPurchasingCustomerBarcode**(): `Promise`\<`null` \| [`PurchasingCustomerBarcode`](#type-aliasespurchasingcustomerbarcodemd)\>
390
+
391
+ getPurchasingCustomerBarcode は顧客の会員証バーコード情報を返します。
392
+
393
+ ##### Returns
394
+
395
+ `Promise`\<`null` \| [`PurchasingCustomerBarcode`](#type-aliasespurchasingcustomerbarcodemd)\>
396
+
397
+ ***
398
+
387
399
  #### getPurchasingCustomerCurrentRank()
388
400
 
389
401
  > **getPurchasingCustomerCurrentRank**(): `Promise`\<`null` \| [`CustomerRank`](#type-aliasescustomerrankmd)\>
@@ -457,6 +469,38 @@ getPurchasingCustomerMetafield は渡されたnamespaceとkeyに一致する現
457
469
 
458
470
  ***
459
471
 
472
+ #### getPurchasingCustomerRetailOrders()
473
+
474
+ > **getPurchasingCustomerRetailOrders**(`first`?, `after`?, `isReverse`?, `sortKeys`?): `Promise`\<`null` \| [`PurchasingCustomerRetailOrders`](#type-aliasespurchasingcustomerretailordersmd)\>
475
+
476
+ getPurchasingCustomerRetailOrders は顧客の店舗受取注文一覧を取得します。
477
+
478
+ ##### Parameters
479
+
480
+ • **first?**: `number`
481
+
482
+ 取得する注文数の上限
483
+
484
+ • **after?**: `string`
485
+
486
+ ページネーション用のカーソル
487
+
488
+ • **isReverse?**: `boolean`
489
+
490
+ 並び順を逆にするかどうか
491
+
492
+ • **sortKeys?**: `RetailOrderSortKey`
493
+
494
+ ソートキー
495
+
496
+ ##### Returns
497
+
498
+ `Promise`\<`null` \| [`PurchasingCustomerRetailOrders`](#type-aliasespurchasingcustomerretailordersmd)\>
499
+
500
+ 顧客の店舗受取注文一覧、または顧客が存在しない場合はnull
501
+
502
+ ***
503
+
460
504
  #### getPurchasingCustomerSMS()
461
505
 
462
506
  > **getPurchasingCustomerSMS**(): `Promise`\<`null` \| [`PurchasingCustomerSMS`](#type-aliasespurchasingcustomersmsmd)\>
@@ -684,6 +728,7 @@ LocationType はロケーションの種別を表す
684
728
  - [MileOrder](#type-aliasesmileordermd)
685
729
  - [MileOrders](#type-aliasesmileordersmd)
686
730
  - [Miles](#type-aliasesmilesmd)
731
+ - [Money](#type-aliasesmoneymd)
687
732
  - [PageInfo](#type-aliasespageinfomd)
688
733
  - [PointCampaignOrderRule](#type-aliasespointcampaignorderrulemd)
689
734
  - [PointCampaignOrderRuleTargetCustomerRank](#type-aliasespointcampaignorderruletargetcustomerrankmd)
@@ -696,11 +741,15 @@ LocationType はロケーションの種別を表す
696
741
  - [ProductVariant](#type-aliasesproductvariantmd)
697
742
  - [ProductVariants](#type-aliasesproductvariantsmd)
698
743
  - [PurchasingCustomer](#type-aliasespurchasingcustomermd)
744
+ - [PurchasingCustomerBarcode](#type-aliasespurchasingcustomerbarcodemd)
699
745
  - [PurchasingCustomerDiscount](#type-aliasespurchasingcustomerdiscountmd)
700
746
  - [PurchasingCustomerDiscounts](#type-aliasespurchasingcustomerdiscountsmd)
701
747
  - [PurchasingCustomerMetafield](#type-aliasespurchasingcustomermetafieldmd)
748
+ - [PurchasingCustomerRetailOrder](#type-aliasespurchasingcustomerretailordermd)
749
+ - [PurchasingCustomerRetailOrders](#type-aliasespurchasingcustomerretailordersmd)
702
750
  - [PurchasingCustomerSMS](#type-aliasespurchasingcustomersmsmd)
703
751
  - [PurchasingCustomerSharing](#type-aliasespurchasingcustomersharingmd)
752
+ - [RetailLocation](#type-aliasesretaillocationmd)
704
753
  - [Tenant](#type-aliasestenantmd)
705
754
 
706
755
  # Type Aliases
@@ -1188,7 +1237,7 @@ location は在庫のLocationを表す。
1188
1237
 
1189
1238
  > **LocationFilter**: `object`
1190
1239
 
1191
- LocationType はロケーションのフィルタリング条件を表現するオブジェクト
1240
+ LocationType はロケーションのフィルタリング条件
1192
1241
 
1193
1242
  ### Type declaration
1194
1243
 
@@ -1524,6 +1573,35 @@ Miles は SDK から取得できるマイルの情報を表す。
1524
1573
  Miles は保有マイルを表す。
1525
1574
 
1526
1575
 
1576
+ <a name="type-aliasesmoneymd"></a>
1577
+
1578
+ [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
1579
+
1580
+ ***
1581
+
1582
+ [@builtbystack/sq-shopify-theme-sdk](#globalsmd) / Money
1583
+
1584
+ ## Type Alias: Money
1585
+
1586
+ > **Money**: `object`
1587
+
1588
+ Money は金額と通貨コードを表す
1589
+
1590
+ ### Type declaration
1591
+
1592
+ #### amount
1593
+
1594
+ > **amount**: `number`
1595
+
1596
+ amount は金額を表す
1597
+
1598
+ #### currencyCode
1599
+
1600
+ > **currencyCode**: [`CurrencyCode`](#enumerationscurrencycodemd)
1601
+
1602
+ currencyCode は通貨コードを表す
1603
+
1604
+
1527
1605
  <a name="type-aliasespageinfomd"></a>
1528
1606
 
1529
1607
  [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
@@ -2001,6 +2079,33 @@ ProductVariants は商品のバリエーションの一覧を取得するため
2001
2079
  > **tenant**: [`Tenant`](#type-aliasestenantmd)
2002
2080
 
2003
2081
 
2082
+ <a name="type-aliasespurchasingcustomerbarcodemd"></a>
2083
+
2084
+ [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
2085
+
2086
+ ***
2087
+
2088
+ [@builtbystack/sq-shopify-theme-sdk](#globalsmd) / PurchasingCustomerBarcode
2089
+
2090
+ ## Type Alias: PurchasingCustomerBarcode
2091
+
2092
+ > **PurchasingCustomerBarcode**: `object`
2093
+
2094
+ PurchasingCustomerBarcode は、顧客の会員証バーコード情報を表す。
2095
+
2096
+ ### Type declaration
2097
+
2098
+ #### barcode
2099
+
2100
+ > **barcode**: `string`
2101
+
2102
+ 顧客の会員証バーコード
2103
+
2104
+ #### id
2105
+
2106
+ > **id**: `string`
2107
+
2108
+
2004
2109
  <a name="type-aliasespurchasingcustomerdiscountmd"></a>
2005
2110
 
2006
2111
  [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
@@ -2136,6 +2241,184 @@ PurchasingCustomerMetafield は購入者のカスタムメタフィールドを
2136
2241
  > **value**: `string`
2137
2242
 
2138
2243
 
2244
+ <a name="type-aliasespurchasingcustomerretailordermd"></a>
2245
+
2246
+ [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
2247
+
2248
+ ***
2249
+
2250
+ [@builtbystack/sq-shopify-theme-sdk](#globalsmd) / PurchasingCustomerRetailOrder
2251
+
2252
+ ## Type Alias: PurchasingCustomerRetailOrder
2253
+
2254
+ > **PurchasingCustomerRetailOrder**: `object`
2255
+
2256
+ PurchasingCustomerRetailOrder は、顧客の店舗受取注文に関する情報を表す。
2257
+
2258
+ ### Type declaration
2259
+
2260
+ #### cancelledAt
2261
+
2262
+ > **cancelledAt**: `Date` \| `null`
2263
+
2264
+ cancelledAt は注文のキャンセル日時(キャンセルされていない場合はnull)
2265
+
2266
+ #### createdAt
2267
+
2268
+ > **createdAt**: `Date`
2269
+
2270
+ createdAt は注文が作成された日時
2271
+
2272
+ #### currentPointApplicationPrice
2273
+
2274
+ > **currentPointApplicationPrice**: [`Money`](#type-aliasesmoneymd)
2275
+
2276
+ currentPointApplicationPrice は現在の利用ポイント金額
2277
+
2278
+ #### currentSubtotalPrice
2279
+
2280
+ > **currentSubtotalPrice**: [`Money`](#type-aliasesmoneymd)
2281
+
2282
+ currentSubtotalPrice は注文作成時の注文明細の合計金額から商品割引の金額を差し引き返金を考慮した価格
2283
+
2284
+ #### currentTotalQuantity
2285
+
2286
+ > **currentTotalQuantity**: `number`
2287
+
2288
+ currentTotalQuantity は返金を考慮した商品の総数量
2289
+
2290
+ #### currentTotalTaxPrice
2291
+
2292
+ > **currentTotalTaxPrice**: [`Money`](#type-aliasesmoneymd)
2293
+
2294
+ currentTotalTaxPrice は現在の注文の合計税金額
2295
+
2296
+ #### fulfilledAt
2297
+
2298
+ > **fulfilledAt**: `Date` \| `null`
2299
+
2300
+ fulfilledAt は注文の出荷日時(未出荷の場合はnull)
2301
+
2302
+ #### id
2303
+
2304
+ > **id**: `string`
2305
+
2306
+ id は注文の一意識別子
2307
+
2308
+ #### isCancelled
2309
+
2310
+ > **isCancelled**: `boolean`
2311
+
2312
+ isCancelled は注文がキャンセル済みかどうかを表すフラグ
2313
+
2314
+ #### managementCode
2315
+
2316
+ > **managementCode**: `string`
2317
+
2318
+ managementCode は注文の管理コード
2319
+
2320
+ #### paymentStatus
2321
+
2322
+ > **paymentStatus**: `string`
2323
+
2324
+ paymentStatus は注文の決済ステータス
2325
+
2326
+ #### pointApplicationPrice
2327
+
2328
+ > **pointApplicationPrice**: [`Money`](#type-aliasesmoneymd)
2329
+
2330
+ pointApplicationPrice は利用ポイント金額
2331
+
2332
+ #### purchasedAt
2333
+
2334
+ > **purchasedAt**: `Date`
2335
+
2336
+ purchasedAt は注文が購入された日時
2337
+
2338
+ #### retailLocation
2339
+
2340
+ > **retailLocation**: [`RetailLocation`](#type-aliasesretaillocationmd)
2341
+
2342
+ retailLocation はこの注文が発生した店舗ロケーション
2343
+
2344
+ #### source
2345
+
2346
+ > **source**: `string`
2347
+
2348
+ source は注文の発生元
2349
+
2350
+ #### subtotalPrice
2351
+
2352
+ > **subtotalPrice**: [`Money`](#type-aliasesmoneymd)
2353
+
2354
+ subtotalPrice は注文の小計
2355
+
2356
+ #### tags
2357
+
2358
+ > **tags**: `string`[]
2359
+
2360
+ tags は注文に付与されているタグの一覧
2361
+
2362
+ #### totalOrderDiscountPrice
2363
+
2364
+ > **totalOrderDiscountPrice**: [`Money`](#type-aliasesmoneymd)
2365
+
2366
+ totalOrderDiscountPrice は注文レベルと注文明細レベルの割引の合計金額
2367
+
2368
+ #### totalPrice
2369
+
2370
+ > **totalPrice**: [`Money`](#type-aliasesmoneymd)
2371
+
2372
+ totalPrice は注文の合計金額
2373
+
2374
+ #### totalQuantity
2375
+
2376
+ > **totalQuantity**: `number`
2377
+
2378
+ totalQuantity は注文時の注文明細の総数量
2379
+
2380
+ #### totalTaxPrice
2381
+
2382
+ > **totalTaxPrice**: [`Money`](#type-aliasesmoneymd)
2383
+
2384
+ totalTaxPrice は注文作成時の送料明細の税の合計金額
2385
+
2386
+ #### updatedAt
2387
+
2388
+ > **updatedAt**: `Date`
2389
+
2390
+ updatedAt は注文が最後に更新された日時
2391
+
2392
+
2393
+ <a name="type-aliasespurchasingcustomerretailordersmd"></a>
2394
+
2395
+ [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
2396
+
2397
+ ***
2398
+
2399
+ [@builtbystack/sq-shopify-theme-sdk](#globalsmd) / PurchasingCustomerRetailOrders
2400
+
2401
+ ## Type Alias: PurchasingCustomerRetailOrders
2402
+
2403
+ > **PurchasingCustomerRetailOrders**: `object`
2404
+
2405
+ PurchasingCustomerRetailOrders は顧客の店舗受取注文一覧を表す
2406
+
2407
+ ### Type declaration
2408
+
2409
+ #### nodes
2410
+
2411
+ > **nodes**: [`PurchasingCustomerRetailOrder`](#type-aliasespurchasingcustomerretailordermd)[]
2412
+
2413
+ nodes は店舗受取注文の配列
2414
+
2415
+ #### pageInfo
2416
+
2417
+ > **pageInfo**: [`PageInfo`](#type-aliasespageinfomd)
2418
+
2419
+ pageInfo はページネーション情報
2420
+
2421
+
2139
2422
  <a name="type-aliasespurchasingcustomersmsmd"></a>
2140
2423
 
2141
2424
  [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
@@ -2192,6 +2475,41 @@ PurchasingCustomerSMS は、顧客のSMS認証情報を表す。
2192
2475
  > **purchasingCustomers**: [`PurchasingCustomer`](#type-aliasespurchasingcustomermd)[]
2193
2476
 
2194
2477
 
2478
+ <a name="type-aliasesretaillocationmd"></a>
2479
+
2480
+ [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
2481
+
2482
+ ***
2483
+
2484
+ [@builtbystack/sq-shopify-theme-sdk](#globalsmd) / RetailLocation
2485
+
2486
+ ## Type Alias: RetailLocation
2487
+
2488
+ > **RetailLocation**: `object`
2489
+
2490
+ RetailLocation は店舗のロケーション情報を表す。
2491
+
2492
+ ### Type declaration
2493
+
2494
+ #### displayName
2495
+
2496
+ > **displayName**: `string`
2497
+
2498
+ 店舗ロケーションの表示名(顧客向けの名称)
2499
+
2500
+ #### id
2501
+
2502
+ > **id**: `string`
2503
+
2504
+ 店舗ロケーションの一意識別子
2505
+
2506
+ #### name
2507
+
2508
+ > **name**: `string`
2509
+
2510
+ 店舗ロケーションの内部名称
2511
+
2512
+
2195
2513
  <a name="type-aliasestenantmd"></a>
2196
2514
 
2197
2515
  [**@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
  */
@@ -618,6 +632,17 @@ export declare type PurchasingCustomer = {
618
632
  tenant: Tenant;
619
633
  };
620
634
 
635
+ /**
636
+ * PurchasingCustomerBarcode は、顧客の会員証バーコード情報を表す。
637
+ */
638
+ export declare type PurchasingCustomerBarcode = {
639
+ id: string;
640
+ /**
641
+ * 顧客の会員証バーコード
642
+ */
643
+ barcode: string;
644
+ };
645
+
621
646
  /**
622
647
  * PurchasingCustomerDiscount は購入者の割引情報を表す。
623
648
  */
@@ -662,6 +687,114 @@ export declare type PurchasingCustomerMetafield = {
662
687
  value: string;
663
688
  };
664
689
 
690
+ /**
691
+ * PurchasingCustomerRetailOrder は、顧客の店舗受取注文に関する情報を表す。
692
+ */
693
+ export declare type PurchasingCustomerRetailOrder = {
694
+ /**
695
+ * id は注文の一意識別子
696
+ */
697
+ id: string;
698
+ /**
699
+ * managementCode は注文の管理コード
700
+ */
701
+ managementCode: string;
702
+ /**
703
+ * source は注文の発生元
704
+ */
705
+ source: string;
706
+ /**
707
+ * purchasedAt は注文が購入された日時
708
+ */
709
+ purchasedAt: Date;
710
+ /**
711
+ * fulfilledAt は注文の出荷日時(未出荷の場合はnull)
712
+ */
713
+ fulfilledAt: Date | null;
714
+ /**
715
+ * isCancelled は注文がキャンセル済みかどうかを表すフラグ
716
+ */
717
+ isCancelled: boolean;
718
+ /**
719
+ * cancelledAt は注文のキャンセル日時(キャンセルされていない場合はnull)
720
+ */
721
+ cancelledAt: Date | null;
722
+ /**
723
+ * tags は注文に付与されているタグの一覧
724
+ */
725
+ tags: string[];
726
+ /**
727
+ * paymentStatus は注文の決済ステータス
728
+ */
729
+ paymentStatus: string;
730
+ /**
731
+ * retailLocation はこの注文が発生した店舗ロケーション
732
+ */
733
+ retailLocation: RetailLocation;
734
+ /**
735
+ * totalQuantity は注文時の注文明細の総数量
736
+ */
737
+ totalQuantity: number;
738
+ /**
739
+ * currentTotalQuantity は返金を考慮した商品の総数量
740
+ */
741
+ currentTotalQuantity: number;
742
+ /**
743
+ * pointApplicationPrice は利用ポイント金額
744
+ */
745
+ pointApplicationPrice: Money;
746
+ /**
747
+ * currentPointApplicationPrice は現在の利用ポイント金額
748
+ */
749
+ currentPointApplicationPrice: Money;
750
+ /**
751
+ * totalOrderDiscountPrice は注文レベルと注文明細レベルの割引の合計金額
752
+ */
753
+ totalOrderDiscountPrice: Money;
754
+ /**
755
+ * subtotalPrice は注文の小計
756
+ */
757
+ subtotalPrice: Money;
758
+ /**
759
+ * totalTaxPrice は注文作成時の送料明細の税の合計金額
760
+ */
761
+ totalTaxPrice: Money;
762
+ /**
763
+ * currentTotalTaxPrice は現在の注文の合計税金額
764
+ */
765
+ currentTotalTaxPrice: Money;
766
+ /**
767
+ * currentSubtotalPrice は注文作成時の注文明細の合計金額から商品割引の金額を差し引き返金を考慮した価格
768
+ */
769
+ currentSubtotalPrice: Money;
770
+ /**
771
+ * totalPrice は注文の合計金額
772
+ */
773
+ totalPrice: Money;
774
+ /**
775
+ * createdAt は注文が作成された日時
776
+ */
777
+ createdAt: Date;
778
+ /**
779
+ * updatedAt は注文が最後に更新された日時
780
+ */
781
+ updatedAt: Date;
782
+ };
783
+
784
+ /**
785
+ * PurchasingCustomerRetailOrders は顧客の店舗受取注文一覧を表す
786
+ */
787
+ export declare type PurchasingCustomerRetailOrders = {
788
+ /**
789
+ * nodes は店舗受取注文の配列
790
+ */
791
+ nodes: PurchasingCustomerRetailOrder[];
792
+ /**
793
+ * pageInfo はページネーション情報
794
+ */
795
+ pageInfo: PageInfo;
796
+ };
797
+
665
798
  export declare type PurchasingCustomerSharing = {
666
799
  id: string;
667
800
  purchasingCustomers: PurchasingCustomer[];
@@ -682,6 +815,30 @@ export declare type PurchasingCustomerSMS = {
682
815
  smsVerifiedPhone: string;
683
816
  };
684
817
 
818
+ /**
819
+ * RetailLocation は店舗のロケーション情報を表す。
820
+ */
821
+ export declare type RetailLocation = {
822
+ /**
823
+ * 店舗ロケーションの一意識別子
824
+ */
825
+ id: string;
826
+ /**
827
+ * 店舗ロケーションの内部名称
828
+ */
829
+ name: string;
830
+ /**
831
+ * 店舗ロケーションの表示名(顧客向けの名称)
832
+ */
833
+ displayName: string;
834
+ };
835
+
836
+ /** 実店舗での注文のソート順を表す列挙型 */
837
+ declare enum RetailOrderSortKey {
838
+ CreatedAt = "CREATED_AT",
839
+ PurchasedAt = "PURCHASED_AT"
840
+ }
841
+
685
842
  export declare class SDK {
686
843
  private api;
687
844
  constructor(apiURL: string);
@@ -808,6 +965,19 @@ export declare class SDK {
808
965
  * getPurchasingCustomerSMS は顧客のSMS認証情報を返します。
809
966
  */
810
967
  getPurchasingCustomerSMS(): Promise<PurchasingCustomerSMS | null>;
968
+ /**
969
+ * getPurchasingCustomerBarcode は顧客の会員証バーコード情報を返します。
970
+ */
971
+ getPurchasingCustomerBarcode(): Promise<PurchasingCustomerBarcode | null>;
972
+ /**
973
+ * getPurchasingCustomerRetailOrders は顧客の店舗受取注文一覧を取得します。
974
+ * @param first 取得する注文数の上限
975
+ * @param after ページネーション用のカーソル
976
+ * @param isReverse 並び順を逆にするかどうか
977
+ * @param sortKeys ソートキー
978
+ * @returns 顧客の店舗受取注文一覧、または顧客が存在しない場合はnull
979
+ */
980
+ getPurchasingCustomerRetailOrders(first?: number, after?: string, isReverse?: boolean, sortKeys?: RetailOrderSortKey): Promise<PurchasingCustomerRetailOrders | null>;
811
981
  /**
812
982
  * mileItemExchange は指定したマイル商品を交換します。
813
983
  *