ultracart_api 4.1.13 → 4.1.15

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 (54) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +23 -2
  3. data/docs/AffiliateApi.md +123 -167
  4. data/docs/AutoOrderApi.md +1250 -903
  5. data/docs/CartUpsellAfter.md +6 -2
  6. data/docs/ChannelPartnerApi.md +1678 -1121
  7. data/docs/ChargebackApi.md +297 -405
  8. data/docs/CheckoutApi.md +1622 -1424
  9. data/docs/ConversationApi.md +4820 -6315
  10. data/docs/ConversationVirtualAgentCapabilities.md +4 -0
  11. data/docs/CouponApi.md +1522 -1443
  12. data/docs/CustomReport.md +36 -0
  13. data/docs/CustomReportAccountConfig.md +34 -0
  14. data/docs/CustomReportAccountConfigResponse.md +26 -0
  15. data/docs/CustomReportExecutionParameter.md +22 -0
  16. data/docs/CustomReportExecutionRequest.md +18 -0
  17. data/docs/CustomReportParameter.md +28 -0
  18. data/docs/CustomReportParameterOption.md +20 -0
  19. data/docs/CustomReportQuery.md +28 -0
  20. data/docs/CustomReportResponse.md +26 -0
  21. data/docs/CustomReportTooltip.md +20 -0
  22. data/docs/CustomerApi.md +2570 -1845
  23. data/docs/DatawarehouseApi.md +933 -723
  24. data/docs/FulfillmentApi.md +567 -441
  25. data/docs/GiftCertificateApi.md +617 -598
  26. data/docs/IntegrationLogApi.md +290 -385
  27. data/docs/Item.md +1 -1
  28. data/docs/ItemApi.md +2174 -1746
  29. data/docs/OauthApi.md +203 -163
  30. data/docs/OrderApi.md +2883 -2177
  31. data/docs/SsoApi.md +223 -288
  32. data/docs/StorefrontApi.md +9692 -12967
  33. data/docs/TaxApi.md +1541 -2017
  34. data/docs/UserApi.md +606 -790
  35. data/docs/WebhookApi.md +787 -628
  36. data/docs/WorkflowApi.md +666 -879
  37. data/lib/ultracart_api/api/datawarehouse_api.rb +474 -0
  38. data/lib/ultracart_api/api/order_api.rb +131 -0
  39. data/lib/ultracart_api/models/cart_upsell_after.rb +25 -5
  40. data/lib/ultracart_api/models/conversation_virtual_agent_capabilities.rb +55 -1
  41. data/lib/ultracart_api/models/custom_report.rb +306 -0
  42. data/lib/ultracart_api/models/custom_report_account_config.rb +296 -0
  43. data/lib/ultracart_api/models/custom_report_account_config_response.rb +256 -0
  44. data/lib/ultracart_api/models/custom_report_execution_parameter.rb +237 -0
  45. data/lib/ultracart_api/models/custom_report_execution_request.rb +221 -0
  46. data/lib/ultracart_api/models/custom_report_parameter.rb +266 -0
  47. data/lib/ultracart_api/models/custom_report_parameter_option.rb +228 -0
  48. data/lib/ultracart_api/models/custom_report_query.rb +266 -0
  49. data/lib/ultracart_api/models/custom_report_response.rb +256 -0
  50. data/lib/ultracart_api/models/custom_report_tooltip.rb +228 -0
  51. data/lib/ultracart_api/models/item.rb +1 -1
  52. data/lib/ultracart_api/version.rb +1 -1
  53. data/lib/ultracart_api.rb +10 -0
  54. metadata +22 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 3a946d9c9a1fc472d1268629bdecc625b9b69254fe4ab711e65e2b6bb46ff81e
4
- data.tar.gz: cc195035bc8e94040c3abd2564141c632d6ec2ae3bc6149859305938e6fc763d
3
+ metadata.gz: 88b53e73ee66470db4628071562e135f24c4ed2fd083e8590ce5be1e9e9bbb89
4
+ data.tar.gz: 61db53c58daef42a6fddd83dfbd4a131ed9ecfd64b579f84ca1a3dc00649824a
5
5
  SHA512:
