Integrations Overview

Integrations Overview is the control center for managing all your connections with eCommerce platforms, marketplaces, and other sales channels. From here you can configure, activate, and monitor all your integrations to automatically sync orders and inventory.

ShipEdge Core supports multiple types of integrations, from direct API connections with platforms like Amazon and Shopify, to imports via CSV files or FTP. Each integration can be configured independently with specific options according to your needs.

Quick Start

To add a new integration, go to My Account > Preferences > Channel Automation or use the “Add Template” button in the Integrations view.

Why Use Integrations?

Order Automation

Orders are automatically imported from your sales channels, eliminating the need to enter them manually.

Inventory Synchronization

Keep your inventory updated in real time across all your platforms to avoid selling out-of-stock products.

Centralized Management

Manage multiple sales channels from one place instead of logging into multiple systems.

Flexible Configuration

Each integration can be configured with specific options like address validation, order hold, and more.

---

Integration Types

ShipEdge Core supports several types of integrations depending on how they connect with your sales channels:

API Integrations (Direct Connection)

These integrations connect directly with platforms using their official APIs:

• Amazon SP-API: Connection with Amazon Seller Central using the Selling Partner API
• Amazon Vendor: Integration with Amazon Vendor Central
• Shopify: Direct connection with your Shopify store
• Walmart: Integration with Walmart Marketplace
• WooCommerce: Integration with WooCommerce
• Other marketplaces: Various additional platforms as available

Features:

• Automatic order synchronization
• Real-time inventory synchronization
• Automatic shipping status updates
• Requires platform API credentials

File-Based Integrations (CSV/FTP)

These integrations import orders from CSV files or via FTP/SFTP connections:

• CSV Upload: Upload CSV files manually or programmatically
• FTP Orders: FTP connection to import files automatically
• SFTP Orders: Secure SFTP connection to import files

Features:

• Order import from structured files
• Custom template configuration
• Support for multiple file formats
• Automatic processing when new files are detected

Output Integrations (OUT)

Some integrations send information from ShipEdge to other platforms:

• FedEx: Sending shipping information to FedEx
• UPS: Integration with UPS for labels and tracking
• Other platforms: According to specific configuration

---

How to Access Integrations

1. Navigate to Integrations Module

   From the main menu, access through Orders > Integrations.

2. View Main Interface

   The page displays:

   • Title: Integrations
   • Table with all your configured integrations
   • Quick access buttons at the top
   • Filters to view active, disabled, or deleted integrations

3. Navigation Tabs

   At the top header you’ll find these tabs:

   • Add Template: Create a new CSV integration template
   • File Upload History: View history of uploaded files
   • History Method Shipping: View shipping method history
   • Xenvio Shipping Labels Mapper: Configure Xenvio label mapping

---

Information Shown in the Table

The main table displays integrations in a simplified two-column layout. The table shows all integrations configured for your account, including:

Main Columns

• Name: Integration name (e.g., “Amazon SP”, “Shopify”, “FTP Orders”)

  • Also shows the description if available
  • Shows StoreID or Channel ID if applicable

• Information: Detailed information about the integration

  • Header Line: File header line (for CSV)
  • Multi-line Orders: Whether it accepts orders with multiple lines
  • Template: Template type used
  • Channel ID: Connected channel or store ID
  • Active: Activation status (Y/N)

Action Buttons

Each integration row includes action buttons on the right side:

Primary Actions (visible buttons):

• Edit (green button): Edit integration configuration (only for user-created integrations)
• Delete (red button): Delete the integration (only for user-created integrations)
• Download Template (blue button): Download CSV template to see the required format (available for all integrations)

Additional Actions (via dropdown menus):

• Document/Spreadsheet icon (dropdown menu): Access to:

  • Config Input File: Configure input file field mappings
  • Communications Templates: Configure communication templates
  • ShipMethod Translator: Translate shipping methods between platforms
  • 3PT Configuration: Configure third-party information (FedEx, UPS)
  • Try again Orders: Resend failed orders (available for Shopify, Amazon Vendor, FBA, Send to Amazon)
  • International Settings: Configure international shipping settings
  • Upload Aliases by CSV: Upload product aliases via CSV
  • Logs: View synchronization logs (available for specific platforms like Amazon, Mango)

• Wrench/Settings icon (dropdown menu): Quick configuration options:

  • Hold Entry: Hold orders in “waiting” status for review
  • Hold if over sold price: Set amount threshold for automatic hold
  • Signature Amount: Require signature for orders over specified amount
  • Reserve Percentage: Set inventory reserve percentage (slider, 0-100% in 5% increments)
  • Add Suffix: Add channel ID suffix to order numbers
  • Divide Available: Divide inventory among multiple channels
  • Address Validation: Enable USPS address validation
  • Residential Check: Verify address type (residential/commercial)
  • Insure when total order value exceeds: Set insurance amount threshold
  • Include UOM packs from Inventory Sync: Exclude UOM packs from Inventory Sync
  • Fulfill dropship items: Fulfill dropship items
  • Stand By Order: Stand by order

