How to connect Delhivery to your store

With Delhivery connected, every order shows Delhivery Surface and Delhivery Express with the charge for that parcel. You book in one click, print Delhivery's label and Zepio tracks the parcel to the door.

Where: Admin › Settings › Delivery Setup › Courier partners › Delhivery

Before you start

You need a Delhivery One account for parcels (B2C) with API access. If you do not have one, sign up at one.delhivery.com or ask your Delhivery account manager.

Get your API token

1. Log in to Delhivery One and open Settings › API Setup.
2. Copy your API token. If there is none, click Request Live API Token.
3. Delhivery shows a new token only once, for a few minutes. Copy it straight away. Requesting a new token stops the old one working.

For testing, Delhivery can give you a separate staging token. Ask your account manager.

Connect Delhivery in Zepio

1. Go to Settings › Delivery Setup. Under How do you deliver orders?, choose Courier partners and click Apply changes.
2. Under Courier partners, click Delhivery.
3. Choose Environment: Live for your live token, Test (staging) for a staging token.
4. Paste the API token and click Connect.

Register your pickup locations

Delhivery only picks up from locations registered in your Delhivery account, and the name must match exactly. Under Pickup addresses, for each branch:

1. Add a Pickup contact name and a 10-digit Pickup phone.
2. Click Add to Delhivery, check the name and click Add address. Zepio registers the branch address with Delhivery and matches the branch to it.
3. Already have the location in Delhivery? Type its name exactly as Delhivery shows it in Name of this address in Delhivery instead, then click Save.

Shipping options

Under Shipping options:

• Services to offer: Surface, Express, or both. Only these show on your orders.
• Pickup time for pickup requests: the time Delhivery should come when you book a pickup.

Tracking updates

Zepio checks Delhivery every 30 minutes on its own. For instant updates, Delhivery has to switch them on for you:

1. Under Tracking updates, click Copy URL.
2. Email your Delhivery account manager, or raise a ticket in Delhivery One, asking them to push scans to this URL. Include one live AWB number for their test.

Ship an order

1. Open an order in Processing and add the package size and weight.
2. Click Get rates and click Ship next to Delhivery Surface or Delhivery Express.
3. Pick a pickup date to book the pickup now, or leave it empty and use Book pickup later.
4. Click Book shipment, then Print label.

Delhivery keeps one open pickup per location. If you book more parcels for the same day, they are collected in that same pickup.

More about tracking, cancelling and returns: How to ship orders with courier partners.

If something goes wrong

"Delhivery did not accept this API token" Copy the token again from Settings › API Setup. If you requested a new token, the old one no longer works. Make sure Environment matches the token (live or staging).

"Choose which Delhivery pickup address this branch ships from" The branch is not matched to a Delhivery warehouse yet, so Zepio shows this instead of rates. Under Pickup addresses, click Add to Delhivery or type the warehouse name.

"ClientWarehouse matching query does not exist" or a pickup location error The name in Zepio does not match the location in Delhivery exactly. It is case-sensitive. Use Add to Delhivery or copy the name from Delhivery One.

"Delhivery does not deliver to this pincode" Delhivery has no service there for this payment type. Try another partner.

GST errors Delhivery may ask for your GSTIN. Add it to the branch under Settings › Branches.