ultracart_api 4.0.238 → 4.0.240

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: a70af5cb98d0587cbecfdfc9662ba4a9c14347670f13a9a677702467a19f276f
4
- data.tar.gz: 42144c4b4b82d971a51d482cd7bda59f93d8bd624a0a9dab0d6980fa48073bee
3
+ metadata.gz: a7055287bb92af14ebdac856bfb87c93d98a966210c215a4fb086709978b2097
4
+ data.tar.gz: 0d5b4e3f35092ab78c2232cf0af2daa554ee5e9aac0e8e5aa906cdef1408cded
5
5
  SHA512:
6
- metadata.gz: 634982a5946314032f882d5081b47275cb57e5258da2521d665ceadfce47b56565a6215357c9b5daebdcff4cc771c271d3815c9506b558f48385cb9e3e024d19
7
- data.tar.gz: f80d7b15d9a4318e15af41e0bcd63208aac7927d231a475991f6774b0c3d89abe6f53f84c20f672e7b6b7ef31e4334ceb3f2279d2762a6805a8574eed38cd811
6
+ metadata.gz: 9b2154411d3b54a8614d3d5d6cc5b2df34d4d7ac18b3b6bb69a0533595b685a93f80940619c947a1eab311f466b51f03c0f118f70c44ed3581063b186cad8f92
7
+ data.tar.gz: 3c05b656603ba51354816fc5e263fd59641dcd8341c72909aa3a3a1a9e5a48d623d8ee65cc15462e2a5b3f84af3d2a522f7018bae75df44ed10e5854d28d7cae
data/README.md CHANGED
@@ -7,7 +7,7 @@ UltraCart REST API Version 2
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.0.238
10
+ - Package version: 4.0.240
11
11
  - Build package: org.openapitools.codegen.languages.RubyClientCodegen
