How to Move Customers within Atria

How to Move Customers within Atria

Objective

This article will guide you how to move a customer from one reseller to another. 

Applies To:

Atria V12.x and later versions

Overview

User move can only be performed by Service Provider Administrator or Reseller Administrator. When moving a Customer, they are also moved within Active Directory to the new Reseller OU.

When a Customer is moved, all the services provisioned to the Customer are also moved. This means that all users are also reprovisioned.
If the destination customer doesn’t have a service that is currently provisioned to the user being moved, e.g. Hosted Exchange,  the user can’t be moved .  The service would have to be provisioned at the destination customer and then the user can be moved.
This means that Services and Service Plans need to be equal between resellers. So if you are trying to move a customer with Hosted Exchange and the new Reseller doesn't have Hosted Exchange, the move will be unable to be initiated.

Process

How to move a customer via the Web Interface

Navigate to the Customer Move function within Atria (Customers > Configuration > Customer Move)



Once at the next screen, select the customer you would like to move, and it's new reseller that you would like the customer moved to.

Please note, there is a validation step run when you select "Load Customers" - This validates the service plans for each reseller to confirm that they can correctly move under the new reseller.
This is to prevent you moving customers to another Reseller who is missing services that are provisioned to the customer.




Next, you are requested to match the relevant plans between the Source and Destination - This is to make sure the Customer Service Plans match on both sides if they are named different for resellers for example.
Additionally, if you are running multi-location you can configure the location of the customer move.




Select "Move" once the service plans have been matched accordingly.

Then you will get a confirmation screen that the DB move is successful. While the user(s) and service(s) are re-provisioning, this is shown as a bulk request on the "Provisioning Requests" screen.


How to move a customer via the API

Moving a customer via the API is simple. All you need to do is set the ParentID of a customer to be matching the new ParentID of where you want the customer moved to. This does require that the service plans are correctly configured for both resellers. Which means that they have the same Plan Selection are the same for both resellers. 

For example, they will need to have matching Hosted Exchange plans within the destination reseller.
The example Set Request, which is moving the customer ATR to the destination parent of HNP, is below

  1. $ApiRequest = @"
  2. <?xml version=`"1.0`" encoding=`"utf-8`"?>
  3. <request version=`"1.0`" action=`"SET`">
  4. <customer>
  5. <name>ATR</name>
  6. <parent>
  7. <name>HNP</name>
  8. </parent>
  9. <status>Provisioned</status>
  10. </customer>
  11. </request>
  12. "@
  13.  
  14. # Initialize the client
  15. $client = New-Object -TypeName System.Net.WebClient -Property @{
  16.     Credentials = New-Object System.Net.NetworkCredential(Get-Credential)
  17. }
  18.  
  19. $apiUrl = "https://atriaweb/cortexapi/default.aspx"
  20.  
  21. $response = ""
  22. [xml]$xml = $response = $client.UploadString($apiUrl, $apiRequest)
  23. $response



    • Related Articles

    • Atria Billing Setup User Guide

      Objective This article describes how to configure Atria to utilize the latest billing features. This document outlines the billing setup attributes that should be configured.    Applies to Introduced in Atria version 12.0.0 Billing Setup Overview To ...

    • Display Patterns for Billing Line Descriptions

      Purpose: When generating billing data, two descriptions are generated for each billable item - Line description (detailed) and summary descriptions.   The Summary Description serves two purpose: Used as a template for your invoice lines and reporting ...

    • Service Billing Summary Report

      Objective This article describes the information contained in the Billing Summary Report.     Applies to Introduced in Atria version 12.0.0 Billing Summary Report Overview The service billing summary report is designed to highlight the billable ...

    • Billing Process Overview

      Objective This article outlines, at a high level, the billing features available in Atria. The billing feature provides transparency of Atria billable services that have been consumed, down to the day. Applies To Introduced in Atria version 12.0.0. ...

    • How to Manage security roles within Atria

      Manage security roles A security role is a set of permissions that defines customer, administrator, and user access to specific tasks in the Atria. For example, the first or default user created for a customer is a customer administrator. The customer ...