Manual Synchronization Buttons (for API integrations with Channel ID):

• Get Orders!: Manually request order import (once per hour limit)
• Sync all inventory!: Manually sync all inventory (once per hour limit)

---

View Filters and Search

Above the table, you’ll find filtering and search options:

Status Filters

Three filter buttons allow you to view integrations by status:

• Active: Shows only active integrations
• Disabled: Shows disabled integrations
• Deleted: Shows deleted integrations

By default, the view shows only active integrations.

Search

Use the Search field to quickly find integrations by name, description, or StoreID. The table filters in real-time as you type.

Pagination

At the top of the table, you’ll find:

• Show entries dropdown: Select how many entries to display per page (default: 10)
• Pagination controls: Navigate between pages (First, Previous, page numbers, Next, Last)

---

Important Notice Panel

On the right side of the screen, you’ll see a blue information panel titled “Please Note:”. This panel displays important disclaimers and responsibilities regarding integrations:

Key Points:

• Your Responsibility: You are responsible for properly setting up all translation features, performing testing, and verifying integration with third-party selling channels
• Testing: Strongly recommended to test integrations frequently, especially when changes occur (SKU renaming, shipping method variations, permissions, credentials)
• Support Limitations: ShipEdge is not responsible for translation issues, omitted orders, or other communication issues with third-party channels
• Support Response Time: Support for channel automation requires at least 24 hours for investigation (hourly development charges may apply)
• Warehouse Responsibility: The warehouse is not responsible for omissions, duplications, or errors in orders coming through the system

This notice appears automatically when viewing integrations and serves as a reminder of your responsibilities when using channel automation features.

---

Configuration Options per Integration

Each integration can be configured with specific options using the configuration menu. The available options depend on whether the integration is a template (CSV/FTP-based) or a channel (API-based with Channel ID).

---

Template Options

Template integrations (CSV uploads, FTP Orders, SFTP Orders) have access to these configuration options:

Hold Entry

What it does: Orders enter in “waiting” status so you can review them before sending them to the warehouse.

When to use it: When you need to review and validate orders before processing them.

Additional configuration:

• Hold if over sold price: Hold orders if the sale price exceeds a specific amount

Address Validation

What it does: Validates each order address against the USPS database. The address can be automatically updated to the one suggested by USPS.

When to use it: To ensure addresses are correct and reduce delivery errors.

Important: Orders that fail validation will enter with “address-error” status.

Availability: Only appears if address validation is enabled in your account configuration.

Visual indicator: When enabled, the “Address Validation” label appears in bold in the dropdown menu.

Residential Check

What it does: Verifies whether the address is residential or commercial type.

When to use it: When you need to apply different rates or shipping methods based on address type.

Availability: Only appears if address validation is enabled in your account configuration.

Visual indicator: When enabled, the “Residential Check” label appears in bold in the dropdown menu.

Additional Dynamic Options

Depending on the integration type, you may also see additional options such as:

• Insure when total order value exceeds: Automatically insure orders over a specified amount
• Include UOM Pack qty for Inventory Sync: Include Unit of Measure pack quantities in inventory synchronization
• Fulfill dropship items: Enable fulfillment of dropship items
• Stand By Order: Place orders in standby status

---

Channel Options

Channel integrations (API-based integrations with Channel ID, such as Shopify, Walmart) have access to all template options plus these additional options:

Signature Amount

What it does: Requires delivery signature if the order value exceeds a specific amount.

When to use it: To protect high-value orders with delivery signature.

Note: Only available for channel integrations (with Channel ID).

Reserve Percentage

What it does: Reserves a percentage of inventory during synchronization to avoid overselling.

Configuration: Use the slider control to set a percentage from 0% to 100% in 5% increments. The slider shows markers at 0%, 20%, 40%, 60%, 80%, and 100%.

How to use: Click and drag the slider or click on a marker to set the reserve percentage. The value saves automatically when you release the slider.

When to use it: When you need to maintain safety stock that doesn’t sync with channels.

Note: Only available for channel integrations (with Channel ID).

Add Suffix

What it does: Adds the channel ID as a suffix to the order number.

When to use it: When you use multiple stores of the same technology and need to distinguish orders.

Example: If the Channel ID is 123, order “ORD-001” becomes “ORD-001#123”.

