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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 2d5d871e0bb19eab14c055ac6a5c89c7ced3ca2c9127aab28c17c15721f51e22
4
- data.tar.gz: 8fba28391554e4fe29d510482bd37805a01d3c313d94c50e6f4818df9cd91425
3
+ metadata.gz: 18d43bd543cc8099b995151cb2e8eba1b3d395ebf4295b7dda09f6e0b551e6ff
4
+ data.tar.gz: 31bdb671cf67931fdfd9cebd7dcc86a9c62a625b7582db370f43def75bb61b1e
5
5
  SHA512:
6
- metadata.gz: 1294d57bcd66fae30a395c4306a060acc3d68f61657363453222cf5e797cd03667f737e2889c23f452357784978e69e75439c0850f6f0299ddf1b97f1f492ef6
7
- data.tar.gz: 281ca6e2d950f6eab70a5cc311fffa540c105b074238a3e9c29114414f3c90e1e4dca0f7e3700fe69a5c15c3598bbd2b14f890ea301b8798544ecde9abb17a14
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.121
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.121'
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
+
@@ -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