Advanced Shiprocket Integration for Botble Marketplace By Viral Addons

Advanced Shiprocket Integration for Botble Maketplace By Viral Addons

Advanced Shiprocket Integration for Botble Marketplace By Viral Addons plugin integrates Shiprocket India's #1 eCommerce shipping solution with your Botble store. It supports both Standard Ecommerce and Multi-Vendor Marketplace setups, allowing granular control over shipping logistics.

Requirements

• Mandatory: Botble Ecommerce CMS
• Optional: Botble Marketplace (Only required if you want multi-vendor/seller features)

🚀 Key Features

Core Capabilities

• Live Shipping Rates: Eliminate guesswork with precise shipping costs calculated in real-time. The plugin connects API-first with Shiprocket to fetch live rates from 17+ courier partners (including Delhivery, BlueDart, DTDC, XpressBees, and more) directly at the checkout page, ensuring customers pay the accurate shipping fee based on weight and distance.
• Auto-Push Orders (Admin): Save hours of manual data entry. If enabled, orders placed on your main store are automatically created in Shiprocket explicitly seconds after the customer completes the purchase, instantly triggering the logistics workflow.
• Manual "Ship with Shiprocket": Retain full control when you need it. A dedicated "Ship with Shiprocket" button is integrated into the Order Details page, allowing you to manually validate order details, select a specific courier, and push the order to Shiprocket only when you are ready.
• Instant AWB Generation: Automate your compliance. The system automatically fetches and assigns the Air Waybill (AWB) number from Shiprocket immediately after an order is processed, syncing it back to your store's database without manual copy-pasting.
• One-Click Label Printing: Streamline your packing process. Download and print official shipping labels (PDF) directly from the Botble Admin Panel, saving you the hassle of logging into multiple shipping dashboards.
• Automated Tracking: Keep customers informed and reduce support tickets. The plugin listens for real-time status updates (Shipped, Out for Delivery, Delivered, RTO) via automated Webhooks and updates the order status in your store automatically.
• Courier Transparency: Build trust with your customers. Instead of showing a generic "Standard Shipping" label, the specific courier name (e.g., "Ecom Express Surface") is displayed on the invoice and shipment details, providing full transparency.

🏪 Marketplace / Vendor Support

• Vendor-Specific Accounts: Empower your vendors to manage their own logistics. Vendors can link their own personal Shiprocket accounts via the Vendor Dashboard, ensuring they pay for their own shipping labels and manage their own wallet.
• Isolated Operations & Data Security:
  • Admin Orders: Orders for the main store are processed via the Admin's Shiprocket account.
  • Vendor Orders: Orders for a vendor are processed via that specific Vendor's Shiprocket account.
  • Data from one vendor never leaks to another.
• Strict Mode for Vendors: Prevent shipping conflicts. When a Vendor enables Shiprocket, the system automatically hides all other basic shipping methods (like Table Rate or Flat Rate) for that vendor's products. This ensures that the only shipping option available is the accurate, weight-based Shiprocket rate.
• Vendor-Controlled Free Shipping: Allow vendors to run their own promotions. Vendors can set their own "Free Shipping" rules (e.g., "Free Shipping on orders over ₹999") with a custom title. This overrides the API rate calculation when the condition is met, giving vendors marketing flexibility.

• Pickup Location Sync: Ensure accurate logistics. Both Admins and Vendors can sync and select their specific Warehouse/Pickup Locations directly from a dropdown in their respective settings panels, ensuring couriers arrive at the correct address for pickup.

Requirements

• Mandatory: [Botble Ecommerce CMS]
• Optional: [Botble Marketplace Plugin] (Only required if you want multi-vendor/seller features)

🛠 Installation

1. Extract: Unzip shiprocket.zip.
2. Upload: Move the shiprocket folder into platform/plugins/.
   • Final path: platform/plugins/shiprocket
3. Activate:
   • Go to Admin Panel -> Plugins.
   • Click Activate under "Shiprocket".

⚙️ Admin Configuration

Go to Admin Panel -> Ecommerce -> Shipping -> Shiprocket.

1. Enable Shiprocket: Toggle to ON.
2. Credentials:
   • Email: The email for the External API User (Not your main login email).
   • Password: The password for the External API User (Not your main login password).
   • Note: You can create an External API User in Shiprocket under Settings -> API -> Configure -> Create New User.
3. Test Connection:
   • Click Test Connection.
   • If successful, it will load your Pickup Locations.
4. Pickup Location: Select the warehouse from the dropdown where you want couriers to pick up your products.
   • Note: This is mandatory for rate calculation.
5. Store Availability:
   • Select "Admin Store" (Always checked).
   • Select which Vendor Stores are allowed to use this plugin (if running a marketplace).
