Connecting Your Store to ISNAAD - Integration Guide

🔗 Integration Overview

Connecting your store to ISNAAD creates a seamless bridge between your sales channels and our fulfillment network. Orders flow automatically, inventory syncs in real-time, and customers receive tracking updates—all without manual intervention.

5 min

Shopify Setup

5 min

Salla/Zid Setup

1-2 weeks

Custom API Integration

🛍️ Shopify Integration

Shopify is the most straightforward integration we offer. With over 60% of Saudi e-commerce stores using Shopify, we've perfected this process to be nearly automatic.

Shopify App Installation

One-click installation from Shopify App Store

Step-by-Step Process:

1. App Store Access: Visit the Shopify App Store and search for "ISNAAD Fulfillment"
2. Install App: Click "Add app" and authorize the required permissions
3. Account Linking: Enter your ISNAAD merchant credentials
4. Sync Settings: Configure order sync preferences and fulfillment rules
5. Test Orders: Process test orders to verify the integration

🇸🇦 Saudi-Specific Settings:

• Enable Arabic language support for customer notifications
• Configure SAR currency and local tax calculations
• Set up Mada payment method compatibility
• Adjust delivery time estimates for Saudi regions

🛍️ Salla Integration

Salla is one of Saudi Arabia's most popular e-commerce platforms, powering thousands of local businesses. Our native integration provides seamless connectivity with full Arabic support and local market optimization.

Salla App Integration

Native integration with Saudi's favorite platform

Integration Steps:

1. Salla Partner Store: Visit Salla's app marketplace and search for "ISNAAD"
2. App Installation: Click "تثبيت" (Install) and authorize permissions
3. Account Connection: Link your ISNAAD merchant account
4. Fulfillment Setup: Configure delivery zones and processing rules
5. Go Live: Activate fulfillment for your products

🇸🇦 Salla Benefits:

• Complete Arabic interface and customer experience
• Native integration with Saudi payment gateways
• Automatic compliance with ZATCA e-invoicing
• Local holiday and event calendar integration
• Support for Arabic product names and descriptions

🇸🇦 Zid Integration

Zid is another leading Saudi e-commerce platform, known for its user-friendly interface and comprehensive features. Our integration provides full connectivity with local market optimization.

Zid Native Integration

Built for the Saudi market with full Arabic support

Integration Process:

1. Zid Dashboard: Log into your Zid admin panel
2. Apps Section: Navigate to "التطبيقات" (Applications)
3. ISNAAD App: Find and install the ISNAAD fulfillment app
4. Authentication: Connect using your ISNAAD merchant account
5. Configuration: Set fulfillment preferences and delivery zones

🌟 Zid Advantages:

• Native Arabic interface and customer communications
• Built-in Mada and STC Pay integration
• Automatic VAT calculations for Saudi tax compliance
• Local delivery time estimates and holiday calendars
• Support for Arabic product descriptions and SKUs

🔧 Custom API Integration

For businesses with custom-built platforms or specific requirements, we offer comprehensive REST API integration. Our development team works closely with yours to ensure seamless connectivity.

REST API Integration

Full API access for custom implementations

API Endpoints Overview:

Orders API

Submit orders for fulfillment and track status

                                POST /api/v1/orders

                                GET /api/v1/orders/{order_id}

                                PUT /api/v1/orders/{order_id}/cancel

Inventory API

Manage stock levels and product information

                                GET /api/v1/inventory

                                POST /api/v1/inventory/update

                                GET /api/v1/inventory/{sku}

Webhooks

Real-time notifications for order status changes

                                order.created, order.picked, order.packed,

                                order.shipped, order.delivered, inventory.updated

⚡ Integration Best Practices

Follow these proven practices to ensure your integration is robust, scalable, and optimized for the Saudi market:

1. Error Handling & Retry Logic

Implement proper error handling to manage network issues and API rate limits:

// Example retry logic for API calls

                        async function submitOrder(orderData, retries = 3) {

                          try {

                            const response = await fetch('/api/v1/orders', {

                              method: 'POST',

                              headers: { 'Authorization': 'Bearer ' + apiKey },

                              body: JSON.stringify(orderData)

                            });

                            return await response.json();

                          } catch (error) {

                            if (retries > 0) return submitOrder(orderData, retries - 1);

                            throw error;

                          }

                        }