Visual indicator: When enabled, the “Add Suffix” label appears in bold in the dropdown menu.

Note: Only available for channel integrations (with Channel ID).

Divide Available

What it does: Divides available inventory among multiple channels when you have the same integration configured multiple times.

When to use it: When you sell the same product in multiple stores and need to distribute stock.

Note: Only available for channel integrations (with Channel ID).

---

Manual Synchronization

For API integrations, you can manually sync orders and inventory:

Get Orders

What it does: Requests import of new orders from the connected platform.

Process:

1. Click the button and confirm the action
2. The system processes the request in the communication queue
3. The process generally takes 2 to 15 minutes
4. Orders appear in the Orders view once processed

Limitation: This button can only be pressed once per hour to provide fair access to all customers.

When to use it: When you need to import orders immediately instead of waiting for automatic synchronization.

Sync All Inventory

What it does: Updates inventory on the connected platform with current ShipEdge quantities.

Process:

1. Click the button and confirm the action
2. The system processes the request in the communication queue
3. All inventory quantities are updated
4. The process generally takes 2 to 15 minutes

Limitation: This button can only be pressed once per hour. If you try to press it before an hour has passed, the system will show how many minutes remain.

Display: Shows the last synchronization date/time below the button.

When to use it: When you need to update inventory on the platform immediately after major changes.

---

Try Again Orders

Some integrations (Shopify, Amazon Vendor, FBA, Send to Amazon) allow retrying orders that failed to import:

1. Access the Option

   Click the spreadsheet icon dropdown menu for the integration, then select “Try again Orders”.

2. Upload File

   Upload a CSV, TSV, XLS, or XLSX file containing the order numbers you want to retry.

3. Select Column

   The system will show the file columns. Select the column that contains the order numbers.

4. Process

   Click “Get Orders” to send the orders again to the import system.

5. Verify Result

   The system will show a list of orders that were sent successfully. You can verify in the Orders view in a few minutes.

---

Adding New Integrations

To add a new integration, you have two main options:

Option 1: From Preferences

1. Go to Preferences

   Navigate to My Account > Preferences and look for the “Channel Automation” section.

2. Configure Channel

   Follow the specific instructions for the platform you want to connect.

3. Activate Integration

   Once configured, the integration will appear in the Integrations view.

Option 2: Create CSV Template

1. Click “Add Template”

   In the Integrations view, click the “Add Template” button.

2. Configure Template

   Configure the name, template type, and CSV file format.

3. Configure Fields

   Use “Config Input File” to map CSV fields to ShipEdge fields.

4. Activate

   Check the “Active” box to activate the integration.

---

💡 Best Practices

Review Imported Orders

Use “Hold Entry” for new integrations until you confirm orders are importing correctly.

Validate Addresses

Enable “Address Validation” to reduce delivery errors and automatically update addresses.

Monitor Synchronizations

Review synchronization logs regularly to detect problems early.

Reserve Inventory

Configure a reserve percentage to maintain safety stock and avoid overselling.

Use Suffixes

Enable “Add Suffix” when you have multiple stores of the same platform to easily distinguish orders.

Manual Synchronization

Use manual synchronization buttons only when necessary, respecting the once-per-hour limit.

---

Troubleshooting

Orders Are Not Importing

Possible causes:

• The integration is disabled (Active = N)
• API credentials have expired or are incorrect
• There’s a problem with the FTP/SFTP connection
• The CSV file format doesn’t match the configured template

Solution:

1. Verify that the integration is active
2. Review synchronization logs
3. Verify credentials in Preferences
4. Use “Get Orders” to try a manual synchronization

Inventory Is Not Synchronizing

Possible causes:

• Automatic synchronization is disabled
• There’s an error in the last synchronization
• The reserve percentage is configured incorrectly

Solution:

1. Use “Sync All Inventory” for manual synchronization
2. Review logs to see specific errors
3. Verify the “Reserve Percentage” configuration

I Can’t Press “Get Orders” or “Sync Inventory”

Cause: These buttons can only be used once per hour.

Solution: Wait at least one hour since the last time you pressed the button. The system will show how many minutes remain if you try to press it before.

Addresses Are Incorrect

Cause: “Address Validation” may be automatically updating addresses or there’s a problem with data format.

Solution:

1. Review the “Address Validation” configuration
2. Check orders with “address-error” status
3. Review logs to see what changes are being made

---

Related Links

• Setting Up Integrations - Detailed guide to configure specific integrations
• Order Rules (Automation) - Configure automatic rules for imported orders
• Preferences - General account and channel configuration
• Orders Overview - View and manage imported orders

---

Next Step: Setting Up Integrations - Learn how to configure specific integrations step by step