Flxpoint Knowledge

Contact us

eBay as a Channel

Table of Contents

How to Connect Listing Operations Order Operations Troubleshooting

eBay is our next-generation integration with eBay, leveraging their latest APIs for enhanced listing and inventory management. It allows you to publish new product listings directly from Flxpoint, set a maximum quantity threshold for each item, and sync orders more reliably. While many new features are introduced, functionality from our previous eBay (Legacy) integration is still available for those who prefer familiar processes. By adding eBay as a channel in Flxpoint, you gain a streamlined workflow for creating new listings, updating existing ones, and keeping your orders up to date.


 

How to Connect

Important: The new eBay integration is separate from eBay (Legacy).
  • Do not replace your existing eBay (Legacy) channel yet. Instead, create a new channel for eBay to test.
  • You can run both side-by-side while testing — your eBay (Legacy) channel will continue to work normally.
  • Once you've verified that eBay meets all your needs, you can retire your eBay (Legacy) channel.
  • Sync any outstanding shipments back to eBay: Keep the old channel active until every open order shows its latest tracking details in eBay. Run Sync Orders on the old channel (or confirm the new channel has already captured those updates) so shipment data isn't lost.
  • Link pre-existing store listings (if applicable): If your eBay store already contains live listings, run Sync & Link Listings on the new channel to associate those items with Flxpoint. This prevents duplicates and ensures inventory, price, and status updates flow to the correct SKUs.
Phase 1: Channel Creation & Authentication +
Open Sales Channels and click +
Navigate to the Channels section in Flxpoint. Click + Add Channel to begin connecting your eBay account.
Select eBay & name your channel
In the channel selector:
  • Choose eBay as your channel type (not eBay Legacy).
  • Enter a descriptive name (e.g., "eBay Main Store").
  • Click Save to continue.
Start the setup wizard
After creating the channel, you'll see "No integrations created yet." Click Get Started to launch the wizard and authenticate with your eBay account.
Tip: Have your eBay account credentials ready before starting the wizard.
Phase 2: Pricing, Quantity & Linking +
Configure Pricing Strategy
Under Pricing & Quantity Rules, set up how you want to price your products on eBay:
  • Add markups (e.g., 20% over cost) or set specific pricing rules.
  • Set minimum prices to protect your margins.
  • Limit quantities shown to reduce the risk of overselling.
Strategy Tip: Some sellers limit the quantity shown even if they have more inventory available — this helps prevent overselling during high-demand periods.
Link Settings
If you already have live listings on eBay, configure Link Settings to match existing eBay listings to your Flxpoint products. This avoids duplicates when you start publishing.
Phase 3: Publishing Settings & eBay Policies +
If you selected Publish Listings during setup, you'll need to connect your eBay Business Policies. These tell eBay how you handle shipping, returns, and payments.
Configure eBay Business Policies
Provide the following policy IDs from your eBay Seller Hub:
  • Return Policy ID — your return handling policy.
  • Fulfillment Policy ID — your shipping options and timeframes.
  • Payment Policy ID — how you accept payments.
  • Merchant Location Key — where you're shipping from.
Click View Policies and View Merchant Locations to see your available options pulled from eBay.
eBay Motors sellers
eBay Motors also requires at least Country + Postal Code — or Country + State/Province — in your Merchant Location Key. Make sure the location exists in Seller Hub before publishing Motors items.
Publish Settings
Choose which product fields Flxpoint sends to eBay when publishing (title, description, images, item specifics, etc.).
Missing Policies? If policy fields are empty, check that you've created them in your eBay Seller Hub. You can also try regenerating your Refresh Token to fetch the latest data.
Phase 4: Order Processing & Shipping +
Order Sync
Configure how Flxpoint handles eBay orders:
  • Get Orders — import new eBay orders into Flxpoint for processing and fulfillment.
  • Order Settings — set routing preferences, timing windows, and cancellation rules.
Shipment Tracking
Enable Sync Orders to send shipment confirmations and tracking numbers back to eBay automatically. This keeps your buyers informed and helps maintain your seller performance metrics.
  • Shipping Mappings — map eBay shipping services to your carriers and service levels.
