BlueDart Plugin

The BlueDart plugin integrates your store with BlueDart, one of India's premier courier and express delivery services. When an order is confirmed, the plugin automatically generates an AWB (Air Waybill) through BlueDart's API, and updates the order with tracking information.

What It Does

• Auto-generates AWB waybills on BlueDart when you confirm an order
• Stores tracking numbers on the order record
• Creates tracking URLs so customers can follow their deliveries on BlueDart's website
• Handles both prepaid and COD (Cash on Delivery) orders
• Automatically calculates item count and package value for the waybill

Requirements

• An active BlueDart business account with API access
• Your BlueDart API Key (JWT Token)
• Your BlueDart License Key
• Your BlueDart Customer Code (account number)

WARNING

BlueDart API access is typically provided to registered business customers. Contact BlueDart's sales team or your account manager to get API credentials.

Setting Up BlueDart

Step 1: Get Your API Credentials

Contact your BlueDart account manager or log in to the BlueDart API portal to obtain:

• API Key -- your JWT authentication token
• License Key -- provided with your API access
• Customer Code -- your BlueDart account number

Step 2: Know Your Origin Details

You will need the following information about your shipping/warehouse location:

• Origin Area Code -- BlueDart's service area code for your location (e.g., BOM for Mumbai, DEL for Delhi, BLR for Bangalore)
• Shipper name -- your business name
• Shipper address and PIN code
• Shipper phone number

Step 3: Configure the Plugin

1. Go to Admin Panel > Plugins
2. Find BlueDart and click Enable
3. Click Settings
4. Fill in all the required fields (see table below)
5. Click Save

Plugin Settings

Setting	What to Enter
API Key	Your BlueDart API key (JWT token)
License Key	Your BlueDart license key
Customer Code	Your BlueDart customer code / account number
Origin Area Code	BlueDart service area code for your location (e.g., BOM, DEL, BLR)
Shipper Name	Your business name as the sender
Shipper Phone	Contact phone number for the shipper
Shipper Address	Full address of your shipping location
Origin Pincode	PIN code of your shipping location
Default Weight (kg)	Default package weight in kilograms (e.g., 0.5). Used when product weight is not specified
Auto-create Shipment on Confirm	Toggle on to automatically generate waybills when orders are confirmed

Common Area Codes

Here are some frequently used BlueDart origin area codes:

Code	City
BOM	Mumbai
DEL	Delhi
BLR	Bangalore
MAA	Chennai
CCU	Kolkata
HYD	Hyderabad
PNQ	Pune
AMD	Ahmedabad

TIP

If you are unsure about your area code, contact BlueDart support or check the BlueDart service area finder on their website.

How It Works

Once the plugin is configured and the auto-create toggle is enabled:

1. A customer places an order on your store
2. You go to Admin Panel > Orders and change the order status to Confirmed
3. The plugin sends the shipment details to BlueDart's waybill generation API
4. BlueDart generates an AWB number for the shipment
5. The AWB number and BlueDart tracking URL are saved to the order
6. Customers can track their package on BlueDart's tracking page

Tracking Information

When a waybill is generated successfully, the plugin adds:

• Tracking ID -- the AWB number assigned by BlueDart
• Tracking URL -- a direct link to BlueDart's tracking page for that shipment

This information appears on the order in both the admin panel and the customer's order history.

Troubleshooting

Waybills are not being generated

• Make sure the plugin is enabled and Auto-create Shipment on Confirm is toggled on
• Verify the order status was changed to Confirmed
• Check that the order has a complete shipping address with a valid PIN code

"Missing API credentials" error

• Make sure all three credential fields are filled in: API Key, License Key, and Customer Code

"Waybill generation returned error"

• Check storage/logs/laravel.log for the detailed error from BlueDart's API
• Common causes: invalid area code, incorrect customer code, or unsupported destination

AWB number not appearing on the order

• The API call may have succeeded but no AWB was returned. Check your BlueDart dashboard for the shipment status

TIP

For any persistent issues, check storage/logs/laravel.log where the plugin logs detailed error information including the full API response from BlueDart.