ultracart_api 3.10.47 → 3.10.49

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6c81286e0c3b92487863d04107623efd2989df4d89073257247f1e8591f1c3b3
-  data.tar.gz: 63bfd9540814e060d2d9779fa72a87d2c30fb754103759b144d44eb24b61e571
+  metadata.gz: 4ebc62fd60c282ea9b80e3b07b9959862b9a6d02179021263b60cad8d774f33f
+  data.tar.gz: 4cb04512260cb399cd45849b12f7a002c9548dd3e0e4e201e497b0e97b2ff8e0
 SHA512:
-  metadata.gz: fa099d7d6f856a4cbf381ffbb978e774331682c71937507407c155f224773702d3798dbc8086eb2746616dcdc5d73cca9f8ab6362894228a4973183e24f3c2a1
-  data.tar.gz: 8d9a82ac81ed72f5586d8c04650838401622b0e069013d115d66bc484e2bdf4a1ba78c66f6c0fdf5c3e761005512269ed026fe6684a98827849cd6034e55e6c9
+  metadata.gz: 7f3ce3d82d8d56569140b5a7852e59bc4022626189967842ba565bba5d752ccd8f280118e4109e252a07a50f7ec64e1bf5edd020c1b559bb4fc944d322267a1a
+  data.tar.gz: e07d68cf1df0ed74d9d0b0c71288787bc4fa39072ed98ab9844fb592117d945ce08cd09af8b255b15cc545e2a8061bdb10782e41baa39c0faedf709cca330ad0

data/README.md

@@ -7,7 +7,7 @@ UltraCart REST API Version 2
 This SDK is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project:
 
 - API version: 2.0.0
