ultracart_api 4.1.230 → 4.1.231

data/docs/SfvbPostcardTrackingResponse.md

@@ -0,0 +1,34 @@
+# UltracartClient::SfvbPostcardTrackingResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **cards** | [**Array<SfvbPostcardCard>**](SfvbPostcardCard.md) | This page of cards. | [optional] |
+| **customer_data** | **String** | masked, or shown when show_customer_data was sent. | [optional] |
+| **notes** | **Array<String>** | What to keep in mind, such as how to handle customer data that is shown. | [optional] |
+| **page** | **Integer** | The page number, from 1. | [optional] |
+| **page_cost** | **Float** | The total cost of the cards on this page. | [optional] |
+| **page_size** | **Integer** | Cards per page. | [optional] |
+| **postcard_uuid** | **String** | The postcard. | [optional] |
+| **total_cards** | **Integer** | How many cards have been mailed for this postcard. | [optional] |
+| **total_pages** | **Integer** | How many pages there are. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbPostcardTrackingResponse.new(
+  cards: null,
+  customer_data: null,
+  notes: null,
+  page: null,
+  page_cost: null,
+  page_size: null,
+  postcard_uuid: null,
+  total_cards: null,
+  total_pages: null
+)
+```
+

data/docs/SfvbTransactionalChange.md

@@ -0,0 +1,24 @@
+# UltracartClient::SfvbTransactionalChange
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **field** | **String** | subject, option, sending_domain_uuid, sending_user or sending_name. | [optional] |
+| **from** | **String** | The value before. | [optional] |
+| **name** | **String** | For an option, its name. | [optional] |
+| **to** | **String** | The value after. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbTransactionalChange.new(
+  field: null,
+  from: null,
+  name: null,
+  to: null
+)
+```
+

data/docs/SfvbTransactionalDeliveryOption.md

@@ -0,0 +1,22 @@
+# UltracartClient::SfvbTransactionalDeliveryOption
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **description** | **String** | What the option does. | [optional] |
+| **name** | **String** | The option's name.  An update names options by it. | [optional] |
+| **selected** | **Boolean** | True when the option is on. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbTransactionalDeliveryOption.new(
+  description: null,
+  name: null,
+  selected: null
+)
+```
+

data/docs/SfvbTransactionalEmailDetail.md

@@ -0,0 +1,30 @@
+# UltracartClient::SfvbTransactionalEmailDetail
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **delivery_options** | [**Array<SfvbTransactionalDeliveryOption>**](SfvbTransactionalDeliveryOption.md) | Its delivery options.  Empty for an email that has none. | [optional] |
+| **file_name** | **String** | The HTML template file, such as receipt_html.vm. | [optional] |
+| **hash_sha256** | **String** | The hash of the subject, the options and the sender.  Send it as If-Match to change them. | [optional] |
+| **name** | **String** | The display name, such as Order - Receipt. | [optional] |
+| **sender** | [**SfvbTransactionalSender**](SfvbTransactionalSender.md) |  | [optional] |
+| **sender_shared_with** | **Array<String>** | Every storefront on this account that shares the sender, this one included. | [optional] |
+| **subject** | **String** | The subject line. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbTransactionalEmailDetail.new(
+  delivery_options: null,
+  file_name: null,
+  hash_sha256: null,
+  name: null,
+  sender: null,
+  sender_shared_with: null,
+  subject: null
+)
+```
+

data/docs/SfvbTransactionalEmailResponse.md

