🛒 E-commerce Integration

E-commerce Integration connects MeTEY with five major online marketplaces, enabling real-time bidirectional synchronization of orders, inventory, and product listings.

Supported Platforms

Overview

The e-commerce system provides:

• Order Sync: Automatically import marketplace orders as QOI records
• Inventory Updates: Push inventory changes to all connected platforms
• Product Listing Management: Create and update listings from MeTEY products
• Multi-Channel Dashboard: View all marketplace activity in one place
• Encrypted Credentials: Secure storage of API keys and tokens
• Error Handling: Automatic retry logic and detailed error reporting

Getting Started

Order Synchronization

How It Works

1. Customer places order on marketplace (Amazon, eBay, etc.)
2. MeTEY checks marketplace every sync interval (configurable)
3. New orders are detected via platform API
4. Order is imported as a QOI with status = ORDER
5. Order items are matched to MeTEY products by SKU or product ID
6. Inventory is automatically reduced
7. Order appears in QOI list with platform badge

Order Mapping

Manual Order Import

You can manually trigger order imports:

1. Go to E-commerce Dashboard
2. Find platform card
3. Click "Sync Orders Now"
4. System fetches and imports all new orders immediately
5. Results shown: Orders imported, items matched, errors (if any)

Inventory Synchronization

Sync Modes

MeTEY supports two synchronization modes for inventory and prices:

Real-Time Push Updates

When real-time sync is enabled, inventory changes in MeTEY automatically push to connected platforms:

Automatic Updates

• Customer order fulfilled → Reduces inventory on all platforms
• PO received → Increases inventory on all platforms
• Manual adjustment → Updates all platforms
• Physical count processed → Updates all platforms

Manual Push

1. Go to E-commerce Dashboard
2. Click "Push Inventory" on platform card
3. Select products to update (or "All Products")
4. Click "Update Inventory"
5. System pushes current inventory to marketplace

Export & Push to Platforms

The Export & Push feature lets you generate inventory/price files from MeTEY and push them to marketplaces on demand.

When to Use Export & Push

• Batch Updates: Update many products at once
• Review Before Push: Preview changes before sending to platforms
• Scheduled Updates: Export during off-hours, push during business hours
• Audit Trail: Download CSV for records before pushing
• Manual Control: Decide exactly when updates are sent

Export & Push Workflow

Export File Format

Inventory Export CSV:

# Inventory Export for Amazon US Store (AMAZON)
# Generated: 2026-05-28 14:30:00
# Company: ABC, Branch: WH01
product_sku,channel_sku,current_quantity,description
ALU-BAR-6061-1X12,B09XYZ1234,150,Aluminum Bar 6061 1x12
STL-SHEET-304-4X8,B09ABC5678,75,Stainless Sheet 304 4x8

Price Export CSV:

# Price Export for Amazon US Store (AMAZON)
# Generated: 2026-05-28 14:30:00
# Company: ABC, Branch: WH01
product_sku,channel_sku,current_price,effective_date,description
ALU-BAR-6061-1X12,B09XYZ1234,45.99,immediate,Aluminum Bar 6061 1x12
STL-SHEET-304-4X8,B09ABC5678,125.50,immediate,Stainless Sheet 304 4x8

Export History

All exports are tracked for audit purposes:

• Date and time of export
• Channel and export type
• Product count
• Status (completed/failed)
• User who generated export
• Any errors encountered

View history at the bottom of the Export & Push page.

Configuring Sync Mode

Choose sync mode per channel in Channel Configuration:

1. Go to E-commerce → Channel Configuration
2. Edit a channel
3. Under "Sync Settings" choose:
   • Sync inventory: Real-time / File upload / Disabled
   • Sync prices: Real-time / File upload / Disabled
4. If "File upload" selected, set schedule (manual/daily/weekly)
5. Save channel configuration

Product Listing Management

E-commerce Dashboard

The dashboard provides an at-a-glance view of all marketplace activity:

Platform Cards

Each connected platform shows:

• Status: Connected, Syncing, Error
• Last Sync: When orders were last checked
• Next Sync: When next automatic sync will occur
• Today's Orders: Number of orders imported today
• Today's Sales: Total sales revenue from this platform today
• Quick Actions: Sync Now, Push Inventory, View Orders, Settings

Sync History

View detailed log of all sync operations:

• Timestamp of each sync
• Platform synced
• Orders imported
• Products updated
• Errors encountered (if any)
• Duration of sync

Error Alerts

Dashboard highlights sync errors and issues:

• 🔴 Connection Error: Cannot reach marketplace API (check credentials)
• 🟡 Product Mismatch: Order items could not be matched to MeTEY products
• 🟡 Rate Limit: Too many requests, sync delayed
• 🟡 Partial Failure: Some operations succeeded, some failed

Troubleshooting

Orders Not Importing

• Verify platform credentials are correct and active
• Check that auto-import is enabled in platform settings
• Ensure sync interval has elapsed since last check
• Review error log in dashboard for API errors
• Try manual "Sync Orders Now" to see immediate error messages

Inventory Not Updating on Marketplace

• Confirm auto-update inventory is enabled
• Check that product has a valid listing ID for that platform
• Verify product SKU matches marketplace listing SKU
• Review sync history for failed inventory pushes
• Some platforms cache inventory for 15-30 minutes

Connection Errors

• Re-enter credentials and test connection
• For OAuth-based platforms (eBay, Etsy), refresh access tokens
• Check that API keys have not been revoked or expired
• Ensure MeTEY has internet connectivity
• Verify no firewall is blocking marketplace API endpoints

Product Matching Issues

• Ensure SKU in marketplace listing matches MeTEY product ID exactly
• SKUs are case-sensitive on most platforms
• Use "Map Products" feature to manually link unmatched items
• Check for extra spaces or special characters in SKUs

Related Topics

• Product Management
• QOI Management (Orders)
• Inventory Management
• E-commerce FAQ
• Troubleshooting E-commerce