fern_gusto 0.0.6.pre.alpha6

data/lib/fern_gusto/employees/employments/types/employments_get_history_response_item.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+require_relative "employments_get_history_response_item_employment_status"
+require "ostruct"
+require "json"
+
+module Gusto
+  module Employees
+    module Employments
+      class EmploymentsGetHistoryResponseItem
+      # @return [String] The employee's start day of work for an employment.
+        attr_reader :hire_date
+      # @return [String] The employee's last day of work for an employment.
+        attr_reader :termination_date
+      # @return [Boolean] The boolean flag indicating whether Gusto will file a new hire report for the
+#  employee.
+        attr_reader :file_new_hire_report
+      # @return [Boolean] Whether the employee is a two percent shareholder of the company. This field
+#  only applies to companies with an S-Corp entity type.
+        attr_reader :two_percent_shareholder
+      # @return [Gusto::Employees::Employments::EmploymentsGetHistoryResponseItemEmploymentStatus] The employee's employment status. Supplying an invalid option will set the
+#  employment_status to _not_set_.
+        attr_reader :employment_status
+      # @return [OpenStruct] Additional properties unmapped to the current class definition
+        attr_reader :additional_properties
+      # @return [Object] 
+        attr_reader :_field_set
+        protected :_field_set
+
+        OMIT = Object.new
+
+        # @param hire_date [String] The employee's start day of work for an employment.
+        # @param termination_date [String] The employee's last day of work for an employment.
+        # @param file_new_hire_report [Boolean] The boolean flag indicating whether Gusto will file a new hire report for the
+#  employee.
+        # @param two_percent_shareholder [Boolean] Whether the employee is a two percent shareholder of the company. This field
+#  only applies to companies with an S-Corp entity type.
+        # @param employment_status [Gusto::Employees::Employments::EmploymentsGetHistoryResponseItemEmploymentStatus] The employee's employment status. Supplying an invalid option will set the
+#  employment_status to _not_set_.
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [Gusto::Employees::Employments::EmploymentsGetHistoryResponseItem]
+        def initialize(hire_date: OMIT, termination_date: OMIT, file_new_hire_report: OMIT, two_percent_shareholder: OMIT, employment_status: OMIT, additional_properties: nil)
+          @hire_date = hire_date if hire_date != OMIT
+          @termination_date = termination_date if termination_date != OMIT
+          @file_new_hire_report = file_new_hire_report if file_new_hire_report != OMIT
+          @two_percent_shareholder = two_percent_shareholder if two_percent_shareholder != OMIT
+          @employment_status = employment_status if employment_status != OMIT
+          @additional_properties = additional_properties
+          @_field_set = { "hire_date": hire_date, "termination_date": termination_date, "file_new_hire_report": file_new_hire_report, "two_percent_shareholder": two_percent_shareholder, "employment_status": employment_status }.reject do | _k, v |
+  v == OMIT
+end
+        end
+# Deserialize a JSON object to an instance of EmploymentsGetHistoryResponseItem
+        #
+        # @param json_object [String] 
+        # @return [Gusto::Employees::Employments::EmploymentsGetHistoryResponseItem]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          hire_date = parsed_json["hire_date"]
+          termination_date = parsed_json["termination_date"]
+          file_new_hire_report = parsed_json["file_new_hire_report"]
+          two_percent_shareholder = parsed_json["two_percent_shareholder"]
+          employment_status = parsed_json["employment_status"]
+          new(
+            hire_date: hire_date,
+            termination_date: termination_date,
+            file_new_hire_report: file_new_hire_report,
+            two_percent_shareholder: two_percent_shareholder,
+            employment_status: employment_status,
+            additional_properties: struct
+          )
+        end
+# Serialize an instance of EmploymentsGetHistoryResponseItem to a JSON object
+        #
+        # @return [String]
+        def to_json
+          @_field_set&.to_json
+        end
+# Leveraged for Union-type generation, validate_raw attempts to parse the given
+#  hash and check each fields type against the current object's property
+#  definitions.
+        #
+        # @param obj [Object] 
+        # @return [Void]
+        def self.validate_raw(obj:)
+          obj.hire_date&.is_a?(String) != false || raise("Passed value for field obj.hire_date is not the expected type, validation failed.")
+          obj.termination_date&.is_a?(String) != false || raise("Passed value for field obj.termination_date is not the expected type, validation failed.")
+          obj.file_new_hire_report&.is_a?(Boolean) != false || raise("Passed value for field obj.file_new_hire_report is not the expected type, validation failed.")
+          obj.two_percent_shareholder&.is_a?(Boolean) != false || raise("Passed value for field obj.two_percent_shareholder is not the expected type, validation failed.")
+          obj.employment_status&.is_a?(Gusto::Employees::Employments::EmploymentsGetHistoryResponseItemEmploymentStatus) != false || raise("Passed value for field obj.employment_status is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

data/lib/fern_gusto/employees/employments/types/employments_get_history_response_item_employment_status.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Gusto
+  module Employees
+    module Employments
+# The employee's employment status. Supplying an invalid option will set the
+#  employment_status to _not_set_.
+      class EmploymentsGetHistoryResponseItemEmploymentStatus
+
+        PART_TIME = "part_time"
+        FULL_TIME = "full_time"
+        PART_TIME_ELIGIBLE = "part_time_eligible"
+        VARIABLE = "variable"
+        SEASONAL = "seasonal"
+        NOT_SET = "not_set"
+
+      end
+    end
+  end
+end

data/lib/fern_gusto/employees/forms/client.rb

@@ -0,0 +1,433 @@
+# frozen_string_literal: true
+require_relative "../../../requests"
+require_relative "types/forms_generate_w2response"
+require_relative "../../forms/types/form"
+require "json"
+require_relative "../../types/form_pdf"
+require "async"
+require "async"
+require "async"
+require "async"
+require "async"
+require_relative "../../../requests"
+
+module Gusto
+  module Employees
+    class FormsClient
+    # @return [Gusto::RequestClient] 
+      attr_reader :request_client
+
+
+      # @param request_client [Gusto::RequestClient] 
+      # @return [Gusto::Employees::FormsClient]
+      def initialize(request_client:)
+        @request_client = request_client
+      end
+# > 🚧 Demo action
+#  >
+#  > This action is only available in the Demo environment
+#  Generates a W2 document for testing purposes.
+#  scope: `employees:write`
+      #
+      # @param employee_id [String] The employee UUID.
+      # @param year [Integer] Must be equal to or more recent than 2015. If not specified, defaults to the
+#  previous year.
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::Employees::Forms::FormsGenerateW2Response]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.forms.generate_w2(employee_id: "employee_id")
+      def generate_w2(employee_id:, year: nil, request_options: nil)
+        response = @request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), employee_id: employee_id, year: year }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/sandbox/generate_w2"
+end
+        Gusto::Employees::Forms::FormsGenerateW2Response.from_json(json_object: response.body)
+      end
+# Get a list of all employee's forms
+#  scope: `employee_forms:read`
+      #
+      # @param employee_id [String] The UUID of the employee
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Array<Gusto::Forms::Form>]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.forms.list(employee_id: "employee_id")
+      def list(employee_id:, request_options: nil)
+        response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employees/#{employee_id}/forms"
+end
+        parsed_json = JSON.parse(response.body)
+        parsed_json&.map do | item |
+          item = item.to_json
+          Gusto::Forms::Form.from_json(json_object: item)
+        end
+      end
+# Get an employee form
+#  scope: `employee_forms:read`
+      #
+      # @param employee_id [String] The UUID of the employee
+      # @param form_id [String] The UUID of the form
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::Forms::Form]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.forms.get(employee_id: "employee_id", form_id: "form_id")
+      def get(employee_id:, form_id:, request_options: nil)
+        response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employees/#{employee_id}/forms/#{form_id}"
+end
+        Gusto::Forms::Form.from_json(json_object: response.body)
+      end
+# Get the link to the form PDF
+#  scope: `employee_forms:read`
+      #
+      # @param employee_id [String] The UUID of the employee
+      # @param form_id [String] The UUID of the form
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::FormPdf]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.forms.get_pdf(employee_id: "employee_id", form_id: "form_id")
+      def get_pdf(employee_id:, form_id:, request_options: nil)
+        response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employees/#{employee_id}/forms/#{form_id}/pdf"
+end
+        Gusto::FormPdf.from_json(json_object: response.body)
+      end
+# Sign an employee form
+#  scope: `employee_forms:sign`
+      #
+      # @param employee_id [String] The UUID of the employee
+      # @param form_id [String] The UUID of the form
+      # @param signature_text [String] The signature
+      # @param agree [Boolean] whether you agree to sign electronically
+      # @param signed_by_ip_address [String] The IP address of the signatory who signed the form.
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::Forms::Form]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.forms.sign(
+#    employee_id: "employee_id",
+#    form_id: "form_id",
+#    signature_text: "Jane Smith",
+#    agree: true,
+#    signed_by_ip_address: "192.168.0.1"
+#  )
+      def sign(employee_id:, form_id:, signature_text:, agree:, signed_by_ip_address:, request_options: nil)
+        response = @request_client.conn.put do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), signature_text: signature_text, agree: agree, signed_by_ip_address: signed_by_ip_address }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employees/#{employee_id}/forms/#{form_id}/sign"
+end
+        Gusto::Forms::Form.from_json(json_object: response.body)
+      end
+    end
+    class AsyncFormsClient
+    # @return [Gusto::AsyncRequestClient] 
+      attr_reader :request_client
+
+
+      # @param request_client [Gusto::RequestClient] 
+      # @return [Gusto::Employees::AsyncFormsClient]
+      def initialize(request_client:)
+        @request_client = request_client
+      end
+# > 🚧 Demo action
+#  >
+#  > This action is only available in the Demo environment
+#  Generates a W2 document for testing purposes.
+#  scope: `employees:write`
+      #
+      # @param employee_id [String] The employee UUID.
+      # @param year [Integer] Must be equal to or more recent than 2015. If not specified, defaults to the
+#  previous year.
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::Employees::Forms::FormsGenerateW2Response]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.forms.generate_w2(employee_id: "employee_id")
+      def generate_w2(employee_id:, year: nil, request_options: nil)
+        Async do
+          response = @request_client.conn.post do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), employee_id: employee_id, year: year }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/sandbox/generate_w2"
+end
+          Gusto::Employees::Forms::FormsGenerateW2Response.from_json(json_object: response.body)
+        end
+      end
+# Get a list of all employee's forms
+#  scope: `employee_forms:read`
+      #
+      # @param employee_id [String] The UUID of the employee
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Array<Gusto::Forms::Form>]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.forms.list(employee_id: "employee_id")
+      def list(employee_id:, request_options: nil)
+        Async do
+          response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employees/#{employee_id}/forms"
+end
+          parsed_json = JSON.parse(response.body)
+          parsed_json&.map do | item |
+            item = item.to_json
+            Gusto::Forms::Form.from_json(json_object: item)
+          end
+        end
+      end
+# Get an employee form
+#  scope: `employee_forms:read`
+      #
+      # @param employee_id [String] The UUID of the employee
+      # @param form_id [String] The UUID of the form
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::Forms::Form]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.forms.get(employee_id: "employee_id", form_id: "form_id")
+      def get(employee_id:, form_id:, request_options: nil)
+        Async do
+          response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employees/#{employee_id}/forms/#{form_id}"
+end
+          Gusto::Forms::Form.from_json(json_object: response.body)
+        end
+      end
+# Get the link to the form PDF
+#  scope: `employee_forms:read`
+      #
+      # @param employee_id [String] The UUID of the employee
+      # @param form_id [String] The UUID of the form
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::FormPdf]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.forms.get_pdf(employee_id: "employee_id", form_id: "form_id")
+      def get_pdf(employee_id:, form_id:, request_options: nil)
+        Async do
+          response = @request_client.conn.get do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  unless request_options.nil? || request_options&.additional_body_parameters.nil?
+    req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+  end
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employees/#{employee_id}/forms/#{form_id}/pdf"
+end
+          Gusto::FormPdf.from_json(json_object: response.body)
+        end
+      end
+# Sign an employee form
+#  scope: `employee_forms:sign`
+      #
+      # @param employee_id [String] The UUID of the employee
+      # @param form_id [String] The UUID of the form
+      # @param signature_text [String] The signature
+      # @param agree [Boolean] whether you agree to sign electronically
+      # @param signed_by_ip_address [String] The IP address of the signatory who signed the form.
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::Forms::Form]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.employees.forms.sign(
+#    employee_id: "employee_id",
+#    form_id: "form_id",
+#    signature_text: "Jane Smith",
+#    agree: true,
+#    signed_by_ip_address: "192.168.0.1"
+#  )
+      def sign(employee_id:, form_id:, signature_text:, agree:, signed_by_ip_address:, request_options: nil)
+        Async do
+          response = @request_client.conn.put do | req |
+  unless request_options&.timeout_in_seconds.nil?
+    req.options.timeout = request_options.timeout_in_seconds
+  end
+  unless request_options&.token.nil?
+    req.headers["Authorization"] = request_options.token
+  end
+  unless request_options&.gusto_api_version.nil?
+    req.headers["X-Gusto-API-Version"] = request_options.gusto_api_version
+  end
+  req.headers = { **(req.headers || {}), **@request_client.get_headers, **(request_options&.additional_headers || {}) }.compact
+  unless request_options.nil? || request_options&.additional_query_parameters.nil?
+    req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+  end
+  req.body = { **(request_options&.additional_body_parameters || {}), signature_text: signature_text, agree: agree, signed_by_ip_address: signed_by_ip_address }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/employees/#{employee_id}/forms/#{form_id}/sign"
+end
+          Gusto::Forms::Form.from_json(json_object: response.body)
+        end
+      end
+    end
+  end
+end

data/lib/fern_gusto/employees/forms/types/forms_generate_w2response.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+require "ostruct"
+require "json"
+
+module Gusto
+  module Employees
+    module Forms
+      class FormsGenerateW2Response
+      # @return [String] The UUID of the employee
+        attr_reader :employee_uuid
+      # @return [String] The UUID of the form
+        attr_reader :uuid
+      # @return [String] The type identifier of the form
+        attr_reader :name
+      # @return [String] The title of the form
+        attr_reader :title
+      # @return [String] The description of the form
+        attr_reader :description
+      # @return [Boolean] If the form is in a draft state. E.g. End of year tax forms may be provided in a
+#  draft state prior to being finalized.
+        attr_reader :draft
+      # @return [Integer] The year of this form. For some forms, e.g. tax forms, this is the year which
+#  the form represents. A W2 for January - December 2022 would be delivered in
+#  January 2023 and have a year value of 2022. This value is nullable and will not
+#  be present on all forms.
+        attr_reader :year
+      # @return [Integer] The quarter of this form. For some forms, e.g. tax forms, this is the calendar
+#  quarter which this form represents. An Employer's Quarterly Federal Tax Return
+#  (Form 941) for April, May, June 2022 would have a quarter value of 2 (and a year
+#  value of 2022). This value is nullable and will not be present on all forms.
+        attr_reader :quarter
+      # @return [Boolean] A boolean flag that indicates whether the form needs signing or not. Note that
+#  this value will change after the form is signed.
+        attr_reader :requires_signing
+      # @return [OpenStruct] Additional properties unmapped to the current class definition
+        attr_reader :additional_properties
+      # @return [Object] 
+        attr_reader :_field_set
+        protected :_field_set
+
+        OMIT = Object.new
+
+        # @param employee_uuid [String] The UUID of the employee
+        # @param uuid [String] The UUID of the form
+        # @param name [String] The type identifier of the form
+        # @param title [String] The title of the form
+        # @param description [String] The description of the form
+        # @param draft [Boolean] If the form is in a draft state. E.g. End of year tax forms may be provided in a
+#  draft state prior to being finalized.
+        # @param year [Integer] The year of this form. For some forms, e.g. tax forms, this is the year which
+#  the form represents. A W2 for January - December 2022 would be delivered in
+#  January 2023 and have a year value of 2022. This value is nullable and will not
+#  be present on all forms.
+        # @param quarter [Integer] The quarter of this form. For some forms, e.g. tax forms, this is the calendar
+#  quarter which this form represents. An Employer's Quarterly Federal Tax Return
+#  (Form 941) for April, May, June 2022 would have a quarter value of 2 (and a year
+#  value of 2022). This value is nullable and will not be present on all forms.
+        # @param requires_signing [Boolean] A boolean flag that indicates whether the form needs signing or not. Note that
+#  this value will change after the form is signed.
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [Gusto::Employees::Forms::FormsGenerateW2Response]
+        def initialize(employee_uuid: OMIT, uuid:, name: OMIT, title: OMIT, description: OMIT, draft: OMIT, year: OMIT, quarter: OMIT, requires_signing: OMIT, additional_properties: nil)
+          @employee_uuid = employee_uuid if employee_uuid != OMIT
+          @uuid = uuid
+          @name = name if name != OMIT
+          @title = title if title != OMIT
+          @description = description if description != OMIT
+          @draft = draft if draft != OMIT
+          @year = year if year != OMIT
+          @quarter = quarter if quarter != OMIT
+          @requires_signing = requires_signing if requires_signing != OMIT
+          @additional_properties = additional_properties
+          @_field_set = { "employee_uuid": employee_uuid, "uuid": uuid, "name": name, "title": title, "description": description, "draft": draft, "year": year, "quarter": quarter, "requires_signing": requires_signing }.reject do | _k, v |
+  v == OMIT
+end
+        end
+# Deserialize a JSON object to an instance of FormsGenerateW2Response
+        #
+        # @param json_object [String] 
+        # @return [Gusto::Employees::Forms::FormsGenerateW2Response]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          employee_uuid = parsed_json["employee_uuid"]
+          uuid = parsed_json["uuid"]
+          name = parsed_json["name"]
+          title = parsed_json["title"]
+          description = parsed_json["description"]
+          draft = parsed_json["draft"]
+          year = parsed_json["year"]
+          quarter = parsed_json["quarter"]
+          requires_signing = parsed_json["requires_signing"]
+          new(
+            employee_uuid: employee_uuid,
+            uuid: uuid,
+            name: name,
+            title: title,
+            description: description,
+            draft: draft,
+            year: year,
+            quarter: quarter,
+            requires_signing: requires_signing,
+            additional_properties: struct
+          )
+        end
+# Serialize an instance of FormsGenerateW2Response to a JSON object
+        #
+        # @return [String]
+        def to_json
+          @_field_set&.to_json
+        end
+# Leveraged for Union-type generation, validate_raw attempts to parse the given
+#  hash and check each fields type against the current object's property
+#  definitions.
+        #
+        # @param obj [Object] 
+        # @return [Void]
+        def self.validate_raw(obj:)
+          obj.employee_uuid&.is_a?(String) != false || raise("Passed value for field obj.employee_uuid is not the expected type, validation failed.")
+          obj.uuid.is_a?(String) != false || raise("Passed value for field obj.uuid is not the expected type, validation failed.")
+          obj.name&.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+          obj.title&.is_a?(String) != false || raise("Passed value for field obj.title is not the expected type, validation failed.")
+          obj.description&.is_a?(String) != false || raise("Passed value for field obj.description is not the expected type, validation failed.")
+          obj.draft&.is_a?(Boolean) != false || raise("Passed value for field obj.draft is not the expected type, validation failed.")
+          obj.year&.is_a?(Integer) != false || raise("Passed value for field obj.year is not the expected type, validation failed.")
+          obj.quarter&.is_a?(Integer) != false || raise("Passed value for field obj.quarter is not the expected type, validation failed.")
+          obj.requires_signing&.is_a?(Boolean) != false || raise("Passed value for field obj.requires_signing is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end