|
|
| (12 intermediate revisions by 2 users not shown) |
| Line 1: |
Line 1: |
| − | {{DISPLAYTITLE:Auto Populating Addresses in Sign Up Orders}}
| + | =This Content Has Moved House= |
| − | = Overview = | |
| − | Service providers who use the Emersion [[End_User_Portal_and_Customer_Sign_Up_Portal|Sign Up Portal]] and the [[Agent Management|Agents]] module have the ability to populate all, or parts of an address used in an orders for that agent. This may be useful when agents selling your products and services are limited to a specific region or area and some fields are always going to be the same.
| |
| | | | |
| − | This feature is optional and is not included with either the [[Agent Management|Agents]] module or the [[End_User_Portal_and_Customer_Sign_Up_Portal|Sign Up Portal]] by default. If you would like to subscribe to this feature, please contact Emersion Sales. | + | This article has been moved to our new home for documentation and help content, the new Emersion Knowledge Base. |
| | | | |
| − | == Prerequisites ==
| + | We are sorry for the untidiness while we are shifting locations and we appreciate your patience during the transition to our new home. |
| − | The following prerequisites apply before you can use this feature
| |
| | | | |
| − | A subscription to Agent module and an instance of the Emersion Sign Up Portal.
| + | [https://resources.emersion.com/display/EKB/Configure+Auto-Populating+Addresses+in+the+Sign+Up+Portal Take me to the Emersion Knowledge Base article] |
| − | Active and correctly configured Agent accounts under your Retail Service Provider Account.
| |
| − | A unique '''Agent Code''' saved in the ''Org Unit'' of each Agent account where address fields will be populated.
| |
| − | A site address is saved against the Agent Account and one is marked as ''default''.
| |
| − | The ability to pass the Agent Code to the Sign Up Portal via a parameter in the URL.
| |
| | | | |
| − | == Address Types and Fields ==
| + | [[file:new_home_sm.jpg|900px]] |
| − | This feature supports standard and complex addresses only. Unstructured addresses are not supported.
| |
| − | | |
| − | The following address fields can be populated in the sign up portal automatically.
| |
| − | | |
| − | * Building Name
| |
| − | * Unit Type
| |
| − | * Unit Number
| |
| − | * Level Type
| |
| − | * Level Number
| |
| − | * Site Name
| |
| − | * Street Number
| |
| − | * Street Name
| |
| − | * Street Type
| |
| − | * Suburb
| |
| − | * Postcode
| |
| − | * State
| |
| − | * Country
| |
| − | | |
| − | Any fields that are not populated in Cumulus remain blank for the sign up user to complete themselves as per any other order.
| |
| − | | |
| − | == Configuration ==
| |
| − | The sections below contain the steps on how to configure the feature.
| |
| − | | |
| − | === Add an Agent Code to the Agent's Org Unit ===
| |
| − | Log in to your Retail Service Provider Account
| |
| − | | |
| − | Nav: '''Admin > Org Unit & Roles > Org Unit'''
| |
| − | | |
| − | # Search for the Org unit that belongs to the Agent.
| |
| − | # Click on the ID to open the Org Unit
| |
| − | # Enter a unique code for the agent in the '''Org Unit / Agent Code''' field. Use only alphanumeric characters.
| |
| − | | |
| − | While Cumulus allows users to enter any text string into the '''Org Unit / Agent Code''' field, this feature uses the agent code in the sign up portal URL. Emersion will not support unsafe characters. [https://perishablepress.com/stop-using-unsafe-characters-in-urls/ Refer to this article] for a chart showing safe/unsafe characters. If you are not sure, use only letters, numbers and underscores and your resultant URL will always be safe.
| |
| − | | |
| − | === Construct a Sign Up URL for your Agent's Orders ===
| |
| − | Once you have an Agent Code, you can create a URL that includes the agent code. By 'passing in' the agent code to the Sign Up portal, the system knows who the agent is, and the order will always be attributed to the agent in the same way as if the agent had logged into Cumulus and placed the order themselves.
| |
| − | | |
| − | The format of the URL is as follows:
| |
| − | | |
| − | <nowiki>
| |
| − | https://yoursignup.yourname.com.au?agent_code=xxxxxx
| |
| − | | |
| − | -- where xxxxxx = agent code
| |
| − | </nowiki>
| |
| − | | |
| − | If the agent code is passed into the Sign Up Portal, the order will always be attributed to the agent, regardless of whether address population is configured.
| |
| − | | |
| − | === Add an Address (site) to the Agent ===
| |
This article has been moved to our new home for documentation and help content, the new Emersion Knowledge Base.
We are sorry for the untidiness while we are shifting locations and we appreciate your patience during the transition to our new home.
