ultracart_api 4.1.14 → 4.1.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 +25 -3
  3. data/docs/CartUpsellAfter.md +6 -2
  4. data/docs/ConversationVirtualAgentCapabilities.md +4 -0
  5. data/docs/CustomReport.md +36 -0
  6. data/docs/CustomReportAccountConfig.md +34 -0
  7. data/docs/CustomReportAccountConfigResponse.md +26 -0
  8. data/docs/CustomReportExecutionParameter.md +22 -0
  9. data/docs/CustomReportExecutionRequest.md +18 -0
  10. data/docs/CustomReportParameter.md +28 -0
  11. data/docs/CustomReportParameterOption.md +20 -0
  12. data/docs/CustomReportQuery.md +28 -0
  13. data/docs/CustomReportResponse.md +26 -0
  14. data/docs/CustomReportTooltip.md +20 -0
  15. data/docs/CustomReportsResponse.md +26 -0
  16. data/docs/DatawarehouseApi.md +430 -0
  17. data/docs/Item.md +1 -1
  18. data/docs/OrderApi.md +137 -63
  19. data/docs/WebhookApi.md +0 -8
  20. data/lib/ultracart_api/api/datawarehouse_api.rb +532 -0
  21. data/lib/ultracart_api/api/order_api.rb +131 -91
  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 +306 -0
  26. data/lib/ultracart_api/models/custom_report_account_config.rb +296 -0
  27. data/lib/ultracart_api/models/custom_report_account_config_response.rb +256 -0
  28. data/lib/ultracart_api/models/custom_report_execution_parameter.rb +237 -0
  29. data/lib/ultracart_api/models/custom_report_execution_request.rb +221 -0
  30. data/lib/ultracart_api/models/custom_report_parameter.rb +266 -0
  31. data/lib/ultracart_api/models/custom_report_parameter_option.rb +228 -0
  32. data/lib/ultracart_api/models/custom_report_query.rb +266 -0
  33. data/lib/ultracart_api/models/custom_report_response.rb +256 -0
  34. data/lib/ultracart_api/models/custom_report_tooltip.rb +228 -0
  35. data/lib/ultracart_api/models/custom_reports_response.rb +259 -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,79 @@ 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
+
29
+ > delete_custom_report(custom_report_oid)
30
+
31
+ Delete a custom report
32
+
33
+ Delete a custom report on the UltraCart account.
34
+
35
+
36
+ ### Examples
37
+
38
+
39
+ (No example for this operation).
40
+
41
+
42
+ #### Using the delete_custom_report_with_http_info variant
43
+
44
+ This returns an Array which contains the response data (`nil` in this case), status code and headers.
45
+
46
+ > <Array(nil, Integer, Hash)> delete_custom_report_with_http_info(custom_report_oid)
47
+
48
+ ```ruby
49
+ begin
50
+ # Delete a custom report
51
+ data, status_code, headers = api_instance.delete_custom_report_with_http_info(custom_report_oid)
52
+ p status_code # => 2xx
53
+ p headers # => { ... }
54
+ p data # => nil
55
+ rescue UltracartClient::ApiError => e
56
+ puts "Error when calling DatawarehouseApi->delete_custom_report_with_http_info: #{e}"
57
+ end
58
+ ```
59
+
60
+ ### Parameters
61
+
62
+ | Name | Type | Description | Notes |
63
+ | ---- | ---- | ----------- | ----- |
64
+ | **custom_report_oid** | **Integer** | The report oid to delete. | |
65
+
66
+ ### Return type
67
+
68
+ nil (empty response body)
69
+
70
+ ### Authorization
71
+
72
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
73
+
74
+ ### HTTP request headers
75
+
76
+ - **Content-Type**: Not defined
77
+ - **Accept**: application/json
78
+
79
+
19
80
  ## delete_report
20
81
 
21
82
  > delete_report(report_oid)
@@ -124,6 +185,60 @@ end
124
185
  - **Accept**: application/json
125
186
 
126
187
 
