eBay Italy Integration: Trading API, Promoted Listings & Unified Store Management

About eBay Italy: Founding, Ownership and Market Position

Global Origin & Italian Launch (1995 – Today)

eBay was founded on September 3, 1995 in San Jose, California by Iranian-American computer programmer Pierre Omidyar, originally as "AuctionWeb." Within two years it became one of the first dot-com success stories and went public on NASDAQ in 1998 under the ticker EBAY. The Italian subsidiary eBay Italia S.r.l. was incorporated in 2001 with headquarters in Milan, making 2026 the platform's 25th anniversary on the Italian market.

Unlike newer marketplaces that pivoted to 1P retail, eBay has remained a pure third-party (3P) marketplace — eBay never holds inventory, never competes with its sellers, and never operates fulfillment warehouses in Italy. This 3P-only stance is a structural moat: SMB and mid-market merchants trust eBay precisely because the platform is not also their competitor. eBay Inc. spun off PayPal in 2015 and StubHub in 2020 to focus exclusively on the core marketplace and adjacent verticals such as eBay Motors, eBay Collectibles and eBay Refurbished.

eBay Inc. Corporate Structure (2025)

• eBay Inc. — Parent company, NASDAQ: EBAY, headquartered in San Jose, California
• eBay Italia S.r.l. — Italian subsidiary, headquartered in Milan, operates eBay.it
• Adevinta stake — 33% post-2021 sale of Classifieds Group (Subito.it, Kijiji)
• eBay Ventures — Corporate VC arm investing in adjacent commerce tech
• Public float — Institutional shareholders include Vanguard, BlackRock, State Street

Position in the Italian E-Commerce Landscape

According to Casaleggio Associati's "E-commerce in Italia 2024" report and Statista market estimates, eBay Italy ranks among the top 5 marketplaces in the country alongside Amazon.it, ePRICE, Subito.it (now Adevinta) and emerging vertical players. While Amazon dominates total GMV, eBay Italy holds a defensible niche in used, refurbished, collectible and long-tail categories — exactly the assortment where Amazon's 1P logic struggles. Italian consumers searching for "ricambi auto," "orologi vintage" or "fumetti d'epoca" disproportionately reach eBay.it first.

eBay Italy GMV and Scale (2024–2025 Data)

While eBay Inc. does not break out Italy-specific revenue in 10-K filings, third-party estimates and Casaleggio market reports converge on a steady ~€3.5–4.5B annual GMV for eBay.it. The platform's growth has been less explosive than Amazon Italy but markedly more durable, with category-mix shifting toward higher-AOV verticals.

Year	IT GMV (EUR)	Active Buyers	Active Sellers	Cross-Border %
2020	~€3.2B	10M	60K	22%
2022	~€3.6B	11.5M	68K	26%
2024	~€4.0B	13M+	75K+	31%
2025 (forecast)	~€4.3B	13.8M	80K	34%

The most strategically relevant data point for SaaS-enabled sellers: the cross-border share is climbing 3–4 points per year. An Italian seller listed on eBay.it automatically surfaces on eBay.de, eBay.fr and eBay.co.uk through eBay's International Site Visibility mechanism — turning a single Milan-based SKU into a pan-European listing without translating each catalog manually.

eBay Italy Seller Onboarding (2026 Current Rules)

1. Legal & Tax Requirements

To sell on eBay Italy as a business, you need an active Italian VAT registration (Partita IVA) with Agenzia delle Entrate. Sole proprietorships ("ditta individuale"), SRLs and SpAs are all eligible, but you must be capable of issuing electronic invoices via FatturaPA through Sistema di Interscambio (SdI) — this is mandatory and non-negotiable since 2019.

• Partita IVA registered with Agenzia delle Entrate
• Codice fiscale and legal representative ID
• Camera di Commercio (REA) registration for SRL/SpA
• SDI recipient code or PEC for FatturaPA delivery
• Bank account (IBAN) eligible for eBay Managed Payments — settlement runs through Payoneer or bank wire
• FatturaPA e-invoicing provider (Aruba, TeamSystem, Fatture in Cloud or equivalent)
• WEEE / REACH registration for electronics, batteries, chemicals and toys
• Trademark documentation for protected categories (cosmetics, pharma-adjacent, luxury)