6. Auto Push:
   • ON: Orders placed for the Admin Store are sent to Shiprocket instantly.
   • OFF: You must manually click "Ship with Shiprocket" in the Order details.
7. Hide Other Methods:
   • ON: If Shiprocket provides rates, hide "Flat Rate" or other static methods to force users to choose real-time couriers.

⚠️ Important: Product Weight & Dimensions

For Shiprocket to calculate accurate shipping rates, you must ensure all your products have Weight and Dimensions defined.

1. Edit Product: Go to Admin -> Ecommerce -> Products -> Edit a Product.
2. Shipping Section: Scroll down to the "Shipping" box.
3. Enter Data:
   • Weight (g/kg): Crucial for rate calculation.
   • Dimensions (L x W x H): Required for volumetric weight calculation.
4. Save: Update the product.

If these are missing, Shiprocket may return a fallback rate or fail to return rates entirely.

👤 Vendor Configuration (Marketplace)

If you are a Vendor:

1. Log in to your Vendor Dashboard.
2. Go to Settings -> Shiprocket tab.
3. Setup Credentials:
   • Go to Shiprocket Panel -> Settings -> API -> Configure -> Create New User.
   • Create an External API User (Email & Password).
   • Enter these specific credentials in your Vendor Dashboard (Do NOT use your main Shiprocket login).
   • Click Test Connection to sync.
4. Pickup Location:
   • Select your correct Pickup Location from the dropdown.
5. Free Shipping (Optional):
   • Enable "Free Shipping".
   • Set Minimum Amount (e.g., 1000).
   • Set Title (e.g., "Free Priority Shipping").
   • Result: If a customer buys ₹1000+ from your store, they get free shipping; otherwise, they pay Shiprocket rates.
6. Strict Mode:
   • Once you enable Shiprocket, other shipping methods for your store are automatically hidden to ensure accurate billing.

📡 Webhook Setup (Required for Tracking)

To receive updates like "Out for Delivery" or "Delivered" automatically:

1. Copy URL:
   • Go to Settings -> Shiprocket (Admin or Vendor).
   • Copy the Webhook URL (e.g., https://yourdomain.com/shiprocket/webhooks).
2. Paste in Shiprocket:
   • Login to Shiprocket.
   • Go to Settings -> API -> Webhooks.
   • Click Create Webhook.
   • URL: Paste the link.
   • Events: Select Order Shipped, Order Delivered, Order Cancelled, RTO Initiated.
   • Click Save.

📦 How to Process Orders

Method 1: Auto-Push (Admin Only)

If enabled in settings, orders are automatically pushed to Shiprocket immediately upon placement. The system will auto-select the cheapest courier and generate an AWB.

Method 2: Manual Push

For Vendor orders or if Auto-Push is disabled:

1. Open the Order Details page.
2. Locate the Shipment box (usually on the right sidebar).
3. Click "Ship with Shiprocket".
4. A popup will show available couriers and rates. Select one to proceed.
5. The order is now created in Shiprocket and an AWB is assigned.

Print Label & Tracking

Once the order is pushed (via Auto or Manual), the buttons in the Shipment box will change:

• Print Label: Click to download/print the shipping label.
• Track Shipment: Click to view real-time tracking status.

🚚 What Happens Next? (Post-Push Steps)

After an order is successfully pushed to Shiprocket and an AWB is assigned:

1. Pickup Scheduling:
   • Go to your Shiprocket Dashboard.
   • Navigate to Orders -> Ready to Ship.
   • Select the order(s) and click Request Pickup to notify the courier.
2. Downloading Labels:
   • You can print the label directly from the Botble Admin Panel (Shipment Box -> "Print Label").
   • Alternatively, download it from the Shiprocket Dashboard.
3. Handover:
   • Paste the label on the package.
   • Hand over the package to the courier agent when they arrive.
4. Automatic Tracking:
   • Once the courier scans the package, the order status in Botble will automatically update to "Shipped".
   • Further updates (Out for Delivery, Delivered) are synced automatically via Webhooks.

❓ Troubleshooting

"Invalid Pickup Pincode" or "No Rates Found"

• Cause: The Pincode in Settings -> Pickup Location matches a location in Shiprocket, but that location might not serve the customer's area.
• Fix: Ensure you have selected the correct Pickup Location in the dropdown. Do not just type a random pincode.

"Authentication Failed"

• Cause: Wrong Email/Password.
• Fix: Vendors must use an External API User created in Shiprocket Settings -> API, NOT their main login email.

© ViralAddons - Building Premium Botble Extensions.

Change log

Version 1.0.1 (Feb 7, 2026) - Initial Release