talon_one 4.0.0 → 5.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (45) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +11 -6
  3. data/docs/ActivateUserRequest.md +17 -0
  4. data/docs/Coupon.md +2 -2
  5. data/docs/CustomerInventory.md +1 -1
  6. data/docs/InlineResponse20044.md +1 -1
  7. data/docs/IntegrationApi.md +11 -11
  8. data/docs/IntegrationCoupon.md +2 -2
  9. data/docs/InventoryCoupon.md +2 -2
  10. data/docs/LoyaltyCardBalances.md +21 -0
  11. data/docs/LoyaltyCardProfileRegistration.md +1 -1
  12. data/docs/ManagementApi.md +187 -69
  13. data/docs/MessageLogEntry.md +1 -3
  14. data/docs/NewCoupons.md +1 -1
  15. data/docs/NewExternalInvitation.md +21 -0
  16. data/docs/UpdateCoupon.md +1 -1
  17. data/docs/UpdateUser.md +1 -1
  18. data/lib/talon_one/api/integration_api.rb +18 -18
  19. data/lib/talon_one/api/management_api.rb +200 -76
  20. data/lib/talon_one/models/activate_user_request.rb +213 -0
  21. data/lib/talon_one/models/additional_campaign_properties.rb +2 -2
  22. data/lib/talon_one/models/campaign.rb +2 -2
  23. data/lib/talon_one/models/coupon.rb +2 -2
  24. data/lib/talon_one/models/customer_inventory.rb +1 -1
  25. data/lib/talon_one/models/inline_response20044.rb +1 -1
  26. data/lib/talon_one/models/integration_coupon.rb +2 -2
  27. data/lib/talon_one/models/inventory_coupon.rb +2 -2
  28. data/lib/talon_one/models/loyalty_card_balances.rb +231 -0
  29. data/lib/talon_one/models/loyalty_card_profile_registration.rb +1 -1
  30. data/lib/talon_one/models/message_log_entry.rb +4 -14
  31. data/lib/talon_one/models/new_coupons.rb +1 -1
  32. data/lib/talon_one/models/new_external_invitation.rb +235 -0
  33. data/lib/talon_one/models/update_coupon.rb +1 -1
  34. data/lib/talon_one/models/update_user.rb +1 -1
  35. data/lib/talon_one/version.rb +1 -1
  36. data/lib/talon_one.rb +3 -0
  37. data/spec/api/integration_api_spec.rb +7 -7
  38. data/spec/api/management_api_spec.rb +43 -19
  39. data/spec/models/activate_user_request_spec.rb +41 -0
  40. data/spec/models/additional_campaign_properties_spec.rb +1 -1
  41. data/spec/models/campaign_spec.rb +1 -1
  42. data/spec/models/loyalty_card_balances_spec.rb +53 -0
  43. data/spec/models/message_log_entry_spec.rb +1 -7
  44. data/spec/models/new_external_invitation_spec.rb +53 -0
  45. metadata +30 -18
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 70b7dd0b522487fb1b7e874d7d71d6ca7d3787ef996d8e60a7aeaf0c49486210
4
- data.tar.gz: f3b011f73cd78383edd1ba961b0c07aee79b4349e365b1070e01320933be3738
3
+ metadata.gz: 9eaf8b6367541506ab5a5c65795feca78547d5f768ad78b1387122920a7c0351
4
+ data.tar.gz: 21e71d932bf55225be51ad2b42ec7f7c47a696d5a3538128adf7fc813ffa67a2
5
5
  SHA512:
6
- metadata.gz: 8c9173e3ba65e41549cfb4074f362bed07a2907d1227840e9c57988ba6cc0ab07b0cafcfda48eb51c45bcb39a66ceee565cf1b533e23ca0bf3ebfc0419d02926
7
- data.tar.gz: 15753714650f14e597e33c5f5326e6dc21fa9df6be22b8a699bfd60e320137fdddaafd8d454b3522d8518ac1d5842a5b8c5082e328ab242829efd6d11c6ddd7d
6
+ metadata.gz: 46f9890f5533a5a6070933fd9c12e4c3478c96b1e4429f1e05971fcd563ffd1650cb9d5312a48e575c5483b8c53379c22d6682465900670192aa58fe934f4293
7
+ data.tar.gz: 62ad41bc40bdc90ecabfdb3016de630135fa13563ba9264e1e539cda6d06a444628b9e656456d09a9ce4ef6b2d0c1b0eaa868ae0c812bcecb899e4a4f548e9ca
data/README.md CHANGED
@@ -21,7 +21,7 @@ is `https://yourbaseurl.talon.one/v2/customer_sessions/{Id}`
21
21
  This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
22
22
 
23
23
  - API version:
