eBay Tracking Number Uploader (Bulk)

Registers tracking numbers and marks orders as shipped on eBay using the official eBay Fulfillment REST API — no screen scraping, fully ToS-compliant.

Supports bulk processing of multiple orders in a single run.

---

Why use this instead of manual entry?

• Bulk-upload tracking numbers for dozens of orders at once
• No eBay API development required — just paste your credentials
• Works for any carrier (Japan Post, FedEx, UPS, DHL, Yamato, etc.)

---

Prerequisites

You need an eBay Developer account with OAuth credentials:

1. Sign up at developer.ebay.com
2. Create an application → get Client ID and Client Secret (Cert ID)
3. Get a User Token (Refresh Token) with sell.fulfillment scope:
   • Go to developer.ebay.com/my/auth
   • Sign in with your seller account
   • Select scopes: sell.fulfillment
   • Copy the Refresh Token
4. Refresh Token is valid for ~540 days. Regenerate when expired.

---

Input

Field	Type	Required	Description
clientId	string	✅	eBay Developer Client ID (App ID)
clientSecret	string	✅	eBay Developer Client Secret (Cert ID)
refreshToken	string	✅	OAuth Refresh Token with sell.fulfillment scope
environment	string	—	production (default) or sandbox
marketplaceId	string	—	eBay marketplace ID (default: EBAY_US)
orders	array	✅	List of orders to ship (see below)

Order object

{
  "orderId": "12-34567-89012",
  "trackingNumber": "1234567890",
  "carrier": "JAPAN_POST"
}

Supported carrier codes: FEDEX, UPS, USPS, DHL, DHL_EXPRESS, JAPAN_POST, YAMATO, SAGAWA, OTHER

---

Output (Dataset)

Each order produces one record:

{
  "orderId": "12-34567-89012",
  "trackingNumber": "1234567890",
  "carrier": "JAPAN_POST",
  "lineItemCount": 1,
  "status": "success",
  "processedAt": "2026-05-14T10:30:00.000Z"
}

On failure: "status": "error" with "error": "..." message.

---

PPE Pricing

$0.20 per successfully processed order.

• Failed orders are not charged
• Infrastructure costs are automatically deducted from eBay API usage (free tier: 5,000 calls/day)

---

⚠️ Notes

• This Actor uses the official eBay Sell API (not browser automation)
• Rate limit: 5,000 API calls/day per application. Each order uses 2 calls (getOrder + createFulfillment).
• Do not run multiple instances simultaneously with the same credentials (rate limit risk)
• Sandbox environment uses api.sandbox.ebay.com with test orders only