fern_gusto 0.0.6.pre.alpha6

data/lib/fern_gusto/contractors/documents/client.rb

@@ -0,0 +1,269 @@
+# frozen_string_literal: true
+require_relative "../../../requests"
+require_relative "../../documents/types/document"
+require_relative "../../types/document_pdf"
+require_relative "types/documents_sign_request_fields_item"
+require_relative "../../documents/types/document_signed"
+require "async"
+require "async"
+require "async"
+require_relative "../../../requests"
+
+module Gusto
+  module Contractors
+    class DocumentsClient
+    # @return [Gusto::RequestClient] 
+      attr_reader :request_client
+
+
+      # @param request_client [Gusto::RequestClient] 
+      # @return [Gusto::Contractors::DocumentsClient]
+      def initialize(request_client:)
+        @request_client = request_client
+      end
+# Get a contractor document.
+#  scope: `contractor_documents:read`
+      #
+      # @param document_uuid [String] The ID or UUID of the document
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::Documents::Document]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.contractors.documents.get(document_uuid: "document_uuid")
+      def get(document_uuid:, 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/documents/#{document_uuid}"
+end
+        Gusto::Documents::Document.from_json(json_object: response.body)
+      end
+# Get the contractor document pdf.
+#  scope: `contractor_documents:read`
+      #
+      # @param document_uuid [String] The ID or UUID of the document
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::DocumentPdf]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.contractors.documents.get_pdf(document_uuid: "document_uuid")
+      def get_pdf(document_uuid:, 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/documents/#{document_uuid}/pdf"
+end
+        Gusto::DocumentPdf.from_json(json_object: response.body)
+      end
+# Sign a contractor document.
+#  scope: `contractor_documents:write`
+      #
+      # @param document_uuid [String] The ID or UUID of the document
+      # @param fields [Array<Hash>] List of fields and the values they will be set to.Request of type Array<Gusto::Contractors::Documents::DocumentsSignRequestFieldsItem>, as a Hash
+      #   * :key (String) 
+      #   * :value (String) 
+      # @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::Documents::DocumentSigned]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.contractors.documents.sign(
+#    document_uuid: "document_uuid",
+#    fields: [{  }],
+#    agree: true,
+#    signed_by_ip_address: "signed_by_ip_address"
+#  )
+      def sign(document_uuid:, fields:, 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 || {}), fields: fields, agree: agree, signed_by_ip_address: signed_by_ip_address }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/documents/#{document_uuid}/sign"
+end
+        Gusto::Documents::DocumentSigned.from_json(json_object: response.body)
+      end
+    end
+    class AsyncDocumentsClient
+    # @return [Gusto::AsyncRequestClient] 
+      attr_reader :request_client
+
+
+      # @param request_client [Gusto::RequestClient] 
+      # @return [Gusto::Contractors::AsyncDocumentsClient]
+      def initialize(request_client:)
+        @request_client = request_client
+      end
+# Get a contractor document.
+#  scope: `contractor_documents:read`
+      #
+      # @param document_uuid [String] The ID or UUID of the document
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::Documents::Document]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.contractors.documents.get(document_uuid: "document_uuid")
+      def get(document_uuid:, 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/documents/#{document_uuid}"
+end
+          Gusto::Documents::Document.from_json(json_object: response.body)
+        end
+      end
+# Get the contractor document pdf.
+#  scope: `contractor_documents:read`
+      #
+      # @param document_uuid [String] The ID or UUID of the document
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::DocumentPdf]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.contractors.documents.get_pdf(document_uuid: "document_uuid")
+      def get_pdf(document_uuid:, 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/documents/#{document_uuid}/pdf"
+end
+          Gusto::DocumentPdf.from_json(json_object: response.body)
+        end
+      end
+# Sign a contractor document.
+#  scope: `contractor_documents:write`
+      #
+      # @param document_uuid [String] The ID or UUID of the document
+      # @param fields [Array<Hash>] List of fields and the values they will be set to.Request of type Array<Gusto::Contractors::Documents::DocumentsSignRequestFieldsItem>, as a Hash
+      #   * :key (String) 
+      #   * :value (String) 
+      # @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::Documents::DocumentSigned]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.contractors.documents.sign(
+#    document_uuid: "document_uuid",
+#    fields: [{  }],
+#    agree: true,
+#    signed_by_ip_address: "signed_by_ip_address"
+#  )
+      def sign(document_uuid:, fields:, 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 || {}), fields: fields, agree: agree, signed_by_ip_address: signed_by_ip_address }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/documents/#{document_uuid}/sign"
+end
+          Gusto::Documents::DocumentSigned.from_json(json_object: response.body)
+        end
+      end
+    end
+  end
+end

