# Junipeer Integration Setup: Centra
## Prerequisites
Before setting up the Junipeer integration with your Centra ecommerce platform, ensure you have:
**Centra Access Requirements:** - Admin-level access to your Centra backend - API credentials with read/write permissions for orders, products, and customers - Your Centra store URL and API endpoint details
**Junipeer Account:** - Active Junipeer subscription - Integration permissions enabled on your account - API key from your Junipeer dashboard
**Technical Requirements:** - SSL certificate installed on your Centra store - Webhook capability enabled - Firewall configured to allow Junipeer IP addresses (provided in your dashboard)
## Step-by-Step Connection Instructions
### Step 1: Generate Centra API Credentials
1. Log into your Centra admin panel 2. Navigate to **System** > **API** > **Integration API** 3. Click **Create New Integration** 4. Set integration name as "Junipeer" 5. Enable the following permissions: - Orders (read/write) - Products (read) - Customers (read) - Stock (read/write) 6. Copy the generated **Client ID** and **Client Secret** 7. Note your **API Base URL** (typically `https://yourstore.centraqa.com/api/integration/`)
### Step 2: Configure Junipeer Connection
1. Access your Junipeer dashboard 2. Go to **Integrations** > **Add New Integration** 3. Select **Centra** from the platform list 4. Enter your connection details: - **Store URL**: Your Centra frontend URL - **API Base URL**: From Step 1 - **Client ID**: From Step 1 - **Client Secret**: From Step 1 5. Click **Test Connection** to verify credentials 6. Save the configuration once the test passes
### Step 3: Set Up Data Synchronization
1. In Junipeer, navigate to **Sync Settings** 2. Configure synchronization preferences: - **Order Import**: Enable automatic order import - **Product Sync**: Set to sync every 4 hours - **Stock Updates**: Enable real-time stock synchronization - **Customer Data**: Enable for personalization features 3. Set your **Historical Data Range** (recommended: 90 days) 4. Click **Start Initial Sync**
### Step 4: Configure Webhooks
1. Return to Centra admin panel 2. Go to **System** > **Webhooks** 3. Create new webhook with these settings: - **URL**: `https://api.junipeer.com/webhooks/centra/[your-account-id]` - **Events**: Select "Order Created", "Order Updated", "Stock Changed" - **Authentication**: Use provided webhook secret from Junipeer 4. Test webhook delivery 5. Enable the webhook
## Common Configuration Tips
### Performance Optimization - **Batch Size**: Set order import batch size to 50-100 for optimal performance - **Sync Frequency**: Start with 4-hour intervals; adjust based on order volume - **Product Filtering**: Exclude discontinued products to reduce sync time
### Data Mapping - **Order Status Mapping**: Align Centra order statuses with Junipeer workflow stages - **Product Categories**: Ensure category hierarchies match between platforms - **Customer Segmentation**: Map Centra customer groups to Junipeer segments
### Security Best Practices - **API Rate Limits**: Configure rate limiting (recommended: 100 requests/minute) - **IP Whitelisting**: Restrict API access to Junipeer IP ranges only - **Secret Rotation**: Schedule monthly rotation of API credentials
### Multi-Market Setup If using Centra's multi-market features: - Configure separate integrations for each market - Set appropriate currency and language mappings - Ensure market-specific product availability syncs correctly
## Post-Setup Verification
### Data Accuracy Check 1. **Orders**: Verify recent orders appear in Junipeer within 5 minutes 2. **Products**: Confirm product catalog sync shows correct inventory levels 3. **Customers**: Check customer profiles include complete contact information 4. **Pricing**: Validate prices match across platforms, including currency conversion
### Integration Health Monitoring 1. Review **Integration Status** in Junipeer dashboard (should show green) 2. Check **Sync Logs** for any errors or warnings 3. Verify **Webhook Delivery** shows 100% success rate 4. Test **Real-time Updates** by creating a test order in Centra
### Performance Testing 1. Monitor **Sync Speed**: Initial sync should complete within 2-4 hours 2. Check **API Response Times**: Should average under 200ms 3. Verify **Resource Usage**: Ensure integration doesn't impact store performance
### Final Steps 1. Enable **Live Mode** in Junipeer settings 2. Configure **Alert Notifications** for integration failures 3. Schedule **Weekly Health Checks** to monitor ongoing performance 4. Document configuration for your team reference
Your Centra-Junipeer integration is now active and ready to enhance your ecommerce operations with advanced analytics and automation capabilities.