188
+ ## execute_custom_report
189
+
190
+ > <CustomReportResponse> execute_custom_report(custom_report_oid, execution_request)
191
+
192
+ Execute a custom report
193
+
194
+ Execute a custom report on the UltraCart account.
195
+
196
+
197
+ ### Examples
198
+
199
+
200
+ (No example for this operation).
201
+
202
+
203
+ #### Using the execute_custom_report_with_http_info variant
204
+
205
+ This returns an Array which contains the response data, status code and headers.
206
+
207
+ > <Array(<CustomReportResponse>, Integer, Hash)> execute_custom_report_with_http_info(custom_report_oid, execution_request)
208
+
209
+ ```ruby
210
+ begin
211
+ # Execute a custom report
212
+ data, status_code, headers = api_instance.execute_custom_report_with_http_info(custom_report_oid, execution_request)
213
+ p status_code # => 2xx
214
+ p headers # => { ... }
215
+ p data # => <CustomReportResponse>
216
+ rescue UltracartClient::ApiError => e
217
+ puts "Error when calling DatawarehouseApi->execute_custom_report_with_http_info: #{e}"
218
+ end
219
+ ```
220
+
221
+ ### Parameters
222
+
223
+ | Name | Type | Description | Notes |
224
+ | ---- | ---- | ----------- | ----- |
225
+ | **custom_report_oid** | **Integer** | The report oid to execute. | |
226
+ | **execution_request** | [**CustomReportExecutionRequest**](CustomReportExecutionRequest.md) | Request to execute custom report | |
227
+
228
+ ### Return type
229
+
230
+ [**CustomReportResponse**](CustomReportResponse.md)
231
+
232
+ ### Authorization
233
+
234
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
235
+
236
+ ### HTTP request headers
237
+
238
+ - **Content-Type**: application/json; charset=UTF-8
239
+ - **Accept**: application/json
240
+
241
+
127
242
  ## execute_report_queries
128
243
 
129
244
  > execute_report_queries(query_request)
@@ -178,6 +293,161 @@ nil (empty response body)
178
293
  - **Accept**: application/json
179
294
 
180
295
 
296
+ ## get_custom_report
297
+
298
+ > <CustomReportResponse> get_custom_report(custom_report_oid)
299
+
300
+ Get a custom report
301
+
302
+ Retrieve a custom report
303
+
304
+
305
+ ### Examples
306
+
307
+
308
+ (No example for this operation).
309
+
310
+
311
+ #### Using the get_custom_report_with_http_info variant
312
+
313
+ This returns an Array which contains the response data, status code and headers.
314
+
315
+ > <Array(<CustomReportResponse>, Integer, Hash)> get_custom_report_with_http_info(custom_report_oid)
316
+
317
+ ```ruby
318
+ begin
319
+ # Get a custom report
320
+ data, status_code, headers = api_instance.get_custom_report_with_http_info(custom_report_oid)
321
+ p status_code # => 2xx
322
+ p headers # => { ... }
323
+ p data # => <CustomReportResponse>
324
+ rescue UltracartClient::ApiError => e
325
+ puts "Error when calling DatawarehouseApi->get_custom_report_with_http_info: #{e}"
326
+ end
327
+ ```
328
+
329
+ ### Parameters
330
+
331
+ | Name | Type | Description | Notes |
332
+ | ---- | ---- | ----------- | ----- |
333
+ | **custom_report_oid** | **Integer** | | |
334
+
335
+ ### Return type
336
+
337
+ [**CustomReportResponse**](CustomReportResponse.md)
338
+
339
+ ### Authorization
340
+
341
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
342
+
343
+ ### HTTP request headers
344
+
345
+ - **Content-Type**: Not defined
346
+ - **Accept**: application/json
347
+
348
+
349
+ ## get_custom_report_account_config
350
+
351
+ > <CustomReportAccountConfigResponse> get_custom_report_account_config
352
+
353
+ Get custom report account configuration
354
+
355
+ Retrieve a custom report account configuration
356
+
357
+
358
+ ### Examples
359
+
360
+
361
+ (No example for this operation).
362
+
363
+
364
+ #### Using the get_custom_report_account_config_with_http_info variant
365
+
366
+ This returns an Array which contains the response data, status code and headers.
367
+
368
+ > <Array(<CustomReportAccountConfigResponse>, Integer, Hash)> get_custom_report_account_config_with_http_info
369
+
370
+ ```ruby
371
+ begin
372
+ # Get custom report account configuration
373
+ data, status_code, headers = api_instance.get_custom_report_account_config_with_http_info
374
+ p status_code # => 2xx
375
+ p headers # => { ... }
376
+ p data # => <CustomReportAccountConfigResponse>
377
+ rescue UltracartClient::ApiError => e
378
+ puts "Error when calling DatawarehouseApi->get_custom_report_account_config_with_http_info: #{e}"
379
+ end
380
+ ```
381
+
382
+ ### Parameters
383
+
384
+ This endpoint does not need any parameter.
385
+
386
+ ### Return type
387
+
388
+ [**CustomReportAccountConfigResponse**](CustomReportAccountConfigResponse.md)
389
+
390
+ ### Authorization
391
+
392
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
393
+
394
+ ### HTTP request headers
395
+
396
+ - **Content-Type**: Not defined
397
+ - **Accept**: application/json
398
+
399
+
400
+ ## get_custom_reports
401
+
402
+ > <CustomReportsResponse> get_custom_reports
403
+
404
+ Get custom reports
405
+
406
+ Retrieve a custom reports
407
+
408
+
409
+ ### Examples
410
+
411
+
412
+ (No example for this operation).
413
+
414
+
415
+ #### Using the get_custom_reports_with_http_info variant
416
+
417
+ This returns an Array which contains the response data, status code and headers.
418
+
419
+ > <Array(<CustomReportsResponse>, Integer, Hash)> get_custom_reports_with_http_info
420
+
421
+ ```ruby
422
+ begin
423
+ # Get custom reports
424
+ data, status_code, headers = api_instance.get_custom_reports_with_http_info
425
+ p status_code # => 2xx
426
+ p headers # => { ... }
427
+ p data # => <CustomReportsResponse>
428
+ rescue UltracartClient::ApiError => e
429
+ puts "Error when calling DatawarehouseApi->get_custom_reports_with_http_info: #{e}"
430
+ end
431
+ ```
432
+
433
+ ### Parameters
434
+
435
+ This endpoint does not need any parameter.
436
+
437
+ ### Return type
438
+
439
+ [**CustomReportsResponse**](CustomReportsResponse.md)
440
+
441
+ ### Authorization
442
+
443
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
444
+
445
+ ### HTTP request headers
446
+
447
+ - **Content-Type**: Not defined
448
+ - **Accept**: application/json
449
+
450
+
181
451
  ## get_report