24
- - Package version: 4.0.0
24
+ - Package version: 5.0.0
25
25
  - Build package: org.openapitools.codegen.languages.RubyClientCodegen
26
26
 
27
27
  ## Installation
@@ -37,16 +37,16 @@ gem build talon_one.gemspec
37
37
  Then either install the gem locally:
38
38
 
39
39
  ```shell
40
- gem install ./talon_one-4.0.0.gem
40
+ gem install ./talon_one-5.0.0.gem
41
41
  ```
42
42
 
43
- (for development, run `gem install --dev ./talon_one-4.0.0.gem` to install the development dependencies)
43
+ (for development, run `gem install --dev ./talon_one-5.0.0.gem` to install the development dependencies)
44
44
 
45
45
  or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
46
46
 
47
47
  Finally add this to the Gemfile:
48
48
 
49
- gem 'talon_one', '~> 4.0.0'
49
+ gem 'talon_one', '~> 5.0.0'
50
50
 
51
51
  ### Install from Git
52
52
 
@@ -223,6 +223,7 @@ Class | Method | HTTP request | Description
223
223
  *TalonOne::IntegrationApi* | [**update_customer_profile_v2**](docs/IntegrationApi.md#update_customer_profile_v2) | **PUT** /v2/customer_profiles/{integrationId} | Update customer profile
224
224
  *TalonOne::IntegrationApi* | [**update_customer_profiles_v2**](docs/IntegrationApi.md#update_customer_profiles_v2) | **PUT** /v2/customer_profiles | Update multiple customer profiles
225
225
  *TalonOne::IntegrationApi* | [**update_customer_session_v2**](docs/IntegrationApi.md#update_customer_session_v2) | **PUT** /v2/customer_sessions/{customerSessionId} | Update customer session
226
+ *TalonOne::ManagementApi* | [**activate_user_by_email**](docs/ManagementApi.md#activate_user_by_email) | **POST** /v1/users/activate | Activate user by email address
226
227
  *TalonOne::ManagementApi* | [**add_loyalty_card_points**](docs/ManagementApi.md#add_loyalty_card_points) | **PUT** /v1/loyalty_programs/{loyaltyProgramId}/cards/{loyaltyCardId}/add_points | Add points to card
227
228
  *TalonOne::ManagementApi* | [**add_loyalty_points**](docs/ManagementApi.md#add_loyalty_points) | **PUT** /v1/loyalty_programs/{loyaltyProgramId}/profile/{integrationId}/add_points | Add points to customer profile
228
229
  *TalonOne::ManagementApi* | [**copy_campaign_to_applications**](docs/ManagementApi.md#copy_campaign_to_applications) | **POST** /v1/applications/{applicationId}/campaigns/{campaignId}/copy | Copy the campaign into the specified Application
@@ -277,7 +278,6 @@ Class | Method | HTTP request | Description
277
278
  *TalonOne::ManagementApi* | [**get_additional_cost**](docs/ManagementApi.md#get_additional_cost) | **GET** /v1/additional_costs/{additionalCostId} | Get additional cost
278
279
  *TalonOne::ManagementApi* | [**get_additional_costs**](docs/ManagementApi.md#get_additional_costs) | **GET** /v1/additional_costs | List additional costs
279
280
  *TalonOne::ManagementApi* | [**get_all_access_logs**](docs/ManagementApi.md#get_all_access_logs) | **GET** /v1/access_logs | List access logs
280
- *TalonOne::ManagementApi* | [**get_all_roles**](docs/ManagementApi.md#get_all_roles) | **GET** /v1/roles | List roles
281
281
  *TalonOne::ManagementApi* | [**get_application**](docs/ManagementApi.md#get_application) | **GET** /v1/applications/{applicationId} | Get Application
282
282
  *TalonOne::ManagementApi* | [**get_application_api_health**](docs/ManagementApi.md#get_application_api_health) | **GET** /v1/applications/{applicationId}/health_report | Get Application health
283
283
  *TalonOne::ManagementApi* | [**get_application_customer**](docs/ManagementApi.md#get_application_customer) | **GET** /v1/applications/{applicationId}/customers/{customerId} | Get application's customer
@@ -323,7 +323,7 @@ Class | Method | HTTP request | Description
323
323
  *TalonOne::ManagementApi* | [**get_loyalty_programs**](docs/ManagementApi.md#get_loyalty_programs) | **GET** /v1/loyalty_programs | List loyalty programs
324
324
  *TalonOne::ManagementApi* | [**get_loyalty_statistics**](docs/ManagementApi.md#get_loyalty_statistics) | **GET** /v1/loyalty_programs/{loyaltyProgramId}/statistics | Get loyalty program statistics
325
325
  *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
326
- *TalonOne::ManagementApi* | [**get_role**](docs/ManagementApi.md#get_role) | **GET** /v1/roles/{roleId} | Get role
326
+ *TalonOne::ManagementApi* | [**get_role_v2**](docs/ManagementApi.md#get_role_v2) | **GET** /v2/roles/{roleId} | Get role
327
327
  *TalonOne::ManagementApi* | [**get_ruleset**](docs/ManagementApi.md#get_ruleset) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/rulesets/{rulesetId} | Get ruleset
328
328
  *TalonOne::ManagementApi* | [**get_rulesets**](docs/ManagementApi.md#get_rulesets) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/rulesets | List campaign rulesets
329
329
  *TalonOne::ManagementApi* | [**get_store**](docs/ManagementApi.md#get_store) | **GET** /v1/applications/{applicationId}/stores/{storeId} | Get store
@@ -343,8 +343,10 @@ Class | Method | HTTP request | Description
343
343
  *TalonOne::ManagementApi* | [**import_loyalty_points**](docs/ManagementApi.md#import_loyalty_points) | **POST** /v1/loyalty_programs/{loyaltyProgramId}/import_points | Import loyalty points
344
344
  *TalonOne::ManagementApi* | [**import_pool_giveaways**](docs/ManagementApi.md#import_pool_giveaways) | **POST** /v1/giveaways/pools/{poolId}/import | Import giveaway codes into a giveaway pool
345
345
  *TalonOne::ManagementApi* | [**import_referrals**](docs/ManagementApi.md#import_referrals) | **POST** /v1/applications/{applicationId}/campaigns/{campaignId}/import_referrals | Import referrals
346
+ *TalonOne::ManagementApi* | [**invite_user_external**](docs/ManagementApi.md#invite_user_external) | **POST** /v1/users/invite | Invite user from identity provider
346
347
  *TalonOne::ManagementApi* | [**list_account_collections**](docs/ManagementApi.md#list_account_collections) | **GET** /v1/collections | List collections in account
347
348
  *TalonOne::ManagementApi* | [**list_achievements**](docs/ManagementApi.md#list_achievements) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/achievements | List achievements
349
+ *TalonOne::ManagementApi* | [**list_all_roles_v2**](docs/ManagementApi.md#list_all_roles_v2) | **GET** /v2/roles | List roles
348
350
  *TalonOne::ManagementApi* | [**list_catalog_items**](docs/ManagementApi.md#list_catalog_items) | **GET** /v1/catalogs/{catalogId}/items | List items in a catalog
349
351
  *TalonOne::ManagementApi* | [**list_collections**](docs/ManagementApi.md#list_collections) | **GET** /v1/applications/{applicationId}/campaigns/{campaignId}/collections | List collections in campaign
350
352
  *TalonOne::ManagementApi* | [**list_collections_in_application**](docs/ManagementApi.md#list_collections_in_application) | **GET** /v1/applications/{applicationId}/collections | List collections in Application
@@ -393,6 +395,7 @@ Class | Method | HTTP request | Description
393
395
  - [TalonOne::Achievement](docs/Achievement.md)
394
396
  - [TalonOne::AchievementAdditionalProperties](docs/AchievementAdditionalProperties.md)
395
397
  - [TalonOne::AchievementProgress](docs/AchievementProgress.md)
398
+ - [TalonOne::ActivateUserRequest](docs/ActivateUserRequest.md)
396
399
  - [TalonOne::AddFreeItemEffectProps](docs/AddFreeItemEffectProps.md)
397
400
  - [TalonOne::AddItemCatalogAction](docs/AddItemCatalogAction.md)
398
401
  - [TalonOne::AddLoyaltyPoints](docs/AddLoyaltyPoints.md)
@@ -632,6 +635,7 @@ Class | Method | HTTP request | Description
632
635
  - [TalonOne::LoyaltyBalance](docs/LoyaltyBalance.md)
633
636
  - [TalonOne::LoyaltyBalances](docs/LoyaltyBalances.md)
634
637
  - [TalonOne::LoyaltyCard](docs/LoyaltyCard.md)
638
+ - [TalonOne::LoyaltyCardBalances](docs/LoyaltyCardBalances.md)
635
639
  - [TalonOne::LoyaltyCardProfileRegistration](docs/LoyaltyCardProfileRegistration.md)
636
640
  - [TalonOne::LoyaltyCardRegistration](docs/LoyaltyCardRegistration.md)
637
641
  - [TalonOne::LoyaltyDashboardData](docs/LoyaltyDashboardData.md)
@@ -691,6 +695,7 @@ Class | Method | HTTP request | Description
691
695
  - [TalonOne::NewCustomerSessionV2](docs/NewCustomerSessionV2.md)
692
696
  - [TalonOne::NewEvent](docs/NewEvent.md)
693
697
  - [TalonOne::NewEventType](docs/NewEventType.md)
698
+ - [TalonOne::NewExternalInvitation](docs/NewExternalInvitation.md)
694
699
  - [TalonOne::NewGiveawaysPool](docs/NewGiveawaysPool.md)
695
700
  - [TalonOne::NewInternalAudience](docs/NewInternalAudience.md)
696
701
  - [TalonOne::NewInvitation](docs/NewInvitation.md)
@@ -0,0 +1,17 @@
1
+ # TalonOne::ActivateUserRequest
2
+
3
+ ## Properties
4
+
5
+ Name | Type | Description | Notes
6
+ ------------ | ------------- | ------------- | -------------
7
+ **email** | **String** | The email address associated with the user profile. |
8
+
9
+ ## Code Sample
10
+
11
+ ```ruby
12
+ require 'TalonOne'
13
+
14
+ instance = TalonOne::ActivateUserRequest.new(email: john.doe@example.com)
15
+ ```
16
+
17
+
data/docs/Coupon.md CHANGED
@@ -22,9 +22,9 @@ Name | Type | Description | Notes
22
22
  **referral_id** | **Integer** | The integration ID of the referring customer (if any) for whom this coupon was created as an effect. | [optional]
23
23
  **recipient_integration_id** | **String** | The Integration ID of the customer that is allowed to redeem this coupon. | [optional]
24
24
  **import_id** | **Integer** | The ID of the Import which created this coupon. | [optional]
25
- **reservation** | **Boolean** | Defines the type of reservation: - `true`: The reservation is a soft reservation. Any customer can use the coupon. This is done via the [Create coupon reservation](https://docs.talon.one/integration-api#operation/createCouponReservation) endpoint. - `false`: The reservation is a hard reservation. Only the associated customer (`recipientIntegrationId`) can use the coupon. This is done via the Campaign Manager when you create a coupon for a given `recipientIntegrationId`, the [Create coupons](https://docs.talon.one/management-api#operation/createCoupons) endpoint or [Create coupons for multiple recipients](https://docs.talon.one/management-api#operation/createCouponsForMultipleRecipients) endpoint. | [optional] [default to true]
25
+ **reservation** | **Boolean** | Defines the reservation type: - `true`: The coupon can be reserved for multiple customers. - `false`: The coupon can be reserved only for one customer. It is a personal code. | [optional] [default to true]
26
26
  **batch_id** | **String** | The id of the batch the coupon belongs to. | [optional]
27
- **is_reservation_mandatory** | **Boolean** | Whether the reservation effect actually created a new reservation. | [optional] [default to false]
27
+ **is_reservation_mandatory** | **Boolean** | An indication of whether the code can be redeemed only if it has been reserved first. | [optional] [default to false]
28
28
  **implicitly_reserved** | **Boolean** | An indication of whether the coupon is implicitly reserved for all customers. | [optional]
29
29
 
30
30
  ## Code Sample
@@ -7,7 +7,7 @@ Name | Type | Description | Notes
7
7
  **profile** | [**CustomerProfile**](CustomerProfile.md) | | [optional]
8
8
  **loyalty** | [**Loyalty**](Loyalty.md) | | [optional]
9
9
  **referrals** | [**Array<InventoryReferral>**](InventoryReferral.md) | | [optional]
10
- **coupons** | [**Array<InventoryCoupon>**](InventoryCoupon.md) | The coupons reserved by this profile. This array includes hard and soft reservations. See each coupon's `reservation` property. | [optional]
10
+ **coupons** | [**Array<InventoryCoupon>**](InventoryCoupon.md) | The coupons reserved by this profile. This array includes hard and soft reservations. | [optional]
11
11
  **giveaways** | [**Array<Giveaway>**](Giveaway.md) | | [optional]
12
12
  **achievements** | [**Array<AchievementProgress>**](AchievementProgress.md) | | [optional]
13
13
 
@@ -5,7 +5,7 @@
5
5
  Name | Type | Description | Notes
6
6
  ------------ | ------------- | ------------- | -------------
7
7
  **total_result_size** | **Integer** | |
8
- **data** | [**Array<Role>**](Role.md) | |
8
+ **data** | [**Array<RoleV2>**](RoleV2.md) | |
9
9
 
10
10
  ## Code Sample
11
11
 
@@ -95,7 +95,7 @@ Name | Type | Description | Notes
95
95
 
96
96
  Create coupon reservation
97
97
 
98
- Create a coupon reservation for specified customer profiles on the specified coupon. You can also create a reservation via the Campaign Manager using the [Create coupon code reservation effect](https://docs.talon.one/docs/product/rules/effects/using-effects#reserving-a-coupon-code). Reserving a coupon allows you to associate a coupon code to a given customer(s). You can then list the reserved coupons of a given customer with the [List customer data](https://docs.talon.one/integration-api#operation/getCustomerInventory) endpoint. If a coupon gets created for a specific user, it will automatically appear in their coupons. When a user redeems a coupon, a reservation is automatically created after the redemption and the used coupon will be returned in the [List customer data](https://docs.talon.one/integration-api#operation/getCustomerInventory) endpoint. For example, you can use this endpoint and `List customer data` to create a _coupon wallet_ by reserving coupon codes for a customer, and then displaying their coupon wallet when they visit your store. If the **Coupon visibility** checkbox was selected when [creating a universal code](https://docs.talon.one/docs/product/campaigns/coupons/creating-coupons#generating-a-universal-code), the coupon code is implicitly reserved for all customers, and the code will be returned for all customer profiles in the [List customer data](https://docs.talon.one/integration-api#operation/getCustomerInventory) endpoint. <div class=\"redoc-section\"> <p class=\"title\">Important</p> This endpoint creates a **soft** reservation. _Any_ customer can use a reserved coupon code and proceed to checkout. To create a hard reservation, you can: - use the [Create coupons](https://docs.talon.one/management-api#operation/createCoupons) endpoint or, - use the [Create coupons for multiple recipients](https://docs.talon.one/management-api#operation/createCouponsForMultipleRecipients) endpoint setting the `recipientsIntegrationId` property or, - create a coupon code with the **Reservation mandatory** option then use the [Create coupon code reservation effect](https://docs.talon.one/docs/product/rules/effects/using-effects#reserving-a-coupon-code). This endpoint overrides the reservation limit set for the coupon code during coupon creation. </div> To delete a reservation, use the [Delete reservation](https://docs.talon.one/integration-api#tag/Coupons/operation/deleteCouponReservation) endpoint.
98
+ Create a coupon reservation for the specified customer profiles on the specified coupon. You can also create a reservation via the Campaign Manager using the [Create coupon code reservation effect](https://docs.talon.one/docs/product/rules/effects/using-effects#reserving-a-coupon-code). - If the **Reservation mandatory** option was selected when creating the specified coupon, the endpoint creates a **hard** reservation, meaning only users who have this coupon code reserved can redeem it. Otherwise, the endpoint creates a **soft** reservation, meaning the coupon will be associated with the specified customer profiles (they show up when using the [List customer data](https://docs.talon.one/integration-api#operation/getCustomerInventory) endpoint), but any user can redeem it. This can be useful, for example, to display a _coupon wallet_ for customers when they visit your store. - If the **Coupon visibility** option was selected when creating the specified coupon, the coupon code is implicitly soft-reserved for all customers, and the code will be returned for all customer profiles in the [List customer data](https://docs.talon.one/integration-api#operation/getCustomerInventory) endpoint. To delete a reservation, use the [Delete reservation](https://docs.talon.one/integration-api#tag/Coupons/operation/deleteCouponReservation) endpoint.
99
99
 
100
100
  ### Example
101
101
 
@@ -599,7 +599,7 @@ Name | Type | Description | Notes
599
599
 
600
600
  Get customer's loyalty points
601
601
 
602
- Retrieve loyalty ledger balances for the given Integration ID in the specified loyalty program. You can filter balances by date and subledger ID. **Note**: If no filtering options are applied, you retrieve all loyalty balances on the current date for the given integration ID. Loyalty balances are calculated when Talon.One receives your request using the points stored in our database, so retrieving a large number of balances at once can impact performance. For more information, see: - [Managing card-based loyalty program data](https://docs.talon.one/docs/product/loyalty-programs/card-based/managing-loyalty-cards) - [Managing profile-based loyalty program data](https://docs.talon.one/docs/product/loyalty-programs/profile-based/managing-pb-lp-data)
602
+ Retrieve loyalty ledger balances for the given Integration ID in the specified loyalty program. You can filter balances by date and subledger ID. **Note**: If no filtering options are applied, you retrieve all loyalty balances on the current date for the given integration ID. Loyalty balances are calculated when Talon.One receives your request using the points stored in our database, so retrieving a large number of balances at once can impact performance. For more information, see: - [Managing card-based loyalty program data](https://docs.talon.one/docs/product/loyalty-programs/card-based/managing-loyalty-cards) - [Managing profile-based loyalty program data](https://docs.talon.one/docs/product/loyalty-programs/profile-based/managing-pb-lp-data)
603
603
 
604
604
  ### Example
605
605
 
@@ -619,7 +619,7 @@ loyalty_program_id = 56 # Integer | Identifier of the profile-based loyalty prog
619
619
  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.
620
620
  opts = {
621
621
  end_date: DateTime.parse('2013-10-20T19:20:30+01:00'), # DateTime | Used to return expired, active, and pending loyalty balances before this timestamp. You can enter any past, present, or future timestamp value. **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.
622
- subledger_id: ['subledger_id_example'] # Array<String> | Filter results by one or more subledger IDs. Must be exact match.
622
+ subledger_id: 'subledger_id_example' # String | The ID of the subledger by which we filter the data.
623
623
  }
624
624
 
625
625
  begin
@@ -639,7 +639,7 @@ Name | Type | Description | Notes
639
639
  **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. |
640
640
  **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. |
641
641
  **end_date** | **DateTime**| Used to return expired, active, and pending loyalty balances before this timestamp. You can enter any past, present, or future timestamp value. **Note:** - It must be an RFC3339 timestamp string. - You can include a time component in your string, for example, &#x60;T23:59:59&#x60; to specify the end of the day. The time zone setting considered is &#x60;UTC&#x60;. If you do not include a time component, a default time value of &#x60;T00:00:00&#x60; (midnight) in &#x60;UTC&#x60; is considered. | [optional]
642
- **subledger_id** | [**Array&lt;String&gt;**](String.md)| Filter results by one or more subledger IDs. Must be exact match. | [optional]
642
+ **subledger_id** | **String**| The ID of the subledger by which we filter the data. | [optional]
643
643
 
644
644
  ### Return type
645
645
 
@@ -657,7 +657,7 @@ Name | Type | Description | Notes
657
657
 
658
658
  ## get_loyalty_card_balances
659
659
 
660
- > LoyaltyBalances get_loyalty_card_balances(loyalty_program_id, loyalty_card_id, opts)
660
+ > LoyaltyCardBalances get_loyalty_card_balances(loyalty_program_id, loyalty_card_id, opts)
661
661
 
662
662
  Get card's point balances
663
663
 
@@ -705,7 +705,7 @@ Name | Type | Description | Notes
705
705
 
706
706
  ### Return type
707
707
 
708
- [**LoyaltyBalances**](LoyaltyBalances.md)
708
+ [**LoyaltyCardBalances**](LoyaltyCardBalances.md)
709
709
 
710
710
  ### Authorization
711
711
 
@@ -743,7 +743,7 @@ loyalty_program_id = 56 # Integer | Identifier of the card-based loyalty program
743
743
  loyalty_card_id = 'loyalty_card_id_example' # String | Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint.
744
744
  opts = {
745
745
  status: 'active', # String | Filter points based on their status.
746
- subledger_id: 'subledger_id_example', # String | The ID of the subledger by which we filter the data.
746
+ subledger_id: ['subledger_id_example'], # Array<String> | Filter results by one or more subledger IDs. Must be exact match.
747
747
  page_size: 50, # Integer | The number of items in the response.
748
748
  skip: 56 # Integer | The number of items to skip when paging through large result sets.
749
749
  }
@@ -765,7 +765,7 @@ Name | Type | Description | Notes
765
765
  **loyalty_program_id** | **Integer**| Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. |
766
766
  **loyalty_card_id** | **String**| Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. |
767
767
  **status** | **String**| Filter points based on their status. | [optional] [default to &#39;active&#39;]
768
- **subledger_id** | **String**| The ID of the subledger by which we filter the data. | [optional]
768
+ **subledger_id** | [**Array&lt;String&gt;**](String.md)| Filter results by one or more subledger IDs. Must be exact match. | [optional]
769
769
  **page_size** | **Integer**| The number of items in the response. | [optional] [default to 50]
770
770
  **skip** | **Integer**| The number of items to skip when paging through large result sets. | [optional]
771
771
 
@@ -808,7 +808,7 @@ api_instance = TalonOne::IntegrationApi.new
808
808
  loyalty_program_id = 56 # Integer | Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint.
809
809
  loyalty_card_id = 'loyalty_card_id_example' # String | Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint.
810
810
  opts = {
811
- subledger_id: 'subledger_id_example', # String | The ID of the subledger by which we filter the data.
811
+ subledger_id: ['subledger_id_example'], # Array<String> | Filter results by one or more subledger IDs. Must be exact match.
812
812
  loyalty_transaction_type: 'loyalty_transaction_type_example', # String | Filter results by loyalty transaction type: - `manual`: Loyalty transaction that was done manually. - `session`: Loyalty transaction that resulted from a customer session. - `import`: Loyalty transaction that was imported from a CSV file.
813
813
  start_date: DateTime.parse('2013-10-20T19:20:30+01:00'), # DateTime | Date and time from which results are returned. Results are filtered by transaction creation date. **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.
814
814
  end_date: DateTime.parse('2013-10-20T19:20:30+01:00'), # DateTime | Date and time by which results are returned. Results are filtered by transaction creation date. **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.
@@ -832,7 +832,7 @@ Name | Type | Description | Notes
832
832
  ------------- | ------------- | ------------- | -------------
833
833
  **loyalty_program_id** | **Integer**| Identifier of the card-based loyalty program containing the loyalty card. You can get the ID with the [List loyalty programs](https://docs.talon.one/management-api#tag/Loyalty/operation/getLoyaltyPrograms) endpoint. |
834
834
  **loyalty_card_id** | **String**| Identifier of the loyalty card. You can get the identifier with the [List loyalty cards](https://docs.talon.one/management-api#tag/Loyalty-cards/operation/getLoyaltyCards) endpoint. |
835
- **subledger_id** | **String**| The ID of the subledger by which we filter the data. | [optional]
835
+ **subledger_id** | [**Array&lt;String&gt;**](String.md)| Filter results by one or more subledger IDs. Must be exact match. | [optional]
836
836
  **loyalty_transaction_type** | **String**| Filter results by loyalty transaction type: - &#x60;manual&#x60;: Loyalty transaction that was done manually. - &#x60;session&#x60;: Loyalty transaction that resulted from a customer session. - &#x60;import&#x60;: Loyalty transaction that was imported from a CSV file. | [optional]
837
837
  **start_date** | **DateTime**| Date and time from which results are returned. Results are filtered by transaction creation date. **Note:** - It must be an RFC3339 timestamp string. - You can include a time component in your string, for example, &#x60;T23:59:59&#x60; to specify the end of the day. The time zone setting considered is &#x60;UTC&#x60;. If you do not include a time component, a default time value of &#x60;T00:00:00&#x60; (midnight) in &#x60;UTC&#x60; is considered. | [optional]
838
838
  **end_date** | **DateTime**| Date and time by which results are returned. Results are filtered by transaction creation date. **Note:** - It must be an RFC3339 timestamp string. - You can include a time component in your string, for example, &#x60;T23:59:59&#x60; to specify the end of the day. The time zone setting considered is &#x60;UTC&#x60;. If you do not include a time component, a default time value of &#x60;T00:00:00&#x60; (midnight) in &#x60;UTC&#x60; is considered. | [optional]
@@ -995,7 +995,7 @@ Name | Type | Description | Notes
995
995
 
996
996
  List customers that have this coupon reserved
997
997
 
998
- Return all customers that have this coupon marked as reserved. Coupons are reserved in the following ways: - To create a soft reservation (any customer can use the coupon), use the [Create coupon reservation](#operation/createCouponReservation) endpoint. - To create a hard reservation (only the given customer can use the coupon), create a coupon in the Campaign Manager for a given `recipientIntegrationId` or use the [Create coupons](https://docs.talon.one/management-api#operation/createCoupons) or [Create coupons for multiple recipients](https://docs.talon.one/management-api#operation/createCouponsForMultipleRecipients) endpoints.
998
+ Return all customers that have this coupon marked as reserved. This includes hard and soft reservations.
999
999
 
1000
1000
  ### Example
1001
1001
 
@@ -22,9 +22,9 @@ Name | Type | Description | Notes
22
22
  **referral_id** | **Integer** | The integration ID of the referring customer (if any) for whom this coupon was created as an effect. | [optional]
23
23
  **recipient_integration_id** | **String** | The Integration ID of the customer that is allowed to redeem this coupon. | [optional]
24
24
  **import_id** | **Integer** | The ID of the Import which created this coupon. | [optional]
25
- **reservation** | **Boolean** | Defines the type of reservation: - &#x60;true&#x60;: The reservation is a soft reservation. Any customer can use the coupon. This is done via the [Create coupon reservation](https://docs.talon.one/integration-api#operation/createCouponReservation) endpoint. - &#x60;false&#x60;: The reservation is a hard reservation. Only the associated customer (&#x60;recipientIntegrationId&#x60;) can use the coupon. This is done via the Campaign Manager when you create a coupon for a given &#x60;recipientIntegrationId&#x60;, the [Create coupons](https://docs.talon.one/management-api#operation/createCoupons) endpoint or [Create coupons for multiple recipients](https://docs.talon.one/management-api#operation/createCouponsForMultipleRecipients) endpoint. | [optional] [default to true]
25
+ **reservation** | **Boolean** | Defines the reservation type: - &#x60;true&#x60;: The coupon can be reserved for multiple customers. - &#x60;false&#x60;: The coupon can be reserved only for one customer. It is a personal code. | [optional] [default to true]
26
26
  **batch_id** | **String** | The id of the batch the coupon belongs to. | [optional]
27
- **is_reservation_mandatory** | **Boolean** | Whether the reservation effect actually created a new reservation. | [optional] [default to false]
27
+ **is_reservation_mandatory** | **Boolean** | An indication of whether the code can be redeemed only if it has been reserved first. | [optional] [default to false]
28
28
  **implicitly_reserved** | **Boolean** | An indication of whether the coupon is implicitly reserved for all customers. | [optional]
29
29
  **profile_redemption_count** | **Integer** | The number of times the coupon was redeemed by the profile. |
30
30
 
@@ -22,9 +22,9 @@ Name | Type | Description | Notes
22
22
  **referral_id** | **Integer** | The integration ID of the referring customer (if any) for whom this coupon was created as an effect. | [optional]
23
23
  **recipient_integration_id** | **String** | The Integration ID of the customer that is allowed to redeem this coupon. | [optional]
24
24
  **import_id** | **Integer** | The ID of the Import which created this coupon. | [optional]
25
- **reservation** | **Boolean** | Defines the type of reservation: - &#x60;true&#x60;: The reservation is a soft reservation. Any customer can use the coupon. This is done via the [Create coupon reservation](https://docs.talon.one/integration-api#operation/createCouponReservation) endpoint. - &#x60;false&#x60;: The reservation is a hard reservation. Only the associated customer (&#x60;recipientIntegrationId&#x60;) can use the coupon. This is done via the Campaign Manager when you create a coupon for a given &#x60;recipientIntegrationId&#x60;, the [Create coupons](https://docs.talon.one/management-api#operation/createCoupons) endpoint or [Create coupons for multiple recipients](https://docs.talon.one/management-api#operation/createCouponsForMultipleRecipients) endpoint. | [optional] [default to true]
25
+ **reservation** | **Boolean** | Defines the reservation type: - &#x60;true&#x60;: The coupon can be reserved for multiple customers. - &#x60;false&#x60;: The coupon can be reserved only for one customer. It is a personal code. | [optional] [default to true]
26
26
  **batch_id** | **String** | The id of the batch the coupon belongs to. | [optional]
27
- **is_reservation_mandatory** | **Boolean** | Whether the reservation effect actually created a new reservation. | [optional] [default to false]
27
+ **is_reservation_mandatory** | **Boolean** | An indication of whether the code can be redeemed only if it has been reserved first. | [optional] [default to false]
28
28
  **implicitly_reserved** | **Boolean** | An indication of whether the coupon is implicitly reserved for all customers. | [optional]
29
29
  **profile_redemption_count** | **Integer** | The number of times the coupon was redeemed by the profile. |
30
30
  **state** | **String** | Can be: - &#x60;active&#x60;: The coupon can be used. It is a reserved coupon that is not pending, used, or expired, and it has a non-exhausted limit counter. **Note:** This coupon state is returned for [scheduled campaigns](https://docs.talon.one/docs/product/campaigns/settings/managing-campaign-schedule), but the coupon cannot be used until the campaign is **running**. - &#x60;used&#x60;: The coupon has been redeemed and cannot be used again. It is not pending and has reached its redemption limit or was redeemed by the profile before expiration. - &#x60;expired&#x60;: The coupon was never redeemed, and it is now expired. It is non-pending, non-active, and non-used by the profile. - &#x60;pending&#x60;: The coupon will be usable in the future. - &#x60;disabled&#x60;: The coupon is part of a non-active campaign. |
@@ -0,0 +1,21 @@
1
+ # TalonOne::LoyaltyCardBalances
2
+
3
+ ## Properties
4
+
5
+ Name | Type | Description | Notes
6
+ ------------ | ------------- | ------------- | -------------
7
+ **balance** | [**LoyaltyBalance**](LoyaltyBalance.md) | | [optional]
8
+ **subledger_balances** | [**Hash&lt;String, LoyaltyBalance&gt;**](LoyaltyBalance.md) | Map of the loyalty balances of the subledgers of a ledger. | [optional]
9
+ **profiles** | [**Array&lt;LoyaltyCardProfileRegistration&gt;**](LoyaltyCardProfileRegistration.md) | Customer profiles linked to the loyalty card. | [optional]
10
+
11
+ ## Code Sample
12
+
13
+ ```ruby
14
+ require 'TalonOne'
15
+
16
+ instance = TalonOne::LoyaltyCardBalances.new(balance: null,
17
+ subledger_balances: {&quot;mysubledger&quot;:{&quot;activePoints&quot;:286,&quot;pendingPoints&quot;:50,&quot;spentPoints&quot;:150,&quot;expiredPoints&quot;:25}},
18
+ profiles: null)
19
+ ```
20
+
21
+
@@ -5,7 +5,7 @@
5
5
  Name | Type | Description | Notes
6
6
  ------------ | ------------- | ------------- | -------------
7
7
  **integration_id** | **String** | Integration ID of the customer profile linked to the card. |
8
- **timestamp** | **DateTime** | Timestamp of the registration to the card. |
8
+ **timestamp** | **DateTime** | Timestamp the customer profile was linked to the card. |
9
9
 
10
10
  ## Code Sample
11
11