CJ Dropshipping

CJ Dropshipping Plugin for Botble CMS

The CJ Dropshipping Plugin allows you to seamlessly import products from CJ Dropshipping directly into your Botble CMS store. It operates as a catalog mirror, preserving structure and product data from selected CJ categories.

[!IMPORTANT]
This plugin is focused exclusively on product importation. It does not handle payments, orders, fulfillment automation, or real-time inventory updates.

📍 Usage

After installation and activation, you can find the plugin settings and import dashboard in your Botble Admin panel under: Ecommerce → CJ Dropshipping Import

🚀 Current Plugin Scope

✅ What the Plugin Does:

• Importing: Pulls products from selected CJ categories.
• Draft Creation: All products are imported as drafts for manual review.
• Data Integrity: Imports images, descriptions, SKU, attributes, variations, and weight.
• Pricing: Allows for profit/margin percentage configuration.
• Automation: Supports manual and Cron-based synchronization.
• Logging: Includes a Debug Mode for record-keeping.
• Cleanup: Includes a "Danger Zone" to clear all imported data.

❌ What the Plugin Does NOT Do:

• Create orders or CJ fulfillments automatically.
• Process payments.
• Sync shipment statuses.
• Provide real-time inventory or price updates after import.

⚙️ How Synchronization Works

The module provides a granular approach to catalog management:

1. Selection: Select one or more CJ categories to mirror.
2. Limits: Define product import limits (ideal for Sandbox mode).
3. Margins: Apply a global Profit/Margin percentage.
4. Workflow: Run synchronization manually or via Cron.

Note: CJ API rate limits apply. Excessive requests may interrupt the import process.

📦 Product Import Details

Imported products include the following metadata:

• Visuals: Full image gallery.
• Content: Detailed descriptions.
• Logistics: Weight and SKU.
• Structure: Attributes and Variations.

🛠️ Important Publishing Requirement

To avoid errors, every imported product must be:

1. Reviewed manually.
2. Assigned a slug using the "Create slug" button.
3. Published only after validation. If a slug is not generated, the product will return a 404 error on the frontend.

💰 Price & Margin Handling

You can define a Profit / Margin (%) during the import process. This percentage is automatically added to the base cost of imported products.

⏱️ Automatic Synchronization (Cron)

The plugin supports Cron-based execution for automated catalog updates.

• Recommended Frequency: Every hour.
• Alternative Frequencies: Twice daily or once daily.
• Manual Trigger: You may run the Laravel command manually via terminal.

Note: Cron synchronizes product data only; it does not enable automatic order placement.

🐞 Debug Mode & Environment

Debug Mode

Logs all synchronization actions to assist with:

• API troubleshooting and rate limit detection.
• Import error tracking and diagnostics.

Environment Support

• Sandbox Mode: Test environment for safe testing with limited imports.
• Production Mode: Full catalog synchronization.
• Both modes use the same API credentials.

⚠️ Danger Zone

Within the settings, you can permanently delete:

• All imported CJ products.
• Synchronization records and mapping data.

Warning: This action cannot be undone. Use with extreme caution in Production environments.

📋 Requirements

To ensure the correct operation of the plugin, your environment must meet the following specifications:

• Botble Core: version 7.0.0 or higher.
• Ecommerce Plugin: Must be installed and enabled.
• SSL Certificate: HTTPS is strictly required for secure API communication.
• CJ Dropshipping Account: A valid account with an active store profile.
• API Credentials: Generated App Key and App Secret from the CJ Dashboard.
• Server Cron: Properly configured (optional, but required for automated synchronization).

🛠️ API Configuration Guide

1. Log in to your CJ Dropshipping Dashboard.
2. Navigate to Apps → API.
3. Activate the API Virtual Store.
4. Generate your App Key and App Secret.
5. Enter these credentials into the plugin settings in Botble.
6. Ensure the API store shows a green checkmark (active) before running synchronization.

🔒 Security Notes

• Store API credentials securely.
• Never expose your App Key or App Secret in public repositories or client-side code.
• All requests are authenticated via the official CJ API.