Sync Orders: eBay Legacy & eBay v2
Overview:
The
Sync Orders operation updates your eBay order statuses and shipping details—such as tracking numbers
and partial vs. full shipments—so that both Flxpoint and eBay remain in sync. This ensures your order
statuses and tracking info are consistent for customers.
-
Legacy uses Trading API calls to apply tracking updates to eBay.
-
v2 uses newer REST calls but shows a similar workflow in Flxpoint.
How It Works:
• Tracking Updates: Whenever you mark an order as shipped in Flxpoint—partial or full—Sync Orders
pushes the corresponding tracking number, carrier, and shipping date to eBay. The buyer can then see the status on eBay.
• Post‐Shipment Status: Flxpoint automatically flags that order’s status
as “shippedto” in your system once the sync is complete. If it’s a partial shipment, only the shipped items get updated
while unshipped items remain open until the next sync.
•
Supported Features:
- Partial Order Shipments (if one item ships, but others are pending)
- Full Order Shipments (entire order is shipped at once)
- Carrier & Method Mapping (so eBay knows how it’s being shipped)
Why Use Sync Orders?
• Accurate Tracking for Customers: eBay displays updated tracking in real time, reducing
customer inquiries.
• Automation: No need to manually confirm shipments on eBay.
Flxpoint handles it via the scheduled sync or one‐click operation.
• Reduced Errors: Minimizes mismatches between your internal system
(Flxpoint) and what eBay shows for shipping status.
Steps to Use “Sync Orders”:
1) Connect an Integration: In Flxpoint, select eBay Legacy or eBay v2 and provide your credentials.
If you already have a channel, ensure “Sync Orders” is enabled.
2) Configure Settings (if any): Typically, you won’t see many extra fields for this step.
eBay v2 might say “no additional configurations needed,” as shipping/tracking is handled by the mapping template and the data from your
fulfillment steps in Flxpoint.
3) Define a Mapping Template: This is where you specify how shipment data
in Flxpoint translates to eBay’s Carrier Code, Tracking Number, Shipped Date, and partial “Shipment Item” details
(SKU + Quantity). See below for a complete breakdown.
4) Save & Complete: Flxpoint can then run Sync Orders automatically or on demand,
updating eBay with your shipment info. Orders in eBay appear as “Shipped” with the correct tracking details.
Mapping Template: Full Shipment Field Breakdown
When you open the Sync Orders mapping template, you’ll see “From Value” → “To eBay Shipment Field” or “To eBay Shipment Item Field.”
Each row can be set to
Don’t Map,
Set To Empty,
Field,
Value,
Mapping Set, or
Rules.
Common eBay shipment fields:
1) Shipment Fields
• Carrier: eBay’s recognized shipping carrier (e.g., USPS, UPS, FedEx).
Recommended Mapping: Shipment → Carrier if you store the carrier name in Flxpoint.
Or set a static Value if all shipments use the same carrier.
• Method: eBay’s shipping service name (e.g., Priority Mail).
Recommended Mapping: Optional—some sellers just provide “Carrier” + “Tracking Number.” But you can
also specify a method if eBay requires it for certain carriers.
• Shipped At: Date/time the items were shipped.
Recommended Mapping: “Shipped Date” from your Flxpoint fulfillment record if available.
• Tracking Number: The unique tracking ID.
Recommended Mapping: “Shipment → Tracking Number.”
This is critical for eBay to show customers real-time tracking updates.
2) Shipment Item Fields
• SKU: The item’s SKU in Flxpoint. eBay uses this to match which line item is being shipped
if you have multi-line or multi-quantity orders.
Recommended Mapping: “Shipment Item → SKU.”
Typically must match the same SKU from your original “Get Orders” step or linking logic.
• Quantity: If partial shipments occur, specify how many units of this SKU
are shipping in this update.
Recommended Mapping: “Shipment Item → Quantity.”
If you always ship the full quantity at once, you may just pass the total from your fulfillment record.
Partial vs. Full Shipments:
If Quantity is less than the total units ordered, eBay sees it as a partial shipment. The rest remain unshipped
until you run another Sync Orders with updated quantities. Once the final items ship, eBay marks the order fully shipped.
Mapping Modes (Recap):
• Don’t Map: Ignores that field (e.g., if you don’t want to specify a shipping method
or partial shipping detail for every line).
• Set To Empty: Clears the field in eBay’s system (rarely used here,
but can be helpful if you want to remove a previously sent tracking number in a correction scenario).
• Field: Copies a field from your Flxpoint “Shipment” data.
(e.g., “Carrier” → “Carrier Code,” “Tracking Number” → “Tracking Number”).
• Value: Uses a static text or date if that’s your preference
(e.g., always set “Method” to “Ground”).
• Mapping Set: Translates carriers or methods from your internal naming
to eBay’s recognized codes if needed (e.g., “UPSGround” → “UPS Ground”).
• Rules: Complex transformations or conditions (optional).
E.g., if tracking is from DHL, you might conditionally set “Carrier Code” to “DHLExpress.”
Legacy-Specific Notes:
For eBay Legacy, Sync Orders typically uses the Trading API to confirm shipments.
The main difference is how eBay IDs the order (via the legacy “OrderID” format). Partial shipments still work similarly;
you provide the item or transaction IDs and the shipped quantity.
The status is updated on eBay once the call completes.
v2-Specific Notes:
eBay v2 uses REST calls to update shipments. You’ll see references to “inventoryItemGroup” or “offer IDs” under the hood,
but from Flxpoint’s perspective, you just map Shipment fields to Carrier, Tracking, ShippedAt,
etc. Partial shipments are also supported if your items are set up as separate inventory lines.
Finish & Confirm:
Once your mapping is saved, run
Sync Orders in Flxpoint. Any orders marked as shipped or partially shipped
in Flxpoint will push these updates to eBay. Check your eBay seller dashboard to confirm that tracking numbers
and statuses are displayed correctly. That’s it! You’ve ensured your eBay shipping info is always accurate,
saving time and improving buyer satisfaction.