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
• 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, look for “Integrations” or navigate directly to /integrationslist.php.

2. View Main View

   The page displays:

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

3. Available Options

   At the top you’ll find:

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

---

Information Shown in the Table

The main table shows the following columns for each integration:

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)

• Template: Template type used for the integration

• Active: Integration status (active or disabled)

• Description: Additional integration description

• Channel ID: Unique identifier of the connected channel

• Type: Integration type (IN for input, OUT for output)

Available Actions

Each integration has action buttons in the last columns:

• Edit: Edit integration configuration
• Delete: Delete the integration (only for user-created integrations)
• Download Template: Download CSV template to see required format
• Config Input File: Configure input file fields
• Communications Templates: Configure communication templates
• ShipMethod Translator: Translate shipping methods between platforms
• 3PT Configuration: Configure third-party information (FedEx, UPS)
• International Settings: Configure international settings
• Upload Aliases by CSV: Upload product aliases via CSV
• Mapping Products: Map products between channels
• Logs: View synchronization logs (for some platforms)
• Try again Orders: Resend failed orders (Shopify, Amazon Vendor, FBA)

---

View Filters

You can filter integrations by status using the buttons at the top:

• Active: Shows only active integrations (Active = Y)
• Disabled: Shows disabled integrations (Active ≠ Y)
• Deleted: Shows deleted integrations (with deletion date)

By default, the view shows only active integrations.

---

Configuration Options per Integration

Each integration can be configured with specific options using the configuration menu (wrench icon):

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.

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.

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”.

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.

Reserve Percentage

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

Configuration: Use the slider to set a percentage from 0% to 100% in 5% increments.

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

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.

---

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. The system processes the request in the communication queue
2. The process generally takes 2 to 15 minutes
3. 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. The system processes the request in the communication queue
2. All inventory quantities are updated
3. The process generally takes 2 to 15 minutes

Limitation: This button can only be pressed once per hour.

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

Generate FBA Removal Report (Amazon FBA Only)

What it does: Requests Amazon FBA to generate a removal report. The system will attempt to create a replenishment from that report in 1 hour.

Process: Amazon FBA takes at least 45 minutes to generate the report.

When to use it: When you need to create replenishments from products stored in Amazon FBA.

---

Try Again Orders

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

1. Access the Option

   In the integration actions menu, 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