ultracart_api 3.11.14 → 3.11.16

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.
Files changed (39) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +27 -5
  3. data/docs/CartUpsellAfter.md +3 -1
  4. data/docs/ConversationVirtualAgentCapabilities.md +2 -0
  5. data/docs/CustomReport.md +17 -0
  6. data/docs/CustomReportAccountConfig.md +16 -0
  7. data/docs/CustomReportAccountConfigResponse.md +12 -0
  8. data/docs/CustomReportExecutionParameter.md +10 -0
  9. data/docs/CustomReportExecutionRequest.md +8 -0
  10. data/docs/CustomReportParameter.md +13 -0
  11. data/docs/CustomReportParameterOption.md +9 -0
  12. data/docs/CustomReportQuery.md +13 -0
  13. data/docs/CustomReportResponse.md +12 -0
  14. data/docs/CustomReportTooltip.md +9 -0
  15. data/docs/CustomReportsResponse.md +12 -0
  16. data/docs/DatawarehouseApi.md +403 -0
  17. data/docs/Item.md +1 -1
  18. data/docs/OrderApi.md +98 -65
  19. data/docs/WebhookApi.md +0 -16
  20. data/lib/ultracart_api/api/datawarehouse_api.rb +439 -0
  21. data/lib/ultracart_api/api/order_api.rb +111 -82
  22. data/lib/ultracart_api/api/webhook_api.rb +0 -24
  23. data/lib/ultracart_api/models/cart_upsell_after.rb +25 -5
  24. data/lib/ultracart_api/models/conversation_virtual_agent_capabilities.rb +55 -1
  25. data/lib/ultracart_api/models/custom_report.rb +271 -0
  26. data/lib/ultracart_api/models/custom_report_account_config.rb +261 -0
  27. data/lib/ultracart_api/models/custom_report_account_config_response.rb +221 -0
  28. data/lib/ultracart_api/models/custom_report_execution_parameter.rb +202 -0
  29. data/lib/ultracart_api/models/custom_report_execution_request.rb +186 -0
  30. data/lib/ultracart_api/models/custom_report_parameter.rb +231 -0
  31. data/lib/ultracart_api/models/custom_report_parameter_option.rb +193 -0
  32. data/lib/ultracart_api/models/custom_report_query.rb +231 -0
  33. data/lib/ultracart_api/models/custom_report_response.rb +221 -0
  34. data/lib/ultracart_api/models/custom_report_tooltip.rb +193 -0
  35. data/lib/ultracart_api/models/custom_reports_response.rb +224 -0
  36. data/lib/ultracart_api/models/item.rb +1 -1
  37. data/lib/ultracart_api/version.rb +1 -1
  38. data/lib/ultracart_api.rb +11 -0
  39. metadata +24 -2
@@ -4,18 +4,75 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
4
4
 
5
5
  Method | HTTP request | Description
6
6
  ------------- | ------------- | -------------
