ultracart_api 4.1.163 → 4.1.166

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/LICENSE +201 -201
  3. data/README.md +611 -602
  4. data/docs/AffiliateApi.md +455 -455
  5. data/docs/AutoOrderApi.md +1694 -1694
  6. data/docs/BulkApi.md +335 -335
  7. data/docs/ChannelPartnerApi.md +1678 -1678
  8. data/docs/CheckoutApi.md +1622 -1622
  9. data/docs/ConversationApi.md +7867 -7867
  10. data/docs/ConversationEmbedApi.md +226 -226
  11. data/docs/CouponApi.md +1522 -1522
  12. data/docs/CustomerApi.md +2849 -2849
  13. data/docs/DatawarehouseApi.md +1637 -1637
  14. data/docs/EmailCommseqEmailReviewStatus.md +32 -0
  15. data/docs/EmailCommseqEmailReviewStatusResponse.md +26 -0
  16. data/docs/EmailCommseqEmailReviewStatusesRequest.md +18 -0
  17. data/docs/EmailCommseqEmailReviewStatusesResponse.md +26 -0
  18. data/docs/FraudApi.md +332 -332
  19. data/docs/FulfillmentApi.md +567 -567
  20. data/docs/GiftCertificateApi.md +617 -617
  21. data/docs/IntegrationLogApi.md +290 -290
  22. data/docs/ItemApi.md +2502 -2502
  23. data/docs/OauthApi.md +311 -311
  24. data/docs/OrderApi.md +3396 -3396
  25. data/docs/SfvbApi.md +3883 -3883
  26. data/docs/SsoApi.md +223 -223
  27. data/docs/StorefrontApi.md +10143 -10035
  28. data/docs/TaxApi.md +1699 -1699
  29. data/docs/UserApi.md +606 -606
  30. data/docs/WebhookApi.md +840 -840
  31. data/docs/WorkflowApi.md +666 -666
  32. data/lib/ultracart_api/api/storefront_api.rb +143 -0
  33. data/lib/ultracart_api/models/email_commseq_email_review_status.rb +324 -0
  34. data/lib/ultracart_api/models/email_commseq_email_review_status_response.rb +256 -0
  35. data/lib/ultracart_api/models/email_commseq_email_review_statuses_request.rb +222 -0
  36. data/lib/ultracart_api/models/email_commseq_email_review_statuses_response.rb +258 -0
  37. data/lib/ultracart_api/version.rb +1 -1
  38. data/lib/ultracart_api.rb +4 -0
  39. metadata +11 -3
