Bulk Actions in AgentSync Manage

If you are to looking expedite some of your daily tasks in Manage, like Onboarding Producers, Appointing Producers, Terminating Appointments, Adding Producer Assignments or Inviting Agents to the Portal, this article is for you!

Many of the actions you take in AgentSync Manage can be done in bulk! This article walks through all of our bulk processes to help save you even more time. 

Click on the link to jump to the desired section:

• Bulk Onboard Producers
• Bulk Onboard Producers with Producer Assignments
• Bulk Appoint Utility in Manage
• Bulk Appoint Eligibility Reasons Dictionary
• Bulk Terminate Appointments
• Bulk Invite Agents to the Portal

Bulk Onboard Producers

Onboarding producers one-by-one is great, until you have a new hiring class. This section walks you through how to upload your producers in bulk.

Step 1: Navigate to the AgentSync CSV Import object in Manage

Step 2: From the Select an Upload type dropdown, select Agent

Step 3: Click the blue here link in the description to download the CSV template that must be used for the upload

Step 4: Add the following information for each of your producers:

• Agency NPN
• First Name
• Last Name
• Agent NPN
• Agent Email (optional)
• Agent SSN (optional)

Step 5: After all the data is entered into the template, save the document as a CSV file

Step 6: Navigate back to the AgentSync CSV Import tab in Manage

Step 7: Click the Upload Files button and upload the CSV file you just saved

Step 8: Click Parse 1 File

Step 9: Click Process Rows to upload agents

You did it!  Now that your agents are added, they are synced with NIPR and you will receive daily updates for these producers.

 

Watch a video of this process here!

---

Bulk Onboard Producers with Producer Assignments

Want to bulk upload your producers with their producer assignments? This section will show you how!

Step 1: Follow steps 1-4 of the Bulk Onboard Producers section.

Step 2: To create a producer assignment, you must also add the following fields:

• LOA category
• States
• Scorecard Type
• Agent Type
• CoCode(s) (for carrier customers who are creating license & appointment scorecards)

Step 3: Follow steps 5-9 of the Bulk Onboard Producers section. 

View a video walkthrough of this process here!

---

Bulk Appoint Utility in Manage

The Bulk Appoint Utility in Manage allows for users to submit appointments for multiple producers at one time through Manage! This highly requested feature is a huge time saver for customers who need to submit appointments for multiple producers at one time.  Here is a quick video on how bulk appointment utility works!

Looking for the Eligibility Reason dictionary? Click here to jump to that section! 

The 5 Things You Need to Know about Bulk Appointments in AgentSync Manage

1. Users have two options for utilizing the AgentSync Bulk Appointment Feature:

1. 1. Auto-submit or queue up appointments through an integration with AgentSync Manage
   2. Partner with AgentSync’s Customer Solutions Engineering (CSE) team to create a flow that allows for submission of multiple appointments through a bulk data load.  In order to take advantage of this functionality, please reach out to your CSM to learn if you are the right fit.

2. AgentSync has critical checkpoints during the appointment process to ensure that your transactions were successfully and accurately submitted! What does this mean? Before an appointment transaction is created via the Bulk Appoint Utility:

1. 1. The system will first confirm that the producer’s NPN exists, synced correctly, and is active in AgentSync.  Once those three criteria are met, the system will then create the appointment transaction.
   2. During your implementation, you likely configured your gateway business rules, which are the lines of authorities and class codes that you do business in.  When you select a specific LOA category, you submit transactions for the active lines within that category. In the latest version of the bulk appointing utility, transactions are created for all active lines within the requested LOA category (whether the producer is eligible or not). 

Here is a brief example from the video (linked in the “New Version” section in this doc).  Below, we can see the Apex code requesting an appointment submission for life and health in California.

The Apex code spun up four transactions, which you can see below.  This is because California has four different lines of authority that fall under the life and health line of authority category: 

• Life
• Accident & Health or Sickness (including Disability)
• Health and Sickness (excluding Disability)
• Part time fraternal (which holds both a life & fraternal LOA category)

 

3. AgentSync’s new Bulk Appoint Utility allow for a more precise understanding of why an appointment request was rejected.  To stay on top of your appointment submissions, we highly recommend you use and report on the new “eligibility reason” field on the transaction record.  This ensures that you can audit your own appointments without disrupting your workflow.  See the section below to learn what the various eligibility reasons mean in AgentSync Manage.

4. AgentSync’s bulk appointment functionality only accepts our supported lines.  If you are auto-submitting an appointment with one of our supported lines that does not fall under this category (ex: not_applicable), simply input the line of authority that you sell for and AgentSync’s backend code will automatically recategorize the line of authority.

5. Your company record lists the lines of authorities that their companies support.  If you are getting error messages regarding not supporting certain lines of authorities, please check that your company record lists that line of authority.  These records are not updated by NIPR and you must ensure that you make any updates when you expand business to new states or lines of authorities.  

---

Bulk Appoint Eligibility Reasons Dictionary

Below is a list of what each Eligibility Reason is and what it means

