Installation and setup

Requirements

• CS-Cart (Ultimate) or Multi-Vendor 4.17.2 or later.
• Administrator access to the store’s admin panel.
• A CJ Dropshipping account with an API key. In your CJ account open My CJ > Authorization > API and create the API key. A free account is enough; it may call the API once per second.
• A cron job on your server (step 6).

Install the add-on

1. Download the kv_cj_dropshipping-<version>.zip package from your Kavio Labs or CS-Cart Marketplace account.
2. In the admin panel, open Add-ons > Manage add-ons.
3. Click the gear button and choose Manual installation, then upload the archive.
4. Find CJ Dropshipping Connector in the list and make sure its status is Active.
5. Enter your license key under Settings > License (Kavio Labs downloads) and click Check now.

Connect CJ Dropshipping

1. Open Orders > CJ Dropshipping and the Connection tab.
2. Paste the CJ API key, keep the mode on Test, save and click Test connection. A green message means the key works. The key is stored encrypted and is never shown again.
3. Click Register webhooks. CJ then calls your store for order, logistics, stock and product messages. Your store must be reachable over HTTPS from the internet; CJ rejects local addresses.
4. Open the Rules tab and set the price rules, warehouse country and order rules (see Configuration).
5. Test mode sends orders with CJ’s sandbox flag (payment is simulated, nothing is fulfilled). When a test order has gone through, switch the connection to Live.
6. Add the cron job from the settings page (Cron section); every minute is fine. Overlapping runs are prevented.
7. Create a shipping method with the CJ service if you want CJ freight quotes at checkout (see Usage).

Multi-Vendor

By default the marketplace owner connects one CJ account for all vendors (Marketplace owner mode on) and only administrators manage CJ. Switch it off to let each vendor connect their own CJ account in the vendor panel: each vendor then imports products into their own catalogue and sees only their own CJ orders.

Update

1. Upload the new package the same way. Your settings, credentials and data are kept.
2. The add-on adds missing tables and settings by itself on the first request after the update.

See CHANGELOG for what changed in each version.

Uninstall

Open Add-ons > Manage add-ons, click the add-on’s gear button and choose Uninstall. This removes the add-on’s settings, language variables, the CJ shipping services and methods, and its database tables, including the stored API key. Imported CS-Cart products stay.