Tip: Set up Order Settings and Shipping Mappings before enabling Get Orders so everything routes correctly from the start.
Phase 5: Automation & Final Setup +
Schedule Your Processes
In Automate Integrations, decide how often each process should run:
  • Sync Listings — how often to update prices and inventory (every hour is common).
  • Get Orders — how frequently to check for new orders (every 15–30 minutes recommended).
  • Sync Orders — how often to update tracking info (every few hours is usually sufficient).
You can also leave processes as manual if you prefer to trigger them yourself.
Ready-for-Launch Checklist
Before turning on automation, verify everything works:
  • Run each process manually first to test.
  • Verify that a few products sync correctly.
  • Check that test orders process properly.
  • Confirm shipping mappings send the right carrier and tracking info.
  • Then enable automation when everything looks good.
Quick first-run checklist: Pricing & Quantity configured | eBay Policies connected | Shipping Mappings set | Test with 1–2 items/orders


 

Listing Operations

Flxpoint allows you to manage product listings on eBay by syncing inventory, updating product details, and controlling pricing and availability. This ensures accurate and real-time updates across your eBay store.

Import Listings

eBay integration: Not Supported
eBay Legacy integration: Supported.

Introduction

The Import Listings operation pulls your existing eBay listings directly into Flxpoint, creating a centralized catalog of your products. The import retrieves titles, descriptions, images, variations, pricing, and item identifiers so you can manage everything from one place.

The sections below cover setup, configuration options, and troubleshooting.

Purpose of This Operation

Import Listings connects your eBay seller account to Flxpoint to:

  • Pull existing eBay listings into your Flxpoint product catalog.
  • Eliminate manual data entry for titles, descriptions, images, variations, pricing, and identifiers.
  • Keep your catalog in sync so you can manage all channels from one place.
What Gets Imported
  • Product Details: Titles, descriptions, and categories.
  • Images: All photos attached to the listing.
  • Variations: Size, color, and other multi-variation attributes.
  • Pricing & Inventory: Current prices and available quantities per variation.
  • Item Identifiers: SKUs, UPCs, EANs, and other identification numbers.
  • Item Specifics: Brand, MPN, condition, and other product attributes.
Configuration Options
  • Set New Listings to Paused: Imported listings start in "Paused" status so you can review them before they go live.
  • Set Master SKU: Choose which eBay field (SKU or Item ID) becomes the primary identifier in Flxpoint.
  • Product Management Mode: "Create and update products & listings" (adds new items) or "Update existing" (only refreshes items already in Flxpoint).
  • Import From Last X Days: How far back to look for active or recently ended listings (e.g., 7, 30, 90 days).
Setup Steps
  • 1 Open Import Listings: In your eBay channel settings, select the Import Listings operation.
  • 2 Set Listing Status: Choose whether imported listings should be "Paused" (recommended for first import) or active.
  • 3 Choose Master SKU: Select "SKU" if your eBay listings use custom SKUs, or "Item ID" if they do not.
  • 4 Select Management Mode: Pick "Create and update" for a first-time import, or "Update existing" for subsequent syncs.
  • 5 Set Date Range: Enter the number of days to look back. Start small (7 days) to validate, then expand.
  • 6 Save and Run: Click Save and Complete to start the import. Review imported products in your Flxpoint catalog once finished.

Import Listings does not use a traditional mapping template. Instead, configuration is handled through the settings below. Each option controls how listings are imported and matched in Flxpoint.

Configuration Options
Setting Options When to Use
Master SKU SKU or Item ID Use SKU if your eBay listings have custom SKUs that match your inventory system. Use Item ID otherwise.
New Listing Status Paused or Active Set to Paused for first-time imports so you can review data before it goes live.
Import From Last X Days Any number (e.g., 7, 30, 90) Start with a small range to validate, then increase to capture your full catalog.
Product Management Mode Create & Update, or Update Existing Use Create & Update for first imports. Use Update Existing for refreshing already-imported products.
Choosing the Right Master SKU

The Master SKU determines how Flxpoint identifies and matches your products. Picking the wrong field can lead to duplicates or mismatched inventory.

  • SKU: Best when your eBay listings already have custom SKUs that match your internal system. Ensures clean matching across channels.
  • Item ID: Use when your eBay listings lack custom SKUs. Item ID is eBay-specific and unique per listing.
Tip: If you plan to manage the same products across multiple channels, use a consistent SKU scheme so Flxpoint can match them automatically.

Quick Checks
  • eBay channel connection shows Connected and passes Test Connection.
  • Date range is wide enough to include the listings you expect (e.g., 30+ days for older listings).
  • eBay seller credentials are current and the account is in good standing.
