<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><style>
p {
margin: 0;
}
span.fr-emoticon.fr-emoticon-img {
background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle;
}
span.fr-emoticon {
font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0;
}
blockquote {
border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px;
}
blockquote blockquote {
border-color: #00bcd4; color: #00bcd4;
}
blockquote blockquote blockquote {
border-color: #43a047; color: #43a047;
}
table.grid {
border-collapse: collapse;
}
table.grid td,
table.grid th {
border: 1px solid #ddd;
}
.fr-fic.fr-dib {
display: block; margin: 5px auto;
}
.fr-fic.fr-dib.fr-fir {
text-align: right; margin: 5px 0 5px auto;
}
.fr-fic.fr-dib.fr-fil {
text-align: left; margin: 5px auto 5px 0;
}
.fr-fic.fr-dii {
float: none; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fil {
float: left; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fir {
float: right; margin: 5px auto;
}
img.fr-dib.fr-fir {
margin-right: 0; text-align: right;
}
img.fr-dib.fr-fil {
margin-left: 0; text-align: left;
}
img.fr-dib {
margin: 5px auto; display: block; float: none;
}
img.fr-bordered {
box-sizing: content-box; border: solid 5px #CCC;
}
img.fr-shadow {
box-shadow: 10px 10px 5px 0px #cccccc;
}
img.fr-rounded {
border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;
}
</style><p><strong>In this guide we will cover:</strong></p><p><strong>- What is the ALSO Integration?</strong></p><p><strong>- Connecting to ALSO </strong></p><p><strong>- Importing Customers</strong></p><p><strong>- Importing Subscriptions</strong></p><p><strong>- Importing on a Schedule</strong></p><p><br></p><p><br></p><p><strong>Related Guides:</strong></p><ul><li style="font-weight: bold;"><a href="https://usehalo.com/halopsa/guides/2508" target="_blank" rel="noopener noreferrer"><strong>Licences/Subscriptions Overview</strong></a></li></ul><p><br></p><p><strong><span style="font-size: 14pt;">What is the ALSO Integration?</span></strong></p><p>Halo can integrate with ALSO to import customers and their subscriptions from ALSO into Halo. Customers and subscriptions can be synced on a scheduled basis to bring any customer/subscription changes from ALSO into Halo automatically. </p><p><br></p><p>If using pro-rata billing based on your customer's subscription use this integration allows your invoices to be calculated automatically based on their subscription count in ALSO. </p><p><br></p><p id="isPasted"><strong><span style="font-size: 14pt;">Connecting to ALSO</span></strong></p><p>First ensure the integration module is enabled, head to Configuration > Integrations > ALSO, enable the module using the '+' icon.</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjA3NWQzNTYwLTNkMGQtNDFhZS05MmUyLTU4NTY4MGFlMTQ2NCJ9.q9I55HvcPwLROQV4DDFsHR36lxXuIiUArUNTN7TsTho" class="fr-fic fr-fil fr-dib" width="116" height="121"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enable integration module </span></strong></p><p><br></p><p>Once enabled click into the module to bring up the integration setup screen. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFiMjkyZTA2LWU5NTktNDU0Ny1iNzc4LTNlZDhjNDk2MGQ2OCJ9.HoHMyBoL-dm_quJvptpyuxuIl7ZtVeeCkIVh6Pc0PM0" class="fr-fic fr-fil fr-dib" width="1220" style="width: 1222px; height: 692.467px;" height="692"></p><p><strong><span style="font-size: 10pt;">Fig 2. Integration setup screen</span></strong></p><p><br></p><p>To connect to ALSO enter your Marketplace URL, account username and account password in the details fields. Your 'Marketplace URL' is just the URL you use when accessing/logging into your ALSO marketplace, this is often 'https://cloud.also.com' and should follow this same format.</p><p><br></p><p>The 'username' and 'password' entered must belong to a ALSO user that has at least read only permissions for customer and subscription data, they also need the 'Reseller Admin' capabilities role. As this account will be used to authenticate the connection between Halo and ALSO. The ' This account will also need to have 2FA against it disabled, this can be done by ALSO support. If the account has 2FA Halo will not be able to connect to ALSO . If you cannot disable the 2FA against the account, or would not like to use an existing users account for the authentication you can set up an API only user with the appropriate permissions in your ALSO to do this. </p><p><br></p><p>Once you have entered your details you can use the 'Test Configuration' button to test you have connected successfully. </p><p><br></p><p><strong><span style="font-size: 14pt;">Importing Customers</span></strong></p><p>Before customers can be imported from ALSO you will need to create customer mappings. Mappings can be set manually or generated automatically. These mappings will determine which ALSO customer the Halo customer is linked to. </p><p><br></p><p>Automatically generated mapping can only be used if your customers in ALSO have the exact same name as your customers in Halo. To generate these mappings use the 'Generate mappings' button. </p><p><br></p><p>Manual mappings are used when your customers already exist in both ALSO and Halo but have different (non exact) names. To create a manual mapping add to the customer mappings table (<strong>Fig 3</strong>), the customer data in ALSO will then be imported to the mapped Halo customer. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjI3NTBlZjhmLTliZWUtNDk4Zi1iMWZiLWUwOWJkZGVhMzA3YiJ9.QdeF3Ajy3i07vO_OporXNHmwKFMY6Qn51lrSiOoCi18" class="fr-fic fr-fil fr-dib" width="1219" style="width: 1221px; height: 597.679px;" height="598"></p><p><strong><span style="font-size: 10pt;">Fig 3. Customer import configuration</span></strong></p><p><br></p><p>If your customers exist in ALSO but not in Halo you do not need to configure mappings, they will be created in Halo upon import and then added to the mappings table. </p><p><br></p><p>You can also have customers that are created from a ALSO import have a chosen Top Level using the 'Top Level for New Customers' field. </p><p><br></p><p>Update the Customer's main Site address in Halo when an existing Customer is imported from ALSO - When this is enabled the customer in Halo will have their main site address updated to match the address against this customer in ALSO. If disabled address information will not be updated. </p><p><br></p><p>Now you are ready to import your customers, to do this hit the 'Import customers' button then hit 'start. </p><p><br></p><p><strong><span style="font-size: 14pt;">Importing Subscriptions </span></strong></p><p>Subscriptions can be imported for any ALSO customer which has been mapped. The subscription name, status and quantity will be imported. When importing the 'Customer Subscriptions to Import' field can be used to determine which subscriptions can be imported. When this is set use the 'Import subscriptions' button to import the subscriptions. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJlMjA5OTk2LWNlZmUtNDUwNC1hZmEwLWU5MDc5YzBjMTdiNyJ9.0VZWprCvcMFXtp6SImhiXKbKJyrGMVFN70f1PjIQKr8" class="fr-fic fr-fil fr-dib" width="854" style="width: 856px; height: 262.138px;" height="262"></p><p><strong><span style="font-size: 10pt;">Fig 4. Import subscriptions</span></strong></p><p><br></p><p>If you would like cost and price data against subscriptions to be imported, enable 'Set price and cost on imported subscriptions' before you complete the import. When this is enabled cost/price data will be updated each time the halo integrator runs for the integration. </p><p><br></p><p>The end date of an imported subscription will use the contract end date if there is no subscription end date.</p><p><br></p><p><strong><span style="font-size: 14pt;">Importing on a Schedule</span></strong></p><p>To have your customer and/or subscription data be imported from ALSO automatically on a scheduled basis enable the Halo integrator for the integration using the setting shown in <strong>Fig 5</strong>. Once this is enabled you will need to set which entities are imported on a schedule by adding them to the 'Entities to Sync' field.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjlmNzg2YTliLTE3ODEtNGI5Ni05YmI0LTk0NjJlYzY3YTM0MCJ9.WVtyxKMU1Aseimjr-5et48ja2Omrg9B154AfBemWtRM" class="fr-fic fr-fil fr-dib" width="804" height="355"></p><p><strong><span style="font-size: 10pt;">Fig 5. Enable Halo integrator for integration</span></strong></p><p><br></p><p>The Halo integrator will run the sync on a daily schedule for this integration. </p><p><br></p><p>If using the Halo integrator you will be able to use the setting 'Deactivate Licences in Halo when they are deleted from ALSO (Halo Integrator only)'. </p><p><br></p><p><strong>Deactivate Licences in Halo when they are deleted from WestCoast (Halo Integrator only)</strong> - When enabled subscriptions will be made inactive in Halo when they are deleted in ALSO. When disabled subscriptions will still be made inactive in Halo when made inactive in ALSO but if they are deleted their count will be set to 0 but their status will not update.</p><p><br></p>