@@ -0,0 +1,24 @@
+# UltracartClient::SfvbTransactionalEmailResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **changes** | [**Array<SfvbTransactionalChange>**](SfvbTransactionalChange.md) | What the update changes, or would change on a dry run. | [optional] |
+| **dry_run** | **Boolean** | True when nothing was written. | [optional] |
+| **email** | [**SfvbTransactionalEmailDetail**](SfvbTransactionalEmailDetail.md) |  | [optional] |
+| **notes** | **Array<String>** | What the change means, such as the orders it reaches and the storefronts that share a sender. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbTransactionalEmailResponse.new(
+  changes: null,
+  dry_run: null,
+  email: null,
+  notes: null
+)
+```
+

data/docs/SfvbTransactionalEmailUpdateRequest.md

@@ -0,0 +1,28 @@
+# UltracartClient::SfvbTransactionalEmailUpdateRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **delivery_options** | [**Array<SfvbTransactionalDeliveryOption>**](SfvbTransactionalDeliveryOption.md) | Options to turn on or off, each by name with selected. | [optional] |
+| **dry_run** | **Boolean** | True to check the change and show it without writing anything or using an approval. | [optional] |
+| **sending_domain_uuid** | **String** | A sending domain on this account. | [optional] |
+| **sending_name** | **String** | The from name. | [optional] |
+| **sending_user** | **String** | The part of the from address before the at sign. | [optional] |
+| **subject** | **String** | The subject line, 1 to 150 characters. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbTransactionalEmailUpdateRequest.new(
+  delivery_options: null,
+  dry_run: null,
+  sending_domain_uuid: null,
+  sending_name: null,
+  sending_user: null,
+  subject: null
+)
+```
+

data/docs/SfvbTransactionalSender.md

@@ -0,0 +1,24 @@
+# UltracartClient::SfvbTransactionalSender
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **sending_domain_uuid** | **String** | The sending domain uuid, or none. | [optional] |
+| **sending_name** | **String** | The from name. | [optional] |
+| **sending_user** | **String** | The part of the from address before the at sign. | [optional] |
+| **smtp** | **Boolean** | True when it sends through the merchant's own mail server, which only the admin changes.  Its credentials are never returned. | [optional] |
+
+## Example
+
+```ruby
+require 'ultracart_api'
+
+instance = UltracartClient::SfvbTransactionalSender.new(
+  sending_domain_uuid: null,
+  sending_name: null,
+  sending_user: null,
+  smtp: null
+)
+```
+

data/lib/ultracart_api/api/sfvb_api.rb

@@ -5102,6 +5102,85 @@ module UltracartClient
       return data, status_code, headers
     end
 