2. eBay Seller Application

Business sellers register through ebay.it/sl/sell — the Official eBay Italy Seller Application. KYB review typically takes 3–10 business days. Once approved, you create developer credentials in the eBay Developer Program (App ID, Cert ID, Dev ID) and generate OAuth 2.0 user tokens — these are the credentials Zunapro consumes to push and pull data through the Trading API and REST Sell APIs.

📥 Official eBay Italy Seller Application ebay.it/sl/sell — free application, 1–3 business days approval →

3. Listing Quality & Content Rules

eBay's content scoring (Listing Quality) directly drives Best Match ranking. The non-negotiables:

• Title: up to 80 characters, no ALL CAPS, no keyword stuffing, brand + product + key attribute
• Images: minimum 500×500px (1600×1600px recommended), max 24 photos, white background preferred, no watermarks
• Item specifics: mandatory fields (Brand, MPN, Condition, EAN/GTIN) — empty fields suppress visibility
• Description: HTML allowed but mobile-friendly responsive layout recommended (60%+ of IT traffic is mobile)
• Category mapping: eBay categoryId + leaf-level specifics; mismatched categories trigger automatic relisting in low-traffic nodes
• GTIN/EAN: strongly recommended; product catalog (EPID) matching boosts Best Match rank

eBay Italy Fees (2026)

eBay's fee model is intentionally simpler than Amazon's: insertion fees are usually waived (250 free zero-insertion-fee listings per month for business sellers), and a final value fee of 4–12% is charged only when an item sells. A fixed €0.35 order fee applies below €10. Italian VAT (22%/10%/4% depending on product class) is added on the fees themselves, not just the merchandise. Below is the consolidated 3-band view:

Net margin formula: Sale price − Final value fee − €0.35 order fee (if applicable) − VAT on fees − Shipping label cost − COGS = Net profit. Zunapro's pricing module runs this calculation per SKU and per category, and blocks any listing that would breach your minimum-margin threshold.

eBay API Integration — Technical Details

eBay exposes two parallel API families. The legacy Trading API is XML/SOAP-based, mature and feature-complete for the Italian site (siteID=101). The modern REST Sell APIs (Inventory, Fulfillment, Marketing, Finances, Account) are JSON-based and where eBay invests new functionality. Production base URL: https://api.ebay.com/ · Sandbox: https://api.sandbox.ebay.com/

Authentication

All modern eBay APIs use OAuth 2.0. You register an application in the eBay Developer Program, obtain App ID, Cert ID and Dev ID, then exchange them for user access tokens via the authorization-code grant. Tokens expire in 2 hours; refresh tokens last 18 months. The Trading API also accepts the same OAuth bearer in the X-EBAY-API-IAF-TOKEN header for backward compatibility.

Key API Surfaces

• Trading API — AddFixedPriceItem, ReviseInventoryStatus, GetOrders, CompleteSale, feedback and dispute handling
• Sell Inventory API — Modern REST inventory management: SKU-level inventory items, offers, location-based inventory
• Sell Fulfillment API — Order retrieval, shipment uploads, refunds, cancellations
• Sell Marketing API — Promoted Listings Standard and Advanced campaigns, ad bidding, performance reports
• Sell Finances API — Payout tracking, transaction-level fee breakdowns, payout schedules (Managed Payments)
• Sell Account API — Fulfillment policies, payment policies, return policies, business policies
• Notifications (Platform Notifications + Notification API) — Real-time webhooks for ItemSold, OrderShipped, ReturnInitiated and 40+ event types

Rate Limits & Error Handling

Default Trading API call ceilings are 5,000 calls/day per app and can be raised to 1.5M+ via Compatible Application Check certification. REST Sell APIs use a sliding-window quota typically set at 5,000 calls/day per resource family. Common HTTP responses: 400 (validation — usually missing item specific), 401 (expired OAuth token, refresh required), 403 (insufficient scope), 429 (rate limit), 500 (eBay transient error — exponential backoff retry). Zunapro's integrator implements exponential backoff with jitter, dead-letter queues for unrecoverable errors and automatic token refresh.

eBay Bulk Listing & File Exchange — High-Volume Catalog Uploads

