Registrar TLD Sync - Revision history

SarahK: /* Unable to display TLD cost pricing as currency 'XXX' is not defined with an exchange rate */

2022-05-05T20:23:40Z

‎Unable to display TLD cost pricing as currency 'XXX' is not defined with an exchange rate

SarahK at 20:02, 2 May 2022

2022-05-02T20:02:01Z

Show changes

SarahK at 22:36, 14 April 2022

2022-04-14T22:36:15Z

SarahK at 21:55, 1 March 2022

2022-03-01T21:55:58Z

John: /* Extension List */

2021-08-09T09:56:48Z

‎Extension List

SarahK at 14:05, 5 August 2020

2020-08-05T14:05:58Z

DanR: /* ResellerClub */

2020-06-09T18:38:40Z

‎ResellerClub

DanR at 18:38, 9 June 2020

2020-06-09T18:38:18Z

Andrew at 13:53, 7 April 2020

2020-04-07T13:53:51Z

Andrew: /* Unable to display TLD cost pricing as currency 'XXX' is not defined with an exchange rate */

2020-04-07T13:50:44Z

‎Unable to display TLD cost pricing as currency 'XXX' is not defined with an exchange rate

@@ Line 94: / Line 94: @@
 ===Unable to display TLD cost pricing as currency 'XXX' is not defined with an exchange rate===