+    # Read one page of a list's members
+    # Each member's customer uuid, email and the date they joined.  Email addresses are masked (w***a@example.com) and customer_data is masked, unless show_customer_data is true, which returns the real addresses and needs the sfvb_publish scope.  Every such read is logged.  Ask for them only when the merchant needs a person's address.  Read only. 
+    # @param storefront_oid [Integer] 
+    # @param list_uuid [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page The page, from 1
+    # @option opts [Integer] :page_size Members per page, 1 to 100 (default 50)
+    # @option opts [Boolean] :show_customer_data True to return the real email addresses instead of masked ones
+    # @return [SfvbCommsMembersResponse]
+    def get_sfvb_comms_list_members(storefront_oid, list_uuid, opts = {})
+      data, _status_code, _headers = get_sfvb_comms_list_members_with_http_info(storefront_oid, list_uuid, opts)
+      data
+    end
+
+    # Read one page of a list's members
+    # Each member's customer uuid, email and the date they joined.  Email addresses are masked (w***a@example.com) and customer_data is masked, unless show_customer_data is true, which returns the real addresses and needs the sfvb_publish scope.  Every such read is logged.  Ask for them only when the merchant needs a person's address.  Read only. 
+    # @param storefront_oid [Integer] 
+    # @param list_uuid [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page The page, from 1
+    # @option opts [Integer] :page_size Members per page, 1 to 100 (default 50)
+    # @option opts [Boolean] :show_customer_data True to return the real email addresses instead of masked ones
+    # @return [Array<(SfvbCommsMembersResponse, Integer, Hash)>] SfvbCommsMembersResponse data, response status code and response headers
+    def get_sfvb_comms_list_members_with_http_info(storefront_oid, list_uuid, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SfvbApi.get_sfvb_comms_list_members ...'
+      end
+      # verify the required parameter 'storefront_oid' is set
+      if @api_client.config.client_side_validation && storefront_oid.nil?
+        fail ArgumentError, "Missing the required parameter 'storefront_oid' when calling SfvbApi.get_sfvb_comms_list_members"
+      end
+      # verify the required parameter 'list_uuid' is set
+      if @api_client.config.client_side_validation && list_uuid.nil?
+        fail ArgumentError, "Missing the required parameter 'list_uuid' when calling SfvbApi.get_sfvb_comms_list_members"
+      end
+      # resource path
+      local_var_path = '/sfvb/storefronts/{storefront_oid}/lists/{list_uuid}/members'.sub('{' + 'storefront_oid' + '}', CGI.escape(storefront_oid.to_s)).sub('{' + 'list_uuid' + '}', CGI.escape(list_uuid.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
+      query_params[:'page_size'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+      query_params[:'show_customer_data'] = opts[:'show_customer_data'] if !opts[:'show_customer_data'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      header_params['X-UltraCart-Api-Version'] = @api_client.select_header_api_version()
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SfvbCommsMembersResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
+
+      new_options = opts.merge(
+        :operation => :"SfvbApi.get_sfvb_comms_list_members",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SfvbApi#get_sfvb_comms_list_members\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Read one segment, with its rule
     # The segment's name, folder, rule, member count at its last rebuild, whether a rebuild is still due, and the campaigns and flows that use it, each with whether it is live.  hash_sha256 is the If-Match for an update.  Never its members, its Facebook audience, its ranking or its third party sync settings. 
     # @param storefront_oid [Integer] 
@@ -5172,6 +5251,85 @@ module UltracartClient
       return data, status_code, headers
     end
 
+    # Read one page of a segment's members
+    # Each member's customer uuid, email and the date they joined.  Email addresses are masked (w***a@example.com) and customer_data is masked, unless show_customer_data is true, which returns the real addresses and needs the sfvb_publish scope.  Every such read is logged.  Ask for them only when the merchant needs a person's address.  Read only. 
+    # @param storefront_oid [Integer] 
+    # @param segment_uuid [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page The page, from 1
+    # @option opts [Integer] :page_size Members per page, 1 to 100 (default 50)
+    # @option opts [Boolean] :show_customer_data True to return the real email addresses instead of masked ones
+    # @return [SfvbCommsMembersResponse]
+    def get_sfvb_comms_segment_members(storefront_oid, segment_uuid, opts = {})
+      data, _status_code, _headers = get_sfvb_comms_segment_members_with_http_info(storefront_oid, segment_uuid, opts)
+      data
+    end
+
+    # Read one page of a segment&#39;s members
+    # Each member&#39;s customer uuid, email and the date they joined.  Email addresses are masked (w***a@example.com) and customer_data is masked, unless show_customer_data is true, which returns the real addresses and needs the sfvb_publish scope.  Every such read is logged.  Ask for them only when the merchant needs a person&#39;s address.  Read only. 
+    # @param storefront_oid [Integer] 
+    # @param segment_uuid [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page The page, from 1
+    # @option opts [Integer] :page_size Members per page, 1 to 100 (default 50)
+    # @option opts [Boolean] :show_customer_data True to return the real email addresses instead of masked ones
+    # @return [Array<(SfvbCommsMembersResponse, Integer, Hash)>] SfvbCommsMembersResponse data, response status code and response headers
+    def get_sfvb_comms_segment_members_with_http_info(storefront_oid, segment_uuid, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SfvbApi.get_sfvb_comms_segment_members ...'
+      end
+      # verify the required parameter 'storefront_oid' is set
+      if @api_client.config.client_side_validation && storefront_oid.nil?
+        fail ArgumentError, "Missing the required parameter 'storefront_oid' when calling SfvbApi.get_sfvb_comms_segment_members"
+      end
+      # verify the required parameter 'segment_uuid' is set
+      if @api_client.config.client_side_validation && segment_uuid.nil?
+        fail ArgumentError, "Missing the required parameter 'segment_uuid' when calling SfvbApi.get_sfvb_comms_segment_members"
+      end
+      # resource path
+      local_var_path = '/sfvb/storefronts/{storefront_oid}/segments/{segment_uuid}/members'.sub('{' + 'storefront_oid' + '}', CGI.escape(storefront_oid.to_s)).sub('{' + 'segment_uuid' + '}', CGI.escape(segment_uuid.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
+      query_params[:'page_size'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+      query_params[:'show_customer_data'] = opts[:'show_customer_data'] if !opts[:'show_customer_data'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      header_params['X-UltraCart-Api-Version'] = @api_client.select_header_api_version()
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SfvbCommsMembersResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
+
+      new_options = opts.merge(
+        :operation => :"SfvbApi.get_sfvb_comms_segment_members",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SfvbApi#get_sfvb_comms_segment_members\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Read a sending domain
     # One sending domain as stored.  To check an amazon domain's DNS again, use the status call. 
     # @param domain [String] 
@@ -7655,6 +7813,85 @@ module UltracartClient
       return data, status_code, headers
     end
 
+    # Read one page of the cards mailed for a postcard
+    # Every printed card mailed for the postcard, newest first, with its status, cost, dates and the order it converted to.  Recipients are masked (the name an initial, the street lines hidden, city, state and postal code kept) and the vendor's status text is left out, unless show_customer_data is true, which needs the sfvb_publish scope and is logged.  The return address is the merchant's own.  Read only. 
+    # @param storefront_oid [Integer] 
+    # @param postcard_uuid [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page The page, from 1
+    # @option opts [Integer] :page_size Cards per page, 1 to 100 (default 50)
+    # @option opts [Boolean] :show_customer_data True to return the recipients&#39; real names and street addresses
+    # @return [SfvbPostcardTrackingResponse]
+    def get_sfvb_postcard_tracking(storefront_oid, postcard_uuid, opts = {})
+      data, _status_code, _headers = get_sfvb_postcard_tracking_with_http_info(storefront_oid, postcard_uuid, opts)
+      data
+    end
+
+    # Read one page of the cards mailed for a postcard
+    # Every printed card mailed for the postcard, newest first, with its status, cost, dates and the order it converted to.  Recipients are masked (the name an initial, the street lines hidden, city, state and postal code kept) and the vendor&#39;s status text is left out, unless show_customer_data is true, which needs the sfvb_publish scope and is logged.  The return address is the merchant&#39;s own.  Read only. 
+    # @param storefront_oid [Integer] 
+    # @param postcard_uuid [String] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page The page, from 1
+    # @option opts [Integer] :page_size Cards per page, 1 to 100 (default 50)
+    # @option opts [Boolean] :show_customer_data True to return the recipients&#39; real names and street addresses
+    # @return [Array<(SfvbPostcardTrackingResponse, Integer, Hash)>] SfvbPostcardTrackingResponse data, response status code and response headers
+    def get_sfvb_postcard_tracking_with_http_info(storefront_oid, postcard_uuid, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SfvbApi.get_sfvb_postcard_tracking ...'
+      end
+      # verify the required parameter 'storefront_oid' is set
+      if @api_client.config.client_side_validation && storefront_oid.nil?
+        fail ArgumentError, "Missing the required parameter 'storefront_oid' when calling SfvbApi.get_sfvb_postcard_tracking"
+      end
+      # verify the required parameter 'postcard_uuid' is set
+      if @api_client.config.client_side_validation && postcard_uuid.nil?
+        fail ArgumentError, "Missing the required parameter 'postcard_uuid' when calling SfvbApi.get_sfvb_postcard_tracking"
+      end
+      # resource path
+      local_var_path = '/sfvb/storefronts/{storefront_oid}/postcards/{postcard_uuid}/tracking'.sub('{' + 'storefront_oid' + '}', CGI.escape(storefront_oid.to_s)).sub('{' + 'postcard_uuid' + '}', CGI.escape(postcard_uuid.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
+      query_params[:'page_size'] = opts[:'page_size'] if !opts[:'page_size'].nil?
+      query_params[:'show_customer_data'] = opts[:'show_customer_data'] if !opts[:'show_customer_data'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      header_params['X-UltraCart-Api-Version'] = @api_client.select_header_api_version()
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SfvbPostcardTrackingResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
+
+      new_options = opts.merge(
+        :operation => :"SfvbApi.get_sfvb_postcard_tracking",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SfvbApi#get_sfvb_postcard_tracking\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # URL that renders a preview session
     # Refuses a session that does not exist, so a URL you receive is for a session that was really there.  expires_in_seconds is the time actually remaining, not the configured lifetime.  Needs a token that resolves to a user, because a preview session belongs to the person who created it. 
     # @param storefront_oid [Integer] 
@@ -9364,6 +9601,76 @@ module UltracartClient
       return data, status_code, headers
     end
 
+    # Read a transactional email's subject, delivery options and sender
+    # file_name is the template file from the transactional email list, such as receipt_html.vm, or its display name.  The sender is shared by every storefront on the same screen branding theme (sender_shared_with); a sender that sends through the merchant's own mail server shows smtp true and never its credentials.  hash_sha256 is the If-Match for an update.  The template itself is a theme file. 
+    # @param storefront_oid [Integer] 
+    # @param file_name [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [SfvbTransactionalEmailResponse]
+    def get_sfvb_transactional_email(storefront_oid, file_name, opts = {})
+      data, _status_code, _headers = get_sfvb_transactional_email_with_http_info(storefront_oid, file_name, opts)
+      data
+    end
+
+    # Read a transactional email&#39;s subject, delivery options and sender
+    # file_name is the template file from the transactional email list, such as receipt_html.vm, or its display name.  The sender is shared by every storefront on the same screen branding theme (sender_shared_with); a sender that sends through the merchant&#39;s own mail server shows smtp true and never its credentials.  hash_sha256 is the If-Match for an update.  The template itself is a theme file. 
+    # @param storefront_oid [Integer] 
+    # @param file_name [String] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(SfvbTransactionalEmailResponse, Integer, Hash)>] SfvbTransactionalEmailResponse data, response status code and response headers
+    def get_sfvb_transactional_email_with_http_info(storefront_oid, file_name, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SfvbApi.get_sfvb_transactional_email ...'
+      end
+      # verify the required parameter 'storefront_oid' is set
+      if @api_client.config.client_side_validation && storefront_oid.nil?
+        fail ArgumentError, "Missing the required parameter 'storefront_oid' when calling SfvbApi.get_sfvb_transactional_email"
+      end
+      # verify the required parameter 'file_name' is set
+      if @api_client.config.client_side_validation && file_name.nil?
+        fail ArgumentError, "Missing the required parameter 'file_name' when calling SfvbApi.get_sfvb_transactional_email"
+      end
+      # resource path
+      local_var_path = '/sfvb/storefronts/{storefront_oid}/transactional_emails/{file_name}'.sub('{' + 'storefront_oid' + '}', CGI.escape(storefront_oid.to_s)).sub('{' + 'file_name' + '}', CGI.escape(file_name.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      header_params['X-UltraCart-Api-Version'] = @api_client.select_header_api_version()
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SfvbTransactionalEmailResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
+
+      new_options = opts.merge(
+        :operation => :"SfvbApi.get_sfvb_transactional_email",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SfvbApi#get_sfvb_transactional_email\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # List the transactional emails a storefront sends
     # The order, shipment, auto order and other transactional emails this storefront sends, with their template files and the body container a draft replaces.  Forgot password and chat verification are not listed, because they have no preview. 
     # @param storefront_oid [Integer] 
@@ -18584,6 +18891,97 @@ module UltracartClient
       return data, status_code, headers
     end
 
+    # Change a transactional email's subject, delivery options or sender
+    # A field left out stays as it is.  It goes to every matching order from the moment it is saved, so every change needs sfvb_publish, the email's hash_sha256 as If-Match, and an approved transactional_email.update request for exactly this change (params.path the template file).  dry_run checks and shows the change without writing or using an approval.  Delivery options are named by name.  A sender change reaches every storefront on the same screen branding theme, and is refused for one that sends through the merchant's own mail server. 
+    # @param storefront_oid [Integer] 
+    # @param file_name [String] 
+    # @param if_match [String] The email&#39;s hash_sha256 from the last read.  Required; 428 when absent, 412 when stale.
+    # @param transactional_email_update_request [SfvbTransactionalEmailUpdateRequest] The fields to change
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :approval_id The approval_id of an approved transactional_email.update request for exactly this change.  See POST /sfvb/approvals.
+    # @return [SfvbTransactionalEmailResponse]
+    def update_sfvb_transactional_email(storefront_oid, file_name, if_match, transactional_email_update_request, opts = {})
+      data, _status_code, _headers = update_sfvb_transactional_email_with_http_info(storefront_oid, file_name, if_match, transactional_email_update_request, opts)
+      data
+    end
+
+    # Change a transactional email&#39;s subject, delivery options or sender
+    # A field left out stays as it is.  It goes to every matching order from the moment it is saved, so every change needs sfvb_publish, the email&#39;s hash_sha256 as If-Match, and an approved transactional_email.update request for exactly this change (params.path the template file).  dry_run checks and shows the change without writing or using an approval.  Delivery options are named by name.  A sender change reaches every storefront on the same screen branding theme, and is refused for one that sends through the merchant&#39;s own mail server. 
+    # @param storefront_oid [Integer] 
+    # @param file_name [String] 
+    # @param if_match [String] The email&#39;s hash_sha256 from the last read.  Required; 428 when absent, 412 when stale.
+    # @param transactional_email_update_request [SfvbTransactionalEmailUpdateRequest] The fields to change
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :approval_id The approval_id of an approved transactional_email.update request for exactly this change.  See POST /sfvb/approvals.
+    # @return [Array<(SfvbTransactionalEmailResponse, Integer, Hash)>] SfvbTransactionalEmailResponse data, response status code and response headers
+    def update_sfvb_transactional_email_with_http_info(storefront_oid, file_name, if_match, transactional_email_update_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SfvbApi.update_sfvb_transactional_email ...'
+      end
+      # verify the required parameter 'storefront_oid' is set
+      if @api_client.config.client_side_validation && storefront_oid.nil?
+        fail ArgumentError, "Missing the required parameter 'storefront_oid' when calling SfvbApi.update_sfvb_transactional_email"
+      end
+      # verify the required parameter 'file_name' is set
+      if @api_client.config.client_side_validation && file_name.nil?
+        fail ArgumentError, "Missing the required parameter 'file_name' when calling SfvbApi.update_sfvb_transactional_email"
+      end
+      # verify the required parameter 'if_match' is set
+      if @api_client.config.client_side_validation && if_match.nil?
+        fail ArgumentError, "Missing the required parameter 'if_match' when calling SfvbApi.update_sfvb_transactional_email"
+      end
+      # verify the required parameter 'transactional_email_update_request' is set
+      if @api_client.config.client_side_validation && transactional_email_update_request.nil?
+        fail ArgumentError, "Missing the required parameter 'transactional_email_update_request' when calling SfvbApi.update_sfvb_transactional_email"
+      end
+      # resource path
+      local_var_path = '/sfvb/storefronts/{storefront_oid}/transactional_emails/{file_name}'.sub('{' + 'storefront_oid' + '}', CGI.escape(storefront_oid.to_s)).sub('{' + 'file_name' + '}', CGI.escape(file_name.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      header_params['X-UltraCart-Api-Version'] = @api_client.select_header_api_version()
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+      header_params[:'If-Match'] = if_match
+      header_params[:'Approval-Id'] = opts[:'approval_id'] if !opts[:'approval_id'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(transactional_email_update_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SfvbTransactionalEmailResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ultraCartOauth', 'ultraCartSimpleApiKey']
+
+      new_options = opts.merge(
+        :operation => :"SfvbApi.update_sfvb_transactional_email",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PUT, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: SfvbApi#update_sfvb_transactional_email\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Update an upsell offer
     # A full replace.  Send back the whole offer you read, changed, with its hash_sha256 in If-Match.  Read only fields are ignored and a writable field left out is cleared.  Changing an offer that is switched on, or changing upsell_item_id_javascript or offsite_content_url, needs sfvb_publish.  An update cannot switch an offer on; that is the enable call, which needs approval.  Settings the API does not show, such as the offer's screenshots, are kept. 
     # @param storefront_oid [Integer] 

data/lib/ultracart_api/models/item_auto_order.rb

@@ -48,7 +48,7 @@ module UltracartClient
     # Day counts (1 to 365, at most 20) a customer may switch this auto-enrolled item to from MyAccount, for example [30, 60, 90].  Requires the advanced auto order settings to be enabled on the account.  Omit to leave unchanged; send an empty array to clear.
     attr_accessor :auto_order_myaccount_frequency_day_counts
 
-    # True if the MyAccount frequency change is only offered once the item is on its last auto order step.  Omit to leave unchanged.
+    # True if the MyAccount frequency change is only offered once the item is on its last auto order step.  If auto_order_myaccount_frequency_schedules or auto_order_myaccount_frequency_day_counts is sent without this property, it is set to false; if none of the three are sent, it is left unchanged.
     attr_accessor :auto_order_myaccount_frequency_last_step_only
 
     # Standard schedules a customer may switch this auto-enrolled item to from MyAccount.  Requires the advanced auto order settings to be enabled on the account.  Omit to leave unchanged; send an empty array to clear.