@builtbystack/sq-shopify-theme-sdk 0.0.34 → 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
@@ -457,6 +457,38 @@ getPurchasingCustomerMetafield は渡されたnamespaceとkeyに一致する現
457
457
 
458
458
  ***
459
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
+
460
492
  #### getPurchasingCustomerSMS()
461
493
 
462
494
  > **getPurchasingCustomerSMS**(): `Promise`\<`null` \| [`PurchasingCustomerSMS`](#type-aliasespurchasingcustomersmsmd)\>
@@ -684,6 +716,7 @@ LocationType はロケーションの種別を表す
684
716
  - [MileOrder](#type-aliasesmileordermd)
685
717
  - [MileOrders](#type-aliasesmileordersmd)
686
718
  - [Miles](#type-aliasesmilesmd)
719
+ - [Money](#type-aliasesmoneymd)
687
720
  - [PageInfo](#type-aliasespageinfomd)
688
721
  - [PointCampaignOrderRule](#type-aliasespointcampaignorderrulemd)
689
722
  - [PointCampaignOrderRuleTargetCustomerRank](#type-aliasespointcampaignorderruletargetcustomerrankmd)
@@ -699,8 +732,11 @@ LocationType はロケーションの種別を表す
699
732
  - [PurchasingCustomerDiscount](#type-aliasespurchasingcustomerdiscountmd)
700
733
  - [PurchasingCustomerDiscounts](#type-aliasespurchasingcustomerdiscountsmd)
701
734
  - [PurchasingCustomerMetafield](#type-aliasespurchasingcustomermetafieldmd)
735
+ - [PurchasingCustomerRetailOrder](#type-aliasespurchasingcustomerretailordermd)
736
+ - [PurchasingCustomerRetailOrders](#type-aliasespurchasingcustomerretailordersmd)
702
737
  - [PurchasingCustomerSMS](#type-aliasespurchasingcustomersmsmd)
703
738
  - [PurchasingCustomerSharing](#type-aliasespurchasingcustomersharingmd)
739
+ - [RetailLocation](#type-aliasesretaillocationmd)
704
740
  - [Tenant](#type-aliasestenantmd)
705
741
 
706
742
  # Type Aliases
@@ -1188,7 +1224,7 @@ location は在庫のLocationを表す。
1188
1224
 
1189
1225
  > **LocationFilter**: `object`
1190
1226
 
1191
- LocationType はロケーションのフィルタリング条件を表現するオブジェクト
1227
+ LocationType はロケーションのフィルタリング条件
1192
1228
 
1193
1229
  ### Type declaration
1194
1230
 
@@ -1524,6 +1560,35 @@ Miles は SDK から取得できるマイルの情報を表す。
1524
1560
  Miles は保有マイルを表す。
1525
1561
 
1526
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
+
1527
1592
  <a name="type-aliasespageinfomd"></a>
1528
1593
 
1529
1594
  [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
@@ -2136,6 +2201,184 @@ PurchasingCustomerMetafield は購入者のカスタムメタフィールドを
2136
2201
  > **value**: `string`
2137
2202
 
2138
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
+
2139
2382
  <a name="type-aliasespurchasingcustomersmsmd"></a>
2140
2383
 
2141
2384
  [**@builtbystack/sq-shopify-theme-sdk**](#readmemd) • **Docs**
@@ -2192,6 +2435,41 @@ PurchasingCustomerSMS は、顧客のSMS認証情報を表す。
2192
2435
  > **purchasingCustomers**: [`PurchasingCustomer`](#type-aliasespurchasingcustomermd)[]
2193
2436
 
2194
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
+
2195
2473
  <a name="type-aliasestenantmd"></a>
2196
2474
 
2197
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
  *