-- Package version: 3.10.47
+- Package version: 3.10.49
 - Build package: io.swagger.codegen.languages.RubyClientCodegen
 For more information, please visit [http://www.ultracart.com](http://www.ultracart.com)
 
@@ -24,15 +24,15 @@ gem build ultracart_api.gemspec
 Then either install the gem locally:
 
 ```shell
-gem install ./ultracart_api-3.10.47.gem
+gem install ./ultracart_api-3.10.49.gem
 ```
-(for development, run `gem install --dev ./ultracart_api-3.10.47.gem` to install the development dependencies)
+(for development, run `gem install --dev ./ultracart_api-3.10.49.gem` to install the development dependencies)
 
 or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
 
 Finally add this to the Gemfile:
 
-    gem 'ultracart_api', '~> 3.10.47'
+    gem 'ultracart_api', '~> 3.10.49'
 
 ### Install from Git
 
@@ -193,12 +193,17 @@ Class | Method | HTTP request | Description
 *UltracartClient::IntegrationLogApi* | [**get_integration_log_file_pdf**](docs/IntegrationLogApi.md#get_integration_log_file_pdf) | **GET** /integration_log/query/{pk}/{sk}/{uuid}/pdf | Retrieve an integration log file converted to PDF
 *UltracartClient::IntegrationLogApi* | [**get_integration_log_summaries_query**](docs/IntegrationLogApi.md#get_integration_log_summaries_query) | **POST** /integration_log/summary/query | Retrieve integration log summaries
 *UltracartClient::IntegrationLogApi* | [**get_integration_logs_query**](docs/IntegrationLogApi.md#get_integration_logs_query) | **POST** /integration_log/query | Retrieve integration logs
+*UltracartClient::ItemApi* | [**delete_digital_item**](docs/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
 *UltracartClient::ItemApi* | [**delete_item**](docs/ItemApi.md#delete_item) | **DELETE** /item/items/{merchant_item_oid} | Delete an item
+*UltracartClient::ItemApi* | [**get_digital_item**](docs/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
+*UltracartClient::ItemApi* | [**get_digital_items**](docs/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
 *UltracartClient::ItemApi* | [**get_item**](docs/ItemApi.md#get_item) | **GET** /item/items/{merchant_item_oid} | Retrieve an item
 *UltracartClient::ItemApi* | [**get_item_by_merchant_item_id**](docs/ItemApi.md#get_item_by_merchant_item_id) | **GET** /item/items/merchant_item_id/{merchant_item_id} | Retrieve an item by item id
 *UltracartClient::ItemApi* | [**get_items**](docs/ItemApi.md#get_items) | **GET** /item/items | Retrieve items
 *UltracartClient::ItemApi* | [**get_pricing_tiers**](docs/ItemApi.md#get_pricing_tiers) | **GET** /item/pricing_tiers | Retrieve pricing tiers
+*UltracartClient::ItemApi* | [**insert_digital_item**](docs/ItemApi.md#insert_digital_item) | **POST** /item/digital_library | Create a file within the digital library
 *UltracartClient::ItemApi* | [**insert_item**](docs/ItemApi.md#insert_item) | **POST** /item/items | Create an item
+*UltracartClient::ItemApi* | [**update_digital_item**](docs/ItemApi.md#update_digital_item) | **PUT** /item/digital_library/{digital_item_oid} | Updates a file within the digital library
 *UltracartClient::ItemApi* | [**update_item**](docs/ItemApi.md#update_item) | **PUT** /item/items/{merchant_item_oid} | Update an item
 *UltracartClient::ItemApi* | [**update_items**](docs/ItemApi.md#update_items) | **PUT** /item/items/batch | Update multiple items
 *UltracartClient::ItemApi* | [**upload_temporary_multimedia**](docs/ItemApi.md#upload_temporary_multimedia) | **POST** /item/temp_multimedia | Upload an image to the temporary multimedia.
@@ -856,6 +861,9 @@ Class | Method | HTTP request | Description
  - [UltracartClient::ItemContentMultimediaThumbnail](docs/ItemContentMultimediaThumbnail.md)
  - [UltracartClient::ItemDigitalDelivery](docs/ItemDigitalDelivery.md)
  - [UltracartClient::ItemDigitalItem](docs/ItemDigitalItem.md)
+ - [UltracartClient::ItemDigitalItemPdfMeta](docs/ItemDigitalItemPdfMeta.md)
+ - [UltracartClient::ItemDigitalItemResponse](docs/ItemDigitalItemResponse.md)
+ - [UltracartClient::ItemDigitalItemsResponse](docs/ItemDigitalItemsResponse.md)
  - [UltracartClient::ItemEbay](docs/ItemEbay.md)
  - [UltracartClient::ItemEbayCategorySpecific](docs/ItemEbayCategorySpecific.md)
  - [UltracartClient::ItemEbayMarketListing](docs/ItemEbayMarketListing.md)
@@ -1188,6 +1196,8 @@ Not every change is committed to every SDK.
 
 | Version | Date | Comments |
 | --: | :-: | --- |
+| 3.10.49 | 09/22/2022 | digital item mgmt testing |
+| 3.10.48 | 09/22/2022 | testing digital file mgmt calls |
 | 3.10.47 | 09/19/2022 | conversations pagination |
 | 3.10.46 | 09/13/2022 | storefront comms - postcard tracking |
 | 3.10.45 | 09/12/2022 | storefront comm - send back reviews.io configured flag on getEmailSettings |

data/docs/ItemApi.md

@@ -4,17 +4,71 @@ All URIs are relative to *https://secure.ultracart.com/rest/v2*
 
 Method | HTTP request | Description
 ------------- | ------------- | -------------
+[**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
 [**delete_item**](ItemApi.md#delete_item) | **DELETE** /item/items/{merchant_item_oid} | Delete an item
+[**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
+[**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
 [**get_item**](ItemApi.md#get_item) | **GET** /item/items/{merchant_item_oid} | Retrieve an item
 [**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
 [**get_items**](ItemApi.md#get_items) | **GET** /item/items | Retrieve items
 [**get_pricing_tiers**](ItemApi.md#get_pricing_tiers) | **GET** /item/pricing_tiers | Retrieve pricing tiers
+[**insert_digital_item**](ItemApi.md#insert_digital_item) | **POST** /item/digital_library | Create a file within the digital library
 [**insert_item**](ItemApi.md#insert_item) | **POST** /item/items | Create an item
+[**update_digital_item**](ItemApi.md#update_digital_item) | **PUT** /item/digital_library/{digital_item_oid} | Updates a file within the digital library
 [**update_item**](ItemApi.md#update_item) | **PUT** /item/items/{merchant_item_oid} | Update an item
 [**update_items**](ItemApi.md#update_items) | **PUT** /item/items/batch | Update multiple items
 [**upload_temporary_multimedia**](ItemApi.md#upload_temporary_multimedia) | **POST** /item/temp_multimedia | Upload an image to the temporary multimedia.
 
 
+# **delete_digital_item**
+> delete_digital_item(digital_item_oid)
+
+Delete a digital item, which is a file within the digital library, not an actual merchant item
+
+Delete a digital item on the UltraCart account. 
+
+### Example
+```ruby
+# load the gem
+require 'ultracart_api'
+
+# Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
+simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
+api_instance = UltracartClient::ItemApi.new_using_api_key(simple_key, false, false)
+
+
+digital_item_oid = 56 # Integer | The digital item oid to delete.
+
+
+begin
+  #Delete a digital item, which is a file within the digital library, not an actual merchant item
+  api_instance.delete_digital_item(digital_item_oid)
+rescue UltracartClient::ApiError => e
+  puts "Exception when calling ItemApi->delete_digital_item: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **digital_item_oid** | **Integer**| The digital item oid to delete. | 
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+
 # **delete_item**
 > delete_item(merchant_item_oid)
 
@@ -64,6 +118,117 @@ nil (empty response body)
 
 
 
+# **get_digital_item**
+> ItemDigitalItemResponse get_digital_item(digital_item_oid)
+
+Retrieve a digital item from the digital library, which are digital files that may be attached to normal items
+
+Retrieves a digital item (file information) from the account.  Be aware that these are not normal items that can be added to a shopping cart. Rather, they are digital files that may be associated with normal items. 
+
+### Example
+```ruby
+# load the gem
+require 'ultracart_api'
+
+# Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
+simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
+api_instance = UltracartClient::ItemApi.new_using_api_key(simple_key, false, false)
+
+
+digital_item_oid = 56 # Integer | The digital item oid to retrieve.
+
+
+begin
+  #Retrieve a digital item from the digital library, which are digital files that may be attached to normal items
+  result = api_instance.get_digital_item(digital_item_oid)
+  p result
+rescue UltracartClient::ApiError => e
+  puts "Exception when calling ItemApi->get_digital_item: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **digital_item_oid** | **Integer**| The digital item oid to retrieve. | 
+
+### Return type
+
+[**ItemDigitalItemResponse**](ItemDigitalItemResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+
+# **get_digital_items**
+> ItemDigitalItemsResponse get_digital_items(opts)
+
+Retrieve digital items from the digital library which are digital files that may be attached to normal items
+
+Retrieves a group of digital items (file information) from the account.  If no parameters are specified, all digital items will be returned.  Be aware that these are not normal items that can be added to a shopping cart. Rather, they are digital files that may be associated with normal items.  You will need to make multiple API calls in order to retrieve the entire result set since this API performs result set pagination. 
+
+### Example
+```ruby
+# load the gem
+require 'ultracart_api'
+
+# Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
+simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
+api_instance = UltracartClient::ItemApi.new_using_api_key(simple_key, false, false)
+
+
+opts = { 
+  _limit: 100, # Integer | The maximum number of records to return on this one API call. (Default 100, Max 2000)
+  _offset: 0, # Integer | Pagination of the record set.  Offset is a zero based index.
+  _since: '_since_example', # String | Fetch items that have been created/modified since this date/time.
+  _sort: '_sort_example', # String | The sort order of the items.  See Sorting documentation for examples of using multiple values and sorting by ascending and descending.
+  _expand: '_expand_example', # String | The object expansion to perform on the result.  See documentation for examples
+  _placeholders: true # BOOLEAN | Whether or not placeholder values should be returned in the result.  Useful for UIs that consume this REST API.
+}
+
+begin
+  #Retrieve digital items from the digital library which are digital files that may be attached to normal items
+  result = api_instance.get_digital_items(opts)
+  p result
+rescue UltracartClient::ApiError => e
+  puts "Exception when calling ItemApi->get_digital_items: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **_limit** | **Integer**| The maximum number of records to return on this one API call. (Default 100, Max 2000) | [optional] [default to 100]
+ **_offset** | **Integer**| Pagination of the record set.  Offset is a zero based index. | [optional] [default to 0]
+ **_since** | **String**| Fetch items that have been created/modified since this date/time. | [optional] 
+ **_sort** | **String**| The sort order of the items.  See Sorting documentation for examples of using multiple values and sorting by ascending and descending. | [optional] 
+ **_expand** | **String**| The object expansion to perform on the result.  See documentation for examples | [optional] 
+ **_placeholders** | **BOOLEAN**| Whether or not placeholder values should be returned in the result.  Useful for UIs that consume this REST API. | [optional] 
+
+### Return type
+
+[**ItemDigitalItemsResponse**](ItemDigitalItemsResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+
 # **get_item**
 > ItemResponse get_item(merchant_item_oid, opts)
 
@@ -292,6 +457,56 @@ Name | Type | Description  | Notes
 
 
 
+# **insert_digital_item**
+> ItemDigitalItemResponse insert_digital_item(digital_item)
+
+Create a file within the digital library
+
+Create a file within the digital library.  This does not create an item, but makes this digital file available and selectable as part (or all) of an item. 
+
+### Example
+```ruby
+# load the gem
+require 'ultracart_api'
+
+# Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
+simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
+api_instance = UltracartClient::ItemApi.new_using_api_key(simple_key, false, false)
+
+
+digital_item = UltracartClient::ItemDigitalItem.new # ItemDigitalItem | Digital item to create
+
+
+begin
+  #Create a file within the digital library
+  result = api_instance.insert_digital_item(digital_item)
+  p result
+rescue UltracartClient::ApiError => e
+  puts "Exception when calling ItemApi->insert_digital_item: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **digital_item** | [**ItemDigitalItem**](ItemDigitalItem.md)| Digital item to create | 
+
+### Return type
+
+[**ItemDigitalItemResponse**](ItemDigitalItemResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json; charset=UTF-8
+ - **Accept**: application/json
+
+
+
 # **insert_item**
 > ItemResponse insert_item(item, opts)
 
@@ -348,6 +563,59 @@ Name | Type | Description  | Notes
 
 
 
+# **update_digital_item**
+> ItemDigitalItemResponse update_digital_item(digital_item_oid, digital_item)
+
+Updates a file within the digital library
+
+Updates a file within the digital library.  This does not update an item, but updates a digital file available and selectable as part (or all) of an item. 
+
+### Example
+```ruby
+# load the gem
+require 'ultracart_api'
+
+# Create a Simple Key: https://ultracart.atlassian.net/wiki/spaces/ucdoc/pages/38688545/API+Simple+Key
+simple_key = '109ee846ee69f50177018ab12f008a00748a25aa28dbdc0177018ab12f008a00'
+api_instance = UltracartClient::ItemApi.new_using_api_key(simple_key, false, false)
+
+
+digital_item_oid = 56 # Integer | The digital item oid to update.
+
+digital_item = UltracartClient::ItemDigitalItem.new # ItemDigitalItem | Digital item to update
+
+
+begin
+  #Updates a file within the digital library
+  result = api_instance.update_digital_item(digital_item_oid, digital_item)
+  p result
+rescue UltracartClient::ApiError => e
+  puts "Exception when calling ItemApi->update_digital_item: #{e}"
+end
+```
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **digital_item_oid** | **Integer**| The digital item oid to update. | 
+ **digital_item** | [**ItemDigitalItem**](ItemDigitalItem.md)| Digital item to update | 
+
+### Return type
+
+[**ItemDigitalItemResponse**](ItemDigitalItemResponse.md)
+
+### Authorization
+
+[ultraCartOauth](../README.md#ultraCartOauth), [ultraCartSimpleApiKey](../README.md#ultraCartSimpleApiKey)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json; charset=UTF-8
+ - **Accept**: application/json
+
+
+
 # **update_item**
 > ItemResponse update_item(item, merchant_item_oid, opts)
 

data/docs/ItemDigitalItem.md

@@ -3,10 +3,14 @@
 ## Properties
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
+**click_wrap_agreement** | **String** | Click wrap agreement is presented to the customer before they can purchase your product. | [optional] 
 **creation_dts** | **String** | File creation date | [optional] 
 **description** | **String** | Description of the digital item | [optional] 
+**digital_item_oid** | **Integer** | The Digital item oid is a primary key used internally by UltraCart.  You should not set or change this value.  Doing so will have no effect. | [optional] 
 **file_size** | **Integer** | File size | [optional] 
+**import_from_url** | **String** | This url is sourced to create or update a digital file in your digital library.  It is only considered during an insert or update operation. | [optional] 
 **mime_type** | **String** | Mime type associated with the file | [optional] 
 **original_filename** | **String** | Original filename | [optional] 
+**pdf_meta** | [**ItemDigitalItemPdfMeta**](ItemDigitalItemPdfMeta.md) |  | [optional] 
 
 

data/docs/ItemDigitalItemPdfMeta.md

@@ -0,0 +1,18 @@
+# UltracartClient::ItemDigitalItemPdfMeta
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**assembly_allowed** | **BOOLEAN** | Assembly allowed | [optional] 
+**copy_allowed** | **BOOLEAN** | Copy/Paste is allowed | [optional] 
+**custom_footer** | **String** | A custom footer for each pdf page | [optional] 
+**custom_header** | **String** | A custom header for each pdf page | [optional] 
+**degraded_printing_allowed** | **BOOLEAN** | Degraded printing allowed | [optional] 
+**fillin_allowed** | **BOOLEAN** | Fillin is allowed | [optional] 
+**modify_annotations_allowed** | **BOOLEAN** | Modifying annotations is allowed | [optional] 
+**modify_contents_allowed** | **BOOLEAN** | Modifying contents is allowed | [optional] 
+**printing_allowed** | **BOOLEAN** | Printing is allowed | [optional] 
+**screen_readers_allowed** | **BOOLEAN** | Screen readers are allowed | [optional] 
+**tagged** | **BOOLEAN** | PDF is tagged | [optional] 
+
+

data/docs/ItemDigitalItemResponse.md

@@ -0,0 +1,12 @@
+# UltracartClient::ItemDigitalItemResponse
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**digital_item** | [**ItemDigitalItem**](ItemDigitalItem.md) |  | [optional] 
+**error** | [**Error**](Error.md) |  | [optional] 
+**metadata** | [**ResponseMetadata**](ResponseMetadata.md) |  | [optional] 
+**success** | **BOOLEAN** | Indicates if API call was successful | [optional] 
+**warning** | [**Warning**](Warning.md) |  | [optional] 
+
+

data/docs/ItemDigitalItemsResponse.md

@@ -0,0 +1,12 @@
+# UltracartClient::ItemDigitalItemsResponse
+
+## Properties
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**digital_items** | [**Array<ItemDigitalItem>**](ItemDigitalItem.md) | digital_items | [optional] 
+**error** | [**Error**](Error.md) |  | [optional] 
+**metadata** | [**ResponseMetadata**](ResponseMetadata.md) |  | [optional] 
+**success** | **BOOLEAN** | Indicates if API call was successful | [optional] 
+**warning** | [**Warning**](Warning.md) |  | [optional] 
+
+