Troubleshooting
  • No listings imported? Check your date range — if set to "Last 1 Day" but nothing was listed recently, expand to 7 or 30 days. Also confirm the channel connection is active.
  • Missing images? The import can only pull images that are already attached to your eBay listings. Verify images exist on the eBay side.
  • Duplicate products? Review your Master SKU setting. Using inconsistent identifiers (e.g., switching between SKU and Item ID across imports) causes duplicates.
  • Authentication errors? Re-authorize your eBay connection in channel settings. eBay tokens can expire and need periodic renewal.
  • Incomplete variation data? Ensure multi-variation listings on eBay have complete attribute data for every variation. Missing data on eBay means missing data in Flxpoint.
Operation Details
Feature Availability What to Expect
Scheduling Manual Only Import is triggered manually — it cannot be scheduled to run automatically.
Mapping Template Not Applicable Import uses built-in field mapping. No custom mapping template needed.
Variations Supported Multi-variation listings (size, color, etc.) are fully imported.
Images Supported All listing images are pulled into Flxpoint.
Item Specifics Supported Brand, MPN, condition, and other eBay item specifics are imported.
First Import Tip: Start with a small date range (7 days) and set listings to "Paused." Validate the imported data, then run a larger import once you are confident in the settings.
 
 

Sync & Link Listings

eBay integration: Supported
eBay Legacy integration: Supported

Introduction

The Sync & Link Listings operations let you manage existing eBay listings directly from Flxpoint without republishing them. Whether you are using eBay (Legacy) or the newer eBay integration, these tools keep pricing and inventory aligned while preserving listing history, feedback, and search rank.

Sync Listings pushes or pulls price and quantity between Flxpoint and eBay. Link Listings matches existing eBay listings to Flxpoint products so that ongoing sync updates the correct SKUs.

The sections below walk through setup, mapping configuration, and troubleshooting for both integrations.



 
 

Publish Listings

eBay integration: Supported
eBay Legacy integration: Not supported.

Introduction

The Publish Listings feature maps and publishes your product data to eBay. Whether you are listing new products or managing a large catalog, this tool aligns your source data with eBay’s required fields for accurate, compliant listings.

eBay integration: Supported.  |  eBay Legacy integration: Not supported.

Important: eBay requires the Category ID to be a leaf (terminal) category—the most specific node with no subcategories. Using a non-leaf category will cause a publish error.
Purpose of This Integration

The Publish Listings integration connects your platform to eBay to:

  • Map source data to eBay’s required fields for precise, compliant listings.
  • Configure settings that control publishing behavior, including options to avoid fees (e.g., subtitles).
  • Customize and manage mapping templates for different product types or categories.
How the Mapping Works
  • Template Creation: Create a mapping template to define how your source data connects to eBay listing fields.
  • Data Alignment: Ensure the correct information (e.g., title, price, UPC) is sent to eBay for each product.
  • Reusability: Save templates for reuse across different product sets or categories.
Note: Incorrect mappings can cause listing failures or incomplete data on eBay.
Configuration Options
  • Field Mapping: Map source fields (e.g., “Product Name”) to eBay fields (e.g., “Title”).
  • Subtitle Fees: Set “Subtitle” to “Don’t Map” to avoid eBay’s per-listing subtitle fee.
  • Category Selection: Use valid eBay leaf category IDs from the appropriate site-specific file (US, CA, GB, or AU). Always verify the ID is a leaf category.
  • Business Policies & Merchant Location: Provide valid Return, Fulfillment, and Payment policy IDs plus a Merchant Location Key. If missing, generate an eBay Refresh Token via Connect Channel, create policies in eBay Seller Hub, and set up a Merchant Location.
Setup Steps
  • 1 Create a New Template: Go to the Mapping Dashboard and name your template (e.g., “eBay Electronics Mapping”).
  • 2 Map Fields: Link source data to eBay fields (e.g., “Product Name” → “Title”, “UPC” → “UPC”).
  • 3 Configure Subtitle: Set “Subtitle” to “Don’t Map” to avoid fees, unless you intentionally want a subtitle.
  • 4 Set Policy IDs: Enter your Return, Payment, and Fulfillment policy IDs (Flxpoint can pull these from eBay via “View Policies”).
  • 5 Create Category Mapping Set: Map internal categories to the correct eBay site’s numeric leaf category IDs.
  • 6 Save & Publish: Save the template and apply it when publishing listings.
eBay Motors: When a product is mapped to an eBay Motors category ID, the system automatically detects the specialized requirements and processes the listing accordingly. No manual intervention is needed once the mapping is set.

The Mapping Template defines how your platform’s product data maps to eBay listing fields.

Interface Overview
  • Screen labeled “Publish Products.” Name your template (e.g., “eBay Clothing Mapping”).
  • Action buttons: Delete, Duplicate, Save.
  • Columns: From Value (source fields or static values) and To eBay Field (eBay listing fields).
Field Mappings

Below are the key eBay fields you can map:

Field Example Suggested Mapping Purpose
Title Wireless Bluetooth Headphones Map using “Field” Product name displayed on eBay
Description High-quality headphones with noise cancellation Map using “Field” Product details on listing page
Subtitle Free Shipping Included Set to “Don’t Map” Avoid per-listing subtitle fee
UPC 012345678905 Map using “Field” Required for many eBay categories
VAT Percentage 20 Set using “Value” (e.g., “20”) Tax compliance for applicable regions
eBay Plus If Eligible Boolean Map or “Don’t Map” Optional eBay Plus enrollment
Note: eBay also supports up to 10 Category Aspects (sub-aspects per category) that can be mapped in the template.
Mapping Options
  • Don’t Map: Ignore the field entirely (e.g., Subtitle to avoid fees).
  • Set To Empty: Map the field but send it as blank.
  • Field: Link a source field directly to the eBay field.
  • Value: Set a fixed/static value (e.g., VAT Percentage “20”).
  • Mapping Set: Apply a predefined set of mappings (e.g., category mapping sets).
  • Rules: Use conditional logic to determine the mapped value.
Source Data Fields
  • Listing Parent: Attribute (K/V), Brand (T), Category 1–3 (T), Custom Field (K/V), Description (T), Image (L), Parent SKU (T), Title (T).
  • Listing Variant: ASIN (T), Custom Field (K/V), Description (T), Dimensional Weight (N), Estimated Cost (N), GTIN (T), Height (N), Image (L), Length (N), List Price (N), MAP (N), MPN (T), MSRP (N), Master SKU (T), Option (K/V), Quantity (N), SKU (T), Title (T), UPC (T), Weight (N), Width (N).
Category ID Files by eBay Site

Download the file for your target eBay site to find valid leaf category IDs:

Tip: eBay updates categories periodically. Re-download the file for your target site if you encounter unexpected category errors.
Merchant Location Requirements

eBay requires a valid Inventory Location for publishing. Valid ways to define a location:

  • postalCode + country
  • state/province + country

Your mapping template may reference a merchantLocationKey that already exists in your eBay account. If the key is missing, the integration will auto-create the inventory location via API and auto-populate your configuration with the new key. If the key is misconfigured or does not exist, the publish step will fail with a clear error rather than an opaque 500 or null-pointer exception.

Leaf Category Validation

To confirm a Category ID is a valid leaf:

  • 1 Download the correct eBay category file for your target site.
  • 2 Search the file for your numeric category ID and confirm it exists.
  • 3 Verify the category is marked as a leaf. If not, choose a more specific child category.
  • 4 Update your Category Mapping Set, save the template, and republish.
Summary: Map key fields (Title, Description, UPC) to eBay, configure policies and Merchant Location, select valid leaf category IDs, and save your template.

Quick Checks
  • Connection shows Connected and passes Test Connection.
  • Mapping template is selected and saved.
  • Category ID is a valid leaf category for your target eBay site.
  • Return, Fulfillment, and Payment policy IDs are populated.
  • Merchant Location Key is valid or left blank for auto-create.
  • All required fields (Title, UPC, etc.) are mapped.
Troubleshooting
  • “Category ID was not mapped correctly on the mapping template”:
    • Confirm the ID is numeric and exists in the site-specific category file.
    • Verify it is a leaf category. If not, choose a more specific child category.
    • Re-save the template and republish.
  • Merchant Location errors (500 / Null Pointer Exception / invalid key):
    • Validate that either postalCode + country or state/province + country is present.
    • If a specific merchantLocationKey is set, confirm it exists in eBay; otherwise, remove it to allow auto-create.
    • Re-run publish; configuration will auto-populate with the new key if created.
  • Missing fields? Ensure all required fields (Title, UPC, Description) are mapped. Check that “Don’t Map” is only used on optional fields.
  • Subtitle fees? Set “Subtitle” to “Don’t Map” and re-save the template.
  • eBay Motors — mandatory attributes: The four dimensions Weight, Length, Width, and Height are required for Motors categories. Listings missing any of these will fail eBay’s validation.
  • Missing policy fields?
    • Generate a Refresh Token via “Connect Channel.”
    • Create policies in eBay Seller Hub (Account > Business Policies).
    • Set up a Merchant Location in eBay if required.
    • Click “View Policies” or “View Merchant Locations” in Flxpoint to sync IDs.
Operation Details
Feature Availability What to Expect
Publish Listings Supported Publishes mapped product data to eBay.
Category Aspects Supported Up to 10 sub-aspects per category can be mapped.
Business Policies Required Return, Fulfillment, and Payment policy IDs must be set.
Merchant Location Required Auto-created if missing; fails with clear error if misconfigured.
eBay Motors Supported Auto-detected by category ID. Weight, Length, Width, Height mandatory.
Scheduling Supported Can be scheduled or run manually.
Diagnostic Tip: Start with one SKU (e.g., a previously failing one), confirm the Category ID is a leaf, policy IDs are set, and Merchant Location is valid—then scale to the full catalog.
 
 


 

Order Operations

Flxpoint imports orders from eBay into your system, automating order processing, tracking updates, and inventory adjustments. This streamlines fulfillment and ensures efficient handling of eBay transactions.

Get Orders

eBay integration: Supported
eBay Legacy integration: Supported

Introduction

The Get Orders feature automates the process of retrieving order data from eBay into your platform. This integration pulls details such as billing and shipping addresses, order totals, payment methods, and line-item information, mapping them to your platform's fields for processing and fulfillment.

eBay integration: Supported. eBay Legacy integration: Supported.

The sections below walk through each step of the setup and configuration process.

Purpose
  • Retrieve order data from eBay, including billing addresses, shipping addresses, and buyer details.
  • Map fields such as Order ID, SKU, quantity, payment method, and totals to your platform's fields for order processing.
  • Automate retrieval to ensure real-time order updates in your system.
  • Filter which eBay orders are imported by fulfillment status (e.g., "Not Started," "In Progress").
How It Works
  • Data Extraction: Pulls order data including buyer registration address, shipping address, item details, payment, and pricing from eBay.
  • Field Mapping: Maps the extracted data to your platform's fields using a customizable mapping template.
  • Data Import: Imports the mapped data into your platform for fulfillment, inventory updates, and customer service.
Sample Data:
{ "Order": { "OrderID": "12-34567-89012", "BuyerUsername": "john_doe_buyer", "FulfillmentStatus": "NOT_STARTED", "CreationDate": "2025-05-20T14:30:00Z", "Total": 65.99, "TotalCurrency": "USD" }, "ShipToAddress": { "FullName": "John Doe", "AddressLine1": "456 Oak St", "City": "Austin", "StateOrProvince": "TX", "PostalCode": "78701", "CountryCode": "US" }, "Items": [ { "SKU": "EBAY-PROD-456", "Quantity": 1, "LineItemCost": 59.99 } ], "Payment": { "PaymentMethod": "PAYPAL", "PaymentAmount": 65.99 } }
Understanding: "OrderID" (12-34567-89012) uniquely identifies the eBay order, while "ShipToAddress" provides the fulfillment destination and "PaymentMethod" (PAYPAL) tracks the transaction type.
Setup Instructions
  • 1 Create a Mapping Template: Go to the Mapping Dashboard, name your template (e.g., "eBay Get Orders"), and define the initial field mappings.
  • 2 Map Fields: Link eBay fields to your platform's fields (e.g., "eBay Order ID" to "External Order ID," "SKU" to "Order Item SKU").
  • 3 Configure Filters: Set Fulfillment Status to "Not Started" or "In Progress" to focus on actionable orders.
  • 4 Set Fetch Period: Choose how many days back to retrieve orders (e.g., 7 days) to avoid duplicates.
  • 5 Save the Template: Click "Save" to store your mappings for future use.
  • 6 Get Orders: Manually trigger a retrieval or set up a schedule to automatically fetch new orders from eBay.
Fulfillment Status Filtering

When you configure eBay Get Orders, you can control which orders are imported by selecting fulfillment statuses.

  • Locate the Fulfillment Status configuration in the Get Orders settings.
  • Select which statuses should be imported (e.g., "Not Started," "In Progress").
  • Set the Fetch Last X Days value to control the lookback period.
Default behavior: For new setups, the Not Started status is typically selected so that new, unshipped orders begin importing immediately.
Important: At least one fulfillment status must be selected for the Get Orders job to run successfully. If no status is selected, the job will fail.

Interface Overview
  • Header Section: Includes a back button, template name input, and action buttons (Delete, Duplicate, Save).
  • Mapping Section: Two columns — From Value (eBay fields) and To Flxpoint Field (platform fields).
  • Action Buttons: Provides options to delete, duplicate, or save the template.
Key Mapping Fields
Field Maps To Example Purpose Status
Order ID (T) Order: External Order ID 12-34567-89012 Uniquely identifies the eBay order Required
Full Name (T) Shipping Address: Full Name John Doe Provides the recipient's name Required
Address Line 1 (T) Shipping Address: Street Address 1 456 Oak St Primary shipping street address Required
Address Line 2 (T) Shipping Address: Street Address 2 Suite 200 Additional address details Optional
City (T) Shipping Address: City Austin Specifies the shipping city Required
State or Province (T) Shipping Address: State Code TX Indicates the shipping state Required
Postal Code (T) Shipping Address: Post Code 78701 Specifies the shipping postal code Required
Country Code (T) Shipping Address: Country US Indicates the shipping country Required
Phone (T) Shipping Address: Phone 555-1234 Provides the buyer's phone number Optional
Email (T) Billing Address: Email john@example.com Provides the buyer's email address Optional
Total (N) Order: Total 65.99 Indicates the order total amount Required
Shipping Cost (N) Order: Shipping Total 5.99 Specifies the shipping cost Optional
Payment Method (T) Order: Payment Method PAYPAL Indicates the payment method used Optional
Fulfillment Status (T) Order: Status NOT_STARTED Tracks the order fulfillment status Required
SKU (T) Order Item: SKU EBAY-PROD-456 Identifies the product SKU Required
Quantity (N) Order Item: Quantity 1 Specifies the item quantity Required
Line Item Cost (N) Order Item: Price 59.99 Price per line item Required
Available Source Fields
  • eBay Buyer Registration Address: Address Line 1 (T), Address Line 2 (T), City (T), Company Name (T), Country (T), Country Code (T), Email (T), Full Name (T), Phone (T), Postal Code (T), State or Province (T).
  • eBay Order Fulfillment Ship To Address: Address Line 1 (T), Address Line 2 (T), City (T), Company Name (T), Country (T), Country Code (T), Email (T), Full Name (T), Phone (T), Postal Code (T), State or Province (T).
  • eBay Order: Buyer Username (T), Cancel State (T), Creation Date (D), Last Modified Date (D), Legacy Order ID (T), Order Fulfillment Status (T), Order ID (T), Order Payment Status (T), Sales Record Reference (T), Seller ID (T), Total Due Seller (N), Total Due Seller Currency (T).
  • eBay Order Item: Legacy Item ID (T), Line Item Cost (N), Line Item Cost Currency (T), Line Item Fulfillment Status (T), Line Item ID (T), Quantity (N), SKU (T), Total (N), Total Currency (T).
  • eBay Order Payment: Payment Amount (N), Payment Amount Currency (T), Payment Date (D), Payment Method (T), Payment Reference ID (T), Payment Status (T).
  • eBay Order Pricing Summary: Delivery Cost (N), Fee (N), Price Discount (N), Price Subtotal (N), Tax (N), Total (N), Total Currency (T).
  • eBay Order Refund: Refund Amount (N), Refund Date (D), Refund ID (T), Refund Status (T).
"Order ID" maps to External Order ID for tracking, while "SKU" and "Quantity" map to line-item fields for inventory accuracy.
Mapping Options
  • Field: Links an eBay field directly to your platform's field (e.g., "Order ID" to "External Order ID").
  • Value: Sets a fixed value (e.g., always set Marketplace to "eBay").
  • Mapping Set: Uses a lookup table to transform data (e.g., standardize shipping methods).
  • Rules: Applies conditional logic (e.g., if "CountryCode=CA," set "OrderType=International").
  • Don't Map: Skips the field in your platform.
  • Set to Empty: Clears the field in your platform.
Use "Mapping Set" to standardize eBay shipping methods (e.g., map eBay carrier codes to your platform's shipping service names).
Summary: Map key fields like Order ID, Ship To Address, SKU, and Total to your platform, enabling comprehensive order retrieval from eBay. Use fulfillment status filtering to control which orders are imported, and configure shipping mappings to unify carrier methods.

Quick Checks
  • Connection shows Connected and passes Test Connection.
  • Mapping template is selected and saved.
  • Fulfillment status filter is configured (at least one status selected).
  • Fetch Last X Days is set appropriately (e.g., 7 days).
  • Shipping mappings are configured for eBay carrier methods.
Troubleshooting
  • No orders importing? Verify the fulfillment status filter includes the statuses you expect (e.g., "Not Started"). Confirm the Fetch Last X Days covers the order creation dates.
  • Missing address fields? Ensure Ship To Address fields (Address Line 1, City, State, Postal Code) are mapped in the template.
  • Duplicate orders? Reduce the Fetch Last X Days value — overlapping lookback windows can re-import orders.
  • Unknown shipping method? Check the Shipping Mappings screen and map any unmapped eBay carrier codes to your platform's shipping services.
  • Missing buyer details? Review PII retention settings — eBay may redact buyer information after a configured period.
  • Mapping errors? Ensure all required fields (Order ID, SKU, Quantity, Address fields) are mapped. Test with a single order before running a full import.
Operation Details
Feature Availability What to Expect
Get Orders Supported Retrieves orders from eBay based on fulfillment status and date filters.
Fulfillment Status Filtering Supported Filter by Not Started, In Progress, or other statuses.
Shipping & Billing Address Supported Full address fields available for mapping (Ship To + Buyer Registration).
Order Items Supported SKU, quantity, line item cost, and item-level details per line item.
Payment Details Supported Payment method, amount, date, and status.
Refund Data Supported Refund amount, date, and status available for mapping.
Scheduling Supported Can be scheduled (every 15-30 minutes recommended) or run manually.
Shipping Mappings Supported Map eBay carrier codes to your platform's shipping service formats.
PII Retention Supported Configure retention periods for buyer details to comply with privacy requirements.
Final Tip: Test your mappings with a small batch of orders to ensure all address, payment, and item fields are correctly imported before scheduling automated retrieval.
 
 

Sync Orders

eBay integration: Supported
eBay Legacy integration: Supported

Introduction

The Sync Orders operation pushes shipment and tracking data from Flxpoint to eBay, keeping order statuses accurate and providing customers with real-time tracking information. It supports both full and partial shipments.

eBay integration: Supported.
eBay Legacy integration: Supported.

The sections below walk through each step of the setup and configuration process.

Purpose of This Integration

The Sync Orders integration connects Flxpoint to eBay to:

  • Sync shipment and tracking data (carrier, tracking number, ship date) from Flxpoint to eBay.
  • Support both partial and full shipments for flexible fulfillment workflows.
  • Automate order status updates, reducing manual entry and customer inquiries.
How the Integration Works
  • Data Extraction: Pulls shipment data (carrier, tracking number, ship date, method) from Flxpoint when orders are marked as shipped.
  • Field Mapping: Maps Flxpoint shipment fields to eBay fulfillment fields using a customizable mapping template.
  • Data Synchronization: Pushes the mapped data to eBay, updating order status to "Shipped" or "Completed."
Sample Shipment Data:
{ "Shipment": { "Carrier": "UPS", "Method": "Ground", "ShippedAt": "2025-07-12T14:00:00Z", "TrackingNumber": "1Z9999W999999999" } }
Understanding the Data: "Carrier" (UPS) maps to eBay's carrier field, while "TrackingNumber" ensures customers can track their orders directly on eBay.
Setup Instructions
  • 1 Connect an Integration: In Flxpoint, navigate to Channels and select either eBay or eBay Legacy. Provide your eBay credentials if not already connected.
  • 2 Enable Sync Orders: Ensure the "Sync Orders" operation is enabled for your eBay channel.
  • 3 Access Mapping Dashboard: Click the three-dot menu (⋮) on the Sync Orders tile, then select "Manage Mapping."
  • 4 Map Fields: Map Carrier, Tracking Number, Shipped At, and Method from Flxpoint to eBay. For partial shipments, also map Shipment Item SKU and Quantity.
  • 5 Save the Template: Click "Save" to store your mappings.
  • 6 Run Sync: Manually trigger a sync or set a schedule via "Adjust Schedule" in the three-dot menu.
Important: After setup, verify your first few shipments update correctly in eBay Seller Hub. Confirm tracking numbers appear and order statuses change as expected.

The Mapping Template defines how Flxpoint shipment data maps to eBay fulfillment fields.

Mapping Fields

Below is a table of key fields you can map, with examples and purposes:

Field Maps To Example Purpose Status
Carrier Name (T) eBay: Carrier UPS Identifies the shipping carrier Required
Tracking Number (T) eBay: Tracking Number 1Z9999W999999999 Provides the tracking identifier Required
Shipping Method (T) eBay: Method Ground Specifies the shipping method Optional
Shipped At (D) eBay: Shipped At 2025-07-12T14:00:00Z Records the shipment date Recommended
Note Header (T) eBay: Note Header Shipping Update Custom text before tracking info Optional
Note Footer (T) eBay: Note Footer Thank you for your order Custom text after tracking info Optional
Tracking URL (T) eBay: Tracking URL https://www.ups.com/track?num=... Links to the tracking page Optional
Available Source Fields
  • Shipment: Carrier (T), FulfillmentRequestNumber (T), Method (T), Note (T), ShippedAt (D), ShippingCost (N), TrackingNumber (T), TrackingURL (T).
  • Shipment Item (for partial shipments): SKU (T), Quantity (N).
Carrier Mapping Tip: eBay recognizes specific carrier codes. If your internal carrier names don't match eBay's expected format, use a Mapping Set to translate them (e.g., map "FedEx Ground" to eBay's "FedEx").
Mapping Options
  • Field: Link a Flxpoint field (e.g., TrackingNumber) to an eBay field.
  • Value: Set a fixed value (e.g., always set Carrier to "USPS").
  • Mapping Set: Translate values between systems (e.g., internal carrier codes to eBay carrier codes).
  • Rules: Apply conditional logic (e.g., if carrier is DHL, set carrier code to "DHLExpress").
  • Don't Map: Skip the field in eBay.
  • Set to Empty: Clear the eBay field.
Summary: At minimum, map Carrier Name and Tracking Number. For partial shipments, also map Shipment Item SKU and Quantity.

Quick Checks
  • Connection shows Connected and passes Test Connection.
  • Mapping template is selected and saved.
  • Carrier and Tracking Number fields are mapped.
  • For partial shipments, Shipment Item SKU and Quantity are mapped.
Troubleshooting
  • Tracking not showing on eBay? Verify the Tracking Number and Carrier fields are mapped correctly. eBay requires both to display tracking.
  • Orders not updating? Check that the mapping template is saved and the sync job is running (manual or scheduled).
  • Wrong carrier showing? eBay uses specific carrier codes. Use a Mapping Set to translate your internal carrier names to eBay's recognized values.
  • Partial shipment not syncing? Ensure Shipment Item SKU and Quantity are mapped. Each shipment must use a unique tracking number -- never reuse tracking numbers across orders.
Operation Details
Feature Availability What to Expect
Sync Orders Supported Updates eBay with fulfillment/shipment data.
Carrier & Tracking Supported Carrier name, tracking number, and URL mappable.
Partial Shipments Supported Ship items in stages; eBay updates per shipment.
Note Header/Footer Supported Custom text before/after tracking info.
Scheduling Supported Can be scheduled or run manually.
eBay Legacy Supported Same workflow; uses Trading API under the hood.
Tip: Test your mappings with a single shipment before enabling a schedule. Verify tracking appears correctly in eBay Seller Hub.
 
 


 

Troubleshooting 

Common issues and solutions for eBay as Channel integration. Expand each item to learn more.

Still need help? If you're experiencing issues not covered here, contact eBay Seller Support or your Flxpoint account manager.

Contact Support

 

Related Articles

Fedex

Overview This document will go over how to connect to the FedEx integration and w...

Channel Engine as a Channel

ChannelEngine is a multi-marketplace platform. As a sales channel in Flxpoint, it...

Newegg

How To Connect Integration Type: Newegg Connection Requirements: Connection Name,...

GunBroker as a Channel

GunBroker is a popular online auction platform specifically tailored for firearms...