6
- metadata.gz: 612d6641cbba23242cb36825571989d82f2148fcac953db69e55c114e57e21833dfb19cda0c5dd650c7972def15542ef840c614aa689c4a8655f22308bf7cca6
7
- data.tar.gz: b631b15fbe14bc3e330b58d3f8e9cfc3e20c97b6f13a2fba51a1029a9dc417368837f42227b39788cc658b9b4b5f02052f36b556e2f5ca2b6c4f686f4404c063
6
+ metadata.gz: e3656f6385e94d3a2d71a86e09364176e42564c10808583f7553441ceb32654f7507cd6ed2d188f3ae4a495695c6c135991058bf01aeb902bd829503408c63e1
7
+ data.tar.gz: 6c4787a05dd1def0585e5bc55ab64371ebe901c08d630e78aa790d8bd188218ba6618f1b1e29e9f5ad26ea09a54693127263c9e97820dc536f4ec82ea14b216f
data/README.md CHANGED
@@ -7,7 +7,7 @@ Note: Every method has a sample for every language. See https://github.com/Ultr
7
7
  This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
8
8
 
9
9
  - API version: 2.0.0
10
- - Package version: 4.1.13
10
+ - Package version: 4.1.15
11
11
  - Build package: org.openapitools.codegen.languages.RubyClientCodegen