eBay File Exchange (CSV-based) and the Sell Inventory API bulk endpoints are the two paths for moving thousands of SKUs into eBay Italy without manual data entry. Zunapro abstracts both behind a single mapping interface, so you choose strategy per use-case rather than per technology.

eBay-Compatible Catalog Schema

The core fields Zunapro maps from your storefront to eBay's required structure:

• SKU — your master inventory key (used by Inventory API)
• Brand, Title, MPN, EPID, GTIN (UPC/EAN/ISBN)
• CategoryID (eBay leaf), aspects (color, size, material, condition)
• availability.shipToLocationAvailability (stock), price.value, price.currency (EUR)
• fulfillmentPolicyId, paymentPolicyId, returnPolicyId
• imageUrls (1–24 URLs), description (responsive HTML)

Supplier Feed Ingestion → eBay Italy

Many Italian wholesalers (especially in Veneto fashion districts, Naples electronics distributors and Lombardy industrial suppliers) publish XML or CSV catalog feeds. Zunapro's ingestion engine:

1. Polls the supplier feed URL (hourly/daily cron)
2. Learns category mapping (first mapping manual, subsequent SKUs auto-classified)
3. Normalizes attributes — brand, material, size, condition into eBay aspect values
4. Applies margin + final value fee to the cost price
5. Tracks supplier stock — out-of-stock SKUs are end-of-life'd on eBay automatically
6. Pushes via Inventory API or File Exchange depending on volume

eBay Italy Shipping & Fulfillment — 3PL Reality

Unlike Amazon FBA, eBay Italy operates no native fulfillment warehouses in Italy. Inventory stays with you or with a 3PL provider, and you remain responsible for handling, packing and dispatch. This is not a weakness — it is the structural choice that lets eBay stay a pure 3P marketplace and keeps category fees 30–50% lower than fully-fulfilled alternatives.

Italian Carrier Ecosystem

• Poste Italiane — National postal operator, best reach in southern Italy and remote provinces
• BRT (Bartolini) — High volume B2C express, dense locker network ("Fermo Point")
• GLS Italia — Strong B2B and northern-Italy coverage, ParcelShop network
• SDA — Poste Italiane Group, integrated with eBay rate cards for SMB sellers
• UPS — Premium B2B and cross-border to DE/FR/AT
• DHL Italia — Premium cross-border, especially DE and benelux

3PL Fulfillment Economics (2025 indicative)

• Storage: €4–9 per pallet position per month, depending on region (Lombardy higher, Puglia lower)
• Pick & pack: €1.20–€2.80 per order, with cubic-volume adjustments
• Return processing: €1.50–€4.00 per returned item, plus disposition workflow
• Shipping label: €4.50–€9.50 domestic via negotiated 3PL rate cards

For sellers below ~300 orders/month, in-house fulfillment from a home warehouse remains the most economical. Above that threshold, 3PL or a hybrid model pays for itself in time saved. Zunapro's multi-warehouse engine can split inventory across your own stockroom plus 1–N 3PL nodes and route each eBay order to the optimal origin.

eBay Italy Seller Performance & Affidabilità Top

eBay grades every seller against three core service metrics that determine Best Match visibility and access to the prized Affidabilità Top (eBay Plus Italy) badge — eBay's equivalent of "Premium Seller" status. The thresholds:

• Defect rate — ≤0.5% of transactions (covers cancellations from seller side, escalated disputes)
• Late-shipment rate — ≤2% over the trailing-12-month window
• Tracking-upload rate — ≥95% of shipments must have valid tracking
• Positive feedback — ≥98% from Italian buyers
• Minimum volume — ≥100 transactions/year with ≥€1,000 sales
• Return policy — 30-day returns with free domestic returns (mandatory for Affidabilità Top)

Zunapro's real-time stock synchronization reduces oversell-driven cancellations by ~90%; the moment a unit is sold on your storefront or another marketplace, the eBay Italy listing is decremented — protecting the defect rate that gates Affidabilità Top.

eBay Italy Advertising, Promotions & Smart Pricing

eBay Promoted Listings

• Promoted Listings Standard — CPA model: pay a 2–20% ad rate only when the promoted listing converts within the attribution window
• Promoted Listings Advanced — CPC model: priority placement at the top of search, full keyword targeting, daily-budget control
• Promoted Offers — Coupon and discount campaigns surfaced in cart and watchlist
• Promoted Stores — Branded eBay Store hero placements (eligible above Anchor Store level)

