CommerceHub Integration

Connect CommerceHub to OmniOrders for drop-ship and marketplace orders. Sync orders, inventory, and fulfillment automatically across retail networks.

---
title: CommerceHub Integration
description: Connect CommerceHub to OmniOrders for drop-ship and marketplace orders. Sync orders, inventory, and fulfillment automatically across retail networks.
---

<div style="background: linear-gradient(135deg, #1a4d8c 0%, #0f3a6b 100%); border-radius: 12px; padding: 2.5rem 2rem; margin-bottom: 2rem; color: white; display: flex; align-items: center; gap: 1.5rem;">
  <Network style="width: 80px; height: 80px; flex-shrink: 0; color: white; stroke-width: 1.5;" />
  <div>
    <h1 style="font-size: 2rem; margin: 0 0 0.5rem 0; color: white;">CommerceHub Integration</h1>
    <p style="font-size: 1.125rem; margin: 0; opacity: 0.95;">
      Connect drop-ship and marketplace orders from CommerceHub retail networks
    </p>
  </div>
</div>

Connect CommerceHub to OmniOrders and manage drop-ship and marketplace orders from one place. Orders from retail partners flow into OmniOrders automatically—inventory and fulfillment sync in both directions.

<SupademoEmbed demoId="cmmpptbfy2n9vf8nqke18h9vq" />

:::tip[Quick Setup]
You'll need CommerceHub API credentials and an active CommerceHub account. Setup typically takes 10–15 minutes.
:::

---

## Why Connect CommerceHub?

<CardGrid>
  <IconCard title="Drop-Ship Orders" icon="package">
    Orders from retail partners (Walmart, Target, and others) flow directly into OmniOrders—no manual entry.
  </IconCard>

  <IconCard title="Inventory Sync" icon="refresh-cw">
    Stock levels stay in sync across CommerceHub and your fulfillment system. Prevents overselling.
  </IconCard>

  <IconCard title="Fulfillment Updates" icon="truck">
    Tracking numbers and shipment status automatically update in CommerceHub when orders ship.
  </IconCard>

  <IconCard title="Multi-Retailer Support" icon="layout-grid">
    Manage orders from multiple retailers through a single CommerceHub connection.
  </IconCard>
</CardGrid>

---

## Before You Start

Make sure you have:

<CardGrid>
  <IconCard title="CommerceHub Account" icon="shield-check">
    You need an active CommerceHub account with API access. Contact CommerceHub or your retail partner for credentials.
  </IconCard>

  <IconCard title="API Credentials" icon="key-round">
    Your CommerceHub API key, secret, and environment (sandbox or production) ready to enter.
  </IconCard>

  <IconCard title="Retailer Connections" icon="store">
    Know which retailers you're connected to in CommerceHub—this affects which orders will sync.
  </IconCard>
</CardGrid>

---

## Connect Your CommerceHub Account

<SupademoEmbed demoId="cmmqx3j1c3qt2f8nq8nbqx396" />

<Steps>

1. **Go to Integrations**

   In OmniOrders, click **Integrations** in the main menu, then click **Add Integration**

2. **Select CommerceHub**

   Find CommerceHub in the list (under EDI & B2B) and click **Connect**

3. **Enter API Credentials**

   You'll need:
   - **API Key** (from your CommerceHub dashboard)
   - **API Secret**
   - **Environment** (Sandbox for testing, Production for live orders)

   :::note[What We Access]
   OmniOrders only requests access to orders, inventory, and fulfillment data—we never access payment or sensitive customer info.
   :::

4. **Configure Settings**

   Choose what to sync:
   - **Orders**: Import drop-ship and marketplace orders automatically
   - **Inventory**: Keep stock levels in sync with CommerceHub
   - **Fulfillment**: Send tracking info and shipment status back to CommerceHub

5. **Map Locations**

   If you have multiple warehouses, map them to your CommerceHub fulfillment locations for accurate routing.

6. **Start Sync**

   Click **Start Sync** to begin importing orders. The first sync may take a few minutes depending on order volume.

</Steps>

:::tip[First Sync]
The first sync imports recent orders from CommerceHub. After that, new orders flow in as they're created.
:::

---

## What Gets Synced?

### Orders

- Order details and line items from retail partners
- Customer shipping addresses
- Order notes and retailer-specific fields
- Fulfillment status
- Ship-by and delivery-by dates

### Inventory

- Stock levels by location
- Inventory updates (both directions)
- Low stock alerts
- Multi-location inventory support

### Fulfillment

- Tracking numbers
- Carrier information
- Shipment status updates
- Fulfillment notifications to retailers