data/docs/AffiliateApi.md CHANGED
@@ -1,455 +1,455 @@
1
- # UltracartClient::AffiliateApi
2
-
3
- All URIs are relative to *https://secure.ultracart.com/rest/v2*
4
-
5
- | Method | HTTP request | Description |
6
- | ------ | ------------ | ----------- |
7
- | [**delete_affiliate**](AffiliateApi.md#delete_affiliate) | **DELETE** /affiliate/affiliates/{affiliate_oid} | Delete an affiliate |
8
- | [**get_affiliate**](AffiliateApi.md#get_affiliate) | **GET** /affiliate/affiliates/{affiliate_oid} | Retrieve an affiliate |
9
- | [**get_affiliates_by_query**](AffiliateApi.md#get_affiliates_by_query) | **POST** /affiliate/affiliates/query | Retrieve affiliates |
10
- | [**get_clicks_by_query**](AffiliateApi.md#get_clicks_by_query) | **POST** /affiliate/clicks/query | Retrieve clicks |
11
- | [**get_ledgers_by_query**](AffiliateApi.md#get_ledgers_by_query) | **POST** /affiliate/ledgers/query | Retrieve ledger entries |
12
- | [**insert_affiliate**](AffiliateApi.md#insert_affiliate) | **POST** /affiliate/affiliates | Insert an affiliate |
13
- | [**send_affiliate_welcome_email**](AffiliateApi.md#send_affiliate_welcome_email) | **POST** /affiliate/affiliates/{affiliate_oid}/welcome_email | Send a welcome email to an affiliate |
14
- | [**update_affiliate**](AffiliateApi.md#update_affiliate) | **PUT** /affiliate/affiliates/{affiliate_oid} | Update an affiliate |
15
-
16
-
17
- ## delete_affiliate
18
-
19
- > delete_affiliate(affiliate_oid)
20
-
21
- Delete an affiliate
22
-
23
- Delete an affiliate on the UltraCart account. The affiliate is disabled within the active affiliate program; their ledger and click history is preserved.
24
-
25
-
26
- ### Examples
27
-
28
-
29
- (No example for this operation).
30
-
31
-
32
- #### Using the delete_affiliate_with_http_info variant
33
-
34
- This returns an Array which contains the response data (`nil` in this case), status code and headers.
35
-
36
- > <Array(nil, Integer, Hash)> delete_affiliate_with_http_info(affiliate_oid)
37
-
38
- ```ruby
39
- begin
40
- # Delete an affiliate
41
- data, status_code, headers = api_instance.delete_affiliate_with_http_info(affiliate_oid)
42
- p status_code # => 2xx
43
- p headers # => { ... }
44
- p data # => nil
45
- rescue UltracartClient::ApiError => e
46
- puts "Error when calling AffiliateApi->delete_affiliate_with_http_info: #{e}"
47
- end
48
- ```
49
-
50
- ### Parameters
51
-
52
- | Name | Type | Description | Notes |
53
- | ---- | ---- | ----------- | ----- |
54
- | **affiliate_oid** | **Integer** | The affiliate oid to delete. | |
55
-
56
- ### Return type
57
-
58
- nil (empty response body)
59
-
60
- ### Authorization
61
-
62
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
63
-
64
- ### HTTP request headers
65
-
66
- - **Content-Type**: Not defined
67
- - **Accept**: application/json
68
-
69
-
70
- ## get_affiliate
71
-
72
- > <AffiliateResponse> get_affiliate(affiliate_oid, opts)
73
-
74
- Retrieve an affiliate
75
-
76
- Retrieves a single affiliate using the specified affiliate oid.
77
-
78
-
79
- ### Examples
80
-
81
-
82
- (No example for this operation).
83
-
84
-
85
- #### Using the get_affiliate_with_http_info variant
86
-
87
- This returns an Array which contains the response data, status code and headers.
88
-
89
- > <Array(<AffiliateResponse>, Integer, Hash)> get_affiliate_with_http_info(affiliate_oid, opts)
90
-
91
- ```ruby
92
- begin
93
- # Retrieve an affiliate
94
- data, status_code, headers = api_instance.get_affiliate_with_http_info(affiliate_oid, opts)
95
- p status_code # => 2xx
96
- p headers # => { ... }
97
- p data # => <AffiliateResponse>
98
- rescue UltracartClient::ApiError => e
99
- puts "Error when calling AffiliateApi->get_affiliate_with_http_info: #{e}"
100
- end
101
- ```
102
-
103
- ### Parameters
104
-
105
- | Name | Type | Description | Notes |
106
- | ---- | ---- | ----------- | ----- |
107
- | **affiliate_oid** | **Integer** | The affiliate oid to retrieve. | |
108
- | **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
109
-
110
- ### Return type
111
-
112
- [**AffiliateResponse**](AffiliateResponse.md)
113
-
114
- ### Authorization
115
-
116
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
117
-
118
- ### HTTP request headers
119
-
120
- - **Content-Type**: Not defined
121
- - **Accept**: application/json
122
-
123
-
124
- ## get_affiliates_by_query
125
-
126
- > <AffiliatesResponse> get_affiliates_by_query(affiliate_query, opts)
127
-
128
- Retrieve affiliates
129
-
130
- Retrieves a group of affiliates 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 affiliates 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.
131
-
132
-
133
- ### Examples
134
-
135
-
136
- (No example for this operation).
137
-
138
-
139
- #### Using the get_affiliates_by_query_with_http_info variant
140
-
141
- This returns an Array which contains the response data, status code and headers.
142
-
143
- > <Array(<AffiliatesResponse>, Integer, Hash)> get_affiliates_by_query_with_http_info(affiliate_query, opts)
144
-
145
- ```ruby
146
- begin
147
- # Retrieve affiliates
148
- data, status_code, headers = api_instance.get_affiliates_by_query_with_http_info(affiliate_query, opts)
149
- p status_code # => 2xx
150
- p headers # => { ... }
151
- p data # => <AffiliatesResponse>
152
- rescue UltracartClient::ApiError => e
153
- puts "Error when calling AffiliateApi->get_affiliates_by_query_with_http_info: #{e}"
154
- end
155
- ```
156
-
157
- ### Parameters
158
-
159
- | Name | Type | Description | Notes |
160
- | ---- | ---- | ----------- | ----- |
161
- | **affiliate_query** | [**AffiliateQuery**](AffiliateQuery.md) | Affiliate query | |
162
- | **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 200) | [optional][default to 100] |
163
- | **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
164
- | **_sort** | **String** | The sort order of the affiliates. See Sorting documentation for examples of using multiple values and sorting by ascending and descending. | [optional] |
165
-
166
- ### Return type
167
-
168
- [**AffiliatesResponse**](AffiliatesResponse.md)
169
-
170
- ### Authorization
171
-
172
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
173
-
174
- ### HTTP request headers
175
-
176
- - **Content-Type**: application/json
177
- - **Accept**: application/json
178
-
179
-
180
- ## get_clicks_by_query
181
-
182
- > <AffiliateClicksResponse> get_clicks_by_query(click_query, opts)
183
-
184
- Retrieve clicks
185
-
186
- 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.
187
-
188
-
189
- ### Examples
190
-
191
- ```ruby
192
- # Internal API. No samples are provided as merchants will never need this api method
193
- ```
194
-
195
-
196
- #### Using the get_clicks_by_query_with_http_info variant
197
-
198
- This returns an Array which contains the response data, status code and headers.
199
-
200
- > <Array(<AffiliateClicksResponse>, Integer, Hash)> get_clicks_by_query_with_http_info(click_query, opts)
201
-
202
- ```ruby
203
- begin
204
- # Retrieve clicks
205
- data, status_code, headers = api_instance.get_clicks_by_query_with_http_info(click_query, opts)
206
- p status_code # => 2xx
207
- p headers # => { ... }
208
- p data # => <AffiliateClicksResponse>
209
- rescue UltracartClient::ApiError => e
210
- puts "Error when calling AffiliateApi->get_clicks_by_query_with_http_info: #{e}"
211
- end
212
- ```
213
-
214
- ### Parameters
215
-
216
- | Name | Type | Description | Notes |
217
- | ---- | ---- | ----------- | ----- |
218
- | **click_query** | [**AffiliateClickQuery**](AffiliateClickQuery.md) | Click query | |
219
- | **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 10000) | [optional][default to 10000] |
220
- | **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
221
- | **_expand** | **String** | The object expansion to perform on the result. Only option is link. | [optional] |
222
-
223
- ### Return type
224
-
225
- [**AffiliateClicksResponse**](AffiliateClicksResponse.md)
226
-
227
- ### Authorization
228
-
229
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
230
-
231
- ### HTTP request headers
232
-
233
- - **Content-Type**: application/json
234
- - **Accept**: application/json
235
-
236
-
237
- ## get_ledgers_by_query
238
-
239
- > <AffiliateLedgersResponse> get_ledgers_by_query(ledger_query, opts)
240
-
241
- Retrieve ledger entries
242
-
243
- 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.
244
-
245
-
246
- ### Examples
247
-
248
- ```ruby
249
- # Internal API. No samples are provided as merchants will never need this api method
250
- ```
251
-
252
-
253
- #### Using the get_ledgers_by_query_with_http_info variant
254
-
255
- This returns an Array which contains the response data, status code and headers.
256
-
257
- > <Array(<AffiliateLedgersResponse>, Integer, Hash)> get_ledgers_by_query_with_http_info(ledger_query, opts)
258
-
259
- ```ruby
260
- begin
261
- # Retrieve ledger entries
262
- data, status_code, headers = api_instance.get_ledgers_by_query_with_http_info(ledger_query, opts)
263
- p status_code # => 2xx
264
- p headers # => { ... }
265
- p data # => <AffiliateLedgersResponse>
266
- rescue UltracartClient::ApiError => e
267
- puts "Error when calling AffiliateApi->get_ledgers_by_query_with_http_info: #{e}"
268
- end
269
- ```
270
-
271
- ### Parameters
272
-
273
- | Name | Type | Description | Notes |
274
- | ---- | ---- | ----------- | ----- |
275
- | **ledger_query** | [**AffiliateLedgerQuery**](AffiliateLedgerQuery.md) | Ledger query | |
276
- | **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 200) | [optional][default to 100] |
277
- | **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
278
- | **_expand** | **String** | The object expansion to perform on the result. Only option is link. | [optional] |
279
-
280
- ### Return type
281
-
282
- [**AffiliateLedgersResponse**](AffiliateLedgersResponse.md)
283
-
284
- ### Authorization
285
-
286
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
287
-
288
- ### HTTP request headers
289
-
290
- - **Content-Type**: application/json
291
- - **Accept**: application/json
292
-
293
-
294
- ## insert_affiliate
295
-
296
- > <AffiliateResponse> insert_affiliate(affiliate, opts)
297
-
298
- Insert an affiliate
299
-
300
- Insert an affiliate on the UltraCart account. The affiliate is created within the merchant's active affiliate program.
301
-
302
-
303
- ### Examples
304
-
305
-
306
- (No example for this operation).
307
-
308
-
309
- #### Using the insert_affiliate_with_http_info variant
310
-
311
- This returns an Array which contains the response data, status code and headers.
312
-
313
- > <Array(<AffiliateResponse>, Integer, Hash)> insert_affiliate_with_http_info(affiliate, opts)
314
-
315
- ```ruby
316
- begin
317
- # Insert an affiliate
318
- data, status_code, headers = api_instance.insert_affiliate_with_http_info(affiliate, opts)
319
- p status_code # => 2xx
320
- p headers # => { ... }
321
- p data # => <AffiliateResponse>
322
- rescue UltracartClient::ApiError => e
323
- puts "Error when calling AffiliateApi->insert_affiliate_with_http_info: #{e}"
324
- end
325
- ```
326
-
327
- ### Parameters
328
-
329
- | Name | Type | Description | Notes |
330
- | ---- | ---- | ----------- | ----- |
331
- | **affiliate** | [**Affiliate**](Affiliate.md) | Affiliate to insert | |
332
- | **send_welcome_email** | **Boolean** | Whether to send a welcome email to the affiliate after it is created. Defaults to false. | [optional][default to false] |
333
- | **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
334
-
335
- ### Return type
336
-
337
- [**AffiliateResponse**](AffiliateResponse.md)
338
-
339
- ### Authorization
340
-
341
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
342
-
343
- ### HTTP request headers
344
-
345
- - **Content-Type**: application/json; charset=UTF-8
346
- - **Accept**: application/json
347
-
348
-
349
- ## send_affiliate_welcome_email
350
-
351
- > send_affiliate_welcome_email(affiliate_oid)
352
-
353
- Send a welcome email to an affiliate
354
-
355
- Sends a welcome email to the specified affiliate using the welcome letter configured on the merchant's active affiliate program.
356
-
357
-
358
- ### Examples
359
-
360
-
361
- (No example for this operation).
362
-
363
-
364
- #### Using the send_affiliate_welcome_email_with_http_info variant
365
-
366
- This returns an Array which contains the response data (`nil` in this case), status code and headers.
367
-
368
- > <Array(nil, Integer, Hash)> send_affiliate_welcome_email_with_http_info(affiliate_oid)
369
-
370
- ```ruby
371
- begin
372
- # Send a welcome email to an affiliate
373
- data, status_code, headers = api_instance.send_affiliate_welcome_email_with_http_info(affiliate_oid)
374
- p status_code # => 2xx
375
- p headers # => { ... }
376
- p data # => nil
377
- rescue UltracartClient::ApiError => e
378
- puts "Error when calling AffiliateApi->send_affiliate_welcome_email_with_http_info: #{e}"
379
- end
380
- ```
381
-
382
- ### Parameters
383
-
384
- | Name | Type | Description | Notes |
385
- | ---- | ---- | ----------- | ----- |
386
- | **affiliate_oid** | **Integer** | The affiliate oid to send the welcome email to. | |
387
-
388
- ### Return type
389
-
390
- nil (empty response body)
391
-
392
- ### Authorization
393
-
394
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
395
-
396
- ### HTTP request headers
397
-
398
- - **Content-Type**: Not defined
399
- - **Accept**: application/json
400
-
401
-
402
- ## update_affiliate
403
-
404
- > <AffiliateResponse> update_affiliate(affiliate_oid, affiliate, opts)
405
-
406
- Update an affiliate
407
-
408
- Update an affiliate on the UltraCart account. This is a full replacement of the affiliate; omitted fields are reset to their defaults, with the exception of password which is only changed when supplied.
409
-
410
-
411
- ### Examples
412
-
413
-
414
- (No example for this operation).
415
-
416
-
417
- #### Using the update_affiliate_with_http_info variant
418
-
419
- This returns an Array which contains the response data, status code and headers.
420
-
421
- > <Array(<AffiliateResponse>, Integer, Hash)> update_affiliate_with_http_info(affiliate_oid, affiliate, opts)
422
-
423
- ```ruby
424
- begin
425
- # Update an affiliate
426
- data, status_code, headers = api_instance.update_affiliate_with_http_info(affiliate_oid, affiliate, opts)
427
- p status_code # => 2xx
428
- p headers # => { ... }
429
- p data # => <AffiliateResponse>
430
- rescue UltracartClient::ApiError => e
431
- puts "Error when calling AffiliateApi->update_affiliate_with_http_info: #{e}"
432
- end
433
- ```
434
-
435
- ### Parameters
436
-
437
- | Name | Type | Description | Notes |
438
- | ---- | ---- | ----------- | ----- |
439
- | **affiliate_oid** | **Integer** | The affiliate oid to update. | |
440
- | **affiliate** | [**Affiliate**](Affiliate.md) | Affiliate to update | |
441
- | **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
442
-
443
- ### Return type
444
-
445
- [**AffiliateResponse**](AffiliateResponse.md)
446
-
447
- ### Authorization
448
-
449
- [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
450
-
451
- ### HTTP request headers
452
-
453
- - **Content-Type**: application/json; charset=UTF-8
454
- - **Accept**: application/json
455
-
1
+ # UltracartClient::AffiliateApi
2
+
3
+ All URIs are relative to *https://secure.ultracart.com/rest/v2*
4
+
5
+ | Method | HTTP request | Description |
6
+ | ------ | ------------ | ----------- |
7
+ | [**delete_affiliate**](AffiliateApi.md#delete_affiliate) | **DELETE** /affiliate/affiliates/{affiliate_oid} | Delete an affiliate |
8
+ | [**get_affiliate**](AffiliateApi.md#get_affiliate) | **GET** /affiliate/affiliates/{affiliate_oid} | Retrieve an affiliate |
9
+ | [**get_affiliates_by_query**](AffiliateApi.md#get_affiliates_by_query) | **POST** /affiliate/affiliates/query | Retrieve affiliates |
10
+ | [**get_clicks_by_query**](AffiliateApi.md#get_clicks_by_query) | **POST** /affiliate/clicks/query | Retrieve clicks |
11
+ | [**get_ledgers_by_query**](AffiliateApi.md#get_ledgers_by_query) | **POST** /affiliate/ledgers/query | Retrieve ledger entries |
12
+ | [**insert_affiliate**](AffiliateApi.md#insert_affiliate) | **POST** /affiliate/affiliates | Insert an affiliate |
13
+ | [**send_affiliate_welcome_email**](AffiliateApi.md#send_affiliate_welcome_email) | **POST** /affiliate/affiliates/{affiliate_oid}/welcome_email | Send a welcome email to an affiliate |
14
+ | [**update_affiliate**](AffiliateApi.md#update_affiliate) | **PUT** /affiliate/affiliates/{affiliate_oid} | Update an affiliate |
15
+
16
+
17
+ ## delete_affiliate
18
+
19
+ > delete_affiliate(affiliate_oid)
20
+
21
+ Delete an affiliate
22
+
23
+ Delete an affiliate on the UltraCart account. The affiliate is disabled within the active affiliate program; their ledger and click history is preserved.
24
+
25
+
26
+ ### Examples
27
+
28
+
29
+ (No example for this operation).
30
+
31
+
32
+ #### Using the delete_affiliate_with_http_info variant
33
+
34
+ This returns an Array which contains the response data (`nil` in this case), status code and headers.
35
+
36
+ > <Array(nil, Integer, Hash)> delete_affiliate_with_http_info(affiliate_oid)
37
+
38
+ ```ruby
39
+ begin
40
+ # Delete an affiliate
41
+ data, status_code, headers = api_instance.delete_affiliate_with_http_info(affiliate_oid)
42
+ p status_code # => 2xx
43
+ p headers # => { ... }
44
+ p data # => nil
45
+ rescue UltracartClient::ApiError => e
46
+ puts "Error when calling AffiliateApi->delete_affiliate_with_http_info: #{e}"
47
+ end
48
+ ```
49
+
50
+ ### Parameters
51
+
52
+ | Name | Type | Description | Notes |
53
+ | ---- | ---- | ----------- | ----- |
54
+ | **affiliate_oid** | **Integer** | The affiliate oid to delete. | |
55
+
56
+ ### Return type
57
+
58
+ nil (empty response body)
59
+
60
+ ### Authorization
61
+
62
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
63
+
64
+ ### HTTP request headers
65
+
66
+ - **Content-Type**: Not defined
67
+ - **Accept**: application/json
68
+
69
+
70
+ ## get_affiliate
71
+
72
+ > <AffiliateResponse> get_affiliate(affiliate_oid, opts)
73
+
74
+ Retrieve an affiliate
75
+
76
+ Retrieves a single affiliate using the specified affiliate oid.
77
+
78
+
79
+ ### Examples
80
+
81
+
82
+ (No example for this operation).
83
+
84
+
85
+ #### Using the get_affiliate_with_http_info variant
86
+
87
+ This returns an Array which contains the response data, status code and headers.
88
+
89
+ > <Array(<AffiliateResponse>, Integer, Hash)> get_affiliate_with_http_info(affiliate_oid, opts)
90
+
91
+ ```ruby
92
+ begin
93
+ # Retrieve an affiliate
94
+ data, status_code, headers = api_instance.get_affiliate_with_http_info(affiliate_oid, opts)
95
+ p status_code # => 2xx
96
+ p headers # => { ... }
97
+ p data # => <AffiliateResponse>
98
+ rescue UltracartClient::ApiError => e
99
+ puts "Error when calling AffiliateApi->get_affiliate_with_http_info: #{e}"
100
+ end
101
+ ```
102
+
103
+ ### Parameters
104
+
105
+ | Name | Type | Description | Notes |
106
+ | ---- | ---- | ----------- | ----- |
107
+ | **affiliate_oid** | **Integer** | The affiliate oid to retrieve. | |
108
+ | **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
109
+
110
+ ### Return type
111
+
112
+ [**AffiliateResponse**](AffiliateResponse.md)
113
+
114
+ ### Authorization
115
+
116
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
117
+
118
+ ### HTTP request headers
119
+
120
+ - **Content-Type**: Not defined
121
+ - **Accept**: application/json
122
+
123
+
124
+ ## get_affiliates_by_query
125
+
126
+ > <AffiliatesResponse> get_affiliates_by_query(affiliate_query, opts)
127
+
128
+ Retrieve affiliates
129
+
130
+ Retrieves a group of affiliates 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 affiliates 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.
131
+
132
+
133
+ ### Examples
134
+
135
+
136
+ (No example for this operation).
137
+
138
+
139
+ #### Using the get_affiliates_by_query_with_http_info variant
140
+
141
+ This returns an Array which contains the response data, status code and headers.
142
+
143
+ > <Array(<AffiliatesResponse>, Integer, Hash)> get_affiliates_by_query_with_http_info(affiliate_query, opts)
144
+
145
+ ```ruby
146
+ begin
147
+ # Retrieve affiliates
148
+ data, status_code, headers = api_instance.get_affiliates_by_query_with_http_info(affiliate_query, opts)
149
+ p status_code # => 2xx
150
+ p headers # => { ... }
151
+ p data # => <AffiliatesResponse>
152
+ rescue UltracartClient::ApiError => e
153
+ puts "Error when calling AffiliateApi->get_affiliates_by_query_with_http_info: #{e}"
154
+ end
155
+ ```
156
+
157
+ ### Parameters
158
+
159
+ | Name | Type | Description | Notes |
160
+ | ---- | ---- | ----------- | ----- |
161
+ | **affiliate_query** | [**AffiliateQuery**](AffiliateQuery.md) | Affiliate query | |
162
+ | **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 200) | [optional][default to 100] |
163
+ | **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
164
+ | **_sort** | **String** | The sort order of the affiliates. See Sorting documentation for examples of using multiple values and sorting by ascending and descending. | [optional] |
165
+
166
+ ### Return type
167
+
168
+ [**AffiliatesResponse**](AffiliatesResponse.md)
169
+
170
+ ### Authorization
171
+
172
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
173
+
174
+ ### HTTP request headers
175
+
176
+ - **Content-Type**: application/json
177
+ - **Accept**: application/json
178
+
179
+
180
+ ## get_clicks_by_query
181
+
182
+ > <AffiliateClicksResponse> get_clicks_by_query(click_query, opts)
183
+
184
+ Retrieve clicks
185
+
186
+ 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.
187
+
188
+
189
+ ### Examples
190
+
191
+ ```ruby
192
+ # Internal API. No samples are provided as merchants will never need this api method
193
+ ```
194
+
195
+
196
+ #### Using the get_clicks_by_query_with_http_info variant
197
+
198
+ This returns an Array which contains the response data, status code and headers.
199
+
200
+ > <Array(<AffiliateClicksResponse>, Integer, Hash)> get_clicks_by_query_with_http_info(click_query, opts)
201
+
202
+ ```ruby
203
+ begin
204
+ # Retrieve clicks
205
+ data, status_code, headers = api_instance.get_clicks_by_query_with_http_info(click_query, opts)
206
+ p status_code # => 2xx
207
+ p headers # => { ... }
208
+ p data # => <AffiliateClicksResponse>
209
+ rescue UltracartClient::ApiError => e
210
+ puts "Error when calling AffiliateApi->get_clicks_by_query_with_http_info: #{e}"
211
+ end
212
+ ```
213
+
214
+ ### Parameters
215
+
216
+ | Name | Type | Description | Notes |
217
+ | ---- | ---- | ----------- | ----- |
218
+ | **click_query** | [**AffiliateClickQuery**](AffiliateClickQuery.md) | Click query | |
219
+ | **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 10000) | [optional][default to 10000] |
220
+ | **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
221
+ | **_expand** | **String** | The object expansion to perform on the result. Only option is link. | [optional] |
222
+
223
+ ### Return type
224
+
225
+ [**AffiliateClicksResponse**](AffiliateClicksResponse.md)
226
+
227
+ ### Authorization
228
+
229
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
230
+
231
+ ### HTTP request headers
232
+
233
+ - **Content-Type**: application/json
234
+ - **Accept**: application/json
235
+
236
+
237
+ ## get_ledgers_by_query
238
+
239
+ > <AffiliateLedgersResponse> get_ledgers_by_query(ledger_query, opts)
240
+
241
+ Retrieve ledger entries
242
+
243
+ 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.
244
+
245
+
246
+ ### Examples
247
+
248
+ ```ruby
249
+ # Internal API. No samples are provided as merchants will never need this api method
250
+ ```
251
+
252
+
253
+ #### Using the get_ledgers_by_query_with_http_info variant
254
+
255
+ This returns an Array which contains the response data, status code and headers.
256
+
257
+ > <Array(<AffiliateLedgersResponse>, Integer, Hash)> get_ledgers_by_query_with_http_info(ledger_query, opts)
258
+
259
+ ```ruby
260
+ begin
261
+ # Retrieve ledger entries
262
+ data, status_code, headers = api_instance.get_ledgers_by_query_with_http_info(ledger_query, opts)
263
+ p status_code # => 2xx
264
+ p headers # => { ... }
265
+ p data # => <AffiliateLedgersResponse>
266
+ rescue UltracartClient::ApiError => e
267
+ puts "Error when calling AffiliateApi->get_ledgers_by_query_with_http_info: #{e}"
268
+ end
269
+ ```
270
+
271
+ ### Parameters
272
+
273
+ | Name | Type | Description | Notes |
274
+ | ---- | ---- | ----------- | ----- |
275
+ | **ledger_query** | [**AffiliateLedgerQuery**](AffiliateLedgerQuery.md) | Ledger query | |
276
+ | **_limit** | **Integer** | The maximum number of records to return on this one API call. (Maximum 200) | [optional][default to 100] |
277
+ | **_offset** | **Integer** | Pagination of the record set. Offset is a zero based index. | [optional][default to 0] |
278
+ | **_expand** | **String** | The object expansion to perform on the result. Only option is link. | [optional] |
279
+
280
+ ### Return type
281
+
282
+ [**AffiliateLedgersResponse**](AffiliateLedgersResponse.md)
283
+
284
+ ### Authorization
285
+
286
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
287
+
288
+ ### HTTP request headers
289
+
290
+ - **Content-Type**: application/json
291
+ - **Accept**: application/json
292
+
293
+
294
+ ## insert_affiliate
295
+
296
+ > <AffiliateResponse> insert_affiliate(affiliate, opts)
297
+
298
+ Insert an affiliate
299
+
300
+ Insert an affiliate on the UltraCart account. The affiliate is created within the merchant's active affiliate program.
301
+
302
+
303
+ ### Examples
304
+
305
+
306
+ (No example for this operation).
307
+
308
+
309
+ #### Using the insert_affiliate_with_http_info variant
310
+
311
+ This returns an Array which contains the response data, status code and headers.
312
+
313
+ > <Array(<AffiliateResponse>, Integer, Hash)> insert_affiliate_with_http_info(affiliate, opts)
314
+
315
+ ```ruby
316
+ begin
317
+ # Insert an affiliate
318
+ data, status_code, headers = api_instance.insert_affiliate_with_http_info(affiliate, opts)
319
+ p status_code # => 2xx
320
+ p headers # => { ... }
321
+ p data # => <AffiliateResponse>
322
+ rescue UltracartClient::ApiError => e
323
+ puts "Error when calling AffiliateApi->insert_affiliate_with_http_info: #{e}"
324
+ end
325
+ ```
326
+
327
+ ### Parameters
328
+
329
+ | Name | Type | Description | Notes |
330
+ | ---- | ---- | ----------- | ----- |
331
+ | **affiliate** | [**Affiliate**](Affiliate.md) | Affiliate to insert | |
332
+ | **send_welcome_email** | **Boolean** | Whether to send a welcome email to the affiliate after it is created. Defaults to false. | [optional][default to false] |
333
+ | **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
334
+
335
+ ### Return type
336
+
337
+ [**AffiliateResponse**](AffiliateResponse.md)
338
+
339
+ ### Authorization
340
+
341
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
342
+
343
+ ### HTTP request headers
344
+
345
+ - **Content-Type**: application/json; charset=UTF-8
346
+ - **Accept**: application/json
347
+
348
+
349
+ ## send_affiliate_welcome_email
350
+
351
+ > send_affiliate_welcome_email(affiliate_oid)
352
+
353
+ Send a welcome email to an affiliate
354
+
355
+ Sends a welcome email to the specified affiliate using the welcome letter configured on the merchant's active affiliate program.
356
+
357
+
358
+ ### Examples
359
+
360
+
361
+ (No example for this operation).
362
+
363
+
364
+ #### Using the send_affiliate_welcome_email_with_http_info variant
365
+
366
+ This returns an Array which contains the response data (`nil` in this case), status code and headers.
367
+
368
+ > <Array(nil, Integer, Hash)> send_affiliate_welcome_email_with_http_info(affiliate_oid)
369
+
370
+ ```ruby
371
+ begin
372
+ # Send a welcome email to an affiliate
373
+ data, status_code, headers = api_instance.send_affiliate_welcome_email_with_http_info(affiliate_oid)
374
+ p status_code # => 2xx
375
+ p headers # => { ... }
376
+ p data # => nil
377
+ rescue UltracartClient::ApiError => e
378
+ puts "Error when calling AffiliateApi->send_affiliate_welcome_email_with_http_info: #{e}"
379
+ end
380
+ ```
381
+
382
+ ### Parameters
383
+
384
+ | Name | Type | Description | Notes |
385
+ | ---- | ---- | ----------- | ----- |
386
+ | **affiliate_oid** | **Integer** | The affiliate oid to send the welcome email to. | |
387
+
388
+ ### Return type
389
+
390
+ nil (empty response body)
391
+
392
+ ### Authorization
393
+
394
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
395
+
396
+ ### HTTP request headers
397
+
398
+ - **Content-Type**: Not defined
399
+ - **Accept**: application/json
400
+
401
+
402
+ ## update_affiliate
403
+
404
+ > <AffiliateResponse> update_affiliate(affiliate_oid, affiliate, opts)
405
+
406
+ Update an affiliate
407
+
408
+ Update an affiliate on the UltraCart account. This is a full replacement of the affiliate; omitted fields are reset to their defaults, with the exception of password which is only changed when supplied.
409
+
410
+
411
+ ### Examples
412
+
413
+
414
+ (No example for this operation).
415
+
416
+
417
+ #### Using the update_affiliate_with_http_info variant
418
+
419
+ This returns an Array which contains the response data, status code and headers.
420
+
421
+ > <Array(<AffiliateResponse>, Integer, Hash)> update_affiliate_with_http_info(affiliate_oid, affiliate, opts)
422
+
423
+ ```ruby
424
+ begin
425
+ # Update an affiliate
426
+ data, status_code, headers = api_instance.update_affiliate_with_http_info(affiliate_oid, affiliate, opts)
427
+ p status_code # => 2xx
428
+ p headers # => { ... }
429
+ p data # => <AffiliateResponse>
430
+ rescue UltracartClient::ApiError => e
431
+ puts "Error when calling AffiliateApi->update_affiliate_with_http_info: #{e}"
432
+ end
433
+ ```
434
+
435
+ ### Parameters
436
+
437
+ | Name | Type | Description | Notes |
438
+ | ---- | ---- | ----------- | ----- |
439
+ | **affiliate_oid** | **Integer** | The affiliate oid to update. | |
440
+ | **affiliate** | [**Affiliate**](Affiliate.md) | Affiliate to update | |
441
+ | **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
442
+
443
+ ### Return type
444
+
445
+ [**AffiliateResponse**](AffiliateResponse.md)
446
+
447
+ ### Authorization
448
+
449
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
450
+
451
+ ### HTTP request headers
452
+
453
+ - **Content-Type**: application/json; charset=UTF-8
454
+ - **Accept**: application/json
455
+