Flxpoint's eBay channel lets users manage inventory, orders, and shipments within one platform. This document provides a step-by-step guide covering account login, authentication, SKU mapping, and API configuration. Follow these instructions to connect your eBay seller account to Flxpoint.
How to Connect
Step 1: Log into your Flxpoint account and go to the Channels section.
Step 2: Click on + Add Channel to begin your eBay integration.
Step 3: In the popup, choose eBay as your channel and enter a channel name. Then click Save.
Step 4: When prompted with "No integrations created yet," click Get Started to launch the setup wizard.
Step 5: In the Setup Integrations wizard, select eBay Marketplace Integration.
Step 6: Click on Connect to eBay to initiate the authentication process.
Step 7: You’ll be redirected to eBay’s authentication page. Log in with your eBay seller credentials and grant the required permissions.
Step 8: Once authenticated, return to the setup screen and review your connection details. Click Continue to proceed.
Step 9: Map your internal Inventory SKU to your eBay Listing SKU. You may also set an SKU prefix if needed.
Note: Ensure your SKU mapping matches your eBay listings to avoid inventory errors.
Tip: Use a consistent naming convention for easier management.
Step 10: Configure your API connection to activate automated features:
Inventory & Pricing: Enable automatic sync and pricing updates with your eBay API credentials.
Order Sync: Enable automatic order processing by linking your eBay account.
Shipment Tracking: Provide the necessary API details to enable shipment updates.
Click Save to finalize your integration.
×
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 V2 integration: Not Supported
Sync & Link Listings
eBay Legacy integration: Supported
Publish Listings
eBay Legacy integration: Not supported.
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 Legacy integration: Supported
Send Orders
Introduction to Send Orders Integration
This guide walks you through setting up the Send Orders integration for your sales channel. It enables you to send order details, including shipping and billing information, to your channel (e.g., eBay) while ensuring compliance with data restrictions and proper mapping of order details. Let’s get started.
Purpose of This Integration
The Send Orders integration allows you to:
- Transmit Order Details: Send order information such as order status, payment status, and invoice details to your sales channel.
- Handle Shipping and Billing: Map shipping and billing addresses, ensuring accurate delivery and invoicing.
- Comply with PII Restrictions: Manage personally identifiable information (PII) retention settings to meet privacy requirements.
This ensures seamless order fulfillment and accurate record-keeping on your sales channel.
How the Integration Works
The Send Orders integration operates as follows:
1. Order Retrieval: Orders are fetched using the "Get Orders" workflow (as configured in the settings, e.g., fetching orders with a "Complete" status from the last X days).
2. Order Acknowledgement: The system acknowledges the order and prepares it for sending, including invoice details available in the same order call.
3. Data Mapping: Order details (e.g., SKU, quantity, price) and shipping/billing information are mapped to the channel’s fields (e.g., eBay Order Item → Order Line Item).
4. Shipping Selection: Users map shipping methods (e.g., UPSGround, FedExHomeDelivery, USPSFirstClass) to ensure the correct shipping option is applied.
5. Transmission: The mapped order data is sent to the sales channel, ensuring all details (e.g., currency in USD, weight, dimensions) are correctly formatted.
Note: If required fields like "SKU" are disabled in the mapping, the order transmission will fail, and an error will be logged.
Configuration Options
Customize the integration with these settings:
- Enable/Disable Fields: Choose which fields to send in the mapping template (e.g., enable "Price" or disable "Other Cost").
- Shipping Method Mapping: Map available shipping methods from the channel (e.g., UPSGround, FedExHomeDelivery) to your system’s shipping options.
- PII Retention: Set the duration to retain personally identifiable information (e.g., "Indefinitely," "30 days After Shipment").
- Order Status Filtering: Select which order statuses to send (e.g., "Complete," "All").
Setup Instructions
Follow these steps to configure the Send Orders integration:
1. Access the Integration: Navigate to your sales channel (e.g., eBay) and select the "Send Orders" option.
2. Configure Order Retrieval: In the "Get Orders" settings, specify the order status to fetch (e.g., "Complete") and the time frame (e.g., last 30 days).
3. Set PII Retention: Under "Personal Identifying Information Retention," choose a retention period (e.g., "Indefinitely" or "30 days After Shipment").
4. Map Shipping Methods: Map the channel’s shipping methods (e.g., UPSGround, FedExHomeDelivery, USPSFirstClass) to your system’s shipping options.
5. Create a Mapping Template: Define which order fields to send (see mapping details below).
6. Send Orders: Manually trigger the send operation or schedule it to run automatically.
Order Details
The following order details are sent to the channel:
- Order & Payment Statuses: Includes the order status (e.g., "Complete") and payment status.
- Order Receipt/Invoice: Invoice information is included in the same order call, with currency set to USD from the store.
- Custom Fields: Any custom fields defined in your system can be mapped and sent.
- Digital Items/Donations: Currently, digital items or donations are not supported in this integration.
Weight & Dimensions
Weight and dimensions can be included if available:
- Units: Weight and dimensions are sent in the units defined by your system (e.g., pounds, inches).
- Mapping: Map these fields in the template if required by the channel.
Limitations
Be aware of the following:
- Tax Handling: There is hardcoded logic—if the Tax field is null, the system sets SalesTaxAmount as the Tax Cost.
- Digital Items/Donations: Not supported in this integration.
- Required Fields: Fields like "SKU" and "Created Time" are required and cannot be disabled in the mapping.
Mapping Template Details
A mapping template controls how order data is sent to the channel. You can enable or disable fields as needed.
Interface Overview
- The mapping screen is labeled “eBay → Flxpoint” with subsections for “Get Orders,” “eBay Order Item,” and “eBay Shipping Address.”
- Buttons: Cancel and Save Mapping.
- Columns: Left (eBay fields), Right (your system’s fields).
Mapping Options
- Enable: Send the field (e.g., enable "Price").
- Disable: Ignore the field (e.g., disable "Other Cost").
Required fields like "SKU" and "Created Time" cannot be disabled.
Available Source Fields
- Get Orders: CREATED TIME, eBAY ORDER ID, IMPORT CHARGE, TOTAL SHIPPING SERVICE COST, SUBTOTAL, TOTAL, CREATED TIME.
- eBay Order Item: SALE PRICE, QUANTITY, SKU, TITLE.
- eBay Shipping Address: ADDRESS 1, ADDRESS 2, CITY NAME, COMPANY NAME, COUNTRY NAME, COUNTRY CODE, NAME, PHONE, POSTAL CODE, STATEorPROVINCE.
Complete Field Mappings
Get Orders Mappings These mappings cover order details from the channel:
Created Time: The date and time the order was created.
- Example: "2025-04-01T10:00:00Z"
- Mapping: Maps to "Channel Invoice: Created On" or "Order: Ordered On".
- Reason: Tracks when the order was placed; required field.
eBay Order ID: The unique identifier for the order on eBay.
- Example: "1234567890-1234567890"
- Mapping: Maps to "Channel Invoice: Invoice Number".
- Reason: Identifies the order on the channel.
Total: The total cost of the order.
- Example: "$150.00"
- Mapping: Maps to "Channel Invoice: Total".
- Reason: Provides the final order amount in USD.
eBay Order Item Mappings These mappings cover item-level details:
SKU: The unique identifier for the product.
- Example: "ABC123"
- Mapping: Maps to "Order Line Item: SKU".
- Reason: Identifies the product; required field.
Quantity: The number of items ordered.
- Example: "2"
- Mapping: Maps to "Order Line Item: Quantity".
- Reason: Specifies how many units were purchased.
Sale Price: The price per item.
- Example: "$50.00"
- Mapping: Maps to "Order Line Item: Price".
- Reason: Provides the cost per unit in USD.
eBay Shipping Address Mappings These mappings cover shipping and billing address details:
Address 1: The primary address line.
- Example: "123 Main St"
- Mapping: Maps to "Billing Address: Address Line 1" or "Shipping Address: Address Line 1".
- Reason: Ensures accurate delivery and billing.
Name: The customer’s full name.
- Example: "John Doe"
- Mapping: Maps to "Billing Address: Full Name" or "Shipping Address: Full Name".
- Reason: Identifies the recipient; subject to PII retention settings.
Postal Code: The postal code for the address.
- Example: "90210"
- Mapping: Maps to "Billing Address: Postal Code" or "Shipping Address: Postal Code".
- Reason: Ensures accurate delivery.
Practice Mapping Try enabling or disabling the "Sale Price" field:
Troubleshooting
If issues arise:
- Verify that required fields like "SKU" and "Created Time" are enabled in the mapping template.
- Check the PII retention settings to ensure compliance with privacy requirements.
- Ensure shipping methods are correctly mapped to avoid delivery errors.
- If the Tax field is null, confirm that SalesTaxAmount is being set as the Tax Cost per the hardcoded logic.
- Contact support if the issue persists.
Conclusion
With the Send Orders integration set up, you can efficiently transmit order details to your sales channel, ensuring accurate fulfillment and compliance with data restrictions.