Eligibility Reason	Meaning
Transaction creationed with Eligibility Reason = Required License Not Active (Found) and Transaction Status = Not Eligible	Either this means that the producer's license is inactive, expired, or does not exist for the requested appointment state or the license does not hold any of the requested LOA categories.
For Transactions where LOAs exist on the license: Eligibility Reason = In Good Standing and Transaction Status = Ready to Submit. For transactions where LOAs do not exist on license: Eligibility Reason = Required License Not Found and Transaction Status = Not Eligible	Producer does not hold the correct line of authority categories.
Transaction is created: Eligibility Reason = In Good Standing and Transaction Status = Ready To Submit	NPN holds more than one eligible license in requested state for agent type = producer and more than one eligible 'Ready to Submit' transaction could be created
Transaction created for eligble license. No transactions created for Ineligible license	All eligible transactions (Possibly multiple) will all be created for the eligible license - and for ineligible requests, transactions will still be created but in a 'Not Eligible' status with Eligibility Reason = 'Required License Not Found'
Transactions are created with Eligibility Teason = "No Active Resident License" and Transaction Status = Not Eligible	NPN has expired resident license or RL has Active = FALSE but license for requested state is active and not expired
Eligibility Reason: Required License Not Found and Transaction Status: Not Eligible	NPN does not hold license in requested state
Eligibility Reason: *Company Name* does not appoint in the requested State: *State* and Transaction Status = Not Eligible	Company record is missing Company State Setting for requested state
Eligibility Reason: Company Does Not Appoint for requested loas. TXN Status: Not Eligible	Company record is missing requested LOA categories
Eligibility Reason: CoCode Not Found. TXN Status: Not Eligible	Company record is missing for CoCode requested
All eligible appts created as JIT appt and held for submission	All eligible appts created as JIT appt and held for submission. JIT will need to =TRUE on the applicable Company State Setting records.
Eligibility Reasons: In Good Order. Txn Status: Dependent on NIPR response	Any request where 'submit = true' will auto submit Non-JIT PDB appointments to NIPR. Any requests with 'submitJustInTime =true' will auto-submit any JIT appts to NIPR.
Dependent on NIPR response. All eligible transactions are submitted to NIPR	Non-JIT state and Auto-Submit = True
Dependent on Eligibility Reason not related to PA	This error occurs when states license for the same class code but only appoint individuals or if Appointment Producer Assignment Required checkbox is turned on and the submitted transaction was outside of the producer assignment.
Two separate transaction batches should be created	This can happen when two separate requests were submitted for the same producer in the same state but the cocodes are different.
One transaction and one transaction batch are created	If Appointment Producer Assignment Required checkbox is turned on, then all bulk appointment requests outside of the producer assignment will be rejected.

Still need help? Reach out to support@agentsync.io for assistance. 

---

Bulk Terminate Appointments

Need to terminate a large number of appointments? This section will walk you through how to terminate appointments in bulk in AgentSync Manage.

 

Step 1: Before we can terminate, we must export the appointment data from Manage that we need. Navigate to the Reports tab in the top ribbon of your screen (check the More button on the right side if its missing)

Step 2: Click New Report in the top right corner

Step 3: There is a list of Categories that defaults to Recently Used. Select All and type Producer Licensing with Carrier Appointments. 

Step 4: Click Producer Licensing with Carrier Appointments and Start Report

Step 5: Remove Producer Licensing: Producer Licensing Name and Carrier Appointment: Carrier Appointment from the Columns by clicking X next to each line

Step 6: In the Add column... box, add the following columns in this exact order from the Carrier Appointment: info section (NOT Producer Licensing: info):

• Related Producer
• NPN
• State Code
• Line of Authority
• CoCode

Step 7: Click over to the Filters tab

Step 8: Change the Show Me filter from My producer licensing to All producer licensing and click Apply

Step 9: In the Add filters... box, add the following filters to your report:

• Cocode - equals - (your company Cocode)
• Status - equals - Appointed
• Line of Authority - equals - (the LOAs you wish to terminate)
• State Code - equals - (the states you wish to terminate)

Step 10: Click Run in the top right corner. 

Step 11: In the top right corner of your report, click the down arrow next to Edit

Step 12: Click Export 

Step 13: Ensure Details Only is selected, change the Format to Comma Delimited .csv and click Export

Step 14: Open the CSV file and save it to your computer. 

Step 15: Return to Manage and click 9-dotted box in the top left corner

Step 16: In the search bar, type AgentSync CSV Import and click AgentSync CSV Import under the Items category

Step 17: In the Select Upload Type drop down, select Terminate

Step 18: Click the blue here link in the description to download the CSV template that must be used for the upload.

Step 19: From the exported report, copy the Agent NPN, State(s), Line of Authority and Carrier CoCode onto the exported template. 

Step 20: Enter in the Termination Reason Code that aligns with each producer's appointment. You can find the Termination Reason Codes listed on the termination_reason_key tab of the template. 

Step 21: Delete the tabs labeled accepted_values and termination_reason_key from the template. 

Step 22: Save the template as a CSV file

Step 23: Return to the AgentSync CSV Import tool in Manage

Step 24: Click the Upload Files button on the Import page and upload your CSV

Step 25: Click Parse 1 file

Step 26: Click Submit "x" Transactions. You can submit your transactions immediately, or create multiple batches.  Creating multiple batches allows for secondary review before submission. 

 

Have questions?  Let us know at support@agentsync.io!

---

Bulk Invite Agents to the Portal

Onboarding a new hire class?  You can invite multiple producers to your AgentSync portal at once! 

Step 1: Click the Contacts tab in AgentSync Manage 

Step 2: Select the producers that you would like to invite to the portal by selecting the box next to their name

Step 3: Click Create/Update Portal User

Step 4: Select the portal you would like to invite your producer to from the drop down

Step 5: Click Save

Your producers are now invited to the portal! They will receive an email with instructions on how to register for the portal. 

 

 

Still need assistance? Here is a step by step tutorial!