View source for NETIM TLD MANAGER

NETIM TLD Manager is an addon allowing an effective management of the extensions proposed by NETIM, especially:

* View active extensions within WHMCS, their cost and current sale price, and make fast changes in pricing

* Add extensions in 1 click

* Check the current configuration of the extensions vs their operating values accepted by NETIM

* View promotions

 This addon complements the "TLD Import & Pricing Sync" functionality available since WHMCS 7.10 and supported by the 2.6.5 module.


== [[File:Fleche.gif|link=]] Installation ==

The addon is included by default in the installation package of the registrar module since version 2.6



== [[File:Fleche.gif|link=]] Activation and settings ==

In the administration area, section "Setup"> "Addons Modules", you will find NETIM TLD Manager in the list of modules

[[File:Netim tld mgr addons.png]]


Click on "Activate" then "Configure"


[[File:Netim_tld_mgr_configure.png]]

Indicate whether the features below will be enabled by default when adding an extension

 "Enable DNS management for new tlds"
 "Enable Email Forwarding for new tlds"
 "Enable ID protection (if applicable) for new tlds" 

Indicate margin rates for sales price proposals when adding an extension

 "Registration default margin (%)"
 "Renewal default margin (%)"
 "Transfer default margin (%)"
 "Restore default margin (%)"
 
 The margin rate should be considered on the sale price (and not the cost price as the "TLD Import & Pricing Sync" functionality)
 The sale price will be calculated according to the formula: (cost price * 100) / (100 - margin rate)
 If the cost price is 100 and the margin set to 25%, the sale price will be 133.33
 Indeed, a sale at 133.33 and a cost price at 100 gives a commercial margin of 25%

Indicate the rounding method on prices

 "Round pricing to"
 
 A value of 1 indicates the rounding to an integer
 A value of 0.99 indicates the rounding to 99 cts (1.99, 2.99, ...)
 A value of 0.50 indicates the rounding to 50 cts (1.50, 2.0, 2.5, ...)
 A value of 0.1 indicates the rounding to 10 cts (1.10, 1.20 1.30, ...)
 
 "Rounding pricing method"
 

Indicate the access control to the module according to the different user groups

 Check the groups whose users of this module depend on.
 By default, check "Full administrator"


As soon as the parameters are saved and if the user is part of an authorized group, the module is accessible in the "Addons" menu.

== [[File:Fleche.gif|link=]] Active extensions ==

The main page of the module displays the list of currently active extensions assigned to NETIM for auto registration.

[[File:Tld-manager2.png]]


The 4 types of paid operations (registration, transfer, renewal and restore) are displayed with:

* your current cost price in EUR

* your current cost price in the base currency of WHMCS (if different from the euro)

* your current sale price in the base currency of WHMCS (see [[# Considerations]])

* the corresponding margin rate

 '''Caution''' 
 The restore prices will only be available for WHMCS versions> = 7.5
 The feature calculates the sale price based on the annual renewal price + the redemption fee
  
 Shaded sections indicate that the operation is not supported by NETIM for the corresponding extension


'''Manual prices update''' 

Modify the values of the desired extensions and click on "Update with manual prices".

The prices will then be applied to the selected extensions taking into account their periods (see [[# Considerations]])

As part of the restore price (WHMCS> = 7.5), the feature calculates the redemption fee based on the indicated price - the annual renewal price


'''Application of default margin''' 

Cliquez sur "Apply default margin"

The prices will then be updated by applying the default margin rate to the selected extensions


'''Prices export''' 

Click on "Export prices"

The values of the table will be exported as a .csv file for download


'''Prices import''' 

Select a file and click on "Import prices"

 The same format than the export is expected
 The functionality allows you to easily modify the prices from an export to re-import the modifications

The input fields will be updated as follows:

"Create sell price in base currency" => Registration current
"Transfer sell price in base currency" => "Transfer current
"Renew sell price in base currency" => Renew current
"Restore sell price in base currency" => Restore current

Finally, a manual price update will allow changes to be saved


== [[File:Fleche.gif|link=]]  Addition of extensions ==

Adding an extension is done in 1 click !

[[File:Netim_tld_mgr_add.png]]


NETIM offers more than 900 extensions, so the display is done in the form of a list by letter.

If an extension is already active, it will be displayed and already checked.


The 4 types of paid operations (registration, transfer, renewal and restore) are displayed with:

* your current cost price in EUR

* your current cost price in the base currency of WHMCS (if different from the euro)

* your sale price proposal, in the WHMCS base currency, calculated according to the module setting (margin rate and rounding method)

 '''Caution''' 
 The restore prices will only be available for WHMCS version > = 7.5
 
 Shaded sections indicate that the operation is not supported by NETIM for that particular extension


'''Adding an extension''' 

Update the prices if needed and click on "Add selected tlds".


The extensions will then be added to WHMCS with the following information:

* NETIM as auto registration

* Support for DNS management and Email forwarding according to the parameterization of the module

* The ID protection support if available and according to the parameterization of the module

* Support for EPP code if available for the extension

* Grace and redemption periods if available for the extension and according to NETIM values

* Prices for registration, renewal and transfer based on the indicated price and extension periods (see [[# Considerations]])

 The addition of an extension is thus achieved with the necessary settings for immediate activation.

== [[File:Fleche.gif|link=]] Check settings ==

In order not to have any problems with customers requests, it is essential that the extensions are well parameterized.

Which features are available? What are the registration and renewal periods?

This feature of the module allows to check all active extensions with NETIM.


[[File:Netim_tld_mgr_check.png]]


For each error and the given parameter, differences between the values in WHMCS and NETIM are displayed in the table with:

* the extension

* the parameter having an error

* the value in WHMCS

* the value at NETIM

* the fix proposal

 '''Examples'''
 For the first row of the table
 The .COM renewal for 6 years is not enabled in WHMCS whereas it is available at NETIM
  
 For the last row of the table
 The EPP code management for .NET is not enabled in WHMCS whereas it is available at NETIM

Select the errors to be fixed and click on "Fix errors"

== [[File:Fleche.gif|link=]] Considerations ==

'''Pricing'''

All prices are displayed and taken into account on an annual basis.


'''Periods'''

Each extension has different periods for registration and renewal from 1 to 10 years.

When adding an extension or updating the prices, prices are calculated and recorded according to the periods of the extension.

Each term is then calculated by multiplying the annual price by the corresponding number of years.

The transfer period is 1 year. Terms ranging from 2 to 10 years are disabled systematically

 '''Caution'''
 WHMCS inappropriately handles renewal and transfer periods because the registration period determines the others.
 If year 1 is deactivated, it will not be possible to activate it for renewal and transfer.
 Therefore, it is currently impossible to manage a registration period for 2 to 10 years and a renewal for 1 to 10 years


'''Exchange rate'''

As NETIM invoices in euro, the module performs a conversion of cost prices in the base currency.

The rate taken into account is either:

* obtained in WHMCS if the EUR currency is defined

* obtained online via a foreign exchange webservice


'''Data source'''

Data related to prices and extensions are retreived directly from NETIM

In order to speed up the page loadings, these data are only downloaded once a day.