shipping-carriers

Shiprocket has no official Node.js SDK, so build a typed fetch wrapper around its REST API at apiv2.shiprocket.in. Authenticate via the /auth/login endpoint, cache the returned token for its 8-day validity, then call endpoints like /orders/create/adhoc and /courier/assign/awb with a Bearer token.

Use the @easypost/api package to create a Shipment with from_address, to_address, parcel dimensions, and customs_info including HS tariff numbers. Then call lowestRate with preferred carriers like DHL, FedEx, and UPS, and buy the shipment to receive a tracking code and label URL.

Shiprocket is an aggregator suited for domestic India shipments with pincode-based addresses and prepaid orders. EasyPost handles international shipments with customs declarations and multi-carrier rate shopping, so a common pattern routes by the isInternational flag.

Cache the auth token in memory along with an expiry timestamp set 8 days ahead, matching Shiprocket's token validity. Before each API call, check whether the cached token is still valid and re-authenticate via /auth/login only when expired.

Maintain a lookup map translating carrier-specific codes into unified statuses. Shiprocket returns numeric codes like 6 for in-transit and 7 for delivered, while EasyPost uses strings like in_transit and out_for_delivery, both mapping to canonical values such as IN_TRANSIT and DELIVERED.

A 401 typically means the Bearer token is missing or expired, so verify the token cache logic and re-authenticate. Also confirm the phone number strips the +91 prefix and that prices are converted from paise to rupees, since malformed payloads can surface as request errors.