---

## Managing Your Connection

### View Sync Status

Check if everything is syncing correctly:

1. Go to **Integrations** → **CommerceHub**
2. View the sync dashboard showing:
   - Last sync time
   - Orders synced
   - Any errors or warnings

### Pause Syncing

Need to temporarily stop syncing?

1. Open your CommerceHub integration settings
2. Toggle **Sync Active** to OFF
3. Syncing stops immediately (you can resume anytime)

### Update Settings

Change what syncs:

1. Click **Settings** on your CommerceHub integration
2. Toggle any sync option on/off
3. Click **Save Changes**

### Update API Credentials

If you need to regenerate your CommerceHub API credentials:

1. Create new credentials in your CommerceHub dashboard
2. Update them in OmniOrders integration settings
3. The connection will resume automatically

---

## Common Questions

<CardGrid>
  <IconCard title="How often does it sync?" icon="clock">
    Orders sync as they arrive from CommerceHub. Inventory typically syncs every 5–15 minutes or when changes occur.
  </IconCard>

  <IconCard title="Which retailers are supported?" icon="store">
    CommerceHub connects you to many retailers (Walmart, Target, and others). Your specific retailers depend on your CommerceHub agreement.
  </IconCard>

  <IconCard title="What about existing orders?" icon="history">
    We import recent orders during initial setup. Older orders can be imported on request.
  </IconCard>

  <IconCard title="Is my data secure?" icon="lock">
    Yes. We use secure API authentication and encrypt all data in transit and at rest.
  </IconCard>
</CardGrid>

---

## Troubleshooting

### Orders Not Syncing

**Problem**: New CommerceHub orders aren't appearing in OmniOrders

**Solutions**:

- Check that **Order Sync** is enabled in integration settings
- Verify your API credentials are valid and not expired
- Look for error messages in the sync log
- Confirm the order meets CommerceHub's fulfillment requirements
- Try clicking **Force Sync** to trigger a manual refresh

### Inventory Not Updating

**Problem**: Stock changes don't sync between CommerceHub and OmniOrders

**Solutions**:

- Confirm **Inventory Sync** is turned on
- Check if products are mapped correctly (same SKU in both systems)
- Verify your API account has inventory write permissions
- Allow up to 15 minutes for updates to sync
- Check for rate limit messages in the sync log

### Connection Expired

**Problem**: CommerceHub integration shows "Connection Expired" or "Authentication Failed"

**Solutions**:

- Verify your API credentials are still valid in CommerceHub
- Check if the API key was rotated or revoked
- Regenerate credentials and update them in OmniOrders
- Ensure you're using the correct environment (sandbox vs production)
- No data is lost—syncing resumes after reconnecting

---

## Best Practices

### For New Users

1. **Start with Sandbox**: Use CommerceHub sandbox environment first to test the connection
2. **Verify Mapping**: Ensure your SKUs match between OmniOrders and CommerceHub
3. **Test One Retailer**: Confirm orders from one retailer sync correctly before scaling
4. **Check Ship Dates**: CommerceHub orders often have strict ship-by dates—monitor them closely

### For Drop-Ship Sellers

1. **Centralize Inventory**: Let OmniOrders be your source of truth for available stock
2. **Use Consistent SKUs**: Keep SKUs identical across all systems for automatic matching
3. **Set Buffer Stock**: Configure safety stock to prevent overselling across retailers
4. **Track Performance**: Monitor fulfillment metrics to meet retailer requirements

### For High-Volume Operations

1. **Enable Auto-Fulfillment**: Let OmniOrders automatically fulfill orders when ready
2. **Sync Tracking Early**: Send tracking as soon as orders ship to meet retailer SLAs
3. **Monitor Sync Logs**: Check regularly for errors or delays
4. **Plan for Peaks**: During busy seasons, ensure sync frequency meets demand

---

## Need More Help?

<CardGrid>
  <IconCard title="Contact Support" icon="message-circle">
    Our team is here to help with setup, troubleshooting, or any questions. [Get Support
    →](mailto:[email protected])
  </IconCard>

  <IconCard title="CommerceHub Docs" icon="book">
    Check CommerceHub's documentation for API details and retailer-specific requirements.
  </IconCard>

  <IconCard title="More Integrations" icon="layout-grid">
    Explore other platforms and integration options. [View Integrations
    →](/integrations/overview/)
  </IconCard>
</CardGrid>

---

:::tip[Pro Tip]
Keep your CommerceHub product catalog in sync with OmniOrders before connecting—matching SKUs from the start prevents mapping issues later.
:::
Copied to clipboard!