ultracart_api 4.1.121 → 4.1.124
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.
- checksums.yaml +4 -4
- data/README.md +14 -2
- data/docs/AutoOrderApi.md +111 -0
- data/docs/AutoOrderPaymentUpdateRequest.md +28 -0
- data/docs/AutoOrderRebillResponse.md +34 -0
- data/docs/CustomerApi.md +55 -0
- data/docs/CustomerEmailSuppressionRequest.md +26 -0
- data/docs/CustomerEmailSuppressionResponse.md +26 -0
- data/docs/CustomerEmailSuppressionResult.md +40 -0
- data/docs/EmailSettings.md +2 -0
- data/docs/EmailSuppressionSurfaces.md +22 -0
- data/docs/TaxCountry.md +5 -1
- data/docs/TaxState.md +5 -1
- data/lib/ultracart_api/api/auto_order_api.rb +145 -0
- data/lib/ultracart_api/api/customer_api.rb +75 -0
- data/lib/ultracart_api/models/auto_order_payment_update_request.rb +304 -0
- data/lib/ultracart_api/models/auto_order_rebill_response.rb +296 -0
- data/lib/ultracart_api/models/customer_email_suppression_request.rb +294 -0
- data/lib/ultracart_api/models/customer_email_suppression_response.rb +256 -0
- data/lib/ultracart_api/models/customer_email_suppression_result.rb +329 -0
- data/lib/ultracart_api/models/email_settings.rb +11 -1
- data/lib/ultracart_api/models/email_suppression_surfaces.rb +240 -0
- data/lib/ultracart_api/models/tax_country.rb +24 -4
- data/lib/ultracart_api/models/tax_state.rb +24 -4
- data/lib/ultracart_api/version.rb +1 -1
- data/lib/ultracart_api.rb +6 -0
- metadata +14 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 18d43bd543cc8099b995151cb2e8eba1b3d395ebf4295b7dda09f6e0b551e6ff
|
|
4
|
+
data.tar.gz: 31bdb671cf67931fdfd9cebd7dcc86a9c62a625b7582db370f43def75bb61b1e
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: dc463b0191fd737be10900d9ad5099d5fb66460f356b6976222873d7f8161ff399744eeb4401dd5b0c1a1253689bcdb308507f1c3886b466b9b075e09ff694a5
|
|
7
|
+
data.tar.gz: 9579f70e1d58c91f7a3b2fb9c89c38db34adc26b28deb6e5e18414006926ba69c703b72e51e37730329af97d3bd730f1012a19f4f9583a4128bf689013f3dddd
|
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.
|
|
10
|
+
- Package version: 4.1.124
|
|
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.
|
|
19
|
+
gem 'ultracart_api', '4.1.124'
|
|
20
20
|
```
|
|
21
21
|
|
|
22
22
|
install:
|
|
@@ -90,6 +90,7 @@ Class | Method | HTTP request | Description
|
|
|
90
90
|
*UltracartClient::AffiliateApi* | [**insert_affiliate**](docs/AffiliateApi.md#insert_affiliate) | **POST** /affiliate/affiliates | Insert an affiliate
|
|
91
91
|
*UltracartClient::AffiliateApi* | [**send_affiliate_welcome_email**](docs/AffiliateApi.md#send_affiliate_welcome_email) | **POST** /affiliate/affiliates/{affiliate_oid}/welcome_email | Send a welcome email to an affiliate
|
|
92
92
|
*UltracartClient::AffiliateApi* | [**update_affiliate**](docs/AffiliateApi.md#update_affiliate) | **PUT** /affiliate/affiliates/{affiliate_oid} | Update an affiliate
|
|
93
|
+
*UltracartClient::AutoOrderApi* | [**attempt_auto_order_rebill**](docs/AutoOrderApi.md#attempt_auto_order_rebill) | **POST** /auto_order/auto_orders/{auto_order_oid}/rebill | Attempt a failed rebill on an auto order
|
|
93
94
|
*UltracartClient::AutoOrderApi* | [**cancel_auto_order_item_by_reference_order_id**](docs/AutoOrderApi.md#cancel_auto_order_item_by_reference_order_id) | **POST** /auto_order/auto_orders/reference_order_id/{reference_order_id}/items/original/{original_item_id}/cancel | Cancel a single item on an auto order
|
|
94
95
|
*UltracartClient::AutoOrderApi* | [**consolidate_auto_orders**](docs/AutoOrderApi.md#consolidate_auto_orders) | **PUT** /auto_order/auto_orders/{auto_order_oid}/consolidate | Consolidates multiple auto orders
|
|
95
96
|
*UltracartClient::AutoOrderApi* | [**establish_auto_order_by_reference_order_id**](docs/AutoOrderApi.md#establish_auto_order_by_reference_order_id) | **POST** /auto_order/auto_orders/reference_order_id/{reference_order_id} | Establish an auto order by referencing a regular order id
|
|
@@ -105,6 +106,7 @@ Class | Method | HTTP request | Description
|
|
|
105
106
|
*UltracartClient::AutoOrderApi* | [**update_auto_order**](docs/AutoOrderApi.md#update_auto_order) | **PUT** /auto_order/auto_orders/{auto_order_oid} | Update an auto order
|
|
106
107
|
*UltracartClient::AutoOrderApi* | [**update_auto_order_item_add_ons**](docs/AutoOrderApi.md#update_auto_order_item_add_ons) | **PUT** /auto_order/auto_orders/{auto_order_oid}/items/{auto_order_item_oid}/add_ons | Update an auto order item add ons
|
|
107
108
|
*UltracartClient::AutoOrderApi* | [**update_auto_order_item_properties**](docs/AutoOrderApi.md#update_auto_order_item_properties) | **PUT** /auto_order/auto_orders/{auto_order_oid}/items/{auto_order_item_oid}/properties | Update an auto order item properties
|
|
109
|
+
*UltracartClient::AutoOrderApi* | [**update_auto_order_payment**](docs/AutoOrderApi.md#update_auto_order_payment) | **PUT** /auto_order/auto_orders/{auto_order_oid}/payment | Update the payment information on an auto order
|
|
108
110
|
*UltracartClient::AutoOrderApi* | [**update_auto_order_properties**](docs/AutoOrderApi.md#update_auto_order_properties) | **PUT** /auto_order/auto_orders/{auto_order_oid}/properties | Update an auto order properties
|
|
109
111
|
*UltracartClient::AutoOrderApi* | [**update_auto_orders_batch**](docs/AutoOrderApi.md#update_auto_orders_batch) | **PUT** /auto_order/auto_orders/batch | Update multiple auto orders
|
|
110
112
|
*UltracartClient::BulkApi* | [**bulk_cancel_job**](docs/BulkApi.md#bulk_cancel_job) | **DELETE** /bulk/{object}/{job_id} | Request cancellation of a bulk job
|
|
@@ -335,6 +337,7 @@ Class | Method | HTTP request | Description
|
|
|
335
337
|
*UltracartClient::CustomerApi* | [**search_customers**](docs/CustomerApi.md#search_customers) | **GET** /customer/customers/search | Search for customers
|
|
336
338
|
*UltracartClient::CustomerApi* | [**update_customer**](docs/CustomerApi.md#update_customer) | **PUT** /customer/customers/{customer_profile_oid} | Update a customer
|
|
337
339
|
*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
|
|
340
|
+
*UltracartClient::CustomerApi* | [**update_customer_email_suppression**](docs/CustomerApi.md#update_customer_email_suppression) | **POST** /customer/customers/{customer_profile_oid}/email_suppression | Clear email suppression for a customer
|
|
338
341
|
*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
|
|
339
342
|
*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
|
|
340
343
|
*UltracartClient::DatawarehouseApi* | [**analyze_custom_report**](docs/DatawarehouseApi.md#analyze_custom_report) | **PUT** /datawarehouse/custom_reports/{custom_report_oid}/analysis | Analyze a custom report
|
|
@@ -764,10 +767,12 @@ Class | Method | HTTP request | Description
|
|
|
764
767
|
- [UltracartClient::AutoOrderItemSimpleSchedule](docs/AutoOrderItemSimpleSchedule.md)
|
|
765
768
|
- [UltracartClient::AutoOrderLog](docs/AutoOrderLog.md)
|
|
766
769
|
- [UltracartClient::AutoOrderManagement](docs/AutoOrderManagement.md)
|
|
770
|
+
- [UltracartClient::AutoOrderPaymentUpdateRequest](docs/AutoOrderPaymentUpdateRequest.md)
|
|
767
771
|
- [UltracartClient::AutoOrderPropertiesUpdateRequest](docs/AutoOrderPropertiesUpdateRequest.md)
|
|
768
772
|
- [UltracartClient::AutoOrderProperty](docs/AutoOrderProperty.md)
|
|
769
773
|
- [UltracartClient::AutoOrderQuery](docs/AutoOrderQuery.md)
|
|
770
774
|
- [UltracartClient::AutoOrderQueryBatch](docs/AutoOrderQueryBatch.md)
|
|
775
|
+
- [UltracartClient::AutoOrderRebillResponse](docs/AutoOrderRebillResponse.md)
|
|
771
776
|
- [UltracartClient::AutoOrderResponse](docs/AutoOrderResponse.md)
|
|
772
777
|
- [UltracartClient::AutoOrdersRequest](docs/AutoOrdersRequest.md)
|
|
773
778
|
- [UltracartClient::AutoOrdersResponse](docs/AutoOrdersResponse.md)
|
|
@@ -1153,6 +1158,9 @@ Class | Method | HTTP request | Description
|
|
|
1153
1158
|
- [UltracartClient::CustomerEditorValues](docs/CustomerEditorValues.md)
|
|
1154
1159
|
- [UltracartClient::CustomerEmail](docs/CustomerEmail.md)
|
|
1155
1160
|
- [UltracartClient::CustomerEmailListChanges](docs/CustomerEmailListChanges.md)
|
|
1161
|
+
- [UltracartClient::CustomerEmailSuppressionRequest](docs/CustomerEmailSuppressionRequest.md)
|
|
1162
|
+
- [UltracartClient::CustomerEmailSuppressionResponse](docs/CustomerEmailSuppressionResponse.md)
|
|
1163
|
+
- [UltracartClient::CustomerEmailSuppressionResult](docs/CustomerEmailSuppressionResult.md)
|
|
1156
1164
|
- [UltracartClient::CustomerLoyalty](docs/CustomerLoyalty.md)
|
|
1157
1165
|
- [UltracartClient::CustomerLoyaltyLedger](docs/CustomerLoyaltyLedger.md)
|
|
1158
1166
|
- [UltracartClient::CustomerLoyaltyRedemption](docs/CustomerLoyaltyRedemption.md)
|
|
@@ -1300,6 +1308,7 @@ Class | Method | HTTP request | Description
|
|
|
1300
1308
|
- [UltracartClient::EmailStepStatResponse](docs/EmailStepStatResponse.md)
|
|
1301
1309
|
- [UltracartClient::EmailStepWaitingRequest](docs/EmailStepWaitingRequest.md)
|
|
1302
1310
|
- [UltracartClient::EmailStepWaitingResponse](docs/EmailStepWaitingResponse.md)
|
|
1311
|
+
- [UltracartClient::EmailSuppressionSurfaces](docs/EmailSuppressionSurfaces.md)
|
|
1303
1312
|
- [UltracartClient::EmailTemplate](docs/EmailTemplate.md)
|
|
1304
1313
|
- [UltracartClient::EmailTemplatesResponse](docs/EmailTemplatesResponse.md)
|
|
1305
1314
|
- [UltracartClient::EmailThirdPartyList](docs/EmailThirdPartyList.md)
|
|
@@ -1825,6 +1834,9 @@ Not every change is committed to every SDK.
|
|
|
1825
1834
|
|
|
1826
1835
|
| Version | Date | Comments |
|
|
1827
1836
|
| --: | :-: | --- |
|
|
1837
|
+
| 4.1.124 | 08/04/2026 | customer - method to remove customer profile from email suppression |
|
|
1838
|
+
| 4.1.123 | 08/04/2026 | customer - method to remove customer profile from email suppression |
|
|
1839
|
+
| 4.1.122 | 07/29/2026 | auto order api - new methods for payment information and rebill |
|
|
1828
1840
|
| 4.1.121 | 07/15/2026 | storefront - parameter to include details on dispatch log methods |
|
|
1829
1841
|
| 4.1.120 | 07/15/2026 | storefront - parameter to include details on dispatch log methods |
|
|
1830
1842
|
| 4.1.119 | 07/15/2026 | order api - query transaction details for cache target |
|
data/docs/AutoOrderApi.md
CHANGED
|
@@ -4,6 +4,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
|
4
4
|
|
|
5
5
|
| Method | HTTP request | Description |
|
|
6
6
|
| ------ | ------------ | ----------- |
|
|
7
|
+
| [**attempt_auto_order_rebill**](AutoOrderApi.md#attempt_auto_order_rebill) | **POST** /auto_order/auto_orders/{auto_order_oid}/rebill | Attempt a failed rebill on an auto order |
|
|
7
8
|
| [**cancel_auto_order_item_by_reference_order_id**](AutoOrderApi.md#cancel_auto_order_item_by_reference_order_id) | **POST** /auto_order/auto_orders/reference_order_id/{reference_order_id}/items/original/{original_item_id}/cancel | Cancel a single item on an auto order |
|
|
8
9
|
| [**consolidate_auto_orders**](AutoOrderApi.md#consolidate_auto_orders) | **PUT** /auto_order/auto_orders/{auto_order_oid}/consolidate | Consolidates multiple auto orders |
|
|
9
10
|
| [**establish_auto_order_by_reference_order_id**](AutoOrderApi.md#establish_auto_order_by_reference_order_id) | **POST** /auto_order/auto_orders/reference_order_id/{reference_order_id} | Establish an auto order by referencing a regular order id |
|
|
@@ -19,10 +20,65 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
|
19
20
|
| [**update_auto_order**](AutoOrderApi.md#update_auto_order) | **PUT** /auto_order/auto_orders/{auto_order_oid} | Update an auto order |
|
|
20
21
|
| [**update_auto_order_item_add_ons**](AutoOrderApi.md#update_auto_order_item_add_ons) | **PUT** /auto_order/auto_orders/{auto_order_oid}/items/{auto_order_item_oid}/add_ons | Update an auto order item add ons |
|
|
21
22
|
| [**update_auto_order_item_properties**](AutoOrderApi.md#update_auto_order_item_properties) | **PUT** /auto_order/auto_orders/{auto_order_oid}/items/{auto_order_item_oid}/properties | Update an auto order item properties |
|
|
23
|
+
| [**update_auto_order_payment**](AutoOrderApi.md#update_auto_order_payment) | **PUT** /auto_order/auto_orders/{auto_order_oid}/payment | Update the payment information on an auto order |
|
|
22
24
|
| [**update_auto_order_properties**](AutoOrderApi.md#update_auto_order_properties) | **PUT** /auto_order/auto_orders/{auto_order_oid}/properties | Update an auto order properties |
|
|
23
25
|
| [**update_auto_orders_batch**](AutoOrderApi.md#update_auto_orders_batch) | **PUT** /auto_order/auto_orders/batch | Update multiple auto orders |
|
|
24
26
|
|
|
25
27
|
|
|
28
|
+
## attempt_auto_order_rebill
|
|
29
|
+
|
|
30
|
+
> <AutoOrderRebillResponse> attempt_auto_order_rebill(auto_order_oid, opts)
|
|
31
|
+
|
|
32
|
+
Attempt a failed rebill on an auto order
|
|
33
|
+
|
|
34
|
+
Attempts to rebill an auto order using the payment information already on the original order. The attempt is refused if the auto order is scheduled to charge within the next five minutes, or if it was already billed within the last 24 hours, both of which guard against double charging. Runs synchronously and may take some time while the gateway is contacted. A declined card is reported in the response body rather than as an API error.
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
### Examples
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
(No example for this operation).
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
#### Using the attempt_auto_order_rebill_with_http_info variant
|
|
44
|
+
|
|
45
|
+
This returns an Array which contains the response data, status code and headers.
|
|
46
|
+
|
|
47
|
+
> <Array(<AutoOrderRebillResponse>, Integer, Hash)> attempt_auto_order_rebill_with_http_info(auto_order_oid, opts)
|
|
48
|
+
|
|
49
|
+
```ruby
|
|
50
|
+
begin
|
|
51
|
+
# Attempt a failed rebill on an auto order
|
|
52
|
+
data, status_code, headers = api_instance.attempt_auto_order_rebill_with_http_info(auto_order_oid, opts)
|
|
53
|
+
p status_code # => 2xx
|
|
54
|
+
p headers # => { ... }
|
|
55
|
+
p data # => <AutoOrderRebillResponse>
|
|
56
|
+
rescue UltracartClient::ApiError => e
|
|
57
|
+
puts "Error when calling AutoOrderApi->attempt_auto_order_rebill_with_http_info: #{e}"
|
|
58
|
+
end
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### Parameters
|
|
62
|
+
|
|
63
|
+
| Name | Type | Description | Notes |
|
|
64
|
+
| ---- | ---- | ----------- | ----- |
|
|
65
|
+
| **auto_order_oid** | **Integer** | The auto order oid to rebill. | |
|
|
66
|
+
| **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
|
|
67
|
+
|
|
68
|
+
### Return type
|
|
69
|
+
|
|
70
|
+
[**AutoOrderRebillResponse**](AutoOrderRebillResponse.md)
|
|
71
|
+
|
|
72
|
+
### Authorization
|
|
73
|
+
|
|
74
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
75
|
+
|
|
76
|
+
### HTTP request headers
|
|
77
|
+
|
|
78
|
+
- **Content-Type**: Not defined
|
|
79
|
+
- **Accept**: application/json
|
|
80
|
+
|
|
81
|
+
|
|
26
82
|
## cancel_auto_order_item_by_reference_order_id
|
|
27
83
|
|
|
28
84
|
> <AutoOrderResponse> cancel_auto_order_item_by_reference_order_id(reference_order_id, original_item_id, opts)
|
|
@@ -1430,6 +1486,61 @@ end
|
|
|
1430
1486
|
- **Accept**: application/json
|
|
1431
1487
|
|
|
1432
1488
|
|
|
1489
|
+
## update_auto_order_payment
|
|
1490
|
+
|
|
1491
|
+
> <AutoOrderRebillResponse> update_auto_order_payment(auto_order_oid, auto_order_payment_update_request, opts)
|
|
1492
|
+
|
|
1493
|
+
Update the payment information on an auto order
|
|
1494
|
+
|
|
1495
|
+
Updates the credit card on the original order behind an auto order, along with any rebills sitting in accounts receivable, and reactivates the auto order. Card data is accepted as hosted field tokens only. raw card numbers and card verification numbers are rejected. Set attempt_rebill to true to also attempt the rebill immediately, which runs synchronously and may take some time while the gateway is contacted. A declined card is reported in the response body rather than as an API error.
|
|
1496
|
+
|
|
1497
|
+
|
|
1498
|
+
### Examples
|
|
1499
|
+
|
|
1500
|
+
|
|
1501
|
+
(No example for this operation).
|
|
1502
|
+
|
|
1503
|
+
|
|
1504
|
+
#### Using the update_auto_order_payment_with_http_info variant
|
|
1505
|
+
|
|
1506
|
+
This returns an Array which contains the response data, status code and headers.
|
|
1507
|
+
|
|
1508
|
+
> <Array(<AutoOrderRebillResponse>, Integer, Hash)> update_auto_order_payment_with_http_info(auto_order_oid, auto_order_payment_update_request, opts)
|
|
1509
|
+
|
|
1510
|
+
```ruby
|
|
1511
|
+
begin
|
|
1512
|
+
# Update the payment information on an auto order
|
|
1513
|
+
data, status_code, headers = api_instance.update_auto_order_payment_with_http_info(auto_order_oid, auto_order_payment_update_request, opts)
|
|
1514
|
+
p status_code # => 2xx
|
|
1515
|
+
p headers # => { ... }
|
|
1516
|
+
p data # => <AutoOrderRebillResponse>
|
|
1517
|
+
rescue UltracartClient::ApiError => e
|
|
1518
|
+
puts "Error when calling AutoOrderApi->update_auto_order_payment_with_http_info: #{e}"
|
|
1519
|
+
end
|
|
1520
|
+
```
|
|
1521
|
+
|
|
1522
|
+
### Parameters
|
|
1523
|
+
|
|
1524
|
+
| Name | Type | Description | Notes |
|
|
1525
|
+
| ---- | ---- | ----------- | ----- |
|
|
1526
|
+
| **auto_order_oid** | **Integer** | The auto order oid to update payment information on. | |
|
|
1527
|
+
| **auto_order_payment_update_request** | [**AutoOrderPaymentUpdateRequest**](AutoOrderPaymentUpdateRequest.md) | Payment information to place on the auto order | |
|
|
1528
|
+
| **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
|
|
1529
|
+
|
|
1530
|
+
### Return type
|
|
1531
|
+
|
|
1532
|
+
[**AutoOrderRebillResponse**](AutoOrderRebillResponse.md)
|
|
1533
|
+
|
|
1534
|
+
### Authorization
|
|
1535
|
+
|
|
1536
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
1537
|
+
|
|
1538
|
+
### HTTP request headers
|
|
1539
|
+
|
|
1540
|
+
- **Content-Type**: application/json; charset=UTF-8
|
|
1541
|
+
- **Accept**: application/json
|
|
1542
|
+
|
|
1543
|
+
|
|
1433
1544
|
## update_auto_order_properties
|
|
1434
1545
|
|
|
1435
1546
|
> <AutoOrderResponse> update_auto_order_properties(auto_order_oid, auto_order_properties_update_request, opts)
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# UltracartClient::AutoOrderPaymentUpdateRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **attempt_rebill** | **Boolean** | Attempt to rebill the auto order immediately after the payment information is updated. Defaults to false. | [optional] |
|
|
8
|
+
| **card_expiration_month** | **Integer** | Card expiration month (1-12) | [optional] |
|
|
9
|
+
| **card_expiration_year** | **Integer** | Card expiration year (four digit) | [optional] |
|
|
10
|
+
| **card_number_token** | **String** | Hosted field token for the credit card number. Tokens are valid for two hours. | [optional] |
|
|
11
|
+
| **card_type** | **String** | Credit card type. Optional. When the hosted field token carries the card type, the token wins. | [optional] |
|
|
12
|
+
| **card_verification_number_token** | **String** | Hosted field token for the card verification number (CVV). Required when the order has a vaulted card that must be re-vaulted. | [optional] |
|
|
13
|
+
|
|
14
|
+
## Example
|
|
15
|
+
|
|
16
|
+
```ruby
|
|
17
|
+
require 'ultracart_api'
|
|
18
|
+
|
|
19
|
+
instance = UltracartClient::AutoOrderPaymentUpdateRequest.new(
|
|
20
|
+
attempt_rebill: null,
|
|
21
|
+
card_expiration_month: null,
|
|
22
|
+
card_expiration_year: null,
|
|
23
|
+
card_number_token: null,
|
|
24
|
+
card_type: null,
|
|
25
|
+
card_verification_number_token: null
|
|
26
|
+
)
|
|
27
|
+
```
|
|
28
|
+
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# UltracartClient::AutoOrderRebillResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **auto_order** | [**AutoOrder**](AutoOrder.md) | | [optional] |
|
|
8
|
+
| **error** | [**Error**](Error.md) | | [optional] |
|
|
9
|
+
| **failure_reason** | **String** | Why the rebill attempt did not succeed | [optional] |
|
|
10
|
+
| **metadata** | [**ResponseMetadata**](ResponseMetadata.md) | | [optional] |
|
|
11
|
+
| **rebill_attempted** | **Boolean** | True if a rebill was attempted during this call | [optional] |
|
|
12
|
+
| **rebill_order_id** | **String** | The order id created by a successful rebill | [optional] |
|
|
13
|
+
| **rebill_success** | **Boolean** | True if the rebill attempt produced an order | [optional] |
|
|
14
|
+
| **success** | **Boolean** | Indicates if API call was successful | [optional] |
|
|
15
|
+
| **warning** | [**Warning**](Warning.md) | | [optional] |
|
|
16
|
+
|
|
17
|
+
## Example
|
|
18
|
+
|
|
19
|
+
```ruby
|
|
20
|
+
require 'ultracart_api'
|
|
21
|
+
|
|
22
|
+
instance = UltracartClient::AutoOrderRebillResponse.new(
|
|
23
|
+
auto_order: null,
|
|
24
|
+
error: null,
|
|
25
|
+
failure_reason: null,
|
|
26
|
+
metadata: null,
|
|
27
|
+
rebill_attempted: null,
|
|
28
|
+
rebill_order_id: null,
|
|
29
|
+
rebill_success: null,
|
|
30
|
+
success: null,
|
|
31
|
+
warning: null
|
|
32
|
+
)
|
|
33
|
+
```
|
|
34
|
+
|
data/docs/CustomerApi.md
CHANGED
|
@@ -28,6 +28,7 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
|
28
28
|
| [**search_customers**](CustomerApi.md#search_customers) | **GET** /customer/customers/search | Search for customers |
|
|
29
29
|
| [**update_customer**](CustomerApi.md#update_customer) | **PUT** /customer/customers/{customer_profile_oid} | Update a customer |
|
|
30
30
|
| [**update_customer_email_lists**](CustomerApi.md#update_customer_email_lists) | **POST** /customer/customers/{customer_profile_oid}/email_lists | Update email list subscriptions for a customer |
|
|
31
|
+
| [**update_customer_email_suppression**](CustomerApi.md#update_customer_email_suppression) | **POST** /customer/customers/{customer_profile_oid}/email_suppression | Clear email suppression for a customer |
|
|
31
32
|
| [**update_wish_list_item**](CustomerApi.md#update_wish_list_item) | **PUT** /customer/customers/{customer_profile_oid}/wishlist/{customer_wishlist_item_oid} | Update a customer wishlist item |
|
|
32
33
|
| [**validate_email_verification_token**](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 |
|
|
33
34
|
|
|
@@ -2445,6 +2446,60 @@ end
|
|
|
2445
2446
|
- **Accept**: application/json
|
|
2446
2447
|
|
|
2447
2448
|
|
|
2449
|
+
## update_customer_email_suppression
|
|
2450
|
+
|
|
2451
|
+
> <CustomerEmailSuppressionResponse> update_customer_email_suppression(customer_profile_oid, suppression_changes)
|
|
2452
|
+
|
|
2453
|
+
Clear email suppression for a customer
|
|
2454
|
+
|
|
2455
|
+
Clears global unsubscribe, spam complaint and/or bounce suppression for a customer. This method is clear-only and cannot set a suppression flag. Clearing a suppression removes the send gate but does not subscribe the customer to any email list -- list membership survives a global unsubscribe untouched, so the customer's original lists become deliverable again with no further action. Returns 200 with a warning if the flags were cleared but an upstream ESP suppression removal failed; the profile was still modified in that case.
|
|
2456
|
+
|
|
2457
|
+
|
|
2458
|
+
### Examples
|
|
2459
|
+
|
|
2460
|
+
|
|
2461
|
+
(No example for this operation).
|
|
2462
|
+
|
|
2463
|
+
|
|
2464
|
+
#### Using the update_customer_email_suppression_with_http_info variant
|
|
2465
|
+
|
|
2466
|
+
This returns an Array which contains the response data, status code and headers.
|
|
2467
|
+
|
|
2468
|
+
> <Array(<CustomerEmailSuppressionResponse>, Integer, Hash)> update_customer_email_suppression_with_http_info(customer_profile_oid, suppression_changes)
|
|
2469
|
+
|
|
2470
|
+
```ruby
|
|
2471
|
+
begin
|
|
2472
|
+
# Clear email suppression for a customer
|
|
2473
|
+
data, status_code, headers = api_instance.update_customer_email_suppression_with_http_info(customer_profile_oid, suppression_changes)
|
|
2474
|
+
p status_code # => 2xx
|
|
2475
|
+
p headers # => { ... }
|
|
2476
|
+
p data # => <CustomerEmailSuppressionResponse>
|
|
2477
|
+
rescue UltracartClient::ApiError => e
|
|
2478
|
+
puts "Error when calling CustomerApi->update_customer_email_suppression_with_http_info: #{e}"
|
|
2479
|
+
end
|
|
2480
|
+
```
|
|
2481
|
+
|
|
2482
|
+
### Parameters
|
|
2483
|
+
|
|
2484
|
+
| Name | Type | Description | Notes |
|
|
2485
|
+
| ---- | ---- | ----------- | ----- |
|
|
2486
|
+
| **customer_profile_oid** | **Integer** | The customer profile oid | |
|
|
2487
|
+
| **suppression_changes** | [**CustomerEmailSuppressionRequest**](CustomerEmailSuppressionRequest.md) | Suppression changes | |
|
|
2488
|
+
|
|
2489
|
+
### Return type
|
|
2490
|
+
|
|
2491
|
+
[**CustomerEmailSuppressionResponse**](CustomerEmailSuppressionResponse.md)
|
|
2492
|
+
|
|
2493
|
+
### Authorization
|
|
2494
|
+
|
|
2495
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
2496
|
+
|
|
2497
|
+
### HTTP request headers
|
|
2498
|
+
|
|
2499
|
+
- **Content-Type**: application/json; charset=UTF-8
|
|
2500
|
+
- **Accept**: application/json
|
|
2501
|
+
|
|
2502
|
+
|
|
2448
2503
|
## update_wish_list_item
|
|
2449
2504
|
|
|
2450
2505
|
> <CustomerWishListItem> update_wish_list_item(customer_profile_oid, customer_wishlist_item_oid, wishlist_item)
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# UltracartClient::CustomerEmailSuppressionRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **clear_bounce** | **Boolean** | Clear bounce suppression for this address. Bounce has no per-customer flag; it exists only on the suppression tables. | [optional] |
|
|
8
|
+
| **clear_global_unsubscribe** | **Boolean** | Clear the global unsubscribe flag. No-op if it is already clear. | [optional] |
|
|
9
|
+
| **clear_spam_complaint** | **Boolean** | Clear the spam complaint flag. Requires a reason. No-op if it is already clear. | [optional] |
|
|
10
|
+
| **consent_source** | **String** | How the customer communicated consent. | [optional] |
|
|
11
|
+
| **reason** | **String** | Justification for the clear. Required when clearing a spam complaint. Retained on the audit record. | [optional] |
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```ruby
|
|
16
|
+
require 'ultracart_api'
|
|
17
|
+
|
|
18
|
+
instance = UltracartClient::CustomerEmailSuppressionRequest.new(
|
|
19
|
+
clear_bounce: null,
|
|
20
|
+
clear_global_unsubscribe: null,
|
|
21
|
+
clear_spam_complaint: null,
|
|
22
|
+
consent_source: null,
|
|
23
|
+
reason: null
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# UltracartClient::CustomerEmailSuppressionResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **email_suppression** | [**CustomerEmailSuppressionResult**](CustomerEmailSuppressionResult.md) | | [optional] |
|
|
8
|
+
| **error** | [**Error**](Error.md) | | [optional] |
|
|
9
|
+
| **metadata** | [**ResponseMetadata**](ResponseMetadata.md) | | [optional] |
|
|
10
|
+
| **success** | **Boolean** | Indicates if API call was successful | [optional] |
|
|
11
|
+
| **warning** | [**Warning**](Warning.md) | | [optional] |
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```ruby
|
|
16
|
+
require 'ultracart_api'
|
|
17
|
+
|
|
18
|
+
instance = UltracartClient::CustomerEmailSuppressionResponse.new(
|
|
19
|
+
email_suppression: null,
|
|
20
|
+
error: null,
|
|
21
|
+
metadata: null,
|
|
22
|
+
success: null,
|
|
23
|
+
warning: null
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# UltracartClient::CustomerEmailSuppressionResult
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **bounce_cleared** | **Boolean** | True only if this call actually removed bounce suppression. Bounce has no per-customer flag, so there is no corresponding state field. | [optional] |
|
|
8
|
+
| **customer_profile_oid** | **Integer** | The customer profile oid that was operated on | [optional] |
|
|
9
|
+
| **email** | **String** | The email address that was operated on | [optional] |
|
|
10
|
+
| **esp_suppression_removed** | **Boolean** | True only if every requested suppression surface was successfully cleared. When false, see esp_warning -- the profile was still modified. | [optional] |
|
|
11
|
+
| **esp_warning** | **String** | Human readable explanation when esp_suppression_removed is false. Suitable for display to a support agent. | [optional] |
|
|
12
|
+
| **global_unsubscribe_cleared** | **Boolean** | True only if this call actually changed the global unsubscribe flag. False if it was already clear. | [optional] |
|
|
13
|
+
| **global_unsubscribed** | **Boolean** | Global unsubscribe state AFTER this call | [optional] |
|
|
14
|
+
| **global_unsubscribed_dts** | **String** | Global unsubscribe timestamp after this call. Nulled when cleared; the prior value is retained on the audit record. | [optional] |
|
|
15
|
+
| **spam_complaint** | **Boolean** | Spam complaint state AFTER this call | [optional] |
|
|
16
|
+
| **spam_complaint_cleared** | **Boolean** | True only if this call actually changed the spam complaint flag. False if it was already clear. | [optional] |
|
|
17
|
+
| **spam_complaint_dts** | **String** | Spam complaint timestamp after this call. Nulled when cleared; the prior value is retained on the audit record. | [optional] |
|
|
18
|
+
| **suppression_surfaces** | [**EmailSuppressionSurfaces**](EmailSuppressionSurfaces.md) | | [optional] |
|
|
19
|
+
|
|
20
|
+
## Example
|
|
21
|
+
|
|
22
|
+
```ruby
|
|
23
|
+
require 'ultracart_api'
|
|
24
|
+
|
|
25
|
+
instance = UltracartClient::CustomerEmailSuppressionResult.new(
|
|
26
|
+
bounce_cleared: null,
|
|
27
|
+
customer_profile_oid: null,
|
|
28
|
+
email: null,
|
|
29
|
+
esp_suppression_removed: null,
|
|
30
|
+
esp_warning: null,
|
|
31
|
+
global_unsubscribe_cleared: null,
|
|
32
|
+
global_unsubscribed: null,
|
|
33
|
+
global_unsubscribed_dts: null,
|
|
34
|
+
spam_complaint: null,
|
|
35
|
+
spam_complaint_cleared: null,
|
|
36
|
+
spam_complaint_dts: null,
|
|
37
|
+
suppression_surfaces: null
|
|
38
|
+
)
|
|
39
|
+
```
|
|
40
|
+
|
data/docs/EmailSettings.md
CHANGED
|
@@ -7,6 +7,7 @@
|
|
|
7
7
|
| **emails_per_day** | **Integer** | Emails per day allowed | [optional] |
|
|
8
8
|
| **emails_per_hour** | **Integer** | Emails per hour allowed | [optional] |
|
|
9
9
|
| **emails_per_month** | **Integer** | Emails per month allowed | [optional] |
|
|
10
|
+
| **machine_open_ignore** | **Boolean** | If machine open should be ignored | [optional] |
|
|
10
11
|
| **marketing_esp_domain_user** | **String** | | [optional] |
|
|
11
12
|
| **marketing_esp_domain_uuid** | **String** | | [optional] |
|
|
12
13
|
| **marketing_esp_friendly_name** | **String** | | [optional] |
|
|
@@ -33,6 +34,7 @@ instance = UltracartClient::EmailSettings.new(
|
|
|
33
34
|
emails_per_day: null,
|
|
34
35
|
emails_per_hour: null,
|
|
35
36
|
emails_per_month: null,
|
|
37
|
+
machine_open_ignore: null,
|
|
36
38
|
marketing_esp_domain_user: null,
|
|
37
39
|
marketing_esp_domain_uuid: null,
|
|
38
40
|
marketing_esp_friendly_name: null,
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# UltracartClient::EmailSuppressionSurfaces
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **central_ses_suppression** | **String** | Outcome of removing the address from the central cross-account ses_suppression table | [optional] |
|
|
8
|
+
| **esp_customer_flags** | **String** | Outcome of clearing the per-customer send gates on esp_customer | [optional] |
|
|
9
|
+
| **ses_account_suppression** | **String** | Outcome of removing the address from the SES-native account-level suppression list | [optional] |
|
|
10
|
+
|
|
11
|
+
## Example
|
|
12
|
+
|
|
13
|
+
```ruby
|
|
14
|
+
require 'ultracart_api'
|
|
15
|
+
|
|
16
|
+
instance = UltracartClient::EmailSuppressionSurfaces.new(
|
|
17
|
+
central_ses_suppression: null,
|
|
18
|
+
esp_customer_flags: null,
|
|
19
|
+
ses_account_suppression: null
|
|
20
|
+
)
|
|
21
|
+
```
|
|
22
|
+
|
data/docs/TaxCountry.md
CHANGED
|
@@ -13,6 +13,8 @@
|
|
|
13
13
|
| **tax_rate** | **Float** | Tax Rate | [optional] |
|
|
14
14
|
| **tax_rate_formatted** | **String** | Tax rate formatted | [optional] |
|
|
15
15
|
| **tax_shipping** | **Boolean** | True if taxation within this jurisdiction should charge tax on shipping | [optional] |
|
|
16
|
+
| **vat_threshold** | **Float** | VAT collection threshold for this country. Blank means no threshold, 0 always collects VAT, a positive value collects at or below that order subtotal. | [optional] |
|
|
17
|
+
| **vat_threshold_currency** | **String** | Currency code the vat_threshold amount is expressed in (USD, EUR or GBP). | [optional] |
|
|
16
18
|
|
|
17
19
|
## Example
|
|
18
20
|
|
|
@@ -28,7 +30,9 @@ instance = UltracartClient::TaxCountry.new(
|
|
|
28
30
|
tax_gift_wrap: null,
|
|
29
31
|
tax_rate: null,
|
|
30
32
|
tax_rate_formatted: null,
|
|
31
|
-
tax_shipping: null
|
|
33
|
+
tax_shipping: null,
|
|
34
|
+
vat_threshold: null,
|
|
35
|
+
vat_threshold_currency: null
|
|
32
36
|
)
|
|
33
37
|
```
|
|
34
38
|
|
data/docs/TaxState.md
CHANGED
|
@@ -22,6 +22,8 @@
|
|
|
22
22
|
| **tax_rate_formatted** | **String** | Tax rate formatted | [optional] |
|
|
23
23
|
| **tax_shipping** | **Boolean** | True if taxation within this jurisdiction should charge tax on shipping | [optional] |
|
|
24
24
|
| **use_ultracart_managed_rates** | **Boolean** | If true, use UltraCart managed rates for this state | [optional] |
|
|
25
|
+
| **vat_threshold** | **Float** | VAT collection threshold override for this region. Blank inherits the country threshold, 0 always collects VAT, a positive value collects at or below that order subtotal. | [optional] |
|
|
26
|
+
| **vat_threshold_currency** | **String** | Currency code the vat_threshold amount is expressed in (USD, EUR or GBP). | [optional] |
|
|
25
27
|
|
|
26
28
|
## Example
|
|
27
29
|
|
|
@@ -46,7 +48,9 @@ instance = UltracartClient::TaxState.new(
|
|
|
46
48
|
tax_rate: null,
|
|
47
49
|
tax_rate_formatted: null,
|
|
48
50
|
tax_shipping: null,
|
|
49
|
-
use_ultracart_managed_rates: null
|
|
51
|
+
use_ultracart_managed_rates: null,
|
|
52
|
+
vat_threshold: null,
|
|
53
|
+
vat_threshold_currency: null
|
|
50
54
|
)
|
|
51
55
|
```
|
|
52
56
|
|