ultracart_api 4.1.83 → 4.1.85
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 +17 -8
- data/docs/Item.md +2 -0
- data/docs/ItemApi.md +328 -167
- data/docs/ItemGatedCode.md +24 -0
- data/docs/{ItemShippingDistributionCenterResponse.md → ItemGatedCodeResponse.md} +4 -4
- data/docs/ItemGatedCodesRequest.md +18 -0
- data/docs/ItemGatedCodesResponse.md +26 -0
- data/docs/ItemGenerateGatedCodesRequest.md +22 -0
- data/docs/OrderApi.md +107 -0
- data/docs/Warning.md +2 -0
- data/lib/ultracart_api/api/item_api.rb +423 -226
- data/lib/ultracart_api/api/order_api.rb +126 -0
- data/lib/ultracart_api/models/item.rb +13 -1
- data/lib/ultracart_api/models/item_gated_code.rb +265 -0
- data/lib/ultracart_api/models/{item_shipping_distribution_center_response.rb → item_gated_code_response.rb} +10 -10
- data/lib/ultracart_api/models/{item_inventory_update_request.rb → item_gated_codes_request.rb} +12 -12
- data/lib/ultracart_api/models/item_gated_codes_response.rb +259 -0
- data/lib/ultracart_api/models/{item_inventory_update.rb → item_generate_gated_codes_request.rb} +27 -25
- data/lib/ultracart_api/models/order_query.rb +2 -2
- data/lib/ultracart_api/models/warning.rb +11 -1
- data/lib/ultracart_api/version.rb +1 -1
- data/lib/ultracart_api.rb +5 -3
- metadata +12 -8
- data/docs/ItemInventoryUpdate.md +0 -22
- data/docs/ItemInventoryUpdateRequest.md +0 -18
data/docs/ItemApi.md
CHANGED
|
@@ -4,34 +4,90 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
|
|
|
4
4
|
|
|
5
5
|
| Method | HTTP request | Description |
|
|
6
6
|
| ------ | ------------ | ----------- |
|
|
7
|
+
| [**delete_all_gated_codes**](ItemApi.md#delete_all_gated_codes) | **DELETE** /item/items/{merchant_item_oid}/gated_codes | Delete all gated access codes for an item |
|
|
7
8
|
| [**delete_digital_item**](ItemApi.md#delete_digital_item) | **DELETE** /item/digital_library/{digital_item_oid} | Delete a digital item, which is a file within the digital library, not an actual merchant item |
|
|
9
|
+
| [**delete_gated_code**](ItemApi.md#delete_gated_code) | **DELETE** /item/items/{merchant_item_oid}/gated_codes/{merchant_item_gated_code_oid} | Delete a gated access code by OID |
|
|
8
10
|
| [**delete_item**](ItemApi.md#delete_item) | **DELETE** /item/items/{merchant_item_oid} | Delete an item |
|
|
9
11
|
| [**delete_review**](ItemApi.md#delete_review) | **DELETE** /item/items/{merchant_item_oid}/reviews/{review_oid} | Delete a review |
|
|
12
|
+
| [**generate_gated_codes**](ItemApi.md#generate_gated_codes) | **POST** /item/items/{merchant_item_oid}/gated_codes/generate | Generate a batch of gated access codes |
|
|
10
13
|
| [**get_digital_item**](ItemApi.md#get_digital_item) | **GET** /item/digital_library/{digital_item_oid} | Retrieve a digital item from the digital library, which are digital files that may be attached to normal items |
|
|
11
14
|
| [**get_digital_items**](ItemApi.md#get_digital_items) | **GET** /item/digital_library | Retrieve digital items from the digital library which are digital files that may be attached to normal items |
|
|
12
15
|
| [**get_digital_items_by_external_id**](ItemApi.md#get_digital_items_by_external_id) | **GET** /item/digital_library/by_external/{external_id} | Retrieves digital items from the digital library (which are digital files that may be attached to normal items) that having a matching external id |
|
|
16
|
+
| [**get_gated_codes**](ItemApi.md#get_gated_codes) | **GET** /item/items/{merchant_item_oid}/gated_codes | Get gated access codes for an item |
|
|
13
17
|
| [**get_inventory_snapshot**](ItemApi.md#get_inventory_snapshot) | **GET** /item/items/inventory_snapshot | Retrieve a list of item inventories. This method may be called once every 15 minutes. More than that will result in a 429 response. |
|
|
14
18
|
| [**get_item**](ItemApi.md#get_item) | **GET** /item/items/{merchant_item_oid} | Retrieve an item |
|
|
15
19
|
| [**get_item_by_merchant_item_id**](ItemApi.md#get_item_by_merchant_item_id) | **GET** /item/items/merchant_item_id/{merchant_item_id} | Retrieve an item by item id |
|
|
16
|
-
| [**get_item_shipping_distribution_center_by_code**](ItemApi.md#get_item_shipping_distribution_center_by_code) | **GET** /item/items/{merchant_item_oid}/shipping/distribution_centers/by_code/{distribution_center_code} | Retrieve an item shipping distribution center |
|
|
17
20
|
| [**get_items**](ItemApi.md#get_items) | **GET** /item/items | Retrieve items |
|
|
18
21
|
| [**get_pricing_tiers**](ItemApi.md#get_pricing_tiers) | **GET** /item/pricing_tiers | Retrieve pricing tiers |
|
|
19
22
|
| [**get_review**](ItemApi.md#get_review) | **GET** /item/items/{merchant_item_oid}/reviews/{review_oid} | Get a review |
|
|
20
23
|
| [**get_reviews**](ItemApi.md#get_reviews) | **GET** /item/items/{merchant_item_oid}/reviews | Get reviews for an item |
|
|
21
24
|
| [**get_unassociated_digital_items**](ItemApi.md#get_unassociated_digital_items) | **GET** /item/digital_library/unassociated | Retrieve digital items from the digital library (which are digital files that may be attached to normal items) not yet associated with actual items |
|
|
22
25
|
| [**insert_digital_item**](ItemApi.md#insert_digital_item) | **POST** /item/digital_library | Create a file within the digital library |
|
|
26
|
+
| [**insert_gated_code**](ItemApi.md#insert_gated_code) | **POST** /item/items/{merchant_item_oid}/gated_codes | Add a single gated access code to an item |
|
|
23
27
|
| [**insert_item**](ItemApi.md#insert_item) | **POST** /item/items | Create an item |
|
|
24
28
|
| [**insert_review**](ItemApi.md#insert_review) | **POST** /item/items/{merchant_item_oid}/reviews | Insert a review |
|
|
25
29
|
| [**insert_update_item_content_attribute**](ItemApi.md#insert_update_item_content_attribute) | **POST** /item/items/{merchant_item_oid}/content/attributes | Upsert an item content attribute |
|
|
30
|
+
| [**replace_gated_codes**](ItemApi.md#replace_gated_codes) | **PUT** /item/items/{merchant_item_oid}/gated_codes | Replace the full list of gated access codes for an item |
|
|
26
31
|
| [**update_digital_item**](ItemApi.md#update_digital_item) | **PUT** /item/digital_library/{digital_item_oid} | Updates a file within the digital library |
|
|
27
32
|
| [**update_item**](ItemApi.md#update_item) | **PUT** /item/items/{merchant_item_oid} | Update an item |
|
|
28
|
-
| [**update_item_inventories**](ItemApi.md#update_item_inventories) | **PUT** /item/items/update_item_inventories | Update item inventories for a distribution center |
|
|
29
|
-
| [**update_item_shipping_distribution_center_by_code**](ItemApi.md#update_item_shipping_distribution_center_by_code) | **PUT** /item/items/{merchant_item_oid}/shipping/distribution_centers/by_code/{distribution_center_code} | Update an item shipping distribution center |
|
|
30
33
|
| [**update_items**](ItemApi.md#update_items) | **PUT** /item/items/batch | Update multiple items |
|
|
31
34
|
| [**update_review**](ItemApi.md#update_review) | **PUT** /item/items/{merchant_item_oid}/reviews/{review_oid} | Update a review |
|
|
32
35
|
| [**upload_temporary_multimedia**](ItemApi.md#upload_temporary_multimedia) | **POST** /item/temp_multimedia | Upload an image to the temporary multimedia. |
|
|
33
36
|
|
|
34
37
|
|
|
38
|
+
## delete_all_gated_codes
|
|
39
|
+
|
|
40
|
+
> <BaseResponse> delete_all_gated_codes(merchant_item_oid)
|
|
41
|
+
|
|
42
|
+
Delete all gated access codes for an item
|
|
43
|
+
|
|
44
|
+
Removes every gated access code currently configured for the item.
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
### Examples
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
(No example for this operation).
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
#### Using the delete_all_gated_codes_with_http_info variant
|
|
54
|
+
|
|
55
|
+
This returns an Array which contains the response data, status code and headers.
|
|
56
|
+
|
|
57
|
+
> <Array(<BaseResponse>, Integer, Hash)> delete_all_gated_codes_with_http_info(merchant_item_oid)
|
|
58
|
+
|
|
59
|
+
```ruby
|
|
60
|
+
begin
|
|
61
|
+
# Delete all gated access codes for an item
|
|
62
|
+
data, status_code, headers = api_instance.delete_all_gated_codes_with_http_info(merchant_item_oid)
|
|
63
|
+
p status_code # => 2xx
|
|
64
|
+
p headers # => { ... }
|
|
65
|
+
p data # => <BaseResponse>
|
|
66
|
+
rescue UltracartClient::ApiError => e
|
|
67
|
+
puts "Error when calling ItemApi->delete_all_gated_codes_with_http_info: #{e}"
|
|
68
|
+
end
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
### Parameters
|
|
72
|
+
|
|
73
|
+
| Name | Type | Description | Notes |
|
|
74
|
+
| ---- | ---- | ----------- | ----- |
|
|
75
|
+
| **merchant_item_oid** | **Integer** | The item oid. | |
|
|
76
|
+
|
|
77
|
+
### Return type
|
|
78
|
+
|
|
79
|
+
[**BaseResponse**](BaseResponse.md)
|
|
80
|
+
|
|
81
|
+
### Authorization
|
|
82
|
+
|
|
83
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
84
|
+
|
|
85
|
+
### HTTP request headers
|
|
86
|
+
|
|
87
|
+
- **Content-Type**: Not defined
|
|
88
|
+
- **Accept**: application/json
|
|
89
|
+
|
|
90
|
+
|
|
35
91
|
## delete_digital_item
|
|
36
92
|
|
|
37
93
|
> delete_digital_item(digital_item_oid)
|
|
@@ -97,6 +153,60 @@ nil (empty response body)
|
|
|
97
153
|
- **Accept**: application/json
|
|
98
154
|
|
|
99
155
|
|
|
156
|
+
## delete_gated_code
|
|
157
|
+
|
|
158
|
+
> <BaseResponse> delete_gated_code(merchant_item_oid, merchant_item_gated_code_oid)
|
|
159
|
+
|
|
160
|
+
Delete a gated access code by OID
|
|
161
|
+
|
|
162
|
+
Delete a specific gated access code by its OID.
|
|
163
|
+
|
|
164
|
+
|
|
165
|
+
### Examples
|
|
166
|
+
|
|
167
|
+
|
|
168
|
+
(No example for this operation).
|
|
169
|
+
|
|
170
|
+
|
|
171
|
+
#### Using the delete_gated_code_with_http_info variant
|
|
172
|
+
|
|
173
|
+
This returns an Array which contains the response data, status code and headers.
|
|
174
|
+
|
|
175
|
+
> <Array(<BaseResponse>, Integer, Hash)> delete_gated_code_with_http_info(merchant_item_oid, merchant_item_gated_code_oid)
|
|
176
|
+
|
|
177
|
+
```ruby
|
|
178
|
+
begin
|
|
179
|
+
# Delete a gated access code by OID
|
|
180
|
+
data, status_code, headers = api_instance.delete_gated_code_with_http_info(merchant_item_oid, merchant_item_gated_code_oid)
|
|
181
|
+
p status_code # => 2xx
|
|
182
|
+
p headers # => { ... }
|
|
183
|
+
p data # => <BaseResponse>
|
|
184
|
+
rescue UltracartClient::ApiError => e
|
|
185
|
+
puts "Error when calling ItemApi->delete_gated_code_with_http_info: #{e}"
|
|
186
|
+
end
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
### Parameters
|
|
190
|
+
|
|
191
|
+
| Name | Type | Description | Notes |
|
|
192
|
+
| ---- | ---- | ----------- | ----- |
|
|
193
|
+
| **merchant_item_oid** | **Integer** | The item oid. | |
|
|
194
|
+
| **merchant_item_gated_code_oid** | **Integer** | The gated code oid. | |
|
|
195
|
+
|
|
196
|
+
### Return type
|
|
197
|
+
|
|
198
|
+
[**BaseResponse**](BaseResponse.md)
|
|
199
|
+
|
|
200
|
+
### Authorization
|
|
201
|
+
|
|
202
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
203
|
+
|
|
204
|
+
### HTTP request headers
|
|
205
|
+
|
|
206
|
+
- **Content-Type**: Not defined
|
|
207
|
+
- **Accept**: application/json
|
|
208
|
+
|
|
209
|
+
|
|
100
210
|
## delete_item
|
|
101
211
|
|
|
102
212
|
> delete_item(merchant_item_oid)
|
|
@@ -234,6 +344,60 @@ nil (empty response body)
|
|
|
234
344
|
- **Accept**: application/json
|
|
235
345
|
|
|
236
346
|
|
|
347
|
+
## generate_gated_codes
|
|
348
|
+
|
|
349
|
+
> <ItemGatedCodesResponse> generate_gated_codes(merchant_item_oid, generate_request)
|
|
350
|
+
|
|
351
|
+
Generate a batch of gated access codes
|
|
352
|
+
|
|
353
|
+
Returns randomly generated codes using a profanity-safe charset (vowel-free, 0/1 removed). Codes are NOT persisted; submit them via PUT or POST to commit.
|
|
354
|
+
|
|
355
|
+
|
|
356
|
+
### Examples
|
|
357
|
+
|
|
358
|
+
|
|
359
|
+
(No example for this operation).
|
|
360
|
+
|
|
361
|
+
|
|
362
|
+
#### Using the generate_gated_codes_with_http_info variant
|
|
363
|
+
|
|
364
|
+
This returns an Array which contains the response data, status code and headers.
|
|
365
|
+
|
|
366
|
+
> <Array(<ItemGatedCodesResponse>, Integer, Hash)> generate_gated_codes_with_http_info(merchant_item_oid, generate_request)
|
|
367
|
+
|
|
368
|
+
```ruby
|
|
369
|
+
begin
|
|
370
|
+
# Generate a batch of gated access codes
|
|
371
|
+
data, status_code, headers = api_instance.generate_gated_codes_with_http_info(merchant_item_oid, generate_request)
|
|
372
|
+
p status_code # => 2xx
|
|
373
|
+
p headers # => { ... }
|
|
374
|
+
p data # => <ItemGatedCodesResponse>
|
|
375
|
+
rescue UltracartClient::ApiError => e
|
|
376
|
+
puts "Error when calling ItemApi->generate_gated_codes_with_http_info: #{e}"
|
|
377
|
+
end
|
|
378
|
+
```
|
|
379
|
+
|
|
380
|
+
### Parameters
|
|
381
|
+
|
|
382
|
+
| Name | Type | Description | Notes |
|
|
383
|
+
| ---- | ---- | ----------- | ----- |
|
|
384
|
+
| **merchant_item_oid** | **Integer** | The item oid. | |
|
|
385
|
+
| **generate_request** | [**ItemGenerateGatedCodesRequest**](ItemGenerateGatedCodesRequest.md) | Generate request. | |
|
|
386
|
+
|
|
387
|
+
### Return type
|
|
388
|
+
|
|
389
|
+
[**ItemGatedCodesResponse**](ItemGatedCodesResponse.md)
|
|
390
|
+
|
|
391
|
+
### Authorization
|
|
392
|
+
|
|
393
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
394
|
+
|
|
395
|
+
### HTTP request headers
|
|
396
|
+
|
|
397
|
+
- **Content-Type**: application/json; charset=UTF-8
|
|
398
|
+
- **Accept**: application/json
|
|
399
|
+
|
|
400
|
+
|
|
237
401
|
## get_digital_item
|
|
238
402
|
|
|
239
403
|
> <ItemDigitalItemResponse> get_digital_item(digital_item_oid)
|
|
@@ -501,6 +665,59 @@ end
|
|
|
501
665
|
- **Accept**: application/json
|
|
502
666
|
|
|
503
667
|
|
|
668
|
+
## get_gated_codes
|
|
669
|
+
|
|
670
|
+
> <ItemGatedCodesResponse> get_gated_codes(merchant_item_oid)
|
|
671
|
+
|
|
672
|
+
Get gated access codes for an item
|
|
673
|
+
|
|
674
|
+
Retrieve all unredeemed gated access codes configured for an item.
|
|
675
|
+
|
|
676
|
+
|
|
677
|
+
### Examples
|
|
678
|
+
|
|
679
|
+
|
|
680
|
+
(No example for this operation).
|
|
681
|
+
|
|
682
|
+
|
|
683
|
+
#### Using the get_gated_codes_with_http_info variant
|
|
684
|
+
|
|
685
|
+
This returns an Array which contains the response data, status code and headers.
|
|
686
|
+
|
|
687
|
+
> <Array(<ItemGatedCodesResponse>, Integer, Hash)> get_gated_codes_with_http_info(merchant_item_oid)
|
|
688
|
+
|
|
689
|
+
```ruby
|
|
690
|
+
begin
|
|
691
|
+
# Get gated access codes for an item
|
|
692
|
+
data, status_code, headers = api_instance.get_gated_codes_with_http_info(merchant_item_oid)
|
|
693
|
+
p status_code # => 2xx
|
|
694
|
+
p headers # => { ... }
|
|
695
|
+
p data # => <ItemGatedCodesResponse>
|
|
696
|
+
rescue UltracartClient::ApiError => e
|
|
697
|
+
puts "Error when calling ItemApi->get_gated_codes_with_http_info: #{e}"
|
|
698
|
+
end
|
|
699
|
+
```
|
|
700
|
+
|
|
701
|
+
### Parameters
|
|
702
|
+
|
|
703
|
+
| Name | Type | Description | Notes |
|
|
704
|
+
| ---- | ---- | ----------- | ----- |
|
|
705
|
+
| **merchant_item_oid** | **Integer** | The item oid. | |
|
|
706
|
+
|
|
707
|
+
### Return type
|
|
708
|
+
|
|
709
|
+
[**ItemGatedCodesResponse**](ItemGatedCodesResponse.md)
|
|
710
|
+
|
|
711
|
+
### Authorization
|
|
712
|
+
|
|
713
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
714
|
+
|
|
715
|
+
### HTTP request headers
|
|
716
|
+
|
|
717
|
+
- **Content-Type**: Not defined
|
|
718
|
+
- **Accept**: application/json
|
|
719
|
+
|
|
720
|
+
|
|
504
721
|
## get_inventory_snapshot
|
|
505
722
|
|
|
506
723
|
> <ItemInventorySnapshotResponse> get_inventory_snapshot
|
|
@@ -838,62 +1055,6 @@ end
|
|
|
838
1055
|
- **Accept**: application/json
|
|
839
1056
|
|
|
840
1057
|
|
|
841
|
-
## get_item_shipping_distribution_center_by_code
|
|
842
|
-
|
|
843
|
-
> <ItemShippingDistributionCenterResponse> get_item_shipping_distribution_center_by_code(merchant_item_oid, distribution_center_code, opts)
|
|
844
|
-
|
|
845
|
-
Retrieve an item shipping distribution center
|
|
846
|
-
|
|
847
|
-
Retrieve an item shipping distribution center.
|
|
848
|
-
|
|
849
|
-
|
|
850
|
-
### Examples
|
|
851
|
-
|
|
852
|
-
|
|
853
|
-
(No example for this operation).
|
|
854
|
-
|
|
855
|
-
|
|
856
|
-
#### Using the get_item_shipping_distribution_center_by_code_with_http_info variant
|
|
857
|
-
|
|
858
|
-
This returns an Array which contains the response data, status code and headers.
|
|
859
|
-
|
|
860
|
-
> <Array(<ItemShippingDistributionCenterResponse>, Integer, Hash)> get_item_shipping_distribution_center_by_code_with_http_info(merchant_item_oid, distribution_center_code, opts)
|
|
861
|
-
|
|
862
|
-
```ruby
|
|
863
|
-
begin
|
|
864
|
-
# Retrieve an item shipping distribution center
|
|
865
|
-
data, status_code, headers = api_instance.get_item_shipping_distribution_center_by_code_with_http_info(merchant_item_oid, distribution_center_code, opts)
|
|
866
|
-
p status_code # => 2xx
|
|
867
|
-
p headers # => { ... }
|
|
868
|
-
p data # => <ItemShippingDistributionCenterResponse>
|
|
869
|
-
rescue UltracartClient::ApiError => e
|
|
870
|
-
puts "Error when calling ItemApi->get_item_shipping_distribution_center_by_code_with_http_info: #{e}"
|
|
871
|
-
end
|
|
872
|
-
```
|
|
873
|
-
|
|
874
|
-
### Parameters
|
|
875
|
-
|
|
876
|
-
| Name | Type | Description | Notes |
|
|
877
|
-
| ---- | ---- | ----------- | ----- |
|
|
878
|
-
| **merchant_item_oid** | **Integer** | The item oid to retrieve. | |
|
|
879
|
-
| **distribution_center_code** | **String** | | |
|
|
880
|
-
| **_expand** | **String** | The object expansion to perform on the result. See documentation for examples | [optional] |
|
|
881
|
-
| **_placeholders** | **Boolean** | Whether or not placeholder values should be returned in the result. Useful for UIs that consume this REST API. | [optional] |
|
|
882
|
-
|
|
883
|
-
### Return type
|
|
884
|
-
|
|
885
|
-
[**ItemShippingDistributionCenterResponse**](ItemShippingDistributionCenterResponse.md)
|
|
886
|
-
|
|
887
|
-
### Authorization
|
|
888
|
-
|
|
889
|
-
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
890
|
-
|
|
891
|
-
### HTTP request headers
|
|
892
|
-
|
|
893
|
-
- **Content-Type**: Not defined
|
|
894
|
-
- **Accept**: application/json
|
|
895
|
-
|
|
896
|
-
|
|
897
1058
|
## get_items
|
|
898
1059
|
|
|
899
1060
|
> <ItemsResponse> get_items(opts)
|
|
@@ -1483,6 +1644,60 @@ end
|
|
|
1483
1644
|
- **Accept**: application/json
|
|
1484
1645
|
|
|
1485
1646
|
|
|
1647
|
+
## insert_gated_code
|
|
1648
|
+
|
|
1649
|
+
> <ItemGatedCodeResponse> insert_gated_code(merchant_item_oid, gated_code)
|
|
1650
|
+
|
|
1651
|
+
Add a single gated access code to an item
|
|
1652
|
+
|
|
1653
|
+
Insert a single gated access code; the server assigns the OID and created_dts.
|
|
1654
|
+
|
|
1655
|
+
|
|
1656
|
+
### Examples
|
|
1657
|
+
|
|
1658
|
+
|
|
1659
|
+
(No example for this operation).
|
|
1660
|
+
|
|
1661
|
+
|
|
1662
|
+
#### Using the insert_gated_code_with_http_info variant
|
|
1663
|
+
|
|
1664
|
+
This returns an Array which contains the response data, status code and headers.
|
|
1665
|
+
|
|
1666
|
+
> <Array(<ItemGatedCodeResponse>, Integer, Hash)> insert_gated_code_with_http_info(merchant_item_oid, gated_code)
|
|
1667
|
+
|
|
1668
|
+
```ruby
|
|
1669
|
+
begin
|
|
1670
|
+
# Add a single gated access code to an item
|
|
1671
|
+
data, status_code, headers = api_instance.insert_gated_code_with_http_info(merchant_item_oid, gated_code)
|
|
1672
|
+
p status_code # => 2xx
|
|
1673
|
+
p headers # => { ... }
|
|
1674
|
+
p data # => <ItemGatedCodeResponse>
|
|
1675
|
+
rescue UltracartClient::ApiError => e
|
|
1676
|
+
puts "Error when calling ItemApi->insert_gated_code_with_http_info: #{e}"
|
|
1677
|
+
end
|
|
1678
|
+
```
|
|
1679
|
+
|
|
1680
|
+
### Parameters
|
|
1681
|
+
|
|
1682
|
+
| Name | Type | Description | Notes |
|
|
1683
|
+
| ---- | ---- | ----------- | ----- |
|
|
1684
|
+
| **merchant_item_oid** | **Integer** | The item oid. | |
|
|
1685
|
+
| **gated_code** | [**ItemGatedCode**](ItemGatedCode.md) | Gated code to insert. | |
|
|
1686
|
+
|
|
1687
|
+
### Return type
|
|
1688
|
+
|
|
1689
|
+
[**ItemGatedCodeResponse**](ItemGatedCodeResponse.md)
|
|
1690
|
+
|
|
1691
|
+
### Authorization
|
|
1692
|
+
|
|
1693
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
1694
|
+
|
|
1695
|
+
### HTTP request headers
|
|
1696
|
+
|
|
1697
|
+
- **Content-Type**: application/json; charset=UTF-8
|
|
1698
|
+
- **Accept**: application/json
|
|
1699
|
+
|
|
1700
|
+
|
|
1486
1701
|
## insert_item
|
|
1487
1702
|
|
|
1488
1703
|
> <ItemResponse> insert_item(item, opts)
|
|
@@ -1771,6 +1986,60 @@ nil (empty response body)
|
|
|
1771
1986
|
- **Accept**: application/json
|
|
1772
1987
|
|
|
1773
1988
|
|
|
1989
|
+
## replace_gated_codes
|
|
1990
|
+
|
|
1991
|
+
> <ItemGatedCodesResponse> replace_gated_codes(merchant_item_oid, gated_codes_request)
|
|
1992
|
+
|
|
1993
|
+
Replace the full list of gated access codes for an item
|
|
1994
|
+
|
|
1995
|
+
Existing codes not present in the request body are deleted. New codes are inserted. Unchanged codes preserve their OID and created_dts.
|
|
1996
|
+
|
|
1997
|
+
|
|
1998
|
+
### Examples
|
|
1999
|
+
|
|
2000
|
+
|
|
2001
|
+
(No example for this operation).
|
|
2002
|
+
|
|
2003
|
+
|
|
2004
|
+
#### Using the replace_gated_codes_with_http_info variant
|
|
2005
|
+
|
|
2006
|
+
This returns an Array which contains the response data, status code and headers.
|
|
2007
|
+
|
|
2008
|
+
> <Array(<ItemGatedCodesResponse>, Integer, Hash)> replace_gated_codes_with_http_info(merchant_item_oid, gated_codes_request)
|
|
2009
|
+
|
|
2010
|
+
```ruby
|
|
2011
|
+
begin
|
|
2012
|
+
# Replace the full list of gated access codes for an item
|
|
2013
|
+
data, status_code, headers = api_instance.replace_gated_codes_with_http_info(merchant_item_oid, gated_codes_request)
|
|
2014
|
+
p status_code # => 2xx
|
|
2015
|
+
p headers # => { ... }
|
|
2016
|
+
p data # => <ItemGatedCodesResponse>
|
|
2017
|
+
rescue UltracartClient::ApiError => e
|
|
2018
|
+
puts "Error when calling ItemApi->replace_gated_codes_with_http_info: #{e}"
|
|
2019
|
+
end
|
|
2020
|
+
```
|
|
2021
|
+
|
|
2022
|
+
### Parameters
|
|
2023
|
+
|
|
2024
|
+
| Name | Type | Description | Notes |
|
|
2025
|
+
| ---- | ---- | ----------- | ----- |
|
|
2026
|
+
| **merchant_item_oid** | **Integer** | The item oid. | |
|
|
2027
|
+
| **gated_codes_request** | [**ItemGatedCodesRequest**](ItemGatedCodesRequest.md) | Codes to replace the existing list with. | |
|
|
2028
|
+
|
|
2029
|
+
### Return type
|
|
2030
|
+
|
|
2031
|
+
[**ItemGatedCodesResponse**](ItemGatedCodesResponse.md)
|
|
2032
|
+
|
|
2033
|
+
### Authorization
|
|
2034
|
+
|
|
2035
|
+
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
2036
|
+
|
|
2037
|
+
### HTTP request headers
|
|
2038
|
+
|
|
2039
|
+
- **Content-Type**: application/json; charset=UTF-8
|
|
2040
|
+
- **Accept**: application/json
|
|
2041
|
+
|
|
2042
|
+
|
|
1774
2043
|
## update_digital_item
|
|
1775
2044
|
|
|
1776
2045
|
> <ItemDigitalItemResponse> update_digital_item(digital_item_oid, digital_item)
|
|
@@ -1962,114 +2231,6 @@ end
|
|
|
1962
2231
|
- **Accept**: application/json
|
|
1963
2232
|
|
|
1964
2233
|
|
|
1965
|
-
## update_item_inventories
|
|
1966
|
-
|
|
1967
|
-
> update_item_inventories(item_inventory_update_request)
|
|
1968
|
-
|
|
1969
|
-
Update item inventories for a distribution center
|
|
1970
|
-
|
|
1971
|
-
Update item inventories for a distribution center
|
|
1972
|
-
|
|
1973
|
-
|
|
1974
|
-
### Examples
|
|
1975
|
-
|
|
1976
|
-
|
|
1977
|
-
(No example for this operation).
|
|
1978
|
-
|
|
1979
|
-
|
|
1980
|
-
#### Using the update_item_inventories_with_http_info variant
|
|
1981
|
-
|
|
1982
|
-
This returns an Array which contains the response data (`nil` in this case), status code and headers.
|
|
1983
|
-
|
|
1984
|
-
> <Array(nil, Integer, Hash)> update_item_inventories_with_http_info(item_inventory_update_request)
|
|
1985
|
-
|
|
1986
|
-
```ruby
|
|
1987
|
-
begin
|
|
1988
|
-
# Update item inventories for a distribution center
|
|
1989
|
-
data, status_code, headers = api_instance.update_item_inventories_with_http_info(item_inventory_update_request)
|
|
1990
|
-
p status_code # => 2xx
|
|
1991
|
-
p headers # => { ... }
|
|
1992
|
-
p data # => nil
|
|
1993
|
-
rescue UltracartClient::ApiError => e
|
|
1994
|
-
puts "Error when calling ItemApi->update_item_inventories_with_http_info: #{e}"
|
|
1995
|
-
end
|
|
1996
|
-
```
|
|
1997
|
-
|
|
1998
|
-
### Parameters
|
|
1999
|
-
|
|
2000
|
-
| Name | Type | Description | Notes |
|
|
2001
|
-
| ---- | ---- | ----------- | ----- |
|
|
2002
|
-
| **item_inventory_update_request** | [**ItemInventoryUpdateRequest**](ItemInventoryUpdateRequest.md) | Item inventory updates | |
|
|
2003
|
-
|
|
2004
|
-
### Return type
|
|
2005
|
-
|
|
2006
|
-
nil (empty response body)
|
|
2007
|
-
|
|
2008
|
-
### Authorization
|
|
2009
|
-
|
|
2010
|
-
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
2011
|
-
|
|
2012
|
-
### HTTP request headers
|
|
2013
|
-
|
|
2014
|
-
- **Content-Type**: application/json; charset=UTF-8
|
|
2015
|
-
- **Accept**: application/json
|
|
2016
|
-
|
|
2017
|
-
|
|
2018
|
-
## update_item_shipping_distribution_center_by_code
|
|
2019
|
-
|
|
2020
|
-
> update_item_shipping_distribution_center_by_code(merchant_item_oid, distribution_center_code, item_shipping_distribution_center)
|
|
2021
|
-
|
|
2022
|
-
Update an item shipping distribution center
|
|
2023
|
-
|
|
2024
|
-
Update an item shipping distribution center
|
|
2025
|
-
|
|
2026
|
-
|
|
2027
|
-
### Examples
|
|
2028
|
-
|
|
2029
|
-
|
|
2030
|
-
(No example for this operation).
|
|
2031
|
-
|
|
2032
|
-
|
|
2033
|
-
#### Using the update_item_shipping_distribution_center_by_code_with_http_info variant
|
|
2034
|
-
|
|
2035
|
-
This returns an Array which contains the response data (`nil` in this case), status code and headers.
|
|
2036
|
-
|
|
2037
|
-
> <Array(nil, Integer, Hash)> update_item_shipping_distribution_center_by_code_with_http_info(merchant_item_oid, distribution_center_code, item_shipping_distribution_center)
|
|
2038
|
-
|
|
2039
|
-
```ruby
|
|
2040
|
-
begin
|
|
2041
|
-
# Update an item shipping distribution center
|
|
2042
|
-
data, status_code, headers = api_instance.update_item_shipping_distribution_center_by_code_with_http_info(merchant_item_oid, distribution_center_code, item_shipping_distribution_center)
|
|
2043
|
-
p status_code # => 2xx
|
|
2044
|
-
p headers # => { ... }
|
|
2045
|
-
p data # => nil
|
|
2046
|
-
rescue UltracartClient::ApiError => e
|
|
2047
|
-
puts "Error when calling ItemApi->update_item_shipping_distribution_center_by_code_with_http_info: #{e}"
|
|
2048
|
-
end
|
|
2049
|
-
```
|
|
2050
|
-
|
|
2051
|
-
### Parameters
|
|
2052
|
-
|
|
2053
|
-
| Name | Type | Description | Notes |
|
|
2054
|
-
| ---- | ---- | ----------- | ----- |
|
|
2055
|
-
| **merchant_item_oid** | **Integer** | The item oid to update. | |
|
|
2056
|
-
| **distribution_center_code** | **String** | | |
|
|
2057
|
-
| **item_shipping_distribution_center** | [**ItemShippingDistributionCenter**](ItemShippingDistributionCenter.md) | Item shipping distribution center | |
|
|
2058
|
-
|
|
2059
|
-
### Return type
|
|
2060
|
-
|
|
2061
|
-
nil (empty response body)
|
|
2062
|
-
|
|
2063
|
-
### Authorization
|
|
2064
|
-
|
|
2065
|
-
[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
|
|
2066
|
-
|
|
2067
|
-
### HTTP request headers
|
|
2068
|
-
|
|
2069
|
-
- **Content-Type**: application/json; charset=UTF-8
|
|
2070
|
-
- **Accept**: application/json
|
|
2071
|
-
|
|
2072
|
-
|
|
2073
2234
|
## update_items
|
|
2074
2235
|
|
|
2075
2236
|
> <ItemsResponse> update_items(items_request, opts)
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
# UltracartClient::ItemGatedCode
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **code** | **String** | The access code a customer must enter at checkout. | [optional] |
|
|
8
|
+
| **created_dts** | **String** | Date/time the code was added. | [optional] |
|
|
9
|
+
| **merchant_item_gated_code_oid** | **Integer** | Internal identifier; populated by the server on insert. | [optional] |
|
|
10
|
+
| **merchant_item_oid** | **Integer** | Item this code is associated with. | [optional] |
|
|
11
|
+
|
|
12
|
+
## Example
|
|
13
|
+
|
|
14
|
+
```ruby
|
|
15
|
+
require 'ultracart_api'
|
|
16
|
+
|
|
17
|
+
instance = UltracartClient::ItemGatedCode.new(
|
|
18
|
+
code: null,
|
|
19
|
+
created_dts: null,
|
|
20
|
+
merchant_item_gated_code_oid: null,
|
|
21
|
+
merchant_item_oid: null
|
|
22
|
+
)
|
|
23
|
+
```
|
|
24
|
+
|
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
# UltracartClient::
|
|
1
|
+
# UltracartClient::ItemGatedCodeResponse
|
|
2
2
|
|
|
3
3
|
## Properties
|
|
4
4
|
|
|
5
5
|
| Name | Type | Description | Notes |
|
|
6
6
|
| ---- | ---- | ----------- | ----- |
|
|
7
7
|
| **error** | [**Error**](Error.md) | | [optional] |
|
|
8
|
-
| **
|
|
8
|
+
| **gated_code** | [**ItemGatedCode**](ItemGatedCode.md) | | [optional] |
|
|
9
9
|
| **metadata** | [**ResponseMetadata**](ResponseMetadata.md) | | [optional] |
|
|
10
10
|
| **success** | **Boolean** | Indicates if API call was successful | [optional] |
|
|
11
11
|
| **warning** | [**Warning**](Warning.md) | | [optional] |
|
|
@@ -15,9 +15,9 @@
|
|
|
15
15
|
```ruby
|
|
16
16
|
require 'ultracart_api'
|
|
17
17
|
|
|
18
|
-
instance = UltracartClient::
|
|
18
|
+
instance = UltracartClient::ItemGatedCodeResponse.new(
|
|
19
19
|
error: null,
|
|
20
|
-
|
|
20
|
+
gated_code: null,
|
|
21
21
|
metadata: null,
|
|
22
22
|
success: null,
|
|
23
23
|
warning: null
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# UltracartClient::ItemGatedCodesRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **gated_codes** | [**Array<ItemGatedCode>**](ItemGatedCode.md) | gated_codes | [optional] |
|
|
8
|
+
|
|
9
|
+
## Example
|
|
10
|
+
|
|
11
|
+
```ruby
|
|
12
|
+
require 'ultracart_api'
|
|
13
|
+
|
|
14
|
+
instance = UltracartClient::ItemGatedCodesRequest.new(
|
|
15
|
+
gated_codes: null
|
|
16
|
+
)
|
|
17
|
+
```
|
|
18
|
+
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# UltracartClient::ItemGatedCodesResponse
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **error** | [**Error**](Error.md) | | [optional] |
|
|
8
|
+
| **gated_codes** | [**Array<ItemGatedCode>**](ItemGatedCode.md) | gated_codes | [optional] |
|
|
9
|
+
| **metadata** | [**ResponseMetadata**](ResponseMetadata.md) | | [optional] |
|
|
10
|
+
| **success** | **Boolean** | Indicates if API call was successful | [optional] |
|
|
11
|
+
| **warning** | [**Warning**](Warning.md) | | [optional] |
|
|
12
|
+
|
|
13
|
+
## Example
|
|
14
|
+
|
|
15
|
+
```ruby
|
|
16
|
+
require 'ultracart_api'
|
|
17
|
+
|
|
18
|
+
instance = UltracartClient::ItemGatedCodesResponse.new(
|
|
19
|
+
error: null,
|
|
20
|
+
gated_codes: null,
|
|
21
|
+
metadata: null,
|
|
22
|
+
success: null,
|
|
23
|
+
warning: null
|
|
24
|
+
)
|
|
25
|
+
```
|
|
26
|
+
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# UltracartClient::ItemGenerateGatedCodesRequest
|
|
2
|
+
|
|
3
|
+
## Properties
|
|
4
|
+
|
|
5
|
+
| Name | Type | Description | Notes |
|
|
6
|
+
| ---- | ---- | ----------- | ----- |
|
|
7
|
+
| **additional_existing_codes** | **Array<String>** | Optional codes to also dedupe against (e.g. an in-progress draft). | [optional] |
|
|
8
|
+
| **count** | **Integer** | Number of codes to generate (1-1000). | [optional] |
|
|
9
|
+
| **length** | **Integer** | Length of each code (8-32). | [optional] |
|
|
10
|
+
|
|
11
|
+
## Example
|
|
12
|
+
|
|
13
|
+
```ruby
|
|
14
|
+
require 'ultracart_api'
|
|
15
|
+
|
|
16
|
+
instance = UltracartClient::ItemGenerateGatedCodesRequest.new(
|
|
17
|
+
additional_existing_codes: null,
|
|
18
|
+
count: null,
|
|
19
|
+
length: null
|
|
20
|
+
)
|
|
21
|
+
```
|
|
22
|
+
|