Smart Repricing

Best Match ranking on eBay Italy weighs price competitiveness heavily. For commoditized SKUs with 5+ sellers, the lowest responsibly priced listing typically wins the top slot. Zunapro's repricer module reprices SKUs against your competitor set every few seconds — and refuses to cross the minimum-margin floor you set, so you never race to the bottom.

FatturaPA & SdI Compliance — Italy's Mandatory E-Invoicing

Every Italian eBay seller is required to issue FatturaPA (electronic XML invoices) through Sistema di Interscambio (SdI), the public infrastructure operated by Agenzia delle Entrate. This applies to both B2B and B2C transactions; for private consumers a fiscal receipt ("scontrino telematico") via "corrispettivi telematici" may substitute, but most eBay business sellers issue FatturaPA for full traceability. Manual invoice generation breaks at 50+ orders/day.

Zunapro's FatturaPA module:

• Generates FatturaPA XML the moment an eBay Italy order is captured
• Routes through SdI-certified providers (Aruba, TeamSystem, Fatture in Cloud, FattureGo)
• Issues automatic credit notes ("nota di credito") on returns and refunds
• Produces monthly LIPE and quarterly VAT reports aligned with Agenzia delle Entrate timelines
• Sends the customer a copy via email + PDF mirror, with PEC/SDI code lookups for B2B counterparties
• Honors GDPR (Garante per la protezione dei dati personali) on customer data retention
• Tracks 14-day right of withdrawal ("diritto di recesso") and the 2-year statutory warranty ("garanzia legale di conformità")
• Flags REACH and WEEE obligations on regulated categories

eBay Italy Shipping Integration — Multi-Courier Routing

eBay Italy orders are shipped via the seller's own contracted carriers. The default mix for Italian eBay merchants is Poste Italiane (national reach), BRT (express B2C), and GLS Italia (B2B & northern Italy), with SDA, UPS and DHL Italia covering premium and cross-border segments.

Zunapro's multi-courier module selects the cheapest carrier per parcel based on weight, destination CAP and customer-selected service level, prints the label, and pushes the tracking number back to eBay via the Fulfillment API — keeping the tracking-upload rate above the 95% Affidabilità Top threshold.

Returns, Disputes & Customer Service on eBay Italy

Italian consumer law grants buyers a mandatory 14-day right of withdrawal (Codice del Consumo art. 52) on distance contracts plus a 2-year statutory warranty for conformity defects. eBay's own return policy typically requires 30-day returns to qualify for Affidabilità Top — so the de-facto standard is 30 days with free domestic returns.

Standard eBay Italy Return Flow:

1. Buyer opens a return request from My eBay (within 30 days of delivery)
2. eBay generates a prepaid return label routed to the seller's carrier
3. Returned item arrives; seller has 2 business days to inspect
4. Seller issues a refund (or partial refund for "Used or damaged" defects) within the eBay Money Back Guarantee window
5. Funds are released through eBay Managed Payments to the buyer's original payment instrument

Zunapro's returns module tracks every step, surfaces SLA breaches before they hurt your defect rate, and auto-issues the FatturaPA credit note ("nota di credito") so your bookkeeping stays in sync with eBay.

eBay Italy Integration with Zunapro — 4 Steps in 10 Minutes

1. Enter Your eBay Developer Credentials — In the Zunapro panel, go to Marketplace → eBay Italy and paste your App ID, Cert ID, Dev ID, then complete the OAuth 2.0 consent flow with your eBay seller account.
2. Connect Your Storefront — Use the ready-made connectors for Shopify, WooCommerce, Magento, PrestaShop, BigCommerce or any REST/GraphQL custom backend. Paste your API URL + access key.
3. Category Mapping Wizard — Drag-and-drop your store categories onto eBay's leaf-level category tree. AI suggestions resolve 80%+ of mappings automatically and remember the rest for next time.
4. First Sync — Inventory, prices, orders, shipments, FatturaPA invoices — everything starts flowing two-way. Within 10 minutes, your eBay Italy store is fully manageable from the Zunapro panel.

Frequently Asked Questions About eBay Italy Integration