SPS Commerce Integration

Connect SPS Commerce to OmniOrders for cloud-based EDI and supply chain management. Sync purchase orders, invoices, ASNs, and inventory with retail partners automatically.

View Rendered Page Back to Docs Home 
---
title: SPS Commerce Integration
description: Connect SPS Commerce to OmniOrders for cloud-based EDI and supply chain management. Sync purchase orders, invoices, ASNs, and inventory with retail partners automatically.
---

<div style="background: linear-gradient(135deg, #0066b3 0%, #004d8c 100%); border-radius: 12px; padding: 2.5rem 2rem; margin-bottom: 2rem; color: white; display: flex; align-items: center; gap: 1.5rem;">
  <ArrowRightLeft 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;">SPS Commerce Integration</h1>
    <p style="font-size: 1.125rem; margin: 0; opacity: 0.95;">
      Cloud-based EDI and supply chain management for retail partner transactions
    </p>
  </div>
</div>

Connect SPS Commerce to OmniOrders and exchange EDI documents with retail partners automatically. Purchase orders flow in, invoices and Advanced Shipping Notices flow out—no manual data entry or paper-based processes. Manage your B2B supply chain from one central dashboard.

<SupademoEmbed demoId="cmmry9uic491vf8nqdwt06cgm" />

:::tip[Quick Setup]
You'll need an SPS Commerce account and connection details from your SPS representative or trading partner. Setup typically takes 15–20 minutes.
:::

---

## Why Connect SPS Commerce?

**Connecting SPS Commerce to OmniOrders means purchase orders from retailers arrive automatically, invoices and ASNs send out without manual work, and your B2B transactions stay compliant with retail partner requirements—all from one central order management system.**

<CardGrid>
  <IconCard title="Automated PO Import" icon="file-down">
    Purchase orders (850) from retail partners flow directly into OmniOrders—no re-keying or email attachments.
  </IconCard>

  <IconCard title="Invoice & ASN Export" icon="file-up">
    Generate and send invoices (810) and Advanced Shipping Notices (856) automatically when orders ship.
  </IconCard>

  <IconCard title="Retail Compliance" icon="shield-check">
    Meet retailer EDI requirements (Walmart, Target, and others) through SPS Commerce's network of 500,000+ pre-built connections.
  </IconCard>

  <IconCard title="Centralized B2B Orders" icon="layout-grid">
    Manage EDI orders alongside your eCommerce channels in one OmniOrders dashboard.
  </IconCard>
</CardGrid>

---

## Before You Start

Make sure you have:

<CardGrid>
  <IconCard title="SPS Commerce Account" icon="shield-check">
    You need an active SPS Commerce subscription. Contact SPS Commerce or your retail partner for access.
  </IconCard>

  <IconCard title="Connection Details" icon="key-round">
    Your SPS Commerce credentials: trading partner IDs, connection settings, and document type mappings (850, 810, 856, etc.).
  </IconCard>

  <IconCard title="Trading Partner Requirements" icon="file-text">
    Know which retailers or suppliers you'll connect to—each may have specific EDI document and format requirements.
  </IconCard>
</CardGrid>

---

## Connect Your SPS Commerce Account

<SupademoEmbed demoId="cmmryey5g498tf8nqaagw16d8" />

<Steps>

1. **Go to Integrations**

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

2. **Select SPS Commerce**

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

3. **Enter Connection Details**

   You'll need:
   - **Trading Partner ID** (or your EDI identifier)
   - **Connection credentials** (from SPS Commerce or your EDI provider)
   - **Document mappings** (which EDI types to send and receive)

   :::note[What We Exchange]
   OmniOrders exchanges only order and fulfillment data—purchase orders, invoices, and ASNs. We never access payment or sensitive customer information.
   :::

4. **Configure Document Types**

   Choose which EDI documents to sync:
   - **850 (Purchase Order)**: Import orders from retail partners
   - **810 (Invoice)**: Send invoices when orders ship
   - **856 (ASN)**: Send Advanced Shipping Notices for fulfillment
   - **846 (Inventory Inquiry/Advice)**: Sync inventory levels with retailers (optional)
   - **855 (PO Acknowledgment)**: Confirm order receipt (optional)

5. **Map Locations**

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

6. **Start Sync**

   Click **Start Sync** to begin receiving purchase orders. The first sync may take a few minutes depending on your trading partner setup.

</Steps>

:::tip[First Sync]
The first connection imports recent purchase orders from your SPS Commerce mailbox. After that, new POs flow in as they arrive.
:::

---

## What Gets Synced?

**The SPS Commerce integration exchanges standard X12 EDI documents: purchase orders flow into OmniOrders, and invoices plus ASNs flow out when you fulfill—keeping your B2B transactions automated and compliant.**