data/lib/fern_gusto/contractors/documents/types/documents_sign_request_fields_item.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+require "ostruct"
+require "json"
+
+module Gusto
+  module Contractors
+    module Documents
+      class DocumentsSignRequestFieldsItem
+      # @return [String] Unique identifier of the field
+        attr_reader :key
+      # @return [String] Value for the field
+        attr_reader :value
+      # @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 key [String] Unique identifier of the field
+        # @param value [String] Value for the field
+        # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+        # @return [Gusto::Contractors::Documents::DocumentsSignRequestFieldsItem]
+        def initialize(key: OMIT, value: OMIT, additional_properties: nil)
+          @key = key if key != OMIT
+          @value = value if value != OMIT
+          @additional_properties = additional_properties
+          @_field_set = { "key": key, "value": value }.reject do | _k, v |
+  v == OMIT
+end
+        end
+# Deserialize a JSON object to an instance of DocumentsSignRequestFieldsItem
+        #
+        # @param json_object [String] 
+        # @return [Gusto::Contractors::Documents::DocumentsSignRequestFieldsItem]
+        def self.from_json(json_object:)
+          struct = JSON.parse(json_object, object_class: OpenStruct)
+          parsed_json = JSON.parse(json_object)
+          key = parsed_json["key"]
+          value = parsed_json["value"]
+          new(
+            key: key,
+            value: value,
+            additional_properties: struct
+          )
+        end
+# Serialize an instance of DocumentsSignRequestFieldsItem 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.key&.is_a?(String) != false || raise("Passed value for field obj.key is not the expected type, validation failed.")
+          obj.value&.is_a?(String) != false || raise("Passed value for field obj.value is not the expected type, validation failed.")
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,343 @@
+# frozen_string_literal: true
+require_relative "../../../requests"
+require_relative "../../forms/types/form1099"
+require "json"
+require_relative "../../types/form_pdf"
+require "async"
+require "async"
+require "async"
+require "async"
+require_relative "../../../requests"
+
+module Gusto
+  module Contractors
+    class FormsClient
+    # @return [Gusto::RequestClient] 
+      attr_reader :request_client
+
+
+      # @param request_client [Gusto::RequestClient] 
+      # @return [Gusto::Contractors::FormsClient]
+      def initialize(request_client:)
+        @request_client = request_client
+      end
+# Get a list of all contractor's forms
+#  scope: `contractor_forms:read`
+      #
+      # @param contractor_uuid [String] The UUID of the contractor
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Array<Gusto::Forms::Form1099>]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.contractors.forms.get(contractor_uuid: "contractor_uuid")
+      def get(contractor_uuid:, 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/contractors/#{contractor_uuid}/forms"
+end
+        parsed_json = JSON.parse(response.body)
+        parsed_json&.map do | item |
+          item = item.to_json
+          Gusto::Forms::Form1099.from_json(json_object: item)
+        end
+      end
+# Get a contractor form
+#  scope: `contractor_forms:read`
+      #
+      # @param contractor_uuid [String] The UUID of the contractor
+      # @param form_id [String] The UUID of the form
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::Forms::Form1099]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.contractors.forms.list(contractor_uuid: "contractor_uuid", form_id: "form_id")
+      def list(contractor_uuid:, 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/contractors/#{contractor_uuid}/forms/#{form_id}"
+end
+        Gusto::Forms::Form1099.from_json(json_object: response.body)
+      end
+# Get the link to the form PDF
+#  scope: `contractor_forms:read`
+      #
+      # @param contractor_uuid [String] The UUID of the contractor
+      # @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.contractors.forms.get_pdf(contractor_uuid: "contractor_uuid", form_id: "form_id")
+      def get_pdf(contractor_uuid:, 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/contractors/#{contractor_uuid}/forms/#{form_id}/pdf"
+end
+        Gusto::FormPdf.from_json(json_object: response.body)
+      end
+# > 🚧 Demo action
+#  >
+#  > This action is only available in the Demo environment
+#  Generates a 1099 document for testing purposes.
+#  scope: `contractors:write`
+      #
+      # @param contractor_id [String] The contractor 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::Forms::Form1099]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.contractors.forms.generate1099(contractor_id: "contractor_id")
+      def generate1099(contractor_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 || {}), contractor_id: contractor_id, year: year }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/sandbox/generate_1099"
+end
+        Gusto::Forms::Form1099.from_json(json_object: response.body)
+      end
+    end
+    class AsyncFormsClient
+    # @return [Gusto::AsyncRequestClient] 
+      attr_reader :request_client
+
+
+      # @param request_client [Gusto::RequestClient] 
+      # @return [Gusto::Contractors::AsyncFormsClient]
+      def initialize(request_client:)
+        @request_client = request_client
+      end
+# Get a list of all contractor's forms
+#  scope: `contractor_forms:read`
+      #
+      # @param contractor_uuid [String] The UUID of the contractor
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Array<Gusto::Forms::Form1099>]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.contractors.forms.get(contractor_uuid: "contractor_uuid")
+      def get(contractor_uuid:, 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/contractors/#{contractor_uuid}/forms"
+end
+          parsed_json = JSON.parse(response.body)
+          parsed_json&.map do | item |
+            item = item.to_json
+            Gusto::Forms::Form1099.from_json(json_object: item)
+          end
+        end
+      end
+# Get a contractor form
+#  scope: `contractor_forms:read`
+      #
+      # @param contractor_uuid [String] The UUID of the contractor
+      # @param form_id [String] The UUID of the form
+      # @param request_options [Gusto::RequestOptions] 
+      # @return [Gusto::Forms::Form1099]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.contractors.forms.list(contractor_uuid: "contractor_uuid", form_id: "form_id")
+      def list(contractor_uuid:, 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/contractors/#{contractor_uuid}/forms/#{form_id}"
+end
+          Gusto::Forms::Form1099.from_json(json_object: response.body)
+        end
+      end
+# Get the link to the form PDF
+#  scope: `contractor_forms:read`
+      #
+      # @param contractor_uuid [String] The UUID of the contractor
+      # @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.contractors.forms.get_pdf(contractor_uuid: "contractor_uuid", form_id: "form_id")
+      def get_pdf(contractor_uuid:, 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/contractors/#{contractor_uuid}/forms/#{form_id}/pdf"
+end
+          Gusto::FormPdf.from_json(json_object: response.body)
+        end
+      end
+# > 🚧 Demo action
+#  >
+#  > This action is only available in the Demo environment
+#  Generates a 1099 document for testing purposes.
+#  scope: `contractors:write`
+      #
+      # @param contractor_id [String] The contractor 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::Forms::Form1099]
+      # @example
+#  api = Gusto::Client.new(
+#    base_url: "https://api.example.com",
+#    environment: Gusto::Environment::DEMO,
+#    token: "YOUR_AUTH_TOKEN"
+#  )
+#  api.contractors.forms.generate1099(contractor_id: "contractor_id")
+      def generate1099(contractor_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 || {}), contractor_id: contractor_id, year: year }.compact
+  req.url "#{@request_client.get_url(request_options: request_options)}/v1/sandbox/generate_1099"
+end
+          Gusto::Forms::Form1099.from_json(json_object: response.body)
+        end
+      end
+    end
+  end
+end