12
12
  For more information, please visit [http://www.ultracart.com](http://www.ultracart.com)
13
13
 
@@ -24,16 +24,16 @@ gem build ultracart_api.gemspec
24
24
  Then either install the gem locally:
25
25
 
26
26
  ```shell
27
- gem install ./ultracart_api-4.0.238.gem
27
+ gem install ./ultracart_api-4.0.240.gem
28
28
  ```
29
29
 
30
- (for development, run `gem install --dev ./ultracart_api-4.0.238.gem` to install the development dependencies)
30
+ (for development, run `gem install --dev ./ultracart_api-4.0.240.gem` to install the development dependencies)
31
31
 
32
32
  or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
33
33
 
34
34
  Finally add this to the Gemfile:
35
35
 
36
- gem 'ultracart_api', '~> 4.0.238'
36
+ gem 'ultracart_api', '~> 4.0.240'
37
37
 
38
38
  ### Install from Git
39
39
 
@@ -109,11 +109,14 @@ Class | Method | HTTP request | Description
109
109
  *UltracartClient::ChannelPartnerApi* | [**delete_channel_partner_ship_to_preference**](docs/ChannelPartnerApi.md#delete_channel_partner_ship_to_preference) | **DELETE** /channel_partner/channel_partners/{channel_partner_oid}/ship_to_preferences/{channel_partner_ship_to_preference_oid} | Delete a ship to preference record for the channel partner.
110
110
  *UltracartClient::ChannelPartnerApi* | [**estimate_shipping_for_channel_partner_order**](docs/ChannelPartnerApi.md#estimate_shipping_for_channel_partner_order) | **POST** /channel_partner/estimate_shipping | Estimate shipping for channel partner order
111
111
  *UltracartClient::ChannelPartnerApi* | [**estimate_tax_for_channel_partner_order**](docs/ChannelPartnerApi.md#estimate_tax_for_channel_partner_order) | **POST** /channel_partner/estimate_tax | Estimate tax for channel partner order
112
+ *UltracartClient::ChannelPartnerApi* | [**get_channel_partner_order**](docs/ChannelPartnerApi.md#get_channel_partner_order) | **GET** /channel_partner/orders/{order_id} | Retrieve a channel partner order
113
+ *UltracartClient::ChannelPartnerApi* | [**get_channel_partner_order_by_channel_partner_order_id**](docs/ChannelPartnerApi.md#get_channel_partner_order_by_channel_partner_order_id) | **GET** /channel_partner/orders/by_channel_partner_order_id/{order_id} | Retrieve a channel partner order by the channel partner order id
112
114
  *UltracartClient::ChannelPartnerApi* | [**get_channel_partner_ship_to_preference**](docs/ChannelPartnerApi.md#get_channel_partner_ship_to_preference) | **GET** /channel_partner/channel_partners/{channel_partner_oid}/ship_to_preferences/{channel_partner_ship_to_preference_oid} | Retrieve the ship to preference associated with the channel partner and the specific id.
113
115
  *UltracartClient::ChannelPartnerApi* | [**get_channel_partner_ship_to_preferences**](docs/ChannelPartnerApi.md#get_channel_partner_ship_to_preferences) | **GET** /channel_partner/channel_partners/{channel_partner_oid}/ship_to_preferences | Retrieve the ship to preferences associated with the channel partner.
114
116
  *UltracartClient::ChannelPartnerApi* | [**get_channel_partners**](docs/ChannelPartnerApi.md#get_channel_partners) | **GET** /channel_partner/channel_partners | Retrieve the channel partners configured on the account.
115
117
  *UltracartClient::ChannelPartnerApi* | [**import_channel_partner_order**](docs/ChannelPartnerApi.md#import_channel_partner_order) | **POST** /channel_partner/import | Insert channel partner order
116
118
  *UltracartClient::ChannelPartnerApi* | [**insert_channel_partner_ship_to_preference**](docs/ChannelPartnerApi.md#insert_channel_partner_ship_to_preference) | **POST** /channel_partner/channel_partners/{channel_partner_oid}/ship_to_preferences | Insert a ship to preference record for the channel partner.
119
+ *UltracartClient::ChannelPartnerApi* | [**refund_channel_partner_order**](docs/ChannelPartnerApi.md#refund_channel_partner_order) | **PUT** /channel_partner/orders/{order_id}/refund | Refund a channel partner order
117
120
  *UltracartClient::ChannelPartnerApi* | [**update_channel_partner_ship_to_preference**](docs/ChannelPartnerApi.md#update_channel_partner_ship_to_preference) | **PUT** /channel_partner/channel_partners/{channel_partner_oid}/ship_to_preferences/{channel_partner_ship_to_preference_oid} | Update a ship to preference record for the channel partner.
118
121
  *UltracartClient::ChargebackApi* | [**delete_chargeback**](docs/ChargebackApi.md#delete_chargeback) | **DELETE** /chargeback/chargebacks/{chargeback_dispute_oid} | Delete a chargeback
119
122
  *UltracartClient::ChargebackApi* | [**get_chargeback_dispute**](docs/ChargebackApi.md#get_chargeback_dispute) | **GET** /chargeback/chargebacks/{chargeback_dispute_oid} | Retrieve a chargeback
@@ -1520,6 +1523,8 @@ Not every change is committed to every SDK.
1520
1523
 
1521
1524
  | Version | Date | Comments |
1522
1525
  | --: | :-: | --- |
1526
+ | 4.0.240 | 01/09/2025 | fix for broken 4.0.39 due to incorrect query sig on getCustomers |
1527
+ | 4.0.239 | 01/09/2025 | added emails parameter to customer queries, refundOrder added to Channel partner |
1523
1528
  | 4.0.238 | 12/13/2024 | added user and group ids to conversation agent auth object |
1524
1529
  | 4.0.237 | 11/11/2024 | added seo properties to item.content object |
1525
1530
  | 4.0.236 | 11/07/2024 | Coupon - PercentOffWithItemsQuantityPurchase - added support for tags |
@@ -9,11 +9,14 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
9
9
  | [**delete_channel_partner_ship_to_preference**](ChannelPartnerApi.md#delete_channel_partner_ship_to_preference) | **DELETE** /channel_partner/channel_partners/{channel_partner_oid}/ship_to_preferences/{channel_partner_ship_to_preference_oid} | Delete a ship to preference record for the channel partner. |
10
10
  | [**estimate_shipping_for_channel_partner_order**](ChannelPartnerApi.md#estimate_shipping_for_channel_partner_order) | **POST** /channel_partner/estimate_shipping | Estimate shipping for channel partner order |
11
11
  | [**estimate_tax_for_channel_partner_order**](ChannelPartnerApi.md#estimate_tax_for_channel_partner_order) | **POST** /channel_partner/estimate_tax | Estimate tax for channel partner order |
12
+ | [**get_channel_partner_order**](ChannelPartnerApi.md#get_channel_partner_order) | **GET** /channel_partner/orders/{order_id} | Retrieve a channel partner order |
13
+ | [**get_channel_partner_order_by_channel_partner_order_id**](ChannelPartnerApi.md#get_channel_partner_order_by_channel_partner_order_id) | **GET** /channel_partner/orders/by_channel_partner_order_id/{order_id} | Retrieve a channel partner order by the channel partner order id |
12
14
  | [**get_channel_partner_ship_to_preference**](ChannelPartnerApi.md#get_channel_partner_ship_to_preference) | **GET** /channel_partner/channel_partners/{channel_partner_oid}/ship_to_preferences/{channel_partner_ship_to_preference_oid} | Retrieve the ship to preference associated with the channel partner and the specific id. |
13
15
  | [**get_channel_partner_ship_to_preferences**](ChannelPartnerApi.md#get_channel_partner_ship_to_preferences) | **GET** /channel_partner/channel_partners/{channel_partner_oid}/ship_to_preferences | Retrieve the ship to preferences associated with the channel partner. |
14
16
  | [**get_channel_partners**](ChannelPartnerApi.md#get_channel_partners) | **GET** /channel_partner/channel_partners | Retrieve the channel partners configured on the account. |
15
17
  | [**import_channel_partner_order**](ChannelPartnerApi.md#import_channel_partner_order) | **POST** /channel_partner/import | Insert channel partner order |
16
18
  | [**insert_channel_partner_ship_to_preference**](ChannelPartnerApi.md#insert_channel_partner_ship_to_preference) | **POST** /channel_partner/channel_partners/{channel_partner_oid}/ship_to_preferences | Insert a ship to preference record for the channel partner. |
19
+ | [**refund_channel_partner_order**](ChannelPartnerApi.md#refund_channel_partner_order) | **PUT** /channel_partner/orders/{order_id}/refund | Refund a channel partner order |
17
20
  | [**update_channel_partner_ship_to_preference**](ChannelPartnerApi.md#update_channel_partner_ship_to_preference) | **PUT** /channel_partner/channel_partners/{channel_partner_oid}/ship_to_preferences/{channel_partner_ship_to_preference_oid} | Update a ship to preference record for the channel partner. |
18
21
 
19
22
 
@@ -373,6 +376,156 @@ end
373
376
  - **Accept**: application/json
374
377
 
375
378
 
379
+ ## get_channel_partner_order
380
+
381
+ > <OrderResponse> get_channel_partner_order(order_id, opts)
382
+
383
+ Retrieve a channel partner order
384
+
385
+ Retrieves a single order using the specified order id. Only orders belonging to this channel partner may be retrieved.
386
+
387
+ ### Examples
388
+
389
+ ```ruby
390
+ require 'time'
391
+ require 'ultracart_api'
392
+ require 'json'
393
+ require 'yaml'
394
+ require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
395
+
396
+ # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
397
+ # As such, this might not be the best way to use this object.
398
+ # Please see https://github.com/UltraCart/sdk_samples for working examples.
399
+
400
+ api = UltracartClient::ChannelPartnerApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
401
+ order_id = 'order_id_example' # String | The order id to retrieve.
402
+ opts = {
403
+ _expand: '_expand_example' # String | The object expansion to perform on the result. See OrderApi.getOrder documentation for examples
404
+ }
405
+
406
+ begin
407
+ # Retrieve a channel partner order
408
+ result = api_instance.get_channel_partner_order(order_id, opts)
409
+ p result
410
+ rescue UltracartClient::ApiError => e
411
+ puts "Error when calling ChannelPartnerApi->get_channel_partner_order: #{e}"
412
+ end
413
+ ```
414
+
415
+ #### Using the get_channel_partner_order_with_http_info variant
416
+
417
+ This returns an Array which contains the response data, status code and headers.
418
+
419
+ > <Array(<OrderResponse>, Integer, Hash)> get_channel_partner_order_with_http_info(order_id, opts)
420
+
421
+ ```ruby
422
+ begin
423
+ # Retrieve a channel partner order
424
+ data, status_code, headers = api_instance.get_channel_partner_order_with_http_info(order_id, opts)
425
+ p status_code # => 2xx
426
+ p headers # => { ... }
427
+ p data # => <OrderResponse>
428
+ rescue UltracartClient::ApiError => e
429
+ puts "Error when calling ChannelPartnerApi->get_channel_partner_order_with_http_info: #{e}"
430
+ end
431
+ ```
432
+
433
+ ### Parameters
434
+
435
+ | Name | Type | Description | Notes |
436
+ | ---- | ---- | ----------- | ----- |
437
+ | **order_id** | **String** | The order id to retrieve. | |
438
+ | **_expand** | **String** | The object expansion to perform on the result. See OrderApi.getOrder documentation for examples | [optional] |
439
+
440
+ ### Return type
441
+
442
+ [**OrderResponse**](OrderResponse.md)
443
+
444
+ ### Authorization
445
+
446
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
447
+
448
+ ### HTTP request headers
449
+
450
+ - **Content-Type**: Not defined
451
+ - **Accept**: application/json
452
+
453
+
454
+ ## get_channel_partner_order_by_channel_partner_order_id
455
+
456
+ > <OrderResponse> get_channel_partner_order_by_channel_partner_order_id(order_id, opts)
457
+
458
+ Retrieve a channel partner order by the channel partner order id
459
+
460
+ Retrieves a single order using the channel partner order id, not the ultracart order id. Only orders belonging to this channel partner may be retrieved.
461
+
462
+ ### Examples
463
+
464
+ ```ruby
465
+ require 'time'
466
+ require 'ultracart_api'
467
+ require 'json'
468
+ require 'yaml'
469
+ require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
470
+
471
+ # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
472
+ # As such, this might not be the best way to use this object.
473
+ # Please see https://github.com/UltraCart/sdk_samples for working examples.
474
+
475
+ api = UltracartClient::ChannelPartnerApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
476
+ order_id = 'order_id_example' # String | The channel partner order id to retrieve.
477
+ opts = {
478
+ _expand: '_expand_example' # String | The object expansion to perform on the result. See OrderApi.getOrder documentation for examples
479
+ }
480
+
481
+ begin
482
+ # Retrieve a channel partner order by the channel partner order id
483
+ result = api_instance.get_channel_partner_order_by_channel_partner_order_id(order_id, opts)
484
+ p result
485
+ rescue UltracartClient::ApiError => e
486
+ puts "Error when calling ChannelPartnerApi->get_channel_partner_order_by_channel_partner_order_id: #{e}"
487
+ end
488
+ ```
489
+
490
+ #### Using the get_channel_partner_order_by_channel_partner_order_id_with_http_info variant
491
+
492
+ This returns an Array which contains the response data, status code and headers.
493
+
494
+ > <Array(<OrderResponse>, Integer, Hash)> get_channel_partner_order_by_channel_partner_order_id_with_http_info(order_id, opts)
495
+
496
+ ```ruby
497
+ begin
498
+ # Retrieve a channel partner order by the channel partner order id
499
+ data, status_code, headers = api_instance.get_channel_partner_order_by_channel_partner_order_id_with_http_info(order_id, opts)
500
+ p status_code # => 2xx
501
+ p headers # => { ... }
502
+ p data # => <OrderResponse>
503
+ rescue UltracartClient::ApiError => e
504
+ puts "Error when calling ChannelPartnerApi->get_channel_partner_order_by_channel_partner_order_id_with_http_info: #{e}"
505
+ end
506
+ ```
507
+
508
+ ### Parameters
509
+
510
+ | Name | Type | Description | Notes |
511
+ | ---- | ---- | ----------- | ----- |
512
+ | **order_id** | **String** | The channel partner order id to retrieve. | |
513
+ | **_expand** | **String** | The object expansion to perform on the result. See OrderApi.getOrder documentation for examples | [optional] |
514
+
515
+ ### Return type
516
+
517
+ [**OrderResponse**](OrderResponse.md)
518
+
519
+ ### Authorization
520
+
521
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
522
+
523
+ ### HTTP request headers
524
+
525
+ - **Content-Type**: Not defined
526
+ - **Accept**: application/json
527
+
528
+
376
529
  ## get_channel_partner_ship_to_preference
377
530
 
378
531
  > <ChannelPartnerShipToPreferenceResponse> get_channel_partner_ship_to_preference(channel_partner_oid, channel_partner_ship_to_preference_oid)
@@ -729,6 +882,97 @@ end
729
882
  - **Accept**: application/json
730
883
 
731
884
 
885
+ ## refund_channel_partner_order
886
+
887
+ > <OrderResponse> refund_channel_partner_order(order_id, order, opts)
888
+
889
+ Refund a channel partner order
890
+
891
+ Perform a refund operation on a channel partner order and then update the order if successful. All of the object properties ending in _refunded should be the TOTAL amount that should end up being refunded. UltraCart will calculate the actual amount to refund based upon the prior refunds.
892
+
893
+ ### Examples
894
+
895
+ ```ruby
896
+ require 'time'
897
+ require 'ultracart_api'
898
+ require 'json'
899
+ require 'yaml'
900
+ require_relative '../constants' # https://github.com/UltraCart/sdk_samples/blob/master/ruby/constants.rb
901
+
902
+ # This example is based on our samples_sdk project, but still contains auto-generated content from our sdk generators.
903
+ # As such, this might not be the best way to use this object.
904
+ # Please see https://github.com/UltraCart/sdk_samples for working examples.
905
+
906
+ api = UltracartClient::ChannelPartnerApi.new_using_api_key(Constants::API_KEY, Constants::VERIFY_SSL, Constants::DEBUG_MODE)
907
+ order_id = 'order_id_example' # String | The order id to refund.
908
+ order = UltracartClient::Order.new # Order | Order to refund
909
+ opts = {
910
+ reject_after_refund: true, # Boolean | Reject order after refund
911
+ skip_customer_notification: true, # Boolean | Skip customer email notification
912
+ auto_order_cancel: true, # Boolean | Cancel associated auto orders
913
+ manual_refund: true, # Boolean | Consider a manual refund done externally
914
+ reverse_affiliate_transactions: true, # Boolean | Reverse affiliate transactions
915
+ issue_store_credit: true, # Boolean | Issue a store credit instead of refunding the original payment method, loyalty must be configured on merchant account
916
+ auto_order_cancel_reason: 'auto_order_cancel_reason_example', # String | Reason for auto orders cancellation
917
+ _expand: '_expand_example' # String | The object expansion to perform on the result. See OrderApi.refundOrder documentation for examples
918
+ }
919
+
920
+ begin
921
+ # Refund a channel partner order
922
+ result = api_instance.refund_channel_partner_order(order_id, order, opts)
923
+ p result
924
+ rescue UltracartClient::ApiError => e
925
+ puts "Error when calling ChannelPartnerApi->refund_channel_partner_order: #{e}"
926
+ end
927
+ ```
928
+
929
+ #### Using the refund_channel_partner_order_with_http_info variant
930
+
931
+ This returns an Array which contains the response data, status code and headers.
932
+
933
+ > <Array(<OrderResponse>, Integer, Hash)> refund_channel_partner_order_with_http_info(order_id, order, opts)
934
+
935
+ ```ruby
936
+ begin
937
+ # Refund a channel partner order
938
+ data, status_code, headers = api_instance.refund_channel_partner_order_with_http_info(order_id, order, opts)
939
+ p status_code # => 2xx
940
+ p headers # => { ... }
941
+ p data # => <OrderResponse>
942
+ rescue UltracartClient::ApiError => e
943
+ puts "Error when calling ChannelPartnerApi->refund_channel_partner_order_with_http_info: #{e}"
944
+ end
945
+ ```
946
+
947
+ ### Parameters
948
+
949
+ | Name | Type | Description | Notes |
950
+ | ---- | ---- | ----------- | ----- |
951
+ | **order_id** | **String** | The order id to refund. | |
952
+ | **order** | [**Order**](Order.md) | Order to refund | |
953
+ | **reject_after_refund** | **Boolean** | Reject order after refund | [optional][default to false] |
954
+ | **skip_customer_notification** | **Boolean** | Skip customer email notification | [optional][default to false] |
955
+ | **auto_order_cancel** | **Boolean** | Cancel associated auto orders | [optional][default to false] |
956
+ | **manual_refund** | **Boolean** | Consider a manual refund done externally | [optional][default to false] |
957
+ | **reverse_affiliate_transactions** | **Boolean** | Reverse affiliate transactions | [optional][default to true] |
958
+ | **issue_store_credit** | **Boolean** | Issue a store credit instead of refunding the original payment method, loyalty must be configured on merchant account | [optional][default to false] |
959
+ | **auto_order_cancel_reason** | **String** | Reason for auto orders cancellation | [optional] |
960
+ | **_expand** | **String** | The object expansion to perform on the result. See OrderApi.refundOrder documentation for examples | [optional] |
961
+
962
+ ### Return type
963
+
964
+ [**OrderResponse**](OrderResponse.md)
965
+
966
+ ### Authorization
967
+
968
+ [ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
969
+
970
+ ### HTTP request headers
971
+
972
+ - **Content-Type**: application/json; charset=UTF-8
973
+ - **Accept**: application/json
974
+
975
+
732
976
  ## update_channel_partner_ship_to_preference
733
977
 
734
978
  > <ChannelPartnerShipToPreferenceResponse> update_channel_partner_ship_to_preference(channel_partner_oid, channel_partner_ship_to_preference_oid, ship_to_preference)
@@ -16,6 +16,7 @@
16
16
  | **billing_postal_code** | **String** | Billing postal code | [optional] |
17
17
  | **billing_state** | **String** | Billing state | [optional] |
18
18
  | **email** | **String** | Email address of this customer profile | [optional] |
19
+ | **emails** | **Array&lt;String&gt;** | Emails allows for searching on multiple email addresses and work with our without the single email variable. You may specify a single email address here or use the email property. | [optional] |
19
20
  | **last_modified_dts_end** | **String** | Last modified date end | [optional] |
20
21
  | **last_modified_dts_start** | **String** | Last modified date start | [optional] |
21
22
  | **pricing_tier_name** | **String** | Pricing tier name | [optional] |
@@ -52,6 +53,7 @@ instance = UltracartClient::CustomerQuery.new(
52
53
  billing_postal_code: null,
53
54
  billing_state: null,
54
55
  email: null,
56
+ emails: null,
55
57
  last_modified_dts_end: null,
56
58
  last_modified_dts_start: null,
57
59
  pricing_tier_name: null,
@@ -368,6 +368,140 @@ module UltracartClient
368
368
  return data, status_code, headers
369
369
  end
370
370
 
371
+ # Retrieve a channel partner order
372
+ # Retrieves a single order using the specified order id. Only orders belonging to this channel partner may be retrieved.
373
+ # @param order_id [String] The order id to retrieve.
374
+ # @param [Hash] opts the optional parameters
375
+ # @option opts [String] :_expand The object expansion to perform on the result. See OrderApi.getOrder documentation for examples
376
+ # @return [OrderResponse]
377
+ def get_channel_partner_order(order_id, opts = {})
378
+ data, _status_code, _headers = get_channel_partner_order_with_http_info(order_id, opts)
379
+ data
380
+ end
381
+
382
+ # Retrieve a channel partner order
383
+ # Retrieves a single order using the specified order id. Only orders belonging to this channel partner may be retrieved.
384
+ # @param order_id [String] The order id to retrieve.
385
+ # @param [Hash] opts the optional parameters
386
+ # @option opts [String] :_expand The object expansion to perform on the result. See OrderApi.getOrder documentation for examples
387
+ # @return [Array<(OrderResponse, Integer, Hash)>] OrderResponse data, response status code and response headers
388
+ def get_channel_partner_order_with_http_info(order_id, opts = {})
389
+ if @api_client.config.debugging
390
+ @api_client.config.logger.debug 'Calling API: ChannelPartnerApi.get_channel_partner_order ...'
391
+ end
392
+ # verify the required parameter 'order_id' is set
393
+ if @api_client.config.client_side_validation && order_id.nil?
394
+ fail ArgumentError, "Missing the required parameter 'order_id' when calling ChannelPartnerApi.get_channel_partner_order"
395
+ end
396
+ # resource path
397
+ local_var_path = '/channel_partner/orders/{order_id}'.sub('{' + 'order_id' + '}', CGI.escape(order_id.to_s))
398
+
399
+ # query parameters
400
+ query_params = opts[:query_params] || {}
401
+ query_params[:'_expand'] = opts[:'_expand'] if !opts[:'_expand'].nil?
402
+
403
+ # header parameters
404
+ header_params = opts[:header_params] || {}
405
+ header_params['X-UltraCart-Api-Version'] = @api_client.select_header_api_version()
406
+ # HTTP header 'Accept' (if needed)
407
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
408
+
409
+ # form parameters
410
+ form_params = opts[:form_params] || {}
411
+
412
+ # http body (model)
413
+ post_body = opts[:debug_body]
414
+
415
+ # return_type
416
+ return_type = opts[:debug_return_type] || 'OrderResponse'
417
+
418
+ # auth_names
419
+ auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
420
+
421
+ new_options = opts.merge(
422
+ :operation => :"ChannelPartnerApi.get_channel_partner_order",
423
+ :header_params => header_params,
424
+ :query_params => query_params,
425
+ :form_params => form_params,
426
+ :body => post_body,
427
+ :auth_names => auth_names,
428
+ :return_type => return_type
429
+ )
430
+
431
+ data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
432
+ if @api_client.config.debugging
433
+ @api_client.config.logger.debug "API called: ChannelPartnerApi#get_channel_partner_order\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
434
+ end
435
+ return data, status_code, headers
436
+ end
437
+
438
+ # Retrieve a channel partner order by the channel partner order id
439
+ # Retrieves a single order using the channel partner order id, not the ultracart order id. Only orders belonging to this channel partner may be retrieved.
440
+ # @param order_id [String] The channel partner order id to retrieve.
441
+ # @param [Hash] opts the optional parameters
442
+ # @option opts [String] :_expand The object expansion to perform on the result. See OrderApi.getOrder documentation for examples
443
+ # @return [OrderResponse]
444
+ def get_channel_partner_order_by_channel_partner_order_id(order_id, opts = {})
445
+ data, _status_code, _headers = get_channel_partner_order_by_channel_partner_order_id_with_http_info(order_id, opts)
446
+ data
447
+ end
448
+
449
+ # Retrieve a channel partner order by the channel partner order id
450
+ # Retrieves a single order using the channel partner order id, not the ultracart order id. Only orders belonging to this channel partner may be retrieved.
451
+ # @param order_id [String] The channel partner order id to retrieve.
452
+ # @param [Hash] opts the optional parameters
453
+ # @option opts [String] :_expand The object expansion to perform on the result. See OrderApi.getOrder documentation for examples
454
+ # @return [Array<(OrderResponse, Integer, Hash)>] OrderResponse data, response status code and response headers
455
+ def get_channel_partner_order_by_channel_partner_order_id_with_http_info(order_id, opts = {})
456
+ if @api_client.config.debugging
457
+ @api_client.config.logger.debug 'Calling API: ChannelPartnerApi.get_channel_partner_order_by_channel_partner_order_id ...'
458
+ end
459
+ # verify the required parameter 'order_id' is set
460
+ if @api_client.config.client_side_validation && order_id.nil?
461
+ fail ArgumentError, "Missing the required parameter 'order_id' when calling ChannelPartnerApi.get_channel_partner_order_by_channel_partner_order_id"
462
+ end
463
+ # resource path
464
+ local_var_path = '/channel_partner/orders/by_channel_partner_order_id/{order_id}'.sub('{' + 'order_id' + '}', CGI.escape(order_id.to_s))
465
+
466
+ # query parameters
467
+ query_params = opts[:query_params] || {}
468
+ query_params[:'_expand'] = opts[:'_expand'] if !opts[:'_expand'].nil?
469
+
470
+ # header parameters
471
+ header_params = opts[:header_params] || {}
472
+ header_params['X-UltraCart-Api-Version'] = @api_client.select_header_api_version()
473
+ # HTTP header 'Accept' (if needed)
474
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
475
+
476
+ # form parameters
477
+ form_params = opts[:form_params] || {}
478
+
479
+ # http body (model)
480
+ post_body = opts[:debug_body]
481
+
482
+ # return_type
483
+ return_type = opts[:debug_return_type] || 'OrderResponse'
484
+
485
+ # auth_names
486
+ auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
487
+
488
+ new_options = opts.merge(
489
+ :operation => :"ChannelPartnerApi.get_channel_partner_order_by_channel_partner_order_id",
490
+ :header_params => header_params,
491
+ :query_params => query_params,
492
+ :form_params => form_params,
493
+ :body => post_body,
494
+ :auth_names => auth_names,
495
+ :return_type => return_type
496
+ )
497
+
498
+ data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
499
+ if @api_client.config.debugging
500
+ @api_client.config.logger.debug "API called: ChannelPartnerApi#get_channel_partner_order_by_channel_partner_order_id\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
501
+ end
502
+ return data, status_code, headers
503
+ end
504
+
371
505
  # Retrieve the ship to preference associated with the channel partner and the specific id.
372
506
  # Retrieve the ship to preference associated with the channel partner and the specific id.
373
507
  # @param channel_partner_oid [Integer]
@@ -704,6 +838,105 @@ module UltracartClient
704
838
  return data, status_code, headers
705
839
  end
706
840
 
841
+ # Refund a channel partner order
842
+ # Perform a refund operation on a channel partner order and then update the order if successful. All of the object properties ending in _refunded should be the TOTAL amount that should end up being refunded. UltraCart will calculate the actual amount to refund based upon the prior refunds.
843
+ # @param order_id [String] The order id to refund.
844
+ # @param order [Order] Order to refund
845
+ # @param [Hash] opts the optional parameters
846
+ # @option opts [Boolean] :reject_after_refund Reject order after refund (default to false)
847
+ # @option opts [Boolean] :skip_customer_notification Skip customer email notification (default to false)
848
+ # @option opts [Boolean] :auto_order_cancel Cancel associated auto orders (default to false)
849
+ # @option opts [Boolean] :manual_refund Consider a manual refund done externally (default to false)
850
+ # @option opts [Boolean] :reverse_affiliate_transactions Reverse affiliate transactions (default to true)
851
+ # @option opts [Boolean] :issue_store_credit Issue a store credit instead of refunding the original payment method, loyalty must be configured on merchant account (default to false)
852
+ # @option opts [String] :auto_order_cancel_reason Reason for auto orders cancellation
853
+ # @option opts [String] :_expand The object expansion to perform on the result. See OrderApi.refundOrder documentation for examples
854
+ # @return [OrderResponse]
855
+ def refund_channel_partner_order(order_id, order, opts = {})
856
+ data, _status_code, _headers = refund_channel_partner_order_with_http_info(order_id, order, opts)
857
+ data
858
+ end
859
+
860
+ # Refund a channel partner order
861
+ # Perform a refund operation on a channel partner order and then update the order if successful. All of the object properties ending in _refunded should be the TOTAL amount that should end up being refunded. UltraCart will calculate the actual amount to refund based upon the prior refunds.
862
+ # @param order_id [String] The order id to refund.
863
+ # @param order [Order] Order to refund
864
+ # @param [Hash] opts the optional parameters
865
+ # @option opts [Boolean] :reject_after_refund Reject order after refund (default to false)
866
+ # @option opts [Boolean] :skip_customer_notification Skip customer email notification (default to false)
867
+ # @option opts [Boolean] :auto_order_cancel Cancel associated auto orders (default to false)
868
+ # @option opts [Boolean] :manual_refund Consider a manual refund done externally (default to false)
869
+ # @option opts [Boolean] :reverse_affiliate_transactions Reverse affiliate transactions (default to true)
870
+ # @option opts [Boolean] :issue_store_credit Issue a store credit instead of refunding the original payment method, loyalty must be configured on merchant account (default to false)
871
+ # @option opts [String] :auto_order_cancel_reason Reason for auto orders cancellation
872
+ # @option opts [String] :_expand The object expansion to perform on the result. See OrderApi.refundOrder documentation for examples
873
+ # @return [Array<(OrderResponse, Integer, Hash)>] OrderResponse data, response status code and response headers
874
+ def refund_channel_partner_order_with_http_info(order_id, order, opts = {})
875
+ if @api_client.config.debugging
876
+ @api_client.config.logger.debug 'Calling API: ChannelPartnerApi.refund_channel_partner_order ...'
877
+ end
878
+ # verify the required parameter 'order_id' is set
879
+ if @api_client.config.client_side_validation && order_id.nil?
880
+ fail ArgumentError, "Missing the required parameter 'order_id' when calling ChannelPartnerApi.refund_channel_partner_order"
881
+ end
882
+ # verify the required parameter 'order' is set
883
+ if @api_client.config.client_side_validation && order.nil?
884
+ fail ArgumentError, "Missing the required parameter 'order' when calling ChannelPartnerApi.refund_channel_partner_order"
885
+ end
886
+ # resource path
887
+ local_var_path = '/channel_partner/orders/{order_id}/refund'.sub('{' + 'order_id' + '}', CGI.escape(order_id.to_s))
888
+
889
+ # query parameters
890
+ query_params = opts[:query_params] || {}
891
+ query_params[:'reject_after_refund'] = opts[:'reject_after_refund'] if !opts[:'reject_after_refund'].nil?
892
+ query_params[:'skip_customer_notification'] = opts[:'skip_customer_notification'] if !opts[:'skip_customer_notification'].nil?
893
+ query_params[:'auto_order_cancel'] = opts[:'auto_order_cancel'] if !opts[:'auto_order_cancel'].nil?
894
+ query_params[:'manual_refund'] = opts[:'manual_refund'] if !opts[:'manual_refund'].nil?
895
+ query_params[:'reverse_affiliate_transactions'] = opts[:'reverse_affiliate_transactions'] if !opts[:'reverse_affiliate_transactions'].nil?
896
+ query_params[:'issue_store_credit'] = opts[:'issue_store_credit'] if !opts[:'issue_store_credit'].nil?
897
+ query_params[:'auto_order_cancel_reason'] = opts[:'auto_order_cancel_reason'] if !opts[:'auto_order_cancel_reason'].nil?
898
+ query_params[:'_expand'] = opts[:'_expand'] if !opts[:'_expand'].nil?
899
+
900
+ # header parameters
901
+ header_params = opts[:header_params] || {}
902
+ header_params['X-UltraCart-Api-Version'] = @api_client.select_header_api_version()
903
+ # HTTP header 'Accept' (if needed)
904
+ header_params['Accept'] = @api_client.select_header_accept(['application/json'])
905
+ # HTTP header 'Content-Type'
906
+ content_type = @api_client.select_header_content_type(['application/json; charset=UTF-8'])
907
+ if !content_type.nil?
908
+ header_params['Content-Type'] = content_type
909
+ end
910
+
911
+ # form parameters
912
+ form_params = opts[:form_params] || {}
913
+
914
+ # http body (model)
915
+ post_body = opts[:debug_body] || @api_client.object_to_http_body(order)
916
+
917
+ # return_type
918
+ return_type = opts[:debug_return_type] || 'OrderResponse'
919
+
920
+ # auth_names
921
+ auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
922
+
923
+ new_options = opts.merge(
924
+ :operation => :"ChannelPartnerApi.refund_channel_partner_order",
925
+ :header_params => header_params,
926
+ :query_params => query_params,
927
+ :form_params => form_params,
928
+ :body => post_body,
929
+ :auth_names => auth_names,
930
+ :return_type => return_type
931
+ )
932
+
933
+ data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
934
+ if @api_client.config.debugging
935
+ @api_client.config.logger.debug "API called: ChannelPartnerApi#refund_channel_partner_order\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
936
+ end
937
+ return data, status_code, headers
938
+ end
939
+
707
940
  # Update a ship to preference record for the channel partner.
708
941
  # Update a ship to preference record for the channel partner.
709
942
  # @param channel_partner_oid [Integer]
@@ -51,6 +51,9 @@ module UltracartClient
51
51
  # Email address of this customer profile
52
52
  attr_accessor :email
53
53
 
54
+ # Emails allows for searching on multiple email addresses and work with our without the single email variable. You may specify a single email address here or use the email property.
55
+ attr_accessor :emails
56
+
54
57
  # Last modified date end
55
58
  attr_accessor :last_modified_dts_end
56
59
 
@@ -117,6 +120,7 @@ module UltracartClient
117
120
  :'billing_postal_code' => :'billing_postal_code',
118
121
  :'billing_state' => :'billing_state',
119
122
  :'email' => :'email',
123
+ :'emails' => :'emails',
120
124
  :'last_modified_dts_end' => :'last_modified_dts_end',
121
125
  :'last_modified_dts_start' => :'last_modified_dts_start',
122
126
  :'pricing_tier_name' => :'pricing_tier_name',
@@ -157,6 +161,7 @@ module UltracartClient
157
161
  :'billing_postal_code' => :'String',
158
162
  :'billing_state' => :'String',
159
163
  :'email' => :'String',
164
+ :'emails' => :'Array<String>',
160
165
  :'last_modified_dts_end' => :'String',
161
166
  :'last_modified_dts_start' => :'String',
162
167
  :'pricing_tier_name' => :'String',
@@ -250,6 +255,12 @@ module UltracartClient
250
255
  self.email = attributes[:'email']
251
256
  end
252
257
 
258
+ if attributes.key?(:'emails')
259
+ if (value = attributes[:'emails']).is_a?(Array)
260
+ self.emails = value
261
+ end
262
+ end
263
+
253
264
  if attributes.key?(:'last_modified_dts_end')
254
265
  self.last_modified_dts_end = attributes[:'last_modified_dts_end']
255
266
  end
@@ -634,6 +645,7 @@ module UltracartClient
634
645
  billing_postal_code == o.billing_postal_code &&
635
646
  billing_state == o.billing_state &&
636
647
  email == o.email &&
648
+ emails == o.emails &&
637
649
  last_modified_dts_end == o.last_modified_dts_end &&
638
650
  last_modified_dts_start == o.last_modified_dts_start &&
639
651
  pricing_tier_name == o.pricing_tier_name &&
@@ -662,7 +674,7 @@ module UltracartClient
662
674
  # Calculates hash code according to all attributes.
663
675
  # @return [Integer] Hash code
664
676
  def hash
665
- [all_tags, any_tags, billing_city, billing_company, billing_country_code, billing_day_phone, billing_evening_phone, billing_first_name, billing_last_name, billing_postal_code, billing_state, email, last_modified_dts_end, last_modified_dts_start, pricing_tier_name, pricing_tier_oid, qb_class, quickbooks_code, shipping_city, shipping_company, shipping_country_code, shipping_day_phone, shipping_evening_phone, shipping_first_name, shipping_last_name, shipping_postal_code, shipping_state, signup_dts_end, signup_dts_start].hash
677
+ [all_tags, any_tags, billing_city, billing_company, billing_country_code, billing_day_phone, billing_evening_phone, billing_first_name, billing_last_name, billing_postal_code, billing_state, email, emails, last_modified_dts_end, last_modified_dts_start, pricing_tier_name, pricing_tier_oid, qb_class, quickbooks_code, shipping_city, shipping_company, shipping_country_code, shipping_day_phone, shipping_evening_phone, shipping_first_name, shipping_last_name, shipping_postal_code, shipping_state, signup_dts_end, signup_dts_start].hash
666
678
  end
667
679
 
668
680
  # Builds the object from hash
@@ -11,5 +11,5 @@ OpenAPI Generator version: 6.0.1-SNAPSHOT
11
11
  =end
12
12
 
13
13
  module UltracartClient
14
- VERSION = '4.0.238'
14
+ VERSION = '4.0.240'
15
15
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: ultracart_api
3
3
  version: !ruby/object:Gem::Version
4
- version: 4.0.238
4
+ version: 4.0.240
5
5
  platform: ruby
6
6
  authors:
7
7
  - UltraCart
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-12-13 00:00:00.000000000 Z
11
+ date: 2025-01-09 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: typhoeus