### Inbound (Into OmniOrders)

- **850 (Purchase Order)**: Order details, line items, quantities, ship-to addresses, and requested dates
- **855 (PO Acknowledgment)**: Optional—send acknowledgments back to confirm order receipt
- **997 (Functional Acknowledgment)**: System-level confirmations (handled automatically)

### Outbound (From OmniOrders)

- **810 (Invoice)**: Generated when orders ship—includes line items, quantities, and pricing
- **856 (ASN)**: Advanced Shipping Notice with tracking, carrier, and expected delivery
- **846 (Inventory Inquiry/Advice)**: Inventory levels for dropship and retail compliance (if enabled)
- **855 (PO Acknowledgment)**: Optional—confirm order acceptance to the trading partner

### Fulfillment

- Tracking numbers and carrier info
- Shipment status updates
- Delivery date notifications

---

## Managing Your Connection

### View Sync Status

Check if everything is syncing correctly:

1. Go to **Integrations** → **SPS Commerce** (or **Services** → **EDI**)
2. View the sync dashboard showing:
   - Last sync time
   - Documents received and sent
   - Any errors or warnings

### Pause Syncing

Need to temporarily stop syncing?

1. Open your SPS Commerce 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 SPS Commerce integration
2. Toggle document types on/off
3. Update trading partner mappings if needed
4. Click **Save Changes**

### Update Connection Credentials

If you need to change your SPS Commerce credentials:

1. Obtain new credentials from SPS Commerce or your EDI provider
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">
    Purchase orders sync as they arrive in your SPS Commerce mailbox. Invoices and ASNs send automatically when orders ship.
  </IconCard>

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

  <IconCard title="What about existing orders?" icon="history">
    We can import recent purchase orders during initial setup. Older orders may require a manual import—contact support if needed.
  </IconCard>

  <IconCard title="Is my data secure?" icon="lock">
    Yes. SPS Commerce connections use secure protocols and we encrypt all data in transit and at rest.
  </IconCard>
</CardGrid>

---

## Troubleshooting

### Purchase Orders Not Syncing

**Problem**: New EDI purchase orders aren't appearing in OmniOrders

**Solutions**:

- Check that **Order Sync** is enabled in integration settings
- Verify your connection credentials are valid and not expired
- Confirm your SPS Commerce mailbox is receiving documents (check with SPS Commerce)
- Look for error messages in the sync log
- Try clicking **Force Sync** to trigger a manual refresh

### Invoices or ASNs Not Sending

**Problem**: Invoices or ASNs aren't being sent to trading partners

**Solutions**:

- Confirm **Invoice** and **ASN** export are enabled in settings
- Verify the order has shipped and tracking is entered
- Check that trading partner IDs and document mappings are correct
- Look for validation errors in the sync log (e.g., missing required fields)

### Connection Expired

**Problem**: SPS Commerce integration shows "Connection Expired" or "Authentication Failed"

**Solutions**:

- Verify your SPS Commerce credentials are still valid
- Check if credentials were rotated or revoked by your EDI provider
- Update credentials in OmniOrders integration settings
- No data is lost—syncing resumes after reconnecting

---

## Best Practices

### For New Users

1. **Start with One Partner**: Connect one trading partner first to verify the flow
2. **Verify Mappings**: Ensure your SKUs and product codes match EDI requirements
3. **Test in Sandbox**: Use SPS Commerce test environment if available before going live
4. **Monitor Ship Dates**: EDI orders often have strict ship-by dates—track them closely

### For B2B Sellers

1. **Centralize Orders**: Let OmniOrders be your source of truth for all channels
2. **Use Consistent SKUs**: Keep SKUs identical across EDI and eCommerce for accurate matching
3. **Send ASNs Early**: Send Advanced Shipping Notices as soon as orders ship to meet retailer SLAs
4. **Track Compliance**: Monitor acknowledgment and error rates to stay compliant

### For High-Volume Operations

1. **Enable Auto-Fulfillment**: Let OmniOrders automatically process EDI orders when ready
2. **Sync Tracking Immediately**: Enter tracking as soon as orders ship
3. **Monitor Sync Logs**: Check regularly for 997 errors or document rejections
4. **Plan for Peaks**: During busy seasons, ensure your SPS Commerce connection can handle volume

---

## 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="SPS Commerce Docs" icon="book">
    Check SPS Commerce's documentation for EDI document specifications and trading partner 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 product catalog and SKUs in sync with your EDI trading partner requirements before connecting—matching product codes from the start prevents mapping errors and rejections.
:::
Copied to clipboard!