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 +4 -4
- data/README.md +9 -4
- data/docs/ChannelPartnerApi.md +244 -0
- data/docs/CustomerQuery.md +2 -0
- data/lib/ultracart_api/api/channel_partner_api.rb +233 -0
- data/lib/ultracart_api/models/customer_query.rb +13 -1
- data/lib/ultracart_api/version.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: a7055287bb92af14ebdac856bfb87c93d98a966210c215a4fb086709978b2097
|
4
|
+
data.tar.gz: 0d5b4e3f35092ab78c2232cf0af2daa554ee5e9aac0e8e5aa906cdef1408cded
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
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.
|
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.
|
27
|
+
gem install ./ultracart_api-4.0.240.gem
|
28
28
|
```
|
29
29
|
|
30
|
-
(for development, run `gem install --dev ./ultracart_api-4.0.
|
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.
|
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 |
|
data/docs/ChannelPartnerApi.md
CHANGED
@@ -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)
|
data/docs/CustomerQuery.md
CHANGED
@@ -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<String>** | 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
|
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.
|
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:
|
11
|
+
date: 2025-01-09 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: typhoeus
|