talon_one_sdk 26.12.0 → 26.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c7302ce415ad914b4c2b843336c7283a31e23682613ae6695d7a90bfa579ac12
-  data.tar.gz: 6a1e6e7fbc202dcd90ebf4774680663aafb3d3d391abb41e4c81019abd499b00
+  metadata.gz: 7fad47556b4439eabc099ba7420990dbad99b8e80d14fe0fe04afb4656f096b3
+  data.tar.gz: 0b9d93b7eaac5ff520130dbfa8a0aa87099fad11e391d7446731ba28d2d6b347
 SHA512:
-  metadata.gz: cd2817e074b91cf0d25715cc75af118cc9513e5742b998cbab699538f21c13a36c9d215d418ce8e7154f6e27a2796a17d2db7eef3dbb88625f4c096a2d2caf18
-  data.tar.gz: eb11d86791ceec4f9997682a93f75ee1e06411844865b559f0a1caa329ed2f7ea807e4436219e9397c59bcc4d6145df471a1b3f77695696f574859d587f71d23
+  metadata.gz: 55dcc9708589a1fce5b9120422b6b175e55eaaae69b95e3731938caa598c8cb400e18cae7a6d63d01b8f8a328a175b2c82cc56a6e1bed1d485d7be4f469332eb
+  data.tar.gz: 16abbda3f6e4fcb33848e12ee77af5d44e3175de40f30e2e80bf909764656e2f428d08b469a3b503a750d25012be4784a5c85f63e2669d87248e4f777505bcba

data/README.md

@@ -16,7 +16,7 @@ See our [migration guide](MIGRATION.md).
 Add this to the Gemfile:
 
 ```shell
-gem 'talon_one_sdk', '~> 26.12.0'
+gem 'talon_one_sdk', '~> 26.13.0'
 ```
 
 ### Build a gem
@@ -32,10 +32,10 @@ gem build talon_one_sdk.gemspec
 To install the gem locally:
 
 ```shell
-gem install ./talon_one_sdk-26.12.0.gem
+gem install ./talon_one_sdk-26.13.0.gem
 ```
 
-For development, run `gem install --dev ./talon_one_sdk-26.12.0.gem` to install the development dependencies.
+For development, run `gem install --dev ./talon_one_sdk-26.13.0.gem` to install the development dependencies.
 
 ### RubyGems
 