182
452
 
183
453
  > <ReportResponse> get_report(report_oid)
@@ -445,6 +715,59 @@ This endpoint does not need any parameter.
445
715
  - **Accept**: application/json
446
716
 
447
717
 
718
+ ## insert_custom_report
719
+
720
+ > <CustomReportResponse> insert_custom_report(report)
721
+
722
+ Create a custom report
723
+
724
+ Create a new custom report on the UltraCart account.
725
+
726
+
727
+ ### Examples
728
+
729
+
730
+ (No example for this operation).
731
+
732
+
733
+ #### Using the insert_custom_report_with_http_info variant
734
+
735
+ This returns an Array which contains the response data, status code and headers.
736
+
737
+ > <Array(<CustomReportResponse>, Integer, Hash)> insert_custom_report_with_http_info(report)
738
+
739
+ ```ruby
740
+ begin
741
+ # Create a custom report
742
+ data, status_code, headers = api_instance.insert_custom_report_with_http_info(report)
743
+ p status_code # => 2xx
744
+ p headers # => { ... }
745
+ p data # => <CustomReportResponse>
746
+ rescue UltracartClient::ApiError => e
747
+ puts "Error when calling DatawarehouseApi->insert_custom_report_with_http_info: #{e}"
748
+ end
749
+ ```
750
+
751
+ ### Parameters
752
+
753
+ | Name | Type | Description | Notes |
754
+ | ---- | ---- | ----------- | ----- |
755
+ | **report** | [**CustomReport**](CustomReport.md) | Report to create | |
756
+
757
+ ### Return type
758
+
759
+ [**CustomReportResponse**](CustomReportResponse.md)
760
+
761
+ ### Authorization
762
+
763
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
764
+
765
+ ### HTTP request headers
766
+
767
+ - **Content-Type**: application/json; charset=UTF-8
768
+ - **Accept**: application/json
769
+
770
+
448
771
  ## insert_report
449
772
 
450
773
  > <ReportResponse> insert_report(report)
@@ -499,6 +822,113 @@ end
499
822
  - **Accept**: application/json
500
823
 
501
824
 