-This message occurs when a currency in WHMCS is missing, or does not have an exchange rate. Navigate to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Currencies''' or, prior to WHMCS 8.0, '''Setup > Payments > Currencies''' and either add or update the currency.
+This message occurs when a currency in WHMCS is missing, or does not have an exchange rate. Navigate to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Currencies]]''' or, prior to WHMCS 8.0, '''Setup > Payments > Currencies''' and either add or update the currency.
 ==Developer Documentation==
 To add support for TLD syncing to a custom or third-party registrar module, see our [https://developers.whmcs.com/domain-registrars/ Registrar Module] documentation.

@@ Line 1: / Line 1: @@
 <div class="docs-alert-warning">
-Registrar TLD & Pricing Sync functionality requires a domain registrar module that supports TLD Pricing functionality. This is supported natively by the eNom and all LogicBoxes modules. All WHMCS users can get a free account with eNom or ResellerClub by navigating to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Domain Registrars''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Domain Registrars''' within the WHMCS admin area interface.
+This feature requires a domain registrar module that supports TLD pricing (for example, [[Enom]] and all [[ResellerClub|LogicBoxes]] modules).
 </div>
-The Registrar TLD & Pricing Sync tool allows import of domain extensions and pricing from supported registrars.
+The '''Registrar TLD Sync''' tool allows import of domain extensions and pricing from supported registrars. On import, a markup amount of either a percentage or a fixed amount can be applied automatically, as well as a rounding amount from a range of options.
-To perform an import & pricing sync, go to '''Utilities > Registrar TLD Sync'''.
+You can access this feature at '''Utilities > Registrar TLD Sync'''.
 ==How to Sync TLDs and Pricing==

@@ Line 4: / Line 4: @@
 The Registrar TLD & Pricing Sync tool allows import of domain extensions and pricing from supported registrars.
 On import, a markup amount of either a percentage or a fixed amount can be applied automatically, as well as a rounding amount from a range of options.
 ==How to Sync TLDs and Pricing==
 Choose the domain registrar that you wish to perform the import or sync with by clicking on the relevant icon.

@@ Line 23: / Line 23: @@
 Once the TLD and pricing information has been obtained from the domain registrar, you will be presented with a list of all available TLDs, grouped by Category.
-For each TLD, you will see the selling status, minimum registration period, and cost price. In the case of TLDs you are already selling, you will also see the current selling price, and margin for each of the 4 pricing options - Register, Renew, Transfer and Redemption.
+For each TLD, you will see the selling status, minimum registration period, and cost price. In the case of TLDs you are already selling, you will also see the current selling price in bold, and margin for each of the 4 pricing options - Register, Renew, Transfer and Redemption.
 [[File:RegistrarTldSyncStepTwo.png]]

@@ Line 1: / Line 1: @@
 <div class="docs-alert-warning">
-Registrar TLD & Pricing Sync functionality requires a domain registrar module that supports TLD Pricing functionality. This is supported natively by the eNom and all LogicBoxes modules. All WHMCS users can get a free account with eNom or ResellerClub by navigating to '''Setup''' > '''Products/Services''' > '''Domain Registrars''' within the WHMCS admin area interface.
+Registrar TLD & Pricing Sync functionality requires a domain registrar module that supports TLD Pricing functionality. This is supported natively by the eNom and all LogicBoxes modules. All WHMCS users can get a free account with eNom or ResellerClub by navigating to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Domain Registrars''' or, prior to WHMCS 8.0, '''Setup > Products/Services > Domain Registrars''' within the WHMCS admin area interface.
 </div>
@@ Line 9: / Line 9: @@
 ==How to Sync TLDs and Pricing==
-To perform an import & pricing sync, begin by navigating to '''Utilities''' > '''Registrar TLD Sync'''.
+To perform an import & pricing sync, begin by navigating to '''Utilities > Registrar TLD Sync'''.
 Choose the domain registrar that you wish to perform the import or sync with by clicking on the relevant icon.
@@ Line 78: / Line 78: @@
 [[File:RegistrarTLDSyncNoCurrency.png]]
-When a pricing import and synchronisation is performed, pricing will be set for all active currencies in WHMCS. Currency conversion will be performed using the rates defined in '''Setup''' > '''Currencies''', and any rounding defined in the [[#Sync_Options|Sync Options]] will be applied after the conversion has occurred.
+When a pricing import and synchronisation is performed, pricing will be set for all active currencies in WHMCS. Currency conversion will be performed using the rates defined in '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Currencies''' or, prior to WHMCS 8.0, '''Setup > Currencies'''. Any rounding defined in the [[#Sync_Options|Sync Options]] will be applied after the conversion has occurred.
 ==Troubleshooting==
 ===Unable to display TLD cost pricing as currency 'XXX' is not defined with an exchange rate===
-This message occurs when a currency in WHMCS is missing, or does not have an exchange rate. Navigate to '''Setup''' > '''Payments''' > '''Currencies''' and either add or update the currency.
+This message occurs when a currency in WHMCS is missing, or does not have an exchange rate. Navigate to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Currencies''' or, prior to WHMCS 8.0, '''Setup > Payments > Currencies''' and either add or update the currency.
 ==Developer Documentation==

@@ Line 89: / Line 89: @@
 ==Notes==
 ===ResellerClub===
-Due to limitations with the ResellerClub API, the prices returned are exclusive of any taxes charged by ResellerClub. If ResellerClub levies a tax on your account we recommend adjusting the Profit Margin setting to include taxes plus the desired profit margin.
+Due to limitations with the ResellerClub API, the prices returned are ''exclusive'' of any taxes charged by ResellerClub. If ResellerClub levies a tax on your account we recommend adjusting the Profit Margin setting to include taxes plus the desired profit margin.

← Older revision		Revision as of 18:38, 9 June 2020
Line 85:		Line 85:

	==Developer Documentation==		==Developer Documentation==
−	If you would like to add support for TLD Syncing to a custom or third party registrar module, please refer to the [https://developers.whmcs.com/domain-registrars/ Registrar Module] documentation on the developer site for details of how to implement the required functions.	+	If you would like to add support for TLD Syncing to a custom or third-party registrar module, please refer to the [https://developers.whmcs.com/domain-registrars/ Registrar Module] documentation on the developer site for details of how to implement the required functions.
		+
		+	==Notes==
		+	===ResellerClub===
		+	Due to limitations with the ResellerClub API, the prices returned are exclusive of any taxes charged by ResellerClub. If ResellerClub levies a tax on your account we recommend adjusting the Profit Margin setting to include taxes plus the desired profit margin.

← Older revision		Revision as of 13:53, 7 April 2020
Line 66:		Line 66:

	If any errors occurred importing or updating an extension, these will be listed separately.		If any errors occurred importing or updating an extension, these will be listed separately.
		+
		+	==Currency==
		+	Domain registrars can return TLD cost pricing information in any currency they define. Typically cost pricing information will be returned in the primary currency of your domain registrar, or based on a setting within your domain registrar account.
		+
		+	Regardless of the currency cost pricing is returned in, WHMCS will always convert and display pricing in your WHMCS system default currency.
		+
		+	For this reason, it is necessary to ensure you always have the currency that cost pricing is returned in by your domain registrar setup and configured with a valid exchange rate prior to using the Registrar TLD Sync tool.
		+
		+	If a currency is encountered that does not exist in WHMCS, or for which no exchange rate is defined, you will see a message such as the ones in red below indicating the currency that needs to be added.
		+
		+	[[File:RegistrarTLDSyncNoCurrency.png]]
		+
		+	When a pricing import and synchronisation is performed, pricing will be set for all active currencies in WHMCS. Currency conversion will be performed using the rates defined in '''Setup''' > '''Currencies''', and any rounding defined in the [[#Sync_Options\|Sync Options]] will be applied after the conversion has occurred.

	==Troubleshooting==		==Troubleshooting==