← All documentation · Catalog & Commerce

Ship orders with a courier

Connect Shiprocket and ship from an order: compare live courier rates, book a pickup, print the label and manifest, and let scans move orders to Delivered.

14 min read · Last updated 2026-10-21

Connect a courier account and LogAI books the shipment for you: real rates from inside the order, an AWB and a scheduled pickup, a printable label, and courier scans that move the order through Shipped → Out for delivery → Delivered without anyone touching a status dropdown. This guide covers Shiprocket, the courier aggregator for shipping within India; the plumbing is carrier-neutral, so the steps stay the same as more providers are added.

Two different “shipping” screens: Store → Configuration → Shipping Providers is the shipping workspace — the courier connection, pickup locations, packages, delivery areas and the delivery options shoppers choose at checkout, including live courier prices. Store → Configuration → Shipping Charges is the simpler price list by order total — see Delivery charges. Both edit the same delivery options, and you can charge for delivery without a courier account.

Set up shipping

Open Store → Configuration → Shipping Providers. The list on the left holds every part of the setup — Delivery options, Delivery areas, Pickup locations, Ship-from address, Packages, Shipping holidays, Health check, Carriers & buckets and Advanced pricing — with a warning icon on any that still needs work. Start setup (it opens by itself the first time you visit with nothing set up, and reads Continue setup once a provider is connected) walks through the essentials in seven steps:

1. 1 — Provider. Pick Shiprocket (“Best for shipping within India”). Shiprocket needs a dedicated API user: in Shiprocket go to Settings → API → Configure and create one, with an email *different* from your Shiprocket login — it doesn't need a working inbox. Enter that Account email and the API user password, then click Save and test connection. Credentials are stored encrypted and used only for shipping.
2. 2 — Ship from. Your business contact and address — Business or warehouse name, Pickup phone, street, city, state, Postcode / PIN and country — plus the units you measure in (kg or lb, cm or in). Continue saves it. Live courier prices are quoted from your default pickup location (step 4), the same place the courier collects from; the ship-from postcode is only used while you have no pickup location yet.
3. 3 — Packages. Add at least one saved package — Add package, or Add starter packages for common sizes — and fill in the Fallback parcel: the size and weight used whenever a product in the order has no measurements of its own. Couriers bill the higher of actual and volumetric weight (L×B×H ÷ 5000), so real per-product values give the most accurate prices.
4. 4 — Pickup. Where the courier collects from. Add location takes a short name, contact person, phone (couriers require one), address and postal / PIN code; Import from carrier pulls in the pickup addresses already on your Shiprocket account. Register pushes a location to Shiprocket — see Pickup locations and Shiprocket below for what it checks and what the status badge means. The starred location is the default; Make default moves the star.
5. 5 — Delivery areas. The regions you deliver to, checked from top to bottom — Add area, or Add starter zones for a ready-made layout you can edit. The Prices by area tab sets a price per area for delivery options priced that way.
6. 6 — Delivery options. What shoppers choose at checkout. Add option sets a Method Name, a Customer Description and how it's Priced by: Free, Flat rate, % of order, Per unit, Item rates, Zone percentage, or Live carrier — real courier quotes sorted into the Delivery bucket you pick. At least one option has to be switched on.
7. 7 — Review. A checklist of the essentials; Finish setup unlocks when every row is ready. Afterwards, Health check in the left-hand list keeps running the same checks, including products that still need a weight.

What booking a courier actually needs: To ship orders you already have, LogAI needs a connected provider, a pickup location that is registered and active with the courier, and product measurements or a fallback parcel. Delivery areas and delivery options decide what checkout offers and charges — they don't hold up booking a courier for an existing order.

Pickup locations and Shiprocket

Each card under Pickup locations carries a badge showing where it stands with the courier, the phone and address, and — when Shiprocket knows the address by a different name — a line such as “Shiprocket name: Main store-12”. When Shiprocket rejects an address, the reason is shown under it in red, and the form opens with the field to fix (phone, address line 1, PIN code…) already marked.

• What Shiprocket accepts — an address in India, an Address line 1 with a house, flat, building or road number in it, and an Indian mobile number as the phone (+91 and 10 digits). Each is checked before anything is sent, and the form marks the field that failed.
• No duplicates — Register first looks for the same address (address lines, PIN code and phone) on your Shiprocket account and links to it, whatever it's called there. If the short name is already used in Shiprocket by a different address, the location is registered under a free variant (the name plus a number) and the card shows the Shiprocket name.
• Refresh status — Refresh status at the top of the list (shown once any location is registered) re-reads every registered address from Shiprocket; an inactive card has its own Refresh status button. A toast says whether any addresses are still inactive.
• Renaming — you can now change a location's short name after creating it. The rename is local: Shiprocket keeps the name it registered, and bookings keep using that name.
• Changing the address or phone — couriers can't edit a pickup address, so changing the street, city, state, country, PIN code or phone makes the location Not registered again; click Register to add the new address to Shiprocket.
• Deleting — removes the location from LogAI only. Shiprocket offers no way to delete a pickup address from outside its panel, so the address stays there.
• Importing — Import from carrier skips addresses whose name already exists in LogAI or that a LogAI location is already linked to, so importing twice doesn't create copies.

Booking checks the pickup address first: A shipment can't be booked from a pickup location Shiprocket holds inactive: the ship dialog stops with “Pickup address '…' isn't active in Shiprocket. Verify its phone in Shiprocket → Settings → Pickup Addresses, then click Refresh status.” A location whose registration failed or disappeared from Shiprocket is refused too, with a prompt to register it again. Pick another location in the dialog's Pickup from, or fix this one.

Preview what a customer pays

Preview price under Delivery options opens the Rate calculator, which prices a real cart exactly as checkout and the POS do. Enter the destination (Country, State / Province, City, Postcode / PIN, optional Street address), pick a Product (required — “Select a product”), a Variant if it has them, the Quantity, the Subtotal and an optional Coupon code, then click Calculate rates.

• Matched Zone — the delivery area the address fell into.
• Live rating — whether live courier prices were fetched and how many came back, plus the parcel the courier was asked about (“Rated as … (packed in …), shipping from 560001.”) — the same package and pickup PIN code LogAI sends when you book the shipment.
• Customer sees — every option the shopper would be offered, with separate Online and Cash on Delivery prices (tax shown with each), the delivery promise, how it's Priced by (with a COD badge when Cash on Delivery is on offer) and a step-by-step How it got there. Live carrier options list each courier underneath with its own online and COD price; the cheapest is marked Cheapest, and “COD not available” means that courier won't collect cash at this address.
• Payment fees — the convenience fee each enabled payment method adds to this cart (set in Store → Configuration → Payment Methods).
• Unavailable methods — options this buyer won't see and why (outside the delivery area, failed conditions, or no courier).
• A coupon that doesn't apply shows “Coupon not applied.” with the reason; the prices are then without it.

Courier preferences

Once Shiprocket is connected, Manage providers at the top of the page opens its settings:

• Show live delivery rates — on the primary provider, lets Live carrier delivery options quote real Shiprocket prices at checkout. Turned off, those options are withheld and shoppers see only the options you price yourself; Carriers & buckets shows whether it's on.
• How should we choose a courier? — Best balance of price and speed, Lowest price, Fastest delivery, or Choose for every shipment. The Create shipment dialog still pre-selects the courier picked at checkout, or else Shiprocket's Recommended one, so check the selection before you book.
• Sync tracking automatically (“Keep order status up to date”, on by default) — courier scans move the order status and send the usual customer emails, as in the table below. Turned off, scans still update the shipment's timeline but the order status stays yours to set.
• Default pickup location — used when the ship dialog doesn't name one.
• Test connection re-checks the credentials, Replace credentials swaps in a different API user, and Disconnect (click again to Confirm disconnect) removes the account.

Leave Checkout rates switched on: Despite its label, the Checkout rates switch turns the whole Shiprocket account on or off: with it off, fetching rates, booking, cancelling and tracking from orders all stop until it's back on. To stop live prices at checkout only, turn off Show live delivery rates instead. The Create shipments automatically and Email failed-delivery alerts switches are saved, but LogAI doesn't act on them yet — book each shipment from its order.

How tracking updates arrive

LogAI pulls tracking from Shiprocket in the background: every 30 minutes it refreshes any active shipment that hasn't had an update for six hours. The refresh icon (Refresh tracking) on a shipment pulls the latest scans immediately.

Shiprocket's tracking webhook: LogAI can also take instant tracking pushes from Shiprocket, but the current Shipping Providers screens don't show the webhook URL or token, so the webhook can't be set up from the app at the moment. A webhook you already configured in Shiprocket's panel keeps working; otherwise rely on the background refresh and the refresh icon.

Ship an order

Open any order in Commerce → Orders — storefront orders and Point of Sale sales alike — and find the Shipment section in its sidebar. A shipment can be booked once the order is Processed, Confirmed or On hold and has a shipping address; the customer also needs a valid phone number, because couriers won't take a parcel without one.

1. Click Create shipment. The Create shipment dialog opens with the pickup location and the package pre-filled from the products in the order. If any product has no weight or size, a warning says your default package (the fallback parcel) was used — correct the figures here if this parcel is different, then Recalculate rates.
2. Compare couriers. LogAI checks serviceability for the delivery pincode and lists every courier that can take it, with its price and estimated delivery time; Shiprocket's suggestion carries a Recommended badge and is pre-selected. If a courier was already picked when the order was placed — on the POS ticket or at storefront checkout — the Shipment section shows “Chosen during checkout: …” and the dialog pre-selects that courier instead, as long as it still serves the pincode. That is always the courier the customer was charged for: if the one picked can't take the order's payment method (no Cash on Delivery, say), LogAI prices the cheapest courier that can and saves that one. Cash-on-Delivery orders show exactly how much the courier will collect. When the order ships from a branch or warehouse linked to a pickup address, rates and the booking use that pickup address unless you choose another under Pickup from.
3. Book the shipment. Book shipment creates the order with Shiprocket, assigns the AWB, schedules the pickup and generates the shipping label in one go. The order Shiprocket receives lists each item at the price the customer actually paid (after discounts, tax included) with its tax rate, plus the delivery charge and any convenience fee — so its order value matches the customer's total.
4. Print and hand over. The section now shows the courier, tracking number (click to copy), estimated delivery and pickup date, with Label and Manifest buttons and a Track on courier site link. The refresh icon (Refresh tracking) pulls the latest scans on demand.

Counter sales don't need a courier: For a sale handed over at the counter, turn on Free for customer under the POS ticket's Shipping Charges — the order then carries no delivery charge and isn't meant for a courier. Otherwise pick a delivery option: for a Live carrier option the ticket lists the couriers that deliver to the customer's address, priced by LogAI for the chosen payment method, with the cheapest pre-selected. The order remembers the courier, so the Shipment section shows it as “Chosen during checkout” and the ship dialog pre-selects it. Right after the sale, the POS offers Book shipment to do this straight away.

Couriers and Cash on Delivery at checkout: For a Live carrier delivery option, storefront checkout receives every courier that delivers within that option's promised window, cheapest first, each with its delivery estimate and two prices — online and Cash on Delivery — because couriers charge more to collect cash. LogAI prices delivery for the payment method the shopper chooses, re-checks the live price as the order is placed, charges it, and saves the courier on the order for the ship dialog. Cash on Delivery needs the store's Cash on Delivery switch on (Store → Configuration → Payment Methods); for a live carrier option it also needs at least one courier that collects cash at that address — otherwise the option isn't offered for COD (“Cash on Delivery is not available for this address with live couriers.”). Options you price yourself (flat, free, by order total…) cost the same either way. Preview price shows both prices side by side.

What happens automatically after that

Every courier scan — from the background refresh, the refresh icon or a webhook — is normalized, added to the shipment's timeline, and (with Sync tracking automatically on) applied to the order:

Out-of-order scans can't confuse it: Shipment events only ever move forward (with sensible exceptions like a re-attempt after a failed delivery), duplicates are ignored, and a Delivered order is never walked backwards. If you turn Sync tracking automatically off, tracking still updates the timeline — LogAI just stops touching the order, and statuses stay yours to set. Orders you've manually cancelled or refunded are never overridden either way.

When something goes wrong

• Booking stalled part-way — the error is shown on the shipment with a Retry booking step button that resumes from where it failed instead of creating a duplicate. If it answers “Booking never reached the courier — cancel this shipment and create a new one.”, cancel the shipment and see the next point.
• Booking a replacement — once an order has a shipment, the Shipment section keeps showing it, even after it's cancelled, lost or damaged, and there's no button to book another one yet. Book the replacement in Shiprocket's own panel and move the order's status by hand — LogAI doesn't track a shipment it didn't book.
• Wrong courier or wrong address — Cancel shipment (click again to Confirm cancel?) is available until the parcel is picked up. Because a fresh booking isn't possible afterwards (see above), double-check the courier and address before you book.
• No courier serves the pincode — the dialog says “No courier services 560001 → 110001 for this package.” (with your pickup and delivery pincodes), and at the POS a live carrier option can't be priced, so the ticket says why (“No courier can deliver this order online.”, or “Cash on Delivery is not available for this shipping option.” for COD) before the sale is completed. COD availability is checked separately from prepaid.
• Pickup address inactive — booking stops with “Pickup address '…' isn't active in Shiprocket…”. Verify the address's phone in Shiprocket's panel, then click Refresh status under Pickup locations (see above).
• The customer has no phone number — rates stop with “The customer has no valid phone number — couriers require one for delivery…”. Add a phone number to the contact and open the dialog again.
• Rates look wrong — nearly always missing product measurements. Add weight and L×B×H to the products in the order (Packages → Product measurements counts the ones still missing them); a note on the shipment tells you when the default package was used.

Access

The Shipping Providers page needs View on Integration. Connecting Shiprocket, changing its preferences and managing pickup locations are checked against Integration on the server (Update, plus Create and Delete for pickup locations) and against the same flags on Order in the screen, so give both — importing, registering, syncing or refreshing the status of pickup locations also needs Manage on Order. Delivery areas, delivery options, packages and the ship-from address use Order (View, Create, Update, Delete). From an order, viewing rates and refreshing tracking need View on Order; booking needs Create, and cancelling, retrying or restoring stock need Update — each together with Manage on Order, which unlocks the shipment buttons, including Label and Manifest.

Open the LogAI app — start free, no credit card required.