@@ -205,6 +205,7 @@ Class | Method | HTTP request | Description
 *TalonOne::IntegrationApi* | [**get_loyalty_program_profile_transactions**](docs/IntegrationApi.md#get_loyalty_program_profile_transactions) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/transactions | List customer's loyalty transactions
 *TalonOne::IntegrationApi* | [**get_reserved_customers**](docs/IntegrationApi.md#get_reserved_customers) | **GET** /v1/coupon_reservations/customerprofiles/{couponValue} | List customers that have this coupon reserved
 *TalonOne::IntegrationApi* | [**integration_get_all_campaigns**](docs/IntegrationApi.md#integration_get_all_campaigns) | **GET** /v1/integration/campaigns | List all running campaigns
+*TalonOne::IntegrationApi* | [**join_loyalty_program**](docs/IntegrationApi.md#join_loyalty_program) | **POST** /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/join | Join customer profile to loyalty program
 *TalonOne::IntegrationApi* | [**link_loyalty_card_to_profile**](docs/IntegrationApi.md#link_loyalty_card_to_profile) | **POST** /v2/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/link_profile | Link customer profile to card
 *TalonOne::IntegrationApi* | [**reopen_customer_session**](docs/IntegrationApi.md#reopen_customer_session) | **PUT** /v2/customer_sessions/{customerSessionId}/reopen | Reopen customer session
 *TalonOne::IntegrationApi* | [**return_cart_items**](docs/IntegrationApi.md#return_cart_items) | **POST** /v2/customer_sessions/{customerSessionId}/returns | Return cart items
@@ -337,6 +338,7 @@ Class | Method | HTTP request | Description
 *TalonOne::ManagementApi* | [**get_referrals_without_total_count**](docs/ManagementApi.md#get_referrals_without_total_count) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/referrals/no_total | List referrals
 *TalonOne::ManagementApi* | [**get_role_v2**](docs/ManagementApi.md#get_role_v2) | **GET** /v2/roles/{roleId} | Get role
 *TalonOne::ManagementApi* | [**get_ruleset**](docs/ManagementApi.md#get_ruleset) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/rulesets/{rulesetId} | Get ruleset
+*TalonOne::ManagementApi* | [**get_ruleset_v2**](docs/ManagementApi.md#get_ruleset_v2) | **GET** /v2/applications/{applicationId}/campaigns/{campaignId}/rulesets/{rulesetId} | Get ruleset (V2)
 *TalonOne::ManagementApi* | [**get_rulesets**](docs/ManagementApi.md#get_rulesets) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/rulesets | List campaign rulesets
 *TalonOne::ManagementApi* | [**get_store**](docs/ManagementApi.md#get_store) | **GET** /v1/applications/{applicationId}/stores/{storeId} | Get store
 *TalonOne::ManagementApi* | [**get_user**](docs/ManagementApi.md#get_user) | **GET** /v1/users/{userId} | Get user
@@ -485,6 +487,7 @@ Class | Method | HTTP request | Description
 - [TalonOne::AudienceMembership](docs/AudienceMembership.md)
 - [TalonOne::AudienceReference](docs/AudienceReference.md)
 - [TalonOne::AwardGiveawayEffectProps](docs/AwardGiveawayEffectProps.md)
+- [TalonOne::BaseBlock](docs/BaseBlock.md)
 - [TalonOne::BaseCampaign](docs/BaseCampaign.md)
 - [TalonOne::BaseLoyaltyProgram](docs/BaseLoyaltyProgram.md)
 - [TalonOne::BaseNotification](docs/BaseNotification.md)
@@ -602,6 +605,7 @@ Class | Method | HTTP request | Description
 - [TalonOne::CreateTemplateCampaignResponse](docs/CreateTemplateCampaignResponse.md)
 - [TalonOne::CustomEffect](docs/CustomEffect.md)
 - [TalonOne::CustomEffectProps](docs/CustomEffectProps.md)
+- [TalonOne::CustomerAchievement](docs/CustomerAchievement.md)
 - [TalonOne::CustomerActivityReport](docs/CustomerActivityReport.md)
 - [TalonOne::CustomerAnalytics](docs/CustomerAnalytics.md)
 - [TalonOne::CustomerInventory](docs/CustomerInventory.md)
@@ -940,6 +944,7 @@ Class | Method | HTTP request | Description
 - [TalonOne::OutgoingIntegrationTemplates](docs/OutgoingIntegrationTemplates.md)
 - [TalonOne::OutgoingIntegrationType](docs/OutgoingIntegrationType.md)
 - [TalonOne::OutgoingIntegrationTypes](docs/OutgoingIntegrationTypes.md)
+- [TalonOne::PassthroughBlock](docs/PassthroughBlock.md)
 - [TalonOne::PatchItemCatalogAction](docs/PatchItemCatalogAction.md)
 - [TalonOne::PatchManyItemsCatalogAction](docs/PatchManyItemsCatalogAction.md)
 - [TalonOne::PendingActivePointsData](docs/PendingActivePointsData.md)
@@ -961,6 +966,8 @@ Class | Method | HTTP request | Description
 - [TalonOne::ProfileAudiencesChanges](docs/ProfileAudiencesChanges.md)
 - [TalonOne::ProjectedTier](docs/ProjectedTier.md)
 - [TalonOne::PromoteExperiment](docs/PromoteExperiment.md)
+- [TalonOne::PromotionGroupBlock](docs/PromotionGroupBlock.md)
+- [TalonOne::PromotionRuleV2](docs/PromotionRuleV2.md)
 - [TalonOne::RedeemReferralEffectProps](docs/RedeemReferralEffectProps.md)
 - [TalonOne::Referral](docs/Referral.md)
 - [TalonOne::ReferralConstraints](docs/ReferralConstraints.md)
@@ -982,6 +989,9 @@ Class | Method | HTTP request | Description
 - [TalonOne::RevisionVersion](docs/RevisionVersion.md)
 - [TalonOne::Reward](docs/Reward.md)
 - [TalonOne::RewardPointsRequired](docs/RewardPointsRequired.md)
+- [TalonOne::Risk](docs/Risk.md)
+- [TalonOne::RiskAffectedEntityItem](docs/RiskAffectedEntityItem.md)
+- [TalonOne::RiskDetail](docs/RiskDetail.md)
 - [TalonOne::RiskNotification](docs/RiskNotification.md)
 - [TalonOne::Role](docs/Role.md)
 - [TalonOne::RoleAssign](docs/RoleAssign.md)
@@ -1006,7 +1016,9 @@ Class | Method | HTTP request | Description
 - [TalonOne::RuleFailureReason](docs/RuleFailureReason.md)
 - [TalonOne::RuleMetadata](docs/RuleMetadata.md)
 - [TalonOne::RuleMetadataEligibility](docs/RuleMetadataEligibility.md)
+- [TalonOne::RuleV2](docs/RuleV2.md)
 - [TalonOne::Ruleset](docs/Ruleset.md)
+- [TalonOne::RulesetV2](docs/RulesetV2.md)
 - [TalonOne::SSOConfig](docs/SSOConfig.md)
 - [TalonOne::SamlConnection](docs/SamlConnection.md)
 - [TalonOne::SamlConnectionInternal](docs/SamlConnectionInternal.md)
@@ -1048,7 +1060,9 @@ Class | Method | HTTP request | Description
 - [TalonOne::StrikethroughCustomEffectPerItemProps](docs/StrikethroughCustomEffectPerItemProps.md)
 - [TalonOne::StrikethroughDebugResponse](docs/StrikethroughDebugResponse.md)
 - [TalonOne::StrikethroughEffect](docs/StrikethroughEffect.md)
+- [TalonOne::StrikethroughGroupBlock](docs/StrikethroughGroupBlock.md)
 - [TalonOne::StrikethroughLabelingNotification](docs/StrikethroughLabelingNotification.md)
+- [TalonOne::StrikethroughRuleV2](docs/StrikethroughRuleV2.md)
 - [TalonOne::StrikethroughSetDiscountPerItemEffectProps](docs/StrikethroughSetDiscountPerItemEffectProps.md)
 - [TalonOne::StrikethroughSetDiscountPerItemMemberEffectProps](docs/StrikethroughSetDiscountPerItemMemberEffectProps.md)
 - [TalonOne::StrikethroughTrigger](docs/StrikethroughTrigger.md)

data/docs/BaseBlock.md

@@ -0,0 +1,22 @@
+# TalonOne::BaseBlock
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** | Unique identifier for this block. |  |
+| **type** | **String** | Identifies the block variant and determines which additional properties are present in it. |  |
+| **tags** | **Array<String>** | Semantic labels attached to this block. | [optional] |
+
+## Example
+
+```ruby
+require 'talon_one_sdk'
+
+instance = TalonOne::BaseBlock.new(
+  id: a1b2c3d4-e5f6-7890-abcd-ef1234567890,
+  type: null,
+  tags: null
+)
+```
+

data/docs/BestPriorPrice.md

@@ -20,7 +20,7 @@ require 'talon_one_sdk'
 
 instance = TalonOne::BestPriorPrice.new(
   id: 1,
-  sku: NVR-GN-GV-UUP,
+  sku: SKU7345278,
   observed_at: 2025-11-10T23:00:00Z,
   context_ids: [SpringSale, SummerSale2025],
   context_id: ,

data/docs/BestPriorPriceRequest.md

@@ -16,7 +16,7 @@
 require 'talon_one_sdk'
 
 instance = TalonOne::BestPriorPriceRequest.new(
-  skus: [comma, period],
+  skus: [SKU1241028, SKU7345278],
   timeframe_end_date: 2020-11-10T23:00:00Z,
   timeframe: 30,
   timeframe_end_date_type: sale,

data/docs/CustomerAchievement.md

@@ -0,0 +1,38 @@
+# TalonOne::CustomerAchievement
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **Integer** | The internal ID of the achievement. |  |
+| **name** | **String** | The internal name of the achievement used in API requests.  |  |
+| **title** | **String** | The display name of the achievement in the Campaign Manager. |  |
+| **description** | **String** | The description of the achievement in the Campaign Manager. |  |
+| **target** | **Float** | The required number of actions or the transactional milestone to complete the achievement. |  |
+| **recurrence_policy** | **String** | The policy that determines if and how the achievement recurs. - `no_recurrence`: The achievement can be completed only once. - `on_expiration`: The achievement resets after it expires and becomes available again. - `on_completion`: When the customer progress status reaches `completed`, the achievement resets and becomes available again.  |  |
+| **activation_policy** | **String** | The policy that determines how the achievement starts, ends, or resets. - `user_action`: The achievement ends or resets relative to when the customer started the achievement. - `fixed_schedule`: The achievement starts, ends, or resets for all customers following a fixed schedule.  |  |
+| **fixed_start_date** | **Time** | The achievement's start date when `activationPolicy` is equal to `fixed_schedule`.  **Note:** It is an RFC3339 timestamp string.  | [optional] |
+| **end_date** | **Time** | The achievement's end date. If defined, customers cannot participate in the achievement after this date.  **Note:** It is an RFC3339 timestamp string.  | [optional] |
+| **allow_rollback_after_completion** | **Boolean** | When `true`, customer progress can be rolled back in completed achievements. |  |
+| **current_progress** | [**AchievementProgress**](AchievementProgress.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'talon_one_sdk'
+
+instance = TalonOne::CustomerAchievement.new(
+  id: 3,
+  name: FreeCoffee10Orders,
+  title: 50% off on 50th purchase.,
+  description: 50% off for every 50th purchase in a year.,
+  target: 10,
+  recurrence_policy: no_recurrence,
+  activation_policy: fixed_schedule,
+  fixed_start_date: 2024-01-15T15:04:05Z07:00,
+  end_date: 2024-02-15T15:04:05Z07:00,
+  allow_rollback_after_completion: false,
+  current_progress: null
+)
+```
+

data/docs/IntegrationApi.md

@@ -29,6 +29,7 @@ All URIs are relative to *https://yourbaseurl.talon.one*
 | [**get_loyalty_program_profile_transactions**](IntegrationApi.md#get_loyalty_program_profile_transactions) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/transactions | List customer's loyalty transactions |
 | [**get_reserved_customers**](IntegrationApi.md#get_reserved_customers) | **GET** /v1/coupon_reservations/customerprofiles/{couponValue} | List customers that have this coupon reserved |
 | [**integration_get_all_campaigns**](IntegrationApi.md#integration_get_all_campaigns) | **GET** /v1/integration/campaigns | List all running campaigns |
+| [**join_loyalty_program**](IntegrationApi.md#join_loyalty_program) | **POST** /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/join | Join customer profile to loyalty program |
 | [**link_loyalty_card_to_profile**](IntegrationApi.md#link_loyalty_card_to_profile) | **POST** /v2/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/link_profile | Link customer profile to card |
 | [**reopen_customer_session**](IntegrationApi.md#reopen_customer_session) | **PUT** /v2/customer_sessions/{customerSessionId}/reopen | Reopen customer session |
 | [**return_cart_items**](IntegrationApi.md#return_cart_items) | **POST** /v2/customer_sessions/{customerSessionId}/returns | Return cart items |
@@ -139,7 +140,7 @@ TalonOne.configure do |config|
 end
 
 api_instance = TalonOne::IntegrationApi.new
-best_prior_price_request = TalonOne::BestPriorPriceRequest.new({skus: [comma,  period], timeframe_end_date: Time.parse('2020-11-10T23:00:00Z'), timeframe: '30', timeframe_end_date_type: 'strict'}) # BestPriorPriceRequest | body
+best_prior_price_request = TalonOne::BestPriorPriceRequest.new({skus: [SKU1241028,  SKU7345278], timeframe_end_date: Time.parse('2020-11-10T23:00:00Z'), timeframe: '30', timeframe_end_date_type: 'strict'}) # BestPriorPriceRequest | body
 
 begin
   # Fetch best prior price
@@ -1184,7 +1185,7 @@ TalonOne.configure do |config|
 end
 
 api_instance = TalonOne::IntegrationApi.new
-customer_session_id = 'customer_session_id_example' # String | The `integration ID` of the customer session. You set this ID when you create a customer session.  You can see existing customer session integration IDs in the Campaign Manager's **Sessions** menu, or via the [List Application session](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationSessions) endpoint. 
+customer_session_id = 'customer_session_id_example' # String | The `integration ID` of the customer session. You set this ID when you create a customer session.  You can see existing customer session integration IDs in the Campaign Manager's **Sessions** menu, or via the [List Application session](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationSessions) endpoint. **Notes**: - There is no length limit for this ID. - It must be URL-encoded. For example, replace spaces with `%20`. [Learn more](https://www.w3schools.com/tags/ref_urlencode.asp). 
 
 begin
   # Get customer session
@@ -1217,7 +1218,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **customer_session_id** | **String** | The `integration ID` of the customer session. You set this ID when you create a customer session.  You can see existing customer session integration IDs in the Campaign Manager's **Sessions** menu, or via the [List Application session](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationSessions) endpoint.  |  |
+| **customer_session_id** | **String** | The `integration ID` of the customer session. You set this ID when you create a customer session.  You can see existing customer session integration IDs in the Campaign Manager's **Sessions** menu, or via the [List Application session](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationSessions) endpoint. **Notes**: - There is no length limit for this ID. - It must be URL-encoded. For example, replace spaces with `%20`. [Learn more](https://www.w3schools.com/tags/ref_urlencode.asp).  |  |
 
 ### Return type
 
@@ -1930,7 +1931,9 @@ opts = {
   start_after: Time.parse('2013-10-20T19:20:30+01:00'), # Time | Filter results to only include campaigns that start on or after  the specified timestamp.  **Note:**  - It must be an RFC3339 timestamp string.  - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. 
   start_before: Time.parse('2013-10-20T19:20:30+01:00'), # Time | Filter results to only include campaigns that start on or before  the specified timestamp.  **Note:**  - It must be an RFC3339 timestamp string.  - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. 
   end_after: Time.parse('2013-10-20T19:20:30+01:00'), # Time | Filter results to only include campaigns that end on or after  the specified timestamp.  **Note:**  - It must be an RFC3339 timestamp string.  - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. 
-  end_before: Time.parse('2013-10-20T19:20:30+01:00') # Time | Filter results to only include campaigns that end on or before  the specified timestamp.  **Note:**  - It must be an RFC3339 timestamp string.  - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. 
+  end_before: Time.parse('2013-10-20T19:20:30+01:00'), # Time | Filter results to only include campaigns that end on or before  the specified timestamp.  **Note:**  - It must be an RFC3339 timestamp string.  - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered. 
+  store_id: 789, # Integer | Filter results to campaigns linked to the specified store ID.
+  audience_id: 789 # Integer | Filter results to campaigns linked to the specified audience ID.
 }
 
 begin
@@ -1971,6 +1974,8 @@ end
 | **start_before** | **Time** | Filter results to only include campaigns that start on or before  the specified timestamp.  **Note:**  - It must be an RFC3339 timestamp string.  - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.  | [optional] |
 | **end_after** | **Time** | Filter results to only include campaigns that end on or after  the specified timestamp.  **Note:**  - It must be an RFC3339 timestamp string.  - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.  | [optional] |
 | **end_before** | **Time** | Filter results to only include campaigns that end on or before  the specified timestamp.  **Note:**  - It must be an RFC3339 timestamp string.  - You can include a time component in your string, for example, `T23:59:59` to specify the end of the day. The time zone setting considered is `UTC`. If you do not include a time component, a default time value of `T00:00:00` (midnight) in `UTC` is considered.  | [optional] |
+| **store_id** | **Integer** | Filter results to campaigns linked to the specified store ID. | [optional] |
+| **audience_id** | **Integer** | Filter results to campaigns linked to the specified audience ID. | [optional] |
 
 ### Return type
 
@@ -1986,6 +1991,78 @@ end
 - **Accept**: application/json
 
 
+## join_loyalty_program
+
+> join_loyalty_program(loyalty_program_id, integration_id)
+
+Join customer profile to loyalty program
+
+Join a customer profile to the specified loyalty program.  If the customer profile does not exist, it will be created first using the provided `integrationId`, then joined to the loyalty program.  > [!note] This endpoint only works with profile-based loyalty programs.  **Behavior**: - If the loyalty program does not exist, the request fails. - If the customer profile is already joined to the loyalty program, the request fails. - If the customer profile does not exist, it is created and then joined to the loyalty program. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'talon_one_sdk'
+# setup authorization
+TalonOne.configure do |config|
+  # Configure API key authorization: api_key_v1
+  config.api_key['Authorization'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['Authorization'] = 'Bearer'
+end
+
+api_instance = TalonOne::IntegrationApi.new
+loyalty_program_id = 789 # Integer | Identifier of the profile-based loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. 
+integration_id = 'integration_id_example' # String | The integration ID of the customer profile. You can get the `integrationId` of a profile using: - A customer session integration ID with the [Update customer session](https://docs.talon.one/integration-api#tag/Customer-sessions/operation/updateCustomerSessionV2) endpoint. - The Management API with the [List application's customers](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationCustomers) endpoint. 
+
+begin
+  # Join customer profile to loyalty program
+  api_instance.join_loyalty_program(loyalty_program_id, integration_id)
+rescue TalonOne::ApiError => e
+  puts "Error when calling IntegrationApi->join_loyalty_program: #{e}"
+end
+```
+
+#### Using the join_loyalty_program_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> join_loyalty_program_with_http_info(loyalty_program_id, integration_id)
+
+```ruby
+begin
+  # Join customer profile to loyalty program
+  data, status_code, headers = api_instance.join_loyalty_program_with_http_info(loyalty_program_id, integration_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue TalonOne::ApiError => e
+  puts "Error when calling IntegrationApi->join_loyalty_program_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **loyalty_program_id** | **Integer** | Identifier of the profile-based loyalty program. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint.  |  |
+| **integration_id** | **String** | The integration ID of the customer profile. You can get the &#x60;integrationId&#x60; of a profile using: - A customer session integration ID with the [Update customer session](https://docs.talon.one/integration-api#tag/Customer-sessions/operation/updateCustomerSessionV2) endpoint. - The Management API with the [List application&#39;s customers](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationCustomers) endpoint.  |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[api_key_v1](../README.md#api_key_v1)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## link_loyalty_card_to_profile
 
 > <LoyaltyCard> link_loyalty_card_to_profile(loyalty_program_id, loyalty_card_id, loyalty_card_registration)
@@ -2754,7 +2831,7 @@ TalonOne.configure do |config|
 end
 
 api_instance = TalonOne::IntegrationApi.new
-integration_id = 'integration_id_example' # String | The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID.  Once set, you cannot update this identifier. 
+integration_id = 'integration_id_example' # String | The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID.  Once set, you cannot update this identifier. **Note**: It must be URL-encoded. For example, replace spaces with `%20`. [Learn more](https://www.w3schools.com/tags/ref_urlencode.asp). 
 customer_profile_integration_request_v2 = TalonOne::CustomerProfileIntegrationRequestV2.new # CustomerProfileIntegrationRequestV2 | body
 opts = {
   run_rule_engine: true, # Boolean | Indicates whether to run the Rule Engine.  If `true`, the response includes: - The effects generated by the triggered campaigns are returned in the `effects` property. - The created coupons and referral objects.  If `false`: - The rules are not executed and the `effects` property is always empty. - The response time improves. - You cannot use `responseContent` in the body. 
@@ -2792,7 +2869,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **integration_id** | **String** | The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID.  Once set, you cannot update this identifier.  |  |
+| **integration_id** | **String** | The integration identifier for this customer profile. Must be: - Unique within the deployment. - Stable for the customer. Do not use an ID that the customer can update themselves. For example, you can use a database ID.  Once set, you cannot update this identifier. **Note**: It must be URL-encoded. For example, replace spaces with &#x60;%20&#x60;. [Learn more](https://www.w3schools.com/tags/ref_urlencode.asp).  |  |
 | **customer_profile_integration_request_v2** | [**CustomerProfileIntegrationRequestV2**](CustomerProfileIntegrationRequestV2.md) | body |  |
 | **run_rule_engine** | **Boolean** | Indicates whether to run the Rule Engine.  If &#x60;true&#x60;, the response includes: - The effects generated by the triggered campaigns are returned in the &#x60;effects&#x60; property. - The created coupons and referral objects.  If &#x60;false&#x60;: - The rules are not executed and the &#x60;effects&#x60; property is always empty. - The response time improves. - You cannot use &#x60;responseContent&#x60; in the body.  | [optional][default to false] |
 | **dry** | **Boolean** | (Only works when &#x60;runRuleEngine&#x3D;true&#x60;) Indicates whether to persist the changes. Changes are ignored when &#x60;dry&#x3D;true&#x60;.  When set to &#x60;true&#x60;, you can use the &#x60;evaluableCampaignIds&#x60; body property to select specific campaigns to run.  | [optional] |
@@ -2908,7 +2985,7 @@ TalonOne.configure do |config|
 end
 
 api_instance = TalonOne::IntegrationApi.new
-customer_session_id = 'customer_session_id_example' # String | The `integration ID` of the customer session. You set this ID when you create a customer session.  You can see existing customer session integration IDs in the Campaign Manager's **Sessions** menu, or via the [List Application session](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationSessions) endpoint. 
+customer_session_id = 'customer_session_id_example' # String | The `integration ID` of the customer session. You set this ID when you create a customer session.  You can see existing customer session integration IDs in the Campaign Manager's **Sessions** menu, or via the [List Application session](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationSessions) endpoint. **Notes**: - There is no length limit for this ID. - It must be URL-encoded. For example, replace spaces with `%20`. [Learn more](https://www.w3schools.com/tags/ref_urlencode.asp). 
 integration_request = TalonOne::IntegrationRequest.new({customer_session: TalonOne::NewCustomerSessionV2.new}) # IntegrationRequest | body
 opts = {
   dry: true, # Boolean | Indicates whether to persist the changes. Changes are ignored when `dry=true`.  When set to `true`: - The endpoint considers **only** the payload that you pass when **closing** the session.   When you do not use the `dry` parameter, the endpoint behaves as a typical PUT endpoint. Each update builds upon the previous ones. - You can use the `evaluableCampaignIds` body property to select specific campaigns to run.  [See the docs](https://docs.talon.one/docs/dev/integration-api/dry-requests). 
@@ -2946,7 +3023,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **customer_session_id** | **String** | The &#x60;integration ID&#x60; of the customer session. You set this ID when you create a customer session.  You can see existing customer session integration IDs in the Campaign Manager&#39;s **Sessions** menu, or via the [List Application session](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationSessions) endpoint.  |  |
+| **customer_session_id** | **String** | The &#x60;integration ID&#x60; of the customer session. You set this ID when you create a customer session.  You can see existing customer session integration IDs in the Campaign Manager&#39;s **Sessions** menu, or via the [List Application session](https://docs.talon.one/management-api#tag/Customer-data/operation/getApplicationSessions) endpoint. **Notes**: - There is no length limit for this ID. - It must be URL-encoded. For example, replace spaces with &#x60;%20&#x60;. [Learn more](https://www.w3schools.com/tags/ref_urlencode.asp).  |  |
 | **integration_request** | [**IntegrationRequest**](IntegrationRequest.md) | body |  |
 | **dry** | **Boolean** | Indicates whether to persist the changes. Changes are ignored when &#x60;dry&#x3D;true&#x60;.  When set to &#x60;true&#x60;: - The endpoint considers **only** the payload that you pass when **closing** the session.   When you do not use the &#x60;dry&#x60; parameter, the endpoint behaves as a typical PUT endpoint. Each update builds upon the previous ones. - You can use the &#x60;evaluableCampaignIds&#x60; body property to select specific campaigns to run.  [See the docs](https://docs.talon.one/docs/dev/integration-api/dry-requests).  | [optional] |
 | **now** | **Time** | A timestamp value of a future date that acts as a current date when included in the query.  Use this parameter, for example, to test campaigns that would be evaluated for this customer session in the future (say, [scheduled campaigns](https://docs.talon.one/docs/product/campaigns/settings/managing-campaign-schedule)).  &gt; [!note] **Note** &gt; - It must be an RFC3339 timestamp string. &gt; - It can **only** be a date in the future. &gt; - It can **only** be used if the &#x60;dry&#x60; parameter in the query is set to &#x60;true&#x60;.  | [optional] |

data/docs/IntegrationCampaign.md

@@ -15,6 +15,8 @@
 | **tags** | **Array<String>** | A list of tags for the campaign. |  |
 | **features** | **Array<String>** | The features enabled in this campaign. |  |
 | **rules** | [**Array<RuleMetadata>**](RuleMetadata.md) | A list of rules containing customer-facing details of the rewards defined in the campaign. |  |
+| **linked_store_ids** | **Array<Integer>** | A list of store IDs linked to this campaign. | [optional] |
+| **linked_audience_ids** | **Array<Integer>** | A list of audience IDs linked to this campaign. | [optional] |
 
 ## Example
 
@@ -32,7 +34,9 @@ instance = TalonOne::IntegrationCampaign.new(
   state: enabled,
   tags: [summer],
   features: [coupons, referrals],
-  rules: null
+  rules: null,
+  linked_store_ids: [1, 2],
+  linked_audience_ids: [3, 4]
 )
 ```
 

data/docs/IntegrationEventV2Response.md

@@ -13,6 +13,7 @@
 | **created_coupons** | [**Array<Coupon>**](Coupon.md) | The coupons that were created during the event processing. |  |
 | **created_referrals** | [**Array<Referral>**](Referral.md) | The referrals that were created during the event processing. |  |
 | **awarded_giveaways** | [**Array<Giveaway>**](Giveaway.md) | The giveaways that were awarded during the event processing. | [optional] |
+| **achievements** | [**Array<CustomerAchievement>**](CustomerAchievement.md) | The achievements progress of the customer. | [optional] |
 | **event** | [**Event**](Event.md) | The event that was processed. | [optional] |
 
 ## Example
@@ -30,6 +31,7 @@ instance = TalonOne::IntegrationEventV2Response.new(
   created_coupons: null,
   created_referrals: null,
   awarded_giveaways: null,
+  achievements: null,
   event: null
 )
 ```

data/docs/IntegrationEventV3Response.md

@@ -13,6 +13,7 @@
 | **created_coupons** | [**Array<Coupon>**](Coupon.md) | The coupons that were created during the event processing. |  |
 | **created_referrals** | [**Array<Referral>**](Referral.md) | The referrals that were created during the event processing. |  |
 | **awarded_giveaways** | [**Array<Giveaway>**](Giveaway.md) | The giveaways that were awarded during the event processing. | [optional] |
+| **achievements** | [**Array<CustomerAchievement>**](CustomerAchievement.md) | The achievements progress of the customer. | [optional] |
 | **advanced_event** | [**EventV3**](EventV3.md) | The advanced event that was processed. | [optional] |
 
 ## Example
@@ -30,6 +31,7 @@ instance = TalonOne::IntegrationEventV3Response.new(
   created_coupons: null,
   created_referrals: null,
   awarded_giveaways: null,
+  achievements: null,
   advanced_event: null
 )
 ```

data/docs/IntegrationHubEventPayloadLoyaltyProfileBasedPointsChangedNotification.md

@@ -10,6 +10,7 @@
 | **subledger_id** | **String** |  |  |
 | **source_of_event** | **String** |  |  |
 | **current_tier** | **String** | The name of the customer's current tier. |  |
+| **session_integration_id** | **String** | The integration ID of the session through which the points were earned or lost. Only set when the change results from a rule engine execution; empty otherwise. | [optional] |
 | **employee_name** | **String** |  | [optional] |
 | **user_id** | **Integer** |  | [optional] |
 | **current_points** | **Float** |  |  |
@@ -28,6 +29,7 @@ instance = TalonOne::IntegrationHubEventPayloadLoyaltyProfileBasedPointsChangedN
   subledger_id: null,
   source_of_event: null,
   current_tier: null,
+  session_integration_id: null,
   employee_name: null,
   user_id: null,
   current_points: null,

data/docs/IntegrationResponse.md

@@ -13,6 +13,7 @@
 | **created_coupons** | [**Array<Coupon>**](Coupon.md) | The coupons that were created during the event processing. |  |
 | **created_referrals** | [**Array<Referral>**](Referral.md) | The referrals that were created during the event processing. |  |
 | **awarded_giveaways** | [**Array<Giveaway>**](Giveaway.md) | The giveaways that were awarded during the event processing. | [optional] |
+| **achievements** | [**Array<CustomerAchievement>**](CustomerAchievement.md) | The achievements progress of the customer. | [optional] |
 
 ## Example
 
@@ -28,7 +29,8 @@ instance = TalonOne::IntegrationResponse.new(
   rule_failure_reasons: null,
   created_coupons: null,
   created_referrals: null,
-  awarded_giveaways: null
+  awarded_giveaways: null,
+  achievements: null
 )
 ```
 

data/docs/IntegrationStateV2.md

@@ -13,6 +13,7 @@
 | **created_coupons** | [**Array<Coupon>**](Coupon.md) | The coupons that were created during the event processing. |  |
 | **created_referrals** | [**Array<Referral>**](Referral.md) | The referrals that were created during the event processing. |  |
 | **awarded_giveaways** | [**Array<Giveaway>**](Giveaway.md) | The giveaways that were awarded during the event processing. | [optional] |
+| **achievements** | [**Array<CustomerAchievement>**](CustomerAchievement.md) | The achievements progress of the customer. | [optional] |
 | **referral** | [**InventoryReferral**](InventoryReferral.md) | The referral that was processed. | [optional] |
 | **coupons** | [**Array<IntegrationCoupon>**](IntegrationCoupon.md) | The coupons that were processed. | [optional] |
 | **event** | [**Event**](Event.md) | The event that was processed. | [optional] |
@@ -36,6 +37,7 @@ instance = TalonOne::IntegrationStateV2.new(
   created_coupons: null,
   created_referrals: null,
   awarded_giveaways: null,
+  achievements: null,
   referral: null,
   coupons: null,
   event: null,

data/docs/ManagementApi.md

@@ -123,6 +123,7 @@ All URIs are relative to *https://yourbaseurl.talon.one*
 | [**get_referrals_without_total_count**](ManagementApi.md#get_referrals_without_total_count) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/referrals/no_total | List referrals |
 | [**get_role_v2**](ManagementApi.md#get_role_v2) | **GET** /v2/roles/{roleId} | Get role |
 | [**get_ruleset**](ManagementApi.md#get_ruleset) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/rulesets/{rulesetId} | Get ruleset |
+| [**get_ruleset_v2**](ManagementApi.md#get_ruleset_v2) | **GET** /v2/applications/{applicationId}/campaigns/{campaignId}/rulesets/{rulesetId} | Get ruleset (V2) |
 | [**get_rulesets**](ManagementApi.md#get_rulesets) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/rulesets | List campaign rulesets |
 | [**get_store**](ManagementApi.md#get_store) | **GET** /v1/applications/{applicationId}/stores/{storeId} | Get store |
 | [**get_user**](ManagementApi.md#get_user) | **GET** /v1/users/{userId} | Get user |
@@ -3550,7 +3551,9 @@ opts = {
   exact_match: true, # Boolean | Filter results to an exact case-insensitive matching against the coupon code.
   date_format: 'excel', # String | Determines the format of dates in the export document.
   campaign_state: 'enabled', # String | Filter results by the state of the campaign.  - `enabled`: Campaigns that are scheduled, running (activated), or expired. - `running`: Campaigns that are running (activated). - `disabled`: Campaigns that are disabled. - `expired`: Campaigns that are expired. - `archived`: Campaigns that are archived. 
-  values_only: true # Boolean | Filter results to only return the coupon codes (`value` column) without the associated coupon data.
+  values_only: true, # Boolean | Filter results to only return the coupon codes (`value` column) without the associated coupon data.
+  deleted_before: Time.parse('2013-10-20T19:20:30+01:00'), # Time | Timestamp that filters the results to only contain coupons deleted before this date. Must be an RFC3339 timestamp string. You can use any time zone setting. Talon.One will convert to UTC internally.  **Note:** Only coupons deleted in the last 7 days will appear in the results.
+  deleted_after: Time.parse('2013-10-20T19:20:30+01:00') # Time | Timestamp that filters the results to only contain coupons deleted after this date. Must be an RFC3339 timestamp string. You can use any time zone setting. Talon.One will convert to UTC internally.  **Note:** Only coupons deleted in the last 7 days will appear in the results.
 }
 
 begin
@@ -3599,6 +3602,8 @@ end
 | **date_format** | **String** | Determines the format of dates in the export document. | [optional] |
 | **campaign_state** | **String** | Filter results by the state of the campaign.  - `enabled`: Campaigns that are scheduled, running (activated), or expired. - `running`: Campaigns that are running (activated). - `disabled`: Campaigns that are disabled. - `expired`: Campaigns that are expired. - `archived`: Campaigns that are archived.  | [optional] |
 | **values_only** | **Boolean** | Filter results to only return the coupon codes (`value` column) without the associated coupon data. | [optional][default to false] |
+| **deleted_before** | **Time** | Timestamp that filters the results to only contain coupons deleted before this date. Must be an RFC3339 timestamp string. You can use any time zone setting. Talon.One will convert to UTC internally.  **Note:** Only coupons deleted in the last 7 days will appear in the results. | [optional] |
+| **deleted_after** | **Time** | Timestamp that filters the results to only contain coupons deleted after this date. Must be an RFC3339 timestamp string. You can use any time zone setting. Talon.One will convert to UTC internally.  **Note:** Only coupons deleted in the last 7 days will appear in the results. | [optional] |
 
 ### Return type
 
@@ -6235,6 +6240,7 @@ opts = {
   sort: 'sort_example', # String | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`.  **Note:** You may not be able to use all fields for sorting. This is due to performance limitations. 
   entity: 'entity_example', # String | Returned attributes will be filtered by supplied entity.
   application_ids: 'application_ids_example', # String | Returned attributes will be filtered by supplied application ids
+  loyalty_program_ids: 'loyalty_program_ids_example', # String | Returned attributes will be filtered by the specified loyalty program ids, separated by commas. You can only use this parameter when `entity` is `LoyaltyCard`.
   type: 'type_example', # String | Returned attributes will be filtered by supplied type
   kind: 'builtin', # String | Returned attributes will be filtered by supplied kind (builtin or custom)
   search: 'search_example' # String | Returned attributes will be filtered by searching case insensitive through Attribute name, description and type
@@ -6276,6 +6282,7 @@ end
 | **sort** | **String** | The field by which results should be sorted. By default, results are sorted in ascending order. To sort them in descending order, prefix the field name with `-`.  **Note:** You may not be able to use all fields for sorting. This is due to performance limitations.  | [optional] |
 | **entity** | **String** | Returned attributes will be filtered by supplied entity. | [optional] |
 | **application_ids** | **String** | Returned attributes will be filtered by supplied application ids | [optional] |
+| **loyalty_program_ids** | **String** | Returned attributes will be filtered by the specified loyalty program ids, separated by commas. You can only use this parameter when `entity` is `LoyaltyCard`. | [optional] |
 | **type** | **String** | Returned attributes will be filtered by supplied type | [optional] |
 | **kind** | **String** | Returned attributes will be filtered by supplied kind (builtin or custom) | [optional] |
 | **search** | **String** | Returned attributes will be filtered by searching case insensitive through Attribute name, description and type | [optional] |
@@ -9472,6 +9479,81 @@ end
 - **Accept**: application/json
 
 
+## get_ruleset_v2
+
+> <RulesetV2> get_ruleset_v2(application_id, campaign_id, ruleset_id)
+
+Get ruleset (V2)
+
+Retrieve the specified ruleset as a JSON object.
+
+### Examples
+
+```ruby
+require 'time'
+require 'talon_one_sdk'
+# setup authorization
+TalonOne.configure do |config|
+  # Configure API key authorization: api_key_v1
+  config.api_key['Authorization'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['Authorization'] = 'Bearer'
+end
+
+api_instance = TalonOne::ManagementApi.new
+application_id = 789 # Integer | The ID of the Application. It is displayed in your Talon.One deployment URL.
+campaign_id = 789 # Integer | The ID of the campaign. It is displayed in your Talon.One deployment URL.
+ruleset_id = 789 # Integer | The ID of the ruleset.
+
+begin
+  # Get ruleset (V2)
+  result = api_instance.get_ruleset_v2(application_id, campaign_id, ruleset_id)
+  p result
+rescue TalonOne::ApiError => e
+  puts "Error when calling ManagementApi->get_ruleset_v2: #{e}"
+end
+```
+
+#### Using the get_ruleset_v2_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<RulesetV2>, Integer, Hash)> get_ruleset_v2_with_http_info(application_id, campaign_id, ruleset_id)
+
+```ruby
+begin
+  # Get ruleset (V2)
+  data, status_code, headers = api_instance.get_ruleset_v2_with_http_info(application_id, campaign_id, ruleset_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <RulesetV2>
+rescue TalonOne::ApiError => e
+  puts "Error when calling ManagementApi->get_ruleset_v2_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **application_id** | **Integer** | The ID of the Application. It is displayed in your Talon.One deployment URL. |  |
+| **campaign_id** | **Integer** | The ID of the campaign. It is displayed in your Talon.One deployment URL. |  |
+| **ruleset_id** | **Integer** | The ID of the ruleset. |  |
+
+### Return type
+
+[**RulesetV2**](RulesetV2.md)
+
+### Authorization
+
+[api_key_v1](../README.md#api_key_v1)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
 ## get_rulesets
 
 > <GetRulesets200Response> get_rulesets(application_id, campaign_id, opts)
@@ -11894,7 +11976,7 @@ end
 
 api_instance = TalonOne::ManagementApi.new
 application_id = 789 # Integer | The ID of the Application. It is displayed in your Talon.One deployment URL.
-price_history_request = TalonOne::PriceHistoryRequest.new({sku: '[sku-124]', start_date: Time.parse('2020-11-10T23:00:00Z'), end_date: Time.parse('2020-12-10T23:00:00Z')}) # PriceHistoryRequest | body
+price_history_request = TalonOne::PriceHistoryRequest.new({sku: 'SKU1241028', start_date: Time.parse('2020-11-10T23:00:00Z'), end_date: Time.parse('2020-12-10T23:00:00Z')}) # PriceHistoryRequest | body
 
 begin
   # Get summary of price history