825
+ ## update_custom_report
826
+
827
+ > <CustomReportResponse> update_custom_report(custom_report_oid, report)
828
+
829
+ Update a custom report
830
+
831
+ Update a custom report on the UltraCart account.
832
+
833
+
834
+ ### Examples
835
+
836
+
837
+ (No example for this operation).
838
+
839
+
840
+ #### Using the update_custom_report_with_http_info variant
841
+
842
+ This returns an Array which contains the response data, status code and headers.
843
+
844
+ > <Array(<CustomReportResponse>, Integer, Hash)> update_custom_report_with_http_info(custom_report_oid, report)
845
+
846
+ ```ruby
847
+ begin
848
+ # Update a custom report
849
+ data, status_code, headers = api_instance.update_custom_report_with_http_info(custom_report_oid, report)
850
+ p status_code # => 2xx
851
+ p headers # => { ... }
852
+ p data # => <CustomReportResponse>
853
+ rescue UltracartClient::ApiError => e
854
+ puts "Error when calling DatawarehouseApi->update_custom_report_with_http_info: #{e}"
855
+ end
856
+ ```
857
+
858
+ ### Parameters
859
+
860
+ | Name | Type | Description | Notes |
861
+ | ---- | ---- | ----------- | ----- |
862
+ | **custom_report_oid** | **Integer** | The report oid to custom update. | |
863
+ | **report** | [**CustomReport**](CustomReport.md) | Report to custom update | |
864
+
865
+ ### Return type
866
+
867
+ [**CustomReportResponse**](CustomReportResponse.md)
868
+
869
+ ### Authorization
870
+
871
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
872
+
873
+ ### HTTP request headers
874
+
875
+ - **Content-Type**: application/json; charset=UTF-8
876
+ - **Accept**: application/json
877
+
878
+
879
+ ## update_custom_report_account_config
880
+
881
+ > <CustomReportAccountConfigResponse> update_custom_report_account_config(account_config)
882
+
883
+ Update custom report account config
884
+
885
+ Update custom report account config.
886
+
887
+
888
+ ### Examples
889
+
890
+
891
+ (No example for this operation).
892
+
893
+
894
+ #### Using the update_custom_report_account_config_with_http_info variant
895
+
896
+ This returns an Array which contains the response data, status code and headers.
897
+
898
+ > <Array(<CustomReportAccountConfigResponse>, Integer, Hash)> update_custom_report_account_config_with_http_info(account_config)
899
+
900
+ ```ruby
901
+ begin
902
+ # Update custom report account config
903
+ data, status_code, headers = api_instance.update_custom_report_account_config_with_http_info(account_config)
904
+ p status_code # => 2xx
905
+ p headers # => { ... }
906
+ p data # => <CustomReportAccountConfigResponse>
907
+ rescue UltracartClient::ApiError => e
908
+ puts "Error when calling DatawarehouseApi->update_custom_report_account_config_with_http_info: #{e}"
909
+ end
910
+ ```
911
+
912
+ ### Parameters
913
+
914
+ | Name | Type | Description | Notes |
915
+ | ---- | ---- | ----------- | ----- |
916
+ | **account_config** | [**CustomReportAccountConfig**](CustomReportAccountConfig.md) | Account config to update | |
917
+
918
+ ### Return type
919
+
920
+ [**CustomReportAccountConfigResponse**](CustomReportAccountConfigResponse.md)
921
+
922
+ ### Authorization
923
+
924
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
925
+
926
+ ### HTTP request headers
927
+
928
+ - **Content-Type**: application/json; charset=UTF-8
929
+ - **Accept**: application/json
930
+
931
+
502
932
  ## update_report
503
933
 
504
934
  > <ReportResponse> update_report(report_oid, report)
data/docs/Item.md CHANGED
@@ -35,7 +35,7 @@
35
35
  | **merchant_item_oid** | **Integer** | Unique object identifier for this item | [optional] |
36
36
  | **options** | [**Array&lt;ItemOption&gt;**](ItemOption.md) | Options | [optional] |
37
37
  | **parent_category_id** | **Integer** | Parent category of the item. Zero indicates the root folder. | [optional] |
38
- | **parent_category_path** | **String** | Parent category path. / indicates the root folder. | [optional] |
38
+ | **parent_category_path** | **String** | Parent category path. / indicates the root folder. This is the folder structure within item management. | [optional] |
39
39
  | **payment_processing** | [**ItemPaymentProcessing**](ItemPaymentProcessing.md) | | [optional] |
40
40
  | **physical** | [**ItemPhysical**](ItemPhysical.md) | | [optional] |
41
41
  | **pricing** | [**ItemPricing**](ItemPricing.md) | | [optional] |