7
+ [**delete_custom_report**](DatawarehouseApi.md#delete_custom_report) | **DELETE** /datawarehouse/custom_reports/{custom_report_oid} | Delete a custom report
7
8
  [**delete_report**](DatawarehouseApi.md#delete_report) | **DELETE** /datawarehouse/reports/{report_oid} | Delete a report
8
9
  [**dry_run_report_queries**](DatawarehouseApi.md#dry_run_report_queries) | **PUT** /datawarehouse/reports/dryrun | Dry run the report queries
10
+ [**execute_custom_report**](DatawarehouseApi.md#execute_custom_report) | **PUT** /datawarehouse/custom_reports/{custom_report_oid}/execute | Execute a custom report
9
11
  [**execute_report_queries**](DatawarehouseApi.md#execute_report_queries) | **PUT** /datawarehouse/reports/execute | Execute the report queries
12
+ [**get_custom_report**](DatawarehouseApi.md#get_custom_report) | **GET** /datawarehouse/custom_reports/{custom_report_oid} | Get a custom report
13
+ [**get_custom_report_account_config**](DatawarehouseApi.md#get_custom_report_account_config) | **GET** /datawarehouse/custom_reports/account_config | Get custom report account configuration
14
+ [**get_custom_reports**](DatawarehouseApi.md#get_custom_reports) | **GET** /datawarehouse/custom_reports | Get custom reports
10
15
  [**get_report**](DatawarehouseApi.md#get_report) | **GET** /datawarehouse/reports/{report_oid} | Get a report
11
16
  [**get_report_data_set**](DatawarehouseApi.md#get_report_data_set) | **GET** /datawarehouse/reports/dataset/{dataset_uuid} | Get a report data set
12
17
  [**get_report_data_set_page**](DatawarehouseApi.md#get_report_data_set_page) | **GET** /datawarehouse/reports/dataset/{dataset_uuid}/pages/{page_number} | Get a report data set page
13
18
  [**get_report_websocket_authorization**](DatawarehouseApi.md#get_report_websocket_authorization) | **PUT** /datawarehouse/reports/auth | Get report websocket authorization
14
19
  [**get_reports**](DatawarehouseApi.md#get_reports) | **GET** /datawarehouse/reports | Get list of reports available
20
+ [**insert_custom_report**](DatawarehouseApi.md#insert_custom_report) | **POST** /datawarehouse/custom_reports | Create a custom report
15
21
  [**insert_report**](DatawarehouseApi.md#insert_report) | **POST** /datawarehouse/reports | Create a report
22
+ [**update_custom_report**](DatawarehouseApi.md#update_custom_report) | **PUT** /datawarehouse/custom_reports/{custom_report_oid} | Update a custom report
23
+ [**update_custom_report_account_config**](DatawarehouseApi.md#update_custom_report_account_config) | **PUT** /datawarehouse/custom_reports/account_config | Update custom report account config
16
24
  [**update_report**](DatawarehouseApi.md#update_report) | **PUT** /datawarehouse/reports/{report_oid} | Update a report
17
25
 
18
26
 
27
+ # **delete_custom_report**
28
+ > delete_custom_report(custom_report_oid)
29
+
30
+ Delete a custom report
31
+
32
+ Delete a custom report on the UltraCart account.
33
+
34
+ ### Example
35
+ ```ruby
36
+ # load the gem
37
+ require 'ultracart_api'
38
+
39
+ # Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
40
+ simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
41
+ api_instance = UltracartClient::DatawarehouseApi.new_using_api_key(simple_key, false, false)
42
+
43
+
44
+ custom_report_oid = 56 # Integer | The report oid to delete.
45
+
46
+
47
+ begin
48
+ #Delete a custom report
49
+ api_instance.delete_custom_report(custom_report_oid)
50
+ rescue UltracartClient::ApiError => e
51
+ puts "Exception when calling DatawarehouseApi->delete_custom_report: #{e}"
52
+ end
53
+ ```
54
+
55
+ ### Parameters
56
+
57
+ Name | Type | Description | Notes
58
+ ------------- | ------------- | ------------- | -------------
59
+ **custom_report_oid** | **Integer**| The report oid to delete. |
60
+
61
+ ### Return type
62
+
63
+ nil (empty response body)
64
+
65
+ ### Authorization
66
+
67
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
68
+
69
+ ### HTTP request headers
70
+
71
+ - **Content-Type**: application/json
72
+ - **Accept**: application/json
73
+
74
+
75
+
19
76
  # **delete_report**
20
77
  > delete_report(report_oid)
21
78
 
@@ -115,6 +172,59 @@ Name | Type | Description | Notes
115
172
 
116
173
 
117
174
 
175
+ # **execute_custom_report**
176
+ > CustomReportResponse execute_custom_report(execution_request, custom_report_oid)
177
+
178
+ Execute a custom report
179
+
180
+ Execute a custom report on the UltraCart account.
181
+
182
+ ### Example
183
+ ```ruby
184
+ # load the gem
185
+ require 'ultracart_api'
186
+
187
+ # Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
188
+ simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
189
+ api_instance = UltracartClient::DatawarehouseApi.new_using_api_key(simple_key, false, false)
190
+
191
+
192
+ execution_request = UltracartClient::CustomReportExecutionRequest.new # CustomReportExecutionRequest | Request to execute custom report
193
+
194
+ custom_report_oid = 56 # Integer | The report oid to execute.
195
+
196
+
197
+ begin
198
+ #Execute a custom report
199
+ result = api_instance.execute_custom_report(execution_request, custom_report_oid)
200
+ p result
201
+ rescue UltracartClient::ApiError => e
202
+ puts "Exception when calling DatawarehouseApi->execute_custom_report: #{e}"
203
+ end
204
+ ```
205
+
206
+ ### Parameters
207
+
208
+ Name | Type | Description | Notes
209
+ ------------- | ------------- | ------------- | -------------
210
+ **execution_request** | [**CustomReportExecutionRequest**](CustomReportExecutionRequest.md)| Request to execute custom report |
211
+ **custom_report_oid** | **Integer**| The report oid to execute. |
212
+
213
+ ### Return type
214
+
215
+ [**CustomReportResponse**](CustomReportResponse.md)
216
+
217
+ ### Authorization
218
+
219
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
220
+
221
+ ### HTTP request headers
222
+
223
+ - **Content-Type**: application/json; charset=UTF-8
224
+ - **Accept**: application/json
225
+
226
+
227
+
118
228
  # **execute_report_queries**
119
229
  > execute_report_queries(query_request)
120
230
 
@@ -164,6 +274,146 @@ nil (empty response body)
164
274
 
165
275
 
166
276
 
277
+ # **get_custom_report**
278
+ > CustomReportResponse get_custom_report(custom_report_oid)
279
+
280
+ Get a custom report
281
+
282
+ Retrieve a custom report
283
+
284
+ ### Example
285
+ ```ruby
286
+ # load the gem
287
+ require 'ultracart_api'
288
+
289
+ # Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
290
+ simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
291
+ api_instance = UltracartClient::DatawarehouseApi.new_using_api_key(simple_key, false, false)
292
+
293
+
294
+ custom_report_oid = 56 # Integer |
295
+
296
+
297
+ begin
298
+ #Get a custom report
299
+ result = api_instance.get_custom_report(custom_report_oid)
300
+ p result
301
+ rescue UltracartClient::ApiError => e
302
+ puts "Exception when calling DatawarehouseApi->get_custom_report: #{e}"
303
+ end
304
+ ```
305
+
306
+ ### Parameters
307
+
308
+ Name | Type | Description | Notes
309
+ ------------- | ------------- | ------------- | -------------
310
+ **custom_report_oid** | **Integer**| |
311
+
312
+ ### Return type
313
+
314
+ [**CustomReportResponse**](CustomReportResponse.md)
315
+
316
+ ### Authorization
317
+
318
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
319
+
320
+ ### HTTP request headers
321
+
322
+ - **Content-Type**: application/json
323
+ - **Accept**: application/json
324
+
325
+
326
+
327
+ # **get_custom_report_account_config**
328
+ > CustomReportAccountConfigResponse get_custom_report_account_config
329
+
330
+ Get custom report account configuration
331
+
332
+ Retrieve a custom report account configuration
333
+
334
+ ### Example
335
+ ```ruby
336
+ # load the gem
337
+ require 'ultracart_api'
338
+
339
+ # Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
340
+ simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
341
+ api_instance = UltracartClient::DatawarehouseApi.new_using_api_key(simple_key, false, false)
342
+
343
+
344
+
345
+ begin
346
+ #Get custom report account configuration
347
+ result = api_instance.get_custom_report_account_config
348
+ p result
349
+ rescue UltracartClient::ApiError => e
350
+ puts "Exception when calling DatawarehouseApi->get_custom_report_account_config: #{e}"
351
+ end
352
+ ```
353
+
354
+ ### Parameters
355
+ This endpoint does not need any parameter.
356
+
357
+ ### Return type
358
+
359
+ [**CustomReportAccountConfigResponse**](CustomReportAccountConfigResponse.md)
360
+
361
+ ### Authorization
362
+
363
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
364
+
365
+ ### HTTP request headers
366
+
367
+ - **Content-Type**: application/json
368
+ - **Accept**: application/json
369
+
370
+
371
+
372
+ # **get_custom_reports**
373
+ > CustomReportsResponse get_custom_reports
374
+
375
+ Get custom reports
376
+
377
+ Retrieve a custom reports
378
+
379
+ ### Example
380
+ ```ruby
381
+ # load the gem
382
+ require 'ultracart_api'
383
+
384
+ # Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
385
+ simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
386
+ api_instance = UltracartClient::DatawarehouseApi.new_using_api_key(simple_key, false, false)
387
+
388
+
389
+
390
+ begin
391
+ #Get custom reports
392
+ result = api_instance.get_custom_reports
393
+ p result
394
+ rescue UltracartClient::ApiError => e
395
+ puts "Exception when calling DatawarehouseApi->get_custom_reports: #{e}"
396
+ end
397
+ ```
398
+
399
+ ### Parameters
400
+ This endpoint does not need any parameter.
401
+
402
+ ### Return type
403
+
404
+ [**CustomReportsResponse**](CustomReportsResponse.md)
405
+
406
+ ### Authorization
407
+
408
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
409
+
410
+ ### HTTP request headers
411
+
412
+ - **Content-Type**: application/json
413
+ - **Accept**: application/json
414
+
415
+
416
+
167
417
  # **get_report**
168
418
  > ReportResponse get_report(report_oid)
169
419
 
@@ -407,6 +657,56 @@ This endpoint does not need any parameter.
407
657
 
408
658
 
409
659
 
660
+ # **insert_custom_report**
661
+ > CustomReportResponse insert_custom_report(report)
662
+
663
+ Create a custom report
664
+
665
+ Create a new custom report on the UltraCart account.
666
+
667
+ ### Example
668
+ ```ruby
669
+ # load the gem
670
+ require 'ultracart_api'
671
+
672
+ # Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
673
+ simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
674
+ api_instance = UltracartClient::DatawarehouseApi.new_using_api_key(simple_key, false, false)
675
+
676
+
677
+ report = UltracartClient::CustomReport.new # CustomReport | Report to create
678
+
679
+
680
+ begin
681
+ #Create a custom report
682
+ result = api_instance.insert_custom_report(report)
683
+ p result
684
+ rescue UltracartClient::ApiError => e
685
+ puts "Exception when calling DatawarehouseApi->insert_custom_report: #{e}"
686
+ end
687
+ ```
688
+
689
+ ### Parameters
690
+
691
+ Name | Type | Description | Notes
692
+ ------------- | ------------- | ------------- | -------------
693
+ **report** | [**CustomReport**](CustomReport.md)| Report to create |
694
+
695
+ ### Return type
696
+
697
+ [**CustomReportResponse**](CustomReportResponse.md)
698
+
699
+ ### Authorization
700
+
701
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
702
+
703
+ ### HTTP request headers
704
+
705
+ - **Content-Type**: application/json; charset=UTF-8
706
+ - **Accept**: application/json
707
+
708
+
709
+
410
710
  # **insert_report**
411
711
  > ReportResponse insert_report(report)
412
712
 
@@ -457,6 +757,109 @@ Name | Type | Description | Notes
457
757
 
458
758
 
459
759
 
760
+ # **update_custom_report**
761
+ > CustomReportResponse update_custom_report(report, custom_report_oid)
762
+
763
+ Update a custom report
764
+
765
+ Update a custom report on the UltraCart account.
766
+
767
+ ### Example
768
+ ```ruby
769
+ # load the gem
770
+ require 'ultracart_api'
771
+
772
+ # Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
773
+ simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
774
+ api_instance = UltracartClient::DatawarehouseApi.new_using_api_key(simple_key, false, false)
775
+
776
+
777
+ report = UltracartClient::CustomReport.new # CustomReport | Report to custom update
778
+
779
+ custom_report_oid = 56 # Integer | The report oid to custom update.
780
+
781
+
782
+ begin
783
+ #Update a custom report
784
+ result = api_instance.update_custom_report(report, custom_report_oid)
785
+ p result
786
+ rescue UltracartClient::ApiError => e
787
+ puts "Exception when calling DatawarehouseApi->update_custom_report: #{e}"
788
+ end
789
+ ```
790
+
791
+ ### Parameters
792
+
793
+ Name | Type | Description | Notes
794
+ ------------- | ------------- | ------------- | -------------
795
+ **report** | [**CustomReport**](CustomReport.md)| Report to custom update |
796
+ **custom_report_oid** | **Integer**| The report oid to custom update. |
797
+
798
+ ### Return type
799
+
800
+ [**CustomReportResponse**](CustomReportResponse.md)
801
+
802
+ ### Authorization
803
+
804
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
805
+
806
+ ### HTTP request headers
807
+
808
+ - **Content-Type**: application/json; charset=UTF-8
809
+ - **Accept**: application/json
810
+
811
+
812
+
813
+ # **update_custom_report_account_config**
814
+ > CustomReportAccountConfigResponse update_custom_report_account_config(account_config)
815
+
816
+ Update custom report account config
817
+
818
+ Update custom report account config.
819
+
820
+ ### Example
821
+ ```ruby
822
+ # load the gem
823
+ require 'ultracart_api'
824
+
825
+ # Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
826
+ simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
827
+ api_instance = UltracartClient::DatawarehouseApi.new_using_api_key(simple_key, false, false)
828
+
829
+
830
+ account_config = UltracartClient::CustomReportAccountConfig.new # CustomReportAccountConfig | Account config to update
831
+
832
+
833
+ begin
834
+ #Update custom report account config
835
+ result = api_instance.update_custom_report_account_config(account_config)
836
+ p result
837
+ rescue UltracartClient::ApiError => e
838
+ puts "Exception when calling DatawarehouseApi->update_custom_report_account_config: #{e}"
839
+ end
840
+ ```
841
+
842
+ ### Parameters
843
+
844
+ Name | Type | Description | Notes
845
+ ------------- | ------------- | ------------- | -------------
846
+ **account_config** | [**CustomReportAccountConfig**](CustomReportAccountConfig.md)| Account config to update |
847
+
848
+ ### Return type
849
+
850
+ [**CustomReportAccountConfigResponse**](CustomReportAccountConfigResponse.md)
851
+
852
+ ### Authorization
853
+
854
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
855
+
856
+ ### HTTP request headers
857
+
858
+ - **Content-Type**: application/json; charset=UTF-8
859
+ - **Accept**: application/json
860
+
861
+
862
+
460
863
  # **update_report**
461
864
  > ReportResponse update_report(report, report_oid)
462
865
 
data/docs/Item.md CHANGED
@@ -34,7 +34,7 @@ Name | Type | Description | Notes
34
34
  **merchant_item_oid** | **Integer** | Unique object identifier for this item | [optional]
35
35
  **options** | [**Array<ItemOption>**](ItemOption.md) | Options | [optional]
36
36
  **parent_category_id** | **Integer** | Parent category of the item. Zero indicates the root folder. | [optional]
37
- **parent_category_path** | **String** | Parent category path. / indicates the root folder. | [optional]
37
+ **parent_category_path** | **String** | Parent category path. / indicates the root folder. This is the folder structure within item management. | [optional]
38
38
  **payment_processing** | [**ItemPaymentProcessing**](ItemPaymentProcessing.md) | | [optional]
39
39
  **physical** | [**ItemPhysical**](ItemPhysical.md) | | [optional]
40
40
  **pricing** | [**ItemPricing**](ItemPricing.md) | | [optional]