How to Integrate ILS Portal API to Automate Order Shipping
API Integration
Managing shipping manually becomes increasingly difficult as your online business grows. From creating shipments and assigning courier partners to tracking orders and managing returns, handling logistics through multiple platforms can consume valuable time and increase the risk of errors.
This is where ILS Portal API Integration helps businesses streamline and automate their shipping operations. By connecting your store, marketplace, ERP, or custom application with Indian Logistics Services (ILS), you can automate order processing, shipment creation, tracking updates, return management, and much more from a single platform.
In this guide, we'll explain how to integrate the ILS Portal API, the benefits it offers, and how businesses can use it to create a fully automated shipping workflow.
What Exactly Is the ILS Portal?
Before we get into the API itself, let me give you a quick picture of what ILS Portal is, because it matters for understanding why this API is different from others you might have used.
Indian Logistics Services (ILS Portal) is a multi-courier logistics management platform built specifically for Indian eCommerce businesses. Through one dashboard, you can manage shipments across 13+ courier partners, Delhivery, Bluedart, DTDC, XpressBees, Ekart, Amazon Shipping, and more, without logging into each courier portal separately.
Why Businesses Need Shipping Automation
Many businesses start with manual shipping processes. However, as order volumes increase, manual operations become inefficient.
Common challenges include:
- Manually creating shipments for every order
- Managing multiple courier accounts
- Delayed order processing
- Tracking updates across different platforms
- Increased chances of shipping errors
- Difficulty handling return requests
Shipping automation eliminates these bottlenecks by ensuring that orders move through the fulfillment process automatically and accurately.
Who Actually Needs This API?
The honest answer is any business that ships orders from a system that isn't Shopify, WooCommerce, or Wix.
That might be a D2C brand that built its own React or Next.js storefront. A textile wholesaler running orders through a custom ERP. A SaaS company that wants to embed courier management into its seller dashboard. A multi-channel aggregator handling orders from WhatsApp, Instagram, and their website all at once.
If any of those sound like you, keep reading. If you're on Shopify the native ILS plugins are probably a faster path, but the API knowledge here will still come in handy.
What Does the API Actually Do?
The ILS Orders API is a clean REST API with four endpoints, JSON in and JSON out, and authenticated with a single API key. Here's the bird's-eye view before we go deeper:
| What You Want to Do | Endpoint |
|---|---|
| Push a new order into ILS Panel | POST /api/order/create |
| Fetch an order's full details + status | POST /api/order/detail |
| Update address, tags, or add tracking | POST /api/order/update |
| Remove an order that was created by mistake | POST /api/order/delete |
Everything goes to https://ilsportal.io/api/, and every single request uses POST. You don't need OAuth, token refreshes, or any complex auth flow, just your API key in a header called auth-key.
How the ILS Portal API Works
The API integration process follows a simple workflow:
Step 1: Customer Places an Order
A customer places an order on your online store.
Step 2: Order Data is Sent to ILS
The order information is automatically transmitted to the ILS Portal through API integration.
Step 3: Shipment is Created
The API generates shipping details and creates a shipment request.
Step 4: Courier Assignment
The selected courier partner receives shipment information.
Step 5: Pickup and Dispatch
The shipment is picked up and enters the delivery network.
Step 6: Tracking Updates
Real-time tracking information is continuously updated.
Step 7: Delivery Confirmation
Final delivery status is automatically synced back to your system.
This automated process significantly reduces manual effort and speeds up order fulfillment.
Step-by-Step Guide to Integrating ILS Portal API
1. Create an ILS Portal Account
Start by registering your business with Indian Logistics Services (ILS) and setting up your logistics account.
Ensure your shipping preferences, warehouse information, and courier configurations are properly configured.
2. Obtain API Credentials
After account setup, you'll receive API access credentials that allow your system to communicate with the ILS Portal securely.
These credentials may include:
- API Key
- Authentication Token
- Account Identifier
- Environment Configuration Details
Store these credentials securely and avoid exposing them publicly.
3. Connect Your Platform
The ILS Portal can be integrated with:
- Shopify Stores
- WooCommerce Websites
- Wix Stores
- Magento Stores
- ERP Systems
- Mobile Applications
- Custom Business Software
Developers can use the API endpoints to establish secure communication between systems.
4. Configure Order Mapping
Map your platform's order fields with ILS shipping requirements.
This typically includes:
- Customer information
- Shipping address
- Product details
- Payment information
- Order reference IDs
Proper mapping ensures smooth shipment creation.
5. Test API Connectivity
Before moving to production, verify that:
- Orders sync correctly
- Shipment creation works properly
- Tracking information is returned accurately
- Error handling functions as expected
Testing helps prevent operational issues after deployment.
6. Go Live
Once testing is complete, activate the integration and begin processing live orders through the automated shipping workflow.
Monitor the system during the initial phase to ensure optimal performance.
What Changes After You Integrate
To give you a clear picture of the before and after, here's how the two approaches compare side by side:
| Aspect | Manual Process | After ILS API Integration |
|---|---|---|
| Order entry speed | Minutes per order, per team member | Milliseconds, automated |
| Human error rate | High — typos in addresses and AWBs | Near-zero — validated programmatically |
| COD handling | Tracked in spreadsheets | Built-in payment_type field |
| GST compliance | Manual GSTIN/HSN entry | Sent per-order via API automatically |
| Partial shipments | Tracked manually | Handled natively with items[] |
| Scalability | Breaks down at 100+ orders/day | Handles thousands without extra staff |
| Courier flexibility | Repeat work per courier | One API, 13+ couriers via ILS Panel |
The ROI on this integration shows up in the first week. Once it's live, the time your team was spending on manual data entry goes back to customer service, product, and growth.
Common Questions People Ask
Do I need to be a developer to use this API?
You'll need a developer to integrate it into your production system. But you can test and explore all four endpoints yourself using the Postman collection, no code required for that part.
Is the API free?
Yes. Your ILS Panel account includes API access, and your first 25 shipments cost nothing. Sign up at ilsportal.io/register.
Does it work with Magento, BigCommerce, or a custom PHP/Python/Node.js app?
Yes, it works with any platform that can make an HTTP POST request. Language and framework don't matter.
Can I use it with international shipping?
The ILS Orders API is currently built for domestic Indian shipping. Address fields follow the Indian format: PIN code, state code, and 10-digit mobile number.
What if I send the wrong field name?
The API returns a 400 Bad Request with a clear message like "Invalid request keys: total_price". You never get an HTML error or an empty response; you always get clean JSON.
How do I know my API key is secure?
The key is only visible to you inside the ILS Panel. If you ever suspect it's been exposed, contact [email protected] to rotate it. All derived tokens are immediately invalidated.
Can I use this for white-label courier accounts?
Yes. The ILS Orders API works seamlessly with white-label accounts on the platform.
Ready to Get Started?
If you've read this far, you already have everything you need to know. The ILS Orders API is genuinely one of the cleanest shipping integrations available for Indian eCommerce, with four endpoints, consistent JSON, COD support, GST fields, partial fulfillment, and a free Postman collection to get you testing in minutes.
Your first 25 orders are free. There's no reason not to start today.
