Skip to content

Move from Upmind to ClientFence

The Upmind import copies your Upmind clients, catalogue, services, billing and tickets into ClientFence. Upmind is hosted, so the import reads it through Upmind’s API. It saves what it reads in a private file on your server, then imports that file with the same steps as the WHMCS import. Nothing changes in Upmind, and nothing is emailed, charged or created on a server.

  • A fresh install. The import keeps Upmind’s invoice numbers, so it does not start on an install that already has data.
  • An API token from Upmind. In Upmind, open Settings → API Tokens → Create API Token. Let it view clients, products, contracts, invoices, payments, tickets and taxes, and add your ClientFence server’s IP address to its IP whitelist.
  • PHP’s pdo_sqlite extension, which most PHP builds include.
  • The same payment gateways set up here.
  1. Go to System → Settings → System and open the Migration tab (Super Administrators only).
  2. Under Move from, select Upmind. Under Import from Upmind, paste the Upmind API token and select Save and test. If a plan was made from another system, saving deletes it after you confirm, and you make a new one.
  3. Select Read Upmind and keep the page open. If it stops, fix the cause and select Go on reading Upmind.
  4. Select Make the plan. It shows what was read and lists the server checks to fix. Check Clients with the most credit in the plan: imported credit pays the client’s next invoices automatically, so correct a wrong balance on the client’s Credit Balance tab right after the import.
  5. Select Start the import and keep the page open, then Check against Upmind to compare the counts.

Clients with their address, phone, company and credit balance; product categories, products and their prices; domain extensions with their registration prices; services and domains with their renewal price and due date; invoices and their lines; payments; tickets with their replies and staff notes; and tax rates by country. Each client’s language comes over, and product and category names and descriptions in other languages ClientFence ships come over as their translations.

Upmind keeps no currency per client: each client gets the currency of its first service or invoice. A client billed in two currencies is named in the warnings, and all of its services and invoices come over in the first one.

Upmind’s API does not give out the following, so they are not imported:

  • Passwords. Clients set a new one with Forgot Password?.
  • Two-factor sign-in. Clients who used it set it up again. The warnings name them.
  • Saved cards and other stored payment methods. With the same Stripe account, Find saved cards links Stripe cards to the clients after the import: see Saved cards.
  • Ticket attachments.

Left out on purpose:

  • Invoices with a zero total. Upmind makes one for each service it imported itself.
  • Credit top-ups. The client’s credit balance already carries them.
  • Which products are taxed, fixed-amount taxes, taxes for a region, city or post code, and other rates for companies. ClientFence charges one rate per country to every item of a taxable client. The percentage rates of whole countries come over as tax rules with tax switched off: check them under System → Tax Rules, then turn on Enable Tax Support in its Tax Settings tab before new invoices are made. See Taxes. Imported invoices keep the tax Upmind charged.
  • Domain transfer prices and exchange rates. Set them after the import.
  • Services billed every 2, 4 or other months that ClientFence does not bill (1, 3, 6, 12, 24 or 36). The warnings name each one.

When you move over, stop Upmind’s automatic charges and invoice emails, so clients are not billed twice.

For a large Upmind account, run the same steps as the site user once the token is saved:

Terminal window
php console.php clientfence:whmcs-import upmind
php console.php clientfence:whmcs-import plan
php console.php clientfence:whmcs-import apply
php console.php clientfence:whmcs-import verify

Add --restart to the first command to read Upmind again from the start.