Overview
The following document describes the steps to update Updater's current configuration within your Yardi database to allow for import of documents/attachments & adding pet information. Additionally, an overview of how the Bi-Directional Workflow process works.
How does our bi-directional workflow work?
When Bi-Directional Workflow has been set up in both Updater & Yardi, the workflow will execute upon approval of the Resident's task in UPDATER PRO. The approval triggers the integration to push the documents & pet information to your Yardi database.
- Note - Only invites that are created after Resident Onboarding has been enabled will be eligible for Bi-Directional Workflow.
Type of Attachments
- Registering Vehicle
- Proof of Renters insurance
- Move-in Costs Confirmation
- Proof of Gas
- Proof of Water
- Proof of Electric
- Pet Information
- Proof of Vaccination
- Photo
Additionally, for Pet information, the system will add to the pet fields under the personal info tab with the following information.
Pet's Name, Weight, Age & Breed
How to Setup Yardi Bi-Directional Workflow
Question: Why am I being asked to make changes in Yardi related to Attachment Types?
Short-ish Answer: Updater’s UPO application allows your incoming tenants to attach information regarding their renter’s insurance, pets, and vehicles which then gets sent into Yardi. To do this we need to make sure that we have either a new attachment type created with read/write access or use an existing attachment type that has the correct read/write access.
Updating the Updater Configuration
Updater uses the common data interface API calls ImportTenantLeaseDocumentExt and UpdateResidentData in order to send documents into Yardi. Therefore, we need access to attachment types to be set up in the common data interface. We are looking to have attachmenttype: attachment created for Tenant and Roommate. This is OUR default. However, if you or your Yardi support team has already created some attachment types that we have "write" access to, then we can use those. Please let your Updater IM/CSM know what those attachment types would be.
Currently, our Updater configuration does not have the sufficient access needed for our Bi-Directional workflow, so it will need to be updated to accommodate the ability for importing Documents & posting Pet information. Therefore the Updater Vendor Configurations/Security will need to be updated to the following;
Yardi 7S Requirements
- Voyager 7S with InterfacesPIv24.1, InterfacesILSGuestCardPIv23, and InterfacesCommonDataPIv21 (although v19 works) or higher are required to complete integration
- Your Yardi account manager can determine if you have the correct Interfaces Plug-in version and assist you with implementation if needed.
- You must have System Administrator access to complete this setup
Configure Updater Vendor for Common Data Interface
Configure Updater Vendor for ILS/Guest Card Interface
-
- Go to Interfaces from the side menu, select Configuration select Review Interface Vendors
- Choose ILS/Guest Card from Entity Type drop-down
- Submit
- Select Updater from the available vendors list
- Select the following ILS/Guest Card Options:
- Activity in the last: 30 days
- Schema: v4.0
- Floor plan: Unchecked
- Export all guest cards: Checked
- Export federal identification: Unchecked
- Update prospect agent: Unchecked
- Import/Export Types: Select All for both tenant and prospect
- Save
Setup Interface User for Updater
- Create security user group - if not already created
- Link user group to menu set - if not already created
- Set permissions as follows:
- Permission level: Most Restrictive
- Access type: Read/Write
Configure Properties for Updater
- Select Interfaces, select Configuration, select Bulk Property Configuration
- Select the property list you created for Updater
- Select interface type ILS/Guest Card
- Select Updater from Available Agencies
- Save
- Access type: Read/Write
Configure Updater Vendor for Common Data Interface
- Go to Interfaces, select Configuration, select Review Interface Vendors
- Choose Common Data from Entity Type drop-down
- Adjust Display Rows to 500
- Submit
- Select Updater from the available vendors list
- Select the following Common Data Configuration settings:
- Ignore Exclude Units Flag: Unchecked
- Export Document Number: Unchecked
- Permission Access:
- Name: Read
- Address: Read
- Phone Numbers: Read
- SSN: None
- Vehicle:Read/Write
- Ledger: None
- Lease Charges: None
- Lease Offers: Read
- Scheduled Lease Renewals: Read
- Rentable Items: None
- User Defined: Read
- Pets: Read/Write
- Date of Birth: None
- Driver's License: Read/Write
- Email: Read *IMPORTANT to not skip this step
- Import/Export Attachment Types (select following):
- Roommate Attachment
- Tenant Attachment
- If you do not see these Attachment types available, then they will need to be added;
- To do this: Select System > Attachment Types.
- In Object Type field, select an object type Tenant.
- In the Description field, type Attachment.
- In a new blank Object Type field, select an object type Roommate.
- In the corresponding Description field, type Attachment.
- If you do not see these Attachment types available, then they will need to be added;
- If other or custom Attachment Types have already been created and are used in lieu of Roommate or Tenant Attachment Types, please communicate this with your onboarding specialist.
- Click Save.
- Save
Here’s what “Roommate - Attachment” and “Tenant - Attachment” look like in our sandbox environment highlighted in blue.
What Happens When Yardi Bi-Directional Workflow Goes Live?
Since the workflow is dependent on when an eligible Resident uploads a document that needs to be approved by a site user in Updater Pro, we will monitor for successful transmissions of the documents over the weeks following going live and provide follow up to you. Within Yardi, all documents should be visible associated with the primary lease holder.