12
12
  - For more information, please visit [http://www.ultracart.com/api/](http://www.ultracart.com/api/)
13
13
 
@@ -16,7 +16,7 @@ This SDK is automatically generated by the [OpenAPI Generator](https://openapi-g
16
16
  gemfile:
17
17
 
18
18
  ```shell
19
- gem 'ultracart_api', '4.1.13'
19
+ gem 'ultracart_api', '4.1.15'
20
20
  ```
21
21
 
22
22
  install:
@@ -265,15 +265,22 @@ Class | Method | HTTP request | Description
265
265
  *UltracartClient::CustomerApi* | [**update_customer_email_lists**](docs/CustomerApi.md#update_customer_email_lists) | **POST** /customer/customers/{customer_profile_oid}/email_lists | Update email list subscriptions for a customer
266
266
  *UltracartClient::CustomerApi* | [**update_wish_list_item**](docs/CustomerApi.md#update_wish_list_item) | **PUT** /customer/customers/{customer_profile_oid}/wishlist/{customer_wishlist_item_oid} | Update a customer wishlist item
267
267
  *UltracartClient::CustomerApi* | [**validate_email_verification_token**](docs/CustomerApi.md#validate_email_verification_token) | **POST** /customer/customers/email_verify/validate_token | Validate a token that can be used to verify a customer email address
268
+ *UltracartClient::DatawarehouseApi* | [**delete_custom_report**](docs/DatawarehouseApi.md#delete_custom_report) | **DELETE** /datawarehouse/custom_reports/{custom_report_oid} | Delete a custom report
268
269
  *UltracartClient::DatawarehouseApi* | [**delete_report**](docs/DatawarehouseApi.md#delete_report) | **DELETE** /datawarehouse/reports/{report_oid} | Delete a report
269
270
  *UltracartClient::DatawarehouseApi* | [**dry_run_report_queries**](docs/DatawarehouseApi.md#dry_run_report_queries) | **PUT** /datawarehouse/reports/dryrun | Dry run the report queries
271
+ *UltracartClient::DatawarehouseApi* | [**execute_custom_report**](docs/DatawarehouseApi.md#execute_custom_report) | **PUT** /datawarehouse/custom_reports/{custom_report_oid}/execute | Execute a custom report
270
272
  *UltracartClient::DatawarehouseApi* | [**execute_report_queries**](docs/DatawarehouseApi.md#execute_report_queries) | **PUT** /datawarehouse/reports/execute | Execute the report queries
273
+ *UltracartClient::DatawarehouseApi* | [**get_custom_report**](docs/DatawarehouseApi.md#get_custom_report) | **GET** /datawarehouse/custom_reports/{custom_report_oid} | Get a custom report
274
+ *UltracartClient::DatawarehouseApi* | [**get_custom_report_account_config**](docs/DatawarehouseApi.md#get_custom_report_account_config) | **GET** /datawarehouse/custom_reports/account_config | Get custom report account configuration
271
275
  *UltracartClient::DatawarehouseApi* | [**get_report**](docs/DatawarehouseApi.md#get_report) | **GET** /datawarehouse/reports/{report_oid} | Get a report
272
276
  *UltracartClient::DatawarehouseApi* | [**get_report_data_set**](docs/DatawarehouseApi.md#get_report_data_set) | **GET** /datawarehouse/reports/dataset/{dataset_uuid} | Get a report data set
273
277
  *UltracartClient::DatawarehouseApi* | [**get_report_data_set_page**](docs/DatawarehouseApi.md#get_report_data_set_page) | **GET** /datawarehouse/reports/dataset/{dataset_uuid}/pages/{page_number} | Get a report data set page
274
278
  *UltracartClient::DatawarehouseApi* | [**get_report_websocket_authorization**](docs/DatawarehouseApi.md#get_report_websocket_authorization) | **PUT** /datawarehouse/reports/auth | Get report websocket authorization
275
279
  *UltracartClient::DatawarehouseApi* | [**get_reports**](docs/DatawarehouseApi.md#get_reports) | **GET** /datawarehouse/reports | Get list of reports available
280
+ *UltracartClient::DatawarehouseApi* | [**insert_custom_report**](docs/DatawarehouseApi.md#insert_custom_report) | **POST** /datawarehouse/custom_reports | Create a custom report
276
281
  *UltracartClient::DatawarehouseApi* | [**insert_report**](docs/DatawarehouseApi.md#insert_report) | **POST** /datawarehouse/reports | Create a report
282
+ *UltracartClient::DatawarehouseApi* | [**update_custom_report**](docs/DatawarehouseApi.md#update_custom_report) | **PUT** /datawarehouse/custom_reports/{custom_report_oid} | Update a custom report
283
+ *UltracartClient::DatawarehouseApi* | [**update_custom_report_account_config**](docs/DatawarehouseApi.md#update_custom_report_account_config) | **PUT** /datawarehouse/custom_reports/account_config | Update custom report account config
277
284
  *UltracartClient::DatawarehouseApi* | [**update_report**](docs/DatawarehouseApi.md#update_report) | **PUT** /datawarehouse/reports/{report_oid} | Update a report
278
285
  *UltracartClient::FulfillmentApi* | [**acknowledge_orders**](docs/FulfillmentApi.md#acknowledge_orders) | **PUT** /fulfillment/distribution_centers/{distribution_center_code}/acknowledgements | Acknowledge receipt of orders.
279
286
  *UltracartClient::FulfillmentApi* | [**generate_packing_slip**](docs/FulfillmentApi.md#generate_packing_slip) | **GET** /fulfillment/distribution_centers/{distribution_center_code}/orders/{order_id} | Generate a packing slip for this order for the given distribution center.
@@ -320,6 +327,7 @@ Class | Method | HTTP request | Description
320
327
  *UltracartClient::OauthApi* | [**oauth_access_token**](docs/OauthApi.md#oauth_access_token) | **POST** /oauth/token | Exchange authorization code for access token.
321
328
  *UltracartClient::OauthApi* | [**oauth_revoke**](docs/OauthApi.md#oauth_revoke) | **POST** /oauth/revoke | Revoke this OAuth application.
322
329
  *UltracartClient::OrderApi* | [**adjust_order_total**](docs/OrderApi.md#adjust_order_total) | **POST** /order/orders/{order_id}/adjust_order_total/{desired_total} | Adjusts an order total
330
+ *UltracartClient::OrderApi* | [**block_refund_on_order**](docs/OrderApi.md#block_refund_on_order) | **POST** /order/orders/{order_id}/refund_block | Set a refund block on an order
323
331
  *UltracartClient::OrderApi* | [**cancel_order**](docs/OrderApi.md#cancel_order) | **POST** /order/orders/{order_id}/cancel | Cancel an order
324
332
  *UltracartClient::OrderApi* | [**delete_order**](docs/OrderApi.md#delete_order) | **DELETE** /order/orders/{order_id} | Delete an order
325
333
  *UltracartClient::OrderApi* | [**duplicate_order**](docs/OrderApi.md#duplicate_order) | **POST** /order/orders/{order_id}/duplicate | Duplicate an order
@@ -344,6 +352,7 @@ Class | Method | HTTP request | Description
344
352
  *UltracartClient::OrderApi* | [**replacement**](docs/OrderApi.md#replacement) | **POST** /order/orders/{order_id}/replacement | Replacement order
345
353
  *UltracartClient::OrderApi* | [**resend_receipt**](docs/OrderApi.md#resend_receipt) | **POST** /order/orders/{order_id}/resend_receipt | Resend receipt
346
354
  *UltracartClient::OrderApi* | [**resend_shipment_confirmation**](docs/OrderApi.md#resend_shipment_confirmation) | **POST** /order/orders/{order_id}/resend_shipment_confirmation | Resend shipment confirmation
355
+ *UltracartClient::OrderApi* | [**unblock_refund_on_order**](docs/OrderApi.md#unblock_refund_on_order) | **POST** /order/orders/{order_id}/refund_unblock | Remove a refund block on an order
347
356
  *UltracartClient::OrderApi* | [**update_accounts_receivable_retry_config**](docs/OrderApi.md#update_accounts_receivable_retry_config) | **POST** /order/accountsReceivableRetryConfig | Update A/R Retry Configuration
348
357
  *UltracartClient::OrderApi* | [**update_order**](docs/OrderApi.md#update_order) | **PUT** /order/orders/{order_id} | Update an order
349
358
  *UltracartClient::OrderApi* | [**validate_order**](docs/OrderApi.md#validate_order) | **POST** /order/validate | Validate
@@ -896,6 +905,16 @@ Class | Method | HTTP request | Description
896
905
  - [UltracartClient::CouponsRequest](docs/CouponsRequest.md)
897
906
  - [UltracartClient::CouponsResponse](docs/CouponsResponse.md)
898
907
  - [UltracartClient::Currency](docs/Currency.md)
908
+ - [UltracartClient::CustomReport](docs/CustomReport.md)
909
+ - [UltracartClient::CustomReportAccountConfig](docs/CustomReportAccountConfig.md)
910
+ - [UltracartClient::CustomReportAccountConfigResponse](docs/CustomReportAccountConfigResponse.md)
911
+ - [UltracartClient::CustomReportExecutionParameter](docs/CustomReportExecutionParameter.md)
912
+ - [UltracartClient::CustomReportExecutionRequest](docs/CustomReportExecutionRequest.md)
913
+ - [UltracartClient::CustomReportParameter](docs/CustomReportParameter.md)
914
+ - [UltracartClient::CustomReportParameterOption](docs/CustomReportParameterOption.md)
915
+ - [UltracartClient::CustomReportQuery](docs/CustomReportQuery.md)
916
+ - [UltracartClient::CustomReportResponse](docs/CustomReportResponse.md)
917
+ - [UltracartClient::CustomReportTooltip](docs/CustomReportTooltip.md)
899
918
  - [UltracartClient::Customer](docs/Customer.md)
900
919
  - [UltracartClient::CustomerActivity](docs/CustomerActivity.md)
901
920
  - [UltracartClient::CustomerAffiliate](docs/CustomerAffiliate.md)
@@ -1530,6 +1549,8 @@ Not every change is committed to every SDK.
1530
1549
 
1531
1550
  | Version | Date | Comments |
1532
1551
  | --: | :-: | --- |
1552
+ | 4.1.15 | 07/28/2025 | new order methods for blocking and unblocking refunds |
1553
+ | 4.1.14 | 07/10/2025 | automation test |
1533
1554
  | 4.1.13 | 05/20/2025 | conversation - virtual agent flag and virtual agent cost |
1534
1555
  | 4.1.12 | 05/19/2025 | conversations - AI agent capabilities method |
1535
1556
  | 4.1.11 | 05/19/2025 | conversations - virtual AI budgets |
data/docs/AffiliateApi.md CHANGED
@@ -1,167 +1,123 @@
1
- # UltracartClient::AffiliateApi
2
-
3
- All URIs are relative to *https://secure.ultracart.com/rest/v2*
4
-
5
- | Method | HTTP request | Description |
6
- | ------ | ------------ | ----------- |
7
- | [**get_clicks_by_query**](AffiliateApi.md#get_clicks_by_query) | **POST** /affiliate/clicks/query | Retrieve clicks |
8
- | [**get_ledgers_by_query**](AffiliateApi.md#get_ledgers_by_query) | **POST** /affiliate/ledgers/query | Retrieve ledger entries |
9
-
10
-
11
- ## get_clicks_by_query
12
-
13
- > <AffiliateClicksResponse> get_clicks_by_query(click_query, opts)
14
-
15
- Retrieve clicks
16
-
17
- Retrieves a group of clicks from the account based on a query object. If no parameters are specified, the API call will fail with a bad request error. Always specify some parameters to limit the scope of the clicks returned to ones you are truly interested in. You will need to make multiple API calls in order to retrieve the entire result set since this API performs result set pagination.
18
-
19
- ### Examples
20
-
21
- ```ruby
22
- require 'time'
23
- require 'ultracart_api'
24
- require 'json'
25
- require 'yaml'
26
- require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
27
-
28
- # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
29
- # As such, this might not be the best way to use this object.
30
- # Please see https://github.com/UltraCart/sdk_samples for working examples.
31
-
32
- api = UltracartClient::AffiliateApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
33
- click_query = UltracartClient::AffiliateClickQuery.new # AffiliateClickQuery | Click query
34
- opts = {
35
- _limit: 56, # Integer | The maximum number of records to return on this one API call. (Maximum 10000)
36
- _offset: 56, # Integer | Pagination of the record set. Offset is a zero based index.
37
- _expand: '_expand_example' # String | The object expansion to perform on the result. Only option is link.
38
- }
39
-
40
- begin
41
- # Retrieve clicks
42
- result = api_instance.get_clicks_by_query(click_query, opts)
43
- p result
44
- rescue UltracartClient::ApiError => e
45
- puts "Error when calling AffiliateApi->get_clicks_by_query: #{e}"
46
- end
47
- ```
48
-
49
- #### Using the get_clicks_by_query_with_http_info variant
50
-
51
- This returns an Array which contains the response data, status code and headers.
52
-
53
- > <Array(<AffiliateClicksResponse>, Integer, Hash)> get_clicks_by_query_with_http_info(click_query, opts)
54
-
55
- ```ruby
56
- begin
57
- # Retrieve clicks
58
- data, status_code, headers = api_instance.get_clicks_by_query_with_http_info(click_query, opts)
59
- p status_code # => 2xx
60
- p headers # => { ... }
61
- p data # => <AffiliateClicksResponse>
62
- rescue UltracartClient::ApiError => e
63
- puts "Error when calling AffiliateApi->get_clicks_by_query_with_http_info: #{e}"
64
- end
65
- ```
66
-
67
- ### Parameters
68
-
69
- | Name | Type | Description | Notes |
70
- | ---- | ---- | ----------- | ----- |
71
- | **click_query** | [**AffiliateClickQuery**](AffiliateClickQuery.md) | Click query | |
72
- | **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 10000) | [optional][default to 10000] |
73
- | **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
74
- | **_expand** | **String** | The object expansion to perform on the result. Only option is link. | [optional] |
75
-
76
- ### Return type
77
-
78
- [**AffiliateClicksResponse**](AffiliateClicksResponse.md)
79
-
80
- ### Authorization
81
-
82
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
83
-
84
- ### HTTP request headers
85
-
86
- - **Content-Type**: application/json
87
- - **Accept**: application/json
88
-
89
-
90
- ## get_ledgers_by_query
91
-
92
- > <AffiliateLedgersResponse> get_ledgers_by_query(ledger_query, opts)
93
-
94
- Retrieve ledger entries
95
-
96
- Retrieves a group of ledger entries from the account based on a query object. If no parameters are specified, the API call will fail with a bad request error. Always specify some parameters to limit the scope of the ledgers returned to ones you are truly interested in. You will need to make multiple API calls in order to retrieve the entire result set since this API performs result set pagination.
97
-
98
- ### Examples
99
-
100
- ```ruby
101
- require 'time'
102
- require 'ultracart_api'
103
- require 'json'
104
- require 'yaml'
105
- require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
106
-
107
- # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
108
- # As such, this might not be the best way to use this object.
109
- # Please see https://github.com/UltraCart/sdk_samples for working examples.
110
-
111
- api = UltracartClient::AffiliateApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
112
- ledger_query = UltracartClient::AffiliateLedgerQuery.new # AffiliateLedgerQuery | Ledger query
113
- opts = {
114
- _limit: 56, # Integer | The maximum number of records to return on this one API call. (Maximum 200)
115
- _offset: 56, # Integer | Pagination of the record set. Offset is a zero based index.
116
- _expand: '_expand_example' # String | The object expansion to perform on the result. Only option is link.
117
- }
118
-
119
- begin
120
- # Retrieve ledger entries
121
- result = api_instance.get_ledgers_by_query(ledger_query, opts)
122
- p result
123
- rescue UltracartClient::ApiError => e
124
- puts "Error when calling AffiliateApi->get_ledgers_by_query: #{e}"
125
- end
126
- ```
127
-
128
- #### Using the get_ledgers_by_query_with_http_info variant
129
-
130
- This returns an Array which contains the response data, status code and headers.
131
-
132
- > <Array(<AffiliateLedgersResponse>, Integer, Hash)> get_ledgers_by_query_with_http_info(ledger_query, opts)
133
-
134
- ```ruby
135
- begin
136
- # Retrieve ledger entries
137
- data, status_code, headers = api_instance.get_ledgers_by_query_with_http_info(ledger_query, opts)
138
- p status_code # => 2xx
139
- p headers # => { ... }
140
- p data # => <AffiliateLedgersResponse>
141
- rescue UltracartClient::ApiError => e
142
- puts "Error when calling AffiliateApi->get_ledgers_by_query_with_http_info: #{e}"
143
- end
144
- ```
145
-
146
- ### Parameters
147
-
148
- | Name | Type | Description | Notes |
149
- | ---- | ---- | ----------- | ----- |
150
- | **ledger_query** | [**AffiliateLedgerQuery**](AffiliateLedgerQuery.md) | Ledger query | |
151
- | **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 200) | [optional][default to 100] |
152
- | **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
153
- | **_expand** | **String** | The object expansion to perform on the result. Only option is link. | [optional] |
154
-
155
- ### Return type
156
-
157
- [**AffiliateLedgersResponse**](AffiliateLedgersResponse.md)
158
-
159
- ### Authorization
160
-
161
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
162
-
163
- ### HTTP request headers
164
-
165
- - **Content-Type**: application/json
166
- - **Accept**: application/json
167
-
1
+ # UltracartClient::AffiliateApi
2
+
3
+ All URIs are relative to *https://secure.ultracart.com/rest/v2*
4
+
5
+ | Method | HTTP request | Description |
6
+ | ------ | ------------ | ----------- |
7
+ | [**get_clicks_by_query**](AffiliateApi.md#get_clicks_by_query) | **POST** /affiliate/clicks/query | Retrieve clicks |
8
+ | [**get_ledgers_by_query**](AffiliateApi.md#get_ledgers_by_query) | **POST** /affiliate/ledgers/query | Retrieve ledger entries |
9
+
10
+
11
+ ## get_clicks_by_query
12
+
13
+ > <AffiliateClicksResponse> get_clicks_by_query(click_query, opts)
14
+
15
+ Retrieve clicks
16
+
17
+ Retrieves a group of clicks from the account based on a query object. If no parameters are specified, the API call will fail with a bad request error. Always specify some parameters to limit the scope of the clicks returned to ones you are truly interested in. You will need to make multiple API calls in order to retrieve the entire result set since this API performs result set pagination.
18
+
19
+
20
+ ### Examples
21
+
22
+ ```ruby
23
+ # Internal API. No samples are provided as merchants will never need this api method
24
+ ```
25
+
26
+
27
+ #### Using the get_clicks_by_query_with_http_info variant
28
+
29
+ This returns an Array which contains the response data, status code and headers.
30
+
31
+ > <Array(<AffiliateClicksResponse>, Integer, Hash)> get_clicks_by_query_with_http_info(click_query, opts)
32
+
33
+ ```ruby
34
+ begin
35
+ # Retrieve clicks
36
+ data, status_code, headers = api_instance.get_clicks_by_query_with_http_info(click_query, opts)
37
+ p status_code # => 2xx
38
+ p headers # => { ... }
39
+ p data # => <AffiliateClicksResponse>
40
+ rescue UltracartClient::ApiError => e
41
+ puts "Error when calling AffiliateApi->get_clicks_by_query_with_http_info: #{e}"
42
+ end
43
+ ```
44
+
45
+ ### Parameters
46
+
47
+ | Name | Type | Description | Notes |
48
+ | ---- | ---- | ----------- | ----- |
49
+ | **click_query** | [**AffiliateClickQuery**](AffiliateClickQuery.md) | Click query | |
50
+ | **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 10000) | [optional][default to 10000] |
51
+ | **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
52
+ | **_expand** | **String** | The object expansion to perform on the result. Only option is link. | [optional] |
53
+
54
+ ### Return type
55
+
56
+ [**AffiliateClicksResponse**](AffiliateClicksResponse.md)
57
+
58
+ ### Authorization
59
+
60
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
61
+
62
+ ### HTTP request headers
63
+
64
+ - **Content-Type**: application/json
65
+ - **Accept**: application/json
66
+
67
+
68
+ ## get_ledgers_by_query
69
+
70
+ > <AffiliateLedgersResponse> get_ledgers_by_query(ledger_query, opts)
71
+
72
+ Retrieve ledger entries
73
+
74
+ Retrieves a group of ledger entries from the account based on a query object. If no parameters are specified, the API call will fail with a bad request error. Always specify some parameters to limit the scope of the ledgers returned to ones you are truly interested in. You will need to make multiple API calls in order to retrieve the entire result set since this API performs result set pagination.
75
+
76
+
77
+ ### Examples
78
+
79
+ ```ruby
80
+ # Internal API. No samples are provided as merchants will never need this api method
81
+ ```
82
+
83
+
84
+ #### Using the get_ledgers_by_query_with_http_info variant
85
+
86
+ This returns an Array which contains the response data, status code and headers.
87
+
88
+ > <Array(<AffiliateLedgersResponse>, Integer, Hash)> get_ledgers_by_query_with_http_info(ledger_query, opts)
89
+
90
+ ```ruby
91
+ begin
92
+ # Retrieve ledger entries
93
+ data, status_code, headers = api_instance.get_ledgers_by_query_with_http_info(ledger_query, opts)
94
+ p status_code # => 2xx
95
+ p headers # => { ... }
96
+ p data # => <AffiliateLedgersResponse>
97
+ rescue UltracartClient::ApiError => e
98
+ puts "Error when calling AffiliateApi->get_ledgers_by_query_with_http_info: #{e}"
99
+ end
100
+ ```
101
+
102
+ ### Parameters
103
+
104
+ | Name | Type | Description | Notes |
105
+ | ---- | ---- | ----------- | ----- |
106
+ | **ledger_query** | [**AffiliateLedgerQuery**](AffiliateLedgerQuery.md) | Ledger query | |
107
+ | **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 200) | [optional][default to 100] |
108
+ | **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
109
+ | **_expand** | **String** | The object expansion to perform on the result. Only option is link. | [optional] |
110
+
111
+ ### Return type
112
+
113
+ [**AffiliateLedgersResponse**](AffiliateLedgersResponse.md)
114
+
115
+ ### Authorization
116
+
117
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
118
+
119
+ ### HTTP request headers
120
+
121
+ - **Content-Type**: application/json
122
+ - **Accept**: application/json
123
+