← All documentation · Catalog & Commerce

Ship orders with a courier

Connect Shiprocket to LogAI and ship straight from an order: compare live courier rates, book a pickup, print the label and manifest, and let courier scans move your orders through Shipped, Out for delivery and Delivered on their own.

11 min read · Last updated 2026-10-04

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. The contact and address printed on labels and used for prices: 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.
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. If Shiprocket rejects an address, the error gives its reason and names the field to fix (a phone or pincode, say), and the location stays Not registered until you correct it and register again. 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, 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.

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. Cash-on-Delivery orders show exactly how much the courier will collect.
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 the ticket shows live rates from every courier that delivers to the customer's pincode and lets the operator pick one; the order remembers it, so the Shipment section shows it as “Chosen during checkout” and the ship dialog pre-selects it.

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 price and delivery estimate. When the shopper picks one, LogAI re-checks that courier's live price as the order is placed, charges it, and saves the courier on the order for the ship dialog. Whether checkout offers Cash on Delivery follows the store's Cash on Delivery switch in Store → Configuration → Payment Methods — the same for every delivery option and courier; Preview price under Delivery options on the Shipping Providers page marks options with a COD badge when it's on.

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 the ticket warns before the sale is even completed. COD availability is checked separately from prepaid.
• 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 or syncing 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.