2. Webhook Security

Secure your webhook endpoints to prevent unauthorized access:

🔒 Security Checklist:

• Verify webhook signatures using HMAC-SHA256
• Use HTTPS endpoints only (required for production)
• Implement idempotency to handle duplicate webhooks
• Log all webhook events for debugging and audit trails
• Set up monitoring alerts for failed webhook deliveries

🔍 Testing Your Integration

Thorough testing prevents issues when you go live. Here's our comprehensive testing checklist:

📝 Order Flow Testing

✓ Single item orders
✓ Multiple item orders
✓ Different payment methods
✓ Various delivery addresses
✓ Order cancellations
✓ Partial fulfillments

📊 Data Sync Testing

✓ Inventory level updates
✓ Product information sync
✓ Order status updates
✓ Tracking number delivery
✓ Customer notifications
✓ Return processing

🚨 Troubleshooting Common Issues

Even with perfect setup, issues can arise. Here are the most common problems and their solutions:

❌ Orders Not Syncing

Symptoms: Orders placed on your store don't appear in ISNAAD portal

Common Causes:

• Webhook URL not configured correctly
• API credentials expired or incorrect
• Firewall blocking outbound requests
• Order status not triggering fulfillment rules

Solution: Check webhook logs in your platform, verify API credentials in ISNAAD portal, and ensure fulfillment rules are properly configured.

❌ Inventory Not Updating

Symptoms: Stock levels in your store don't reflect ISNAAD inventory

Common Causes:

• SKU mismatches between store and ISNAAD
• Inventory sync disabled in settings
• Multiple inventory locations causing conflicts
• API rate limiting preventing updates

Solution: Verify SKU mapping, enable inventory sync, consolidate inventory locations, and check API rate limits.

📱 Mobile App Integration

For businesses with mobile apps, ISNAAD provides mobile SDKs for iOS and Android, ensuring your customers get the same seamless experience across all platforms.

📱 iOS SDK

Swift package for iOS applications

                            import ISNAADFulfillment

                            let fulfillment = ISNAADClient(apiKey: "your_key")

                            fulfillment.submitOrder(order) { result in

                              // Handle response

                            }

🤖 Android SDK

Kotlin library for Android applications

                            implementation 'com.isnaad:fulfillment:1.0.0'

                            val client = ISNAADClient(apiKey)

                            client.submitOrder(order) { response ->

                              // Handle response

                            }

🎯 Advanced Configuration

Once your basic integration is working, these advanced features can optimize your fulfillment operations:

Conditional Fulfillment Rules

Set up rules to automatically route orders based on various criteria:

Example Rules:

• Express Orders: Orders over 500 SAR get same-day delivery
• Regional Routing: Riyadh orders go to Riyadh warehouse
• Product-Based: Electronics require special handling
• Time-Based: Orders after 2 PM process next day

Custom Packaging Options

Configure branded packaging for different order types:

• Standard Packaging: ISNAAD branded boxes for regular orders
• Premium Packaging: Your branded boxes for high-value orders
• Gift Packaging: Special wrapping for gift orders
• Eco Packaging: Sustainable materials for environmentally conscious customers

📊 Monitoring Integration Health

Keep your integration running smoothly with these monitoring practices:

Daily Metrics

Order sync rate, processing time, error count

Health Checks

Automated tests every 15 minutes

Alerts

Instant notifications for critical issues

"The integration was surprisingly smooth. Our developer had it working in under an hour, and we've had zero downtime in 8 months of operation." - Khalid Al-Otaibi, CTO of Fashion Forward KSA

🚀 Going Live Checklist

Before switching to live fulfillment, ensure everything is properly configured:

✅ Pre-Launch Checklist

Integration tested with multiple orders

Inventory levels verified and synced

Webhook endpoints responding correctly

Customer notifications working

Error handling implemented

Monitoring and alerts configured

Team trained on new workflow

Backup plan ready if needed

Ready to Connect Your Store?

Our technical team is ready to help you integrate your platform with ISNAAD

Start Integration Process