The eBay v2 connector syncs orders, fulfillments, products, inventory, locations, cancellations, and returns between eBay and the app using eBay’s Sell REST APIs. It works only with listings in eBay’s Inventory model, which are listings created through eBay’s Inventory API. Listings created in Seller Hub or with older eBay tools must be migrated to the Inventory model before the connector can see them.
With this connector, you can:
- Pull paid eBay orders into the app every 5 minutes.
- Cancel orders in the app when eBay cancels them, and send cancellations from the app to eBay.
- Send tracking numbers from your fulfillments to eBay.
- Pull eBay inventory items into the app as products, or push prices from the app to eBay offers.
- Push available inventory to eBay.
- Pull eBay inventory locations and returns into the app.
Setup
Before you begin, make sure you have:
- The connector turned on for your organization. This connector is in beta, so submit a support request to turn it on.
- An eBay seller account and permission to authorize apps for it.
- Your listings in eBay’s Inventory model, with a seller SKU on every item and variation. Listings created in Seller Hub or with older eBay tools aren’t visible to this connector until they’re migrated.
- (Optional) Your own eBay developer app, if you don’t want to use the Pipe17 app: its Client ID, Client Secret, and a RuName (eBay redirect URL name).
To connect eBay v2:
- Navigate to Integrations in the app.
- Click Add Integration, and then select eBay v2.
- Select the marketplace your seller account lists on in the eBay marketplace field.
- If you use your own eBay app, enter its Client ID in the Custom App Client ID field. Otherwise, leave it empty.
- If you use your own eBay app, enter its Client Secret in the Custom App Client Secret field. Otherwise, leave it empty.
- If you use your own eBay app, enter the RuName in the Custom App RuName field. Otherwise, leave it empty.
- If you use your own eBay app, copy the URL from OAuth Redirect URL and set it as the accept URL of your RuName in your eBay developer account. Otherwise, ignore this field.
- Click Connect. eBay opens and asks you to sign in.
- Sign in to your eBay seller account, and then click Agree and Continue. eBay returns you to the app.
- After you connect, toggle on the flows you want to use: Pull inventory locations from eBay, Pull orders from eBay, Push order cancellations to eBay, Push fulfillments information to eBay, Push inventory updates to eBay, and Pull returns from eBay. To sync products, select an option in Process product catalog information.
Settings
| Setting | Description | Options/Default |
|---|---|---|
| Pull inventory locations from eBay | Creates a location in the app for each eBay inventory location. | On/Off. Default: Off |
| Pull orders from eBay | Pulls paid orders that match the order filters. | On/Off. Default: Off |
| Exclude orders created before this date | Pulls only orders created after this date. | Optional. Default: the date you created the integration |
| Process orders with specific order IDs | Pulls only the eBay orders you list. Cancellations of other orders still apply. Use this while testing. | Optional. Empty pulls all |
| Process orders with specific status | Pulls only orders in the selected eBay fulfillment statuses. Cancellations still apply. | Not started, In progress, Fulfilled. Empty pulls all |
| Cancel Pipe17 orders when eBay reports the order canceled | Cancels the order in the app when eBay marks it canceled. Shipping requests already sent to the warehouse are canceled so the 3PL can try to stop them. If a shipping request has already shipped, the order gets a late cancel exception. | On/Off. Default: On |
| Push order cancellations to eBay | Cancels the order on eBay when you cancel it in the app, or approves the buyer’s open cancellation request. Only orders canceled after you turn this on are sent. The cancel reason comes from the order’s cancelReason custom field. Default reason: out of stock or can’t fulfill. |
On/Off. Default: Off |
| Push fulfillments information to eBay | Sends shipment tracking for new fulfillments to eBay. | On/Off. Default: Off |
| Exclude fulfillments created before this date | Sends only fulfillments created after this date. | Optional. Default: the date you created the integration |
| Process product catalog information | Pulls eBay inventory items into the app, or pushes prices from the app to eBay offers. You can’t pull and push at the same time. | Disabled, Pull product catalog from eBay, Push product catalog to eBay. Default: Disabled |
| When pulling eBay product catalog to Pipe17 | Controls what the pull does with eBay products. | Only link eBay products with existing Pipe17 products, Only pull eBay products updates for existing Pipe17 products, Pull eBay products to create or update Pipe17 products. Default: Only link eBay products with existing Pipe17 products |
| Allow updating prices in eBay offers | Required for the price push. When on, the app updates the price of published fixed-price offers. Auction listings aren’t changed. | On/Off. Default: Off |
| Use prices with names in the list below as the eBay offer price | The price names to send to eBay. The app uses the first price that matches. If you leave it empty, the app uses the product’s first price. | Optional |
| Process only products with specific SKUs | Syncs only the SKUs you list. Accepts /regex/ patterns. |
Optional. Empty syncs all |
| Force product catalog resync | Starts a full product resync on the next run. Turns off on its own when the resync is complete. | On/Off. Default: Off |
| Push inventory updates to eBay | Sends available quantities to eBay. By default, the app sends the total from all active locations. | On/Off. Default: Off |
| Process only inventory items with specific SKUs | Pushes inventory only for the SKUs you list. Accepts /regex/ patterns. |
Optional. Empty pushes all |
| Push inventory from a specific location only | Pushes inventory from this location only, instead of the total from all active locations. | Location. Default: none |
| Push inventory only for products linked to an eBay inventory item | Skips SKUs that aren’t linked to an eBay inventory item. Turn it off to send every SKU and let eBay reject unknown ones. | On/Off. Default: On |
| Force inventory resync | Pushes all inventory again on the next run. Turns off on its own when the resync is complete. | On/Off. Default: Off |
| Pull returns from eBay | Pulls eBay return requests and links them to the original order in the app. | On/Off. Default: Off |
| Exclude returns created before this date | Pulls only returns created after this date. | Optional. Default: the date you created the integration |
| Process returns with specific return IDs | Pulls only the eBay returns you list. Applies to new returns only. | Optional. Empty pulls all |
| Pull only returns in one of the following eBay states | Pulls only returns in the eBay states you list, for example RETURN_REQUESTED, ITEM_SHIPPED, ITEM_DELIVERED, or CLOSED. Applies to new returns only. |
Optional. Empty pulls all |
Flows
| Flow | Direction | Notes |
|---|---|---|
| Locations | eBay → Pipe17 | Runs every 5 minutes. Creates a location for each eBay inventory location. |
| Orders | eBay → Pipe17 | Runs every 5 minutes. Pulls paid orders changed since the last run. Refunded orders are skipped. The first run looks back up to 60 days. |
| Order cancellations | eBay → Pipe17 | Runs with the orders flow. Cancels the order in the app when eBay reports it canceled. Buyer cancellation requests that are still open aren’t acted on. |
| Order cancellations | Pipe17 → eBay | Runs every 5 minutes. Cancels whole orders only, up to 30 days after the sale. An order with any shipped item is never canceled on eBay and gets a late cancel exception instead. |
| Fulfillments | Pipe17 → eBay | Runs every 5 minutes. Sends the first tracking number of each fulfillment, with letters and digits only, and the carrier. If eBay already has the tracking number, nothing is sent. Orders eBay marks as fulfilled are skipped. |
| Products | eBay → Pipe17 | Reads the full eBay catalog on each run. The next run is scheduled 1, 4, 8, or 12 hours later depending on how long the last one took, or the next day at 04:00 UTC. |
| Product prices | Pipe17 → eBay | Runs every 5 minutes. Sends prices only, and only when they changed. eBay allows 250 revisions per listing per day. Product details aren’t pushed. |
| Inventory | Pipe17 → eBay | Runs every 5 minutes. Sends the available quantity, up to 25 SKUs per eBay call. A listing shows the lower of the pushed quantity and its offer’s available quantity. |
| Returns | eBay → Pipe17 | Runs every 30 minutes. Every 6 hours, the app also rechecks returns created in the last 60 days for status changes. |
| Listings outside the Inventory model | Not supported | Listings created in Seller Hub or with older eBay tools aren’t visible to this connector until they’re migrated to the Inventory model. |
Troubleshooting
No products or inventory sync for some or all listings
Those listings aren’t in eBay’s Inventory model, so the connector can’t see them. Migrate them in eBay, and check that every item and variation has a seller SKU. Also check that Push inventory only for products linked to an eBay inventory item isn’t skipping SKUs that have no link yet.The integration stops syncing with an authorization error
The eBay access was revoked or expired. Click Connect again and approve access in eBay. If you use your own eBay app, check the Custom App Client ID, Custom App Client Secret, and Custom App RuName, and make sure the RuName’s accept URL is the OAuth Redirect URL.A fulfillment wasn’t sent to eBay
eBay needs both a carrier and a tracking number. Add the missing carrier or tracking number to the fulfillment. Fulfillments without an order ID, and orders eBay already marks as fulfilled, are skipped.An order has a late cancel exception
The order was canceled after some of it shipped. Shipped orders are never canceled on eBay, and shipments already sent can’t be stopped. Handle the order in eBay or with your warehouse directly.An inventory exception lists SKUs that eBay rejected
eBay accepted the rest of the update and rejected the SKUs listed. Check that each SKU exists as an eBay inventory item on the marketplace you selected, and then use the Push inventory to eBay by SKU action to send them again.
Need Help?
If you need additional assistance:
- Use Ask Pippen, our AI agent, located at the top of the platform page.
- Submit a support request with as much relevant detail as possible. Learn how to submit a request.
We’re here to help you succeed with your operations.
Comments
0 comments