entrata 1.1.0 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2316690e03ac91b2580dbaab63c56ac93afc70eaef268c787d206aba024a484f
-  data.tar.gz: 574ed8030e63871b2cb1a59afd3e5ea25a57a995b790ba5a2a6c606aa3965db3
+  metadata.gz: b67937a35dbe94da3aba8e507c91ce2071c501f4d6749b13c5cb8a61259bb01a
+  data.tar.gz: 18c7849a9e00d6a56f49d2b96258a42cee3a3aa59ec872e4aa102253df832128
 SHA512:
-  metadata.gz: 678ea4ce2d8dbf797263d707df80c21351f26085c6e690d5024a23a346c52a272695f049e23c3a74cf536ff96257156878c9ba019ee050d62046f42ace087fe2
-  data.tar.gz: e92102c9060201f39c692dbac217f27b77b60d131ac5ff12d33b639453225d728fd02c6b1548bad0423b12a04be91820e495d5e4736bd76498ec1ddf4b4d7c64
+  metadata.gz: 63f260606f1f0304ac1d53f582a20164eedd85e8fb7d4e20b5b778800b393c297827799287a759f0c8400f1b4a98e9c2108415461a7192d446d90e197404346b
+  data.tar.gz: 85c40e922e28e6322db5a92508238a326fd2d2e74c393a1448b75726ba67913a11ee06a4b601d7e05737f9bce20dea62aab61420d11fd5cf92c67e99ab710417

data/README.md

@@ -17,6 +17,8 @@ Ruby client for Entrata API
 * 1.0.4 Make entrata gem compatible with Ruby 3 syntax updates
 * 1.0.5 No functional changes. Updating build pipeline to publish to GitHub Packages.
 * 1.1.0 Adding services to manage lea lite inactive and reactive guestcard requests.
+* 1.2.0 Adding services to manage lea lite general guestcard requests.
+* 1.2.1 Using mountain time in reactivate guestcard flow.
 
 ## Installation
 

data/lib/entrata/client.rb

@@ -5,8 +5,9 @@ require 'entrata/request/get_client_info'
 require 'entrata/request/get_ils_properties_data'
 require 'entrata/request/get_property_info'
 require 'entrata/request/process_property_activation'
-require 'entrata/request/send_lead_details'
+require 'entrata/request/send_general_leads'
 require 'entrata/request/send_inactive_leads'
+require 'entrata/request/send_lead_details'
 require 'entrata/request/send_reactivate_leads'
 
 # Client to access all API resources through
@@ -79,6 +80,17 @@ module Entrata
       ).perform
     end
 
+    def send_general_leads(customer:, lead_source_id:, preferences:, property_id:)
+      byebug
+      Request::SendGeneralLeads.new(
+        conn: basic_auth_conn,
+        customer: customer,
+        lead_source_id: lead_source_id,
+        preferences: preferences,
+        property_id: property_id
+      ).perform
+    end
+
     def send_reactivate_leads(applicant_id:, application_id:, customer:, preferences:, property_id:)
       Request::SendReactivateLeads.new(
         conn: basic_auth_conn,

data/lib/entrata/request/send_general_leads.rb

@@ -0,0 +1,89 @@
+require 'entrata/request/base'
+
+module Entrata
+  module Request
+    # the general Entrata API that we have access to through the drive team.
+    # Used for adding leads through the general API that don't go through the inactive/reactivate flow
+    class SendGeneralLeads < Base
+      # Preferences are optional for inserting a lead into Entrata.
+      def after_initialize(customer:, lead_source_id:, preferences:, property_id:)
+        @customer = customer
+        @lead_source_id = lead_source_id
+        @preferences = preferences
+        @property_id = property_id
+      end
+
+      def resource_auth
+        { type: 'basic' }
+      end
+
+      def resource_name
+        'sendLeads'
+      end
+
+      def resource_path
+        '/api/leads'
+      end
+
+      def body
+        {
+          auth: resource_auth,
+          requestId: '15', # used in all requests for Lea(SA) product
+          method: {
+            name: resource_name,
+            params: resource_params
+          }
+        }.to_json
+      end
+
+      def resource_params
+        # all dates and times used in the API are assumed to be in Mountain Time (MST or MDT)
+        five_minutes_ago = 5.minutes.ago.in_time_zone('America/Denver').strftime('%m/%d/%YT%H:%M:%S')
+        {
+          propertyId: property_id, # Entrata remote property ID
+          doNotSendConfirmationEmail: '1', # Suppress email to renter - need to validate
+          isWaitList: '0',
+          prospects: {
+            prospect: [
+              {
+                leadSource: {
+                  originatingLeadSourceId: lead_source_id # ApartmentList source ID to be acquired during onboarding
+                },
+                createdDate: five_minutes_ago, # Now - 5 minutes
+                customers: { # Renter details
+                  customer: [
+                    {
+                      name: {
+                        firstName: customer.first_name,
+                        lastName: customer.last_name
+                      },
+                      phone: {
+                        cellPhoneNumber: customer.phone
+                      },
+                      email: customer.email
+                    }
+                  ]
+                },
+                customerPreferences: {
+                  desiredMoveInDate: formatted_move_in_date,
+                  comment: preferences.comments,
+                  desiredNumBedrooms: preferences.beds
+                }
+              }
+            ]
+          }
+        }
+      end
+
+      private
+
+      attr_reader :customer, :preferences, :property_id, :lead_source_id
+
+      # Entrata needs mm/dd/yyyy format for move in dates and will respond with
+      # an error if we send them a format they don't like.
+      def formatted_move_in_date
+        preferences.move_in_date.strftime('%m/%d/%Y')
+      end
+    end
+  end
+end

data/lib/entrata/request/send_reactivate_leads.rb

@@ -39,7 +39,7 @@ module Entrata
 
       def resource_params
         # all dates and times used in the API are assumed to be in Mountain Time (MST or MDT)
-        five_minutes_ago = 5.minutes.ago.strftime('%m/%d/%YT%H:%M:%S')
+        five_minutes_ago = 5.minutes.ago.in_time_zone('America/Denver').strftime('%m/%d/%YT%H:%M:%S')
         {
           propertyId: property_id, # Entrata remote property ID
           doNotSendConfirmationEmail: '1', # Suppress email to renter - need to validate

data/lib/entrata/test_client.rb

@@ -61,7 +61,12 @@ module Entrata
 
     def send_inactive_leads(customer:, lead_source_id:, leasing_agent_id:, preferences:, property_id:)
       raise_forced_failure! if property_id == 'fail'
-      StaticFileFetcher.parsed_response_for('send_lead_details')
+      StaticFileFetcher.parsed_response_for('send_inactive_leads')
+    end
+
+    def send_general_leads(customer:, lead_source_id:, preferences:, property_id:)
+      raise_forced_failure! if property_id == 'fail'
+      StaticFileFetcher.parsed_response_for('send_general_leads')
     end
 
     def send_reactivate_leads(applicant_id:, application_id:, customer:, preferences:, property_id:)

data/lib/entrata/version.rb

@@ -1,3 +1,3 @@
 module Entrata
-  VERSION = '1.1.0'
+  VERSION = '1.2.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: entrata
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.1
 platform: ruby
 authors:
 - Justin Richard
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-10-11 00:00:00.000000000 Z
+date: 2022-10-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -136,6 +136,7 @@ files:
 - lib/entrata/request/get_ils_properties_data.rb
 - lib/entrata/request/get_property_info.rb
 - lib/entrata/request/process_property_activation.rb
+- lib/entrata/request/send_general_leads.rb
 - lib/entrata/request/send_inactive_leads.rb
 - lib/entrata/request/send_lead_details.rb
 - lib/entrata/request/send_reactivate_leads.rb