KuantoKusta Integration: Marketplace API, Comparator & Centralized Sales Management

About KuantoKusta: History, Ownership & Market Position

Founding & Timeline (2003 – Today)

KuantoKusta was founded in 2003 in Porto by Paulo Pimenta together with a small group of co-founders. The original product was a price comparison engine — the first of its kind in Portugal — that aggregated SKU-level pricing from electronics and IT retailers and let shoppers identify the cheapest seller in a single click. Throughout the 2000s and early 2010s, it became the default tool Portuguese buyers used before purchasing a laptop, smartphone, TV or home appliance.

In 2018, KuantoKusta evolved beyond comparison into a full B2C marketplace, onboarding third-party sellers, handling checkout end-to-end and introducing seller-rating, dispute resolution and centralized customer service. The company is operated by KuantoKusta SA from a Porto tech campus and has progressively layered new products — KK Cash cashback, Preço Mínimo low-price guarantee, mobile apps, and the KuantoKusta Pro B2B program — without abandoning its comparator DNA.

Ownership Structure (2025)

• KuantoKusta SA — Operating entity headquartered in Porto
• Paulo Pimenta — Co-founder, strategic leadership role
• Portuguese institutional investors — Minority stakes acquired through multiple funding rounds
• Founding partners — Retain operating and board involvement

Position in Portuguese E-commerce

KuantoKusta is the #1 price comparison platform in Portugal and ranks among the top 5 marketplaces by domestic GMV — alongside Worten Marketplace, Fnac, El Corte Inglés and Amazon.es (which serves PT cross-border). Its strength is concentrated in electronics, IT and home appliances, where it routinely captures double-digit share of online category demand. For sellers targeting Portuguese consumers who research on price before buying, KuantoKusta delivers high-intent traffic with measurable conversion velocity.

KuantoKusta Market Size & Traffic (2024–2025 Data)

While KuantoKusta is more focused than pan-European platforms, its traffic and conversion intensity in Portugal are exceptional. Buyers arrive ready to purchase — they have already compared prices across all sellers on the platform.

Year	GMV (EUR)	Monthly Visitors	3P Sellers	Core Categories
2020	~€90M	2.5M	~400	Electronics, IT
2022	~€140M	3.4M	~620	+ Home, Appliances
2024	~€180M	4M+	800+	+ Beauty, Fashion, Pet, DIY, Auto
2025 (forecast)	~€215M	4.6M	950+	Full-line marketplace

This trajectory is driven by the platform's dominance in electronics search, the rollout of KK Cash cashback, an increasingly polished mobile app, and the maturity of its 3P marketplace operations. For sellers with competitively priced inventory in IT, home appliances or consumer electronics, KuantoKusta is one of Portugal's highest-ROI marketplace channels.

How to Open a KuantoKusta Seller Account (2026 Process)

1. Legal & Fiscal Requirements (Portugal)

To sell on KuantoKusta you need an active Portuguese business entity registered with the Autoridade Tributária (AT). Sole traders (ENI), LDA and SA are all eligible — provided you can issue compliant e-Fatura invoices and export SAF-T PT files.

• NIPC (Portuguese fiscal number for legal entities)
• Certidão Permanente (commercial registration certificate)
• Bank IBAN — settlement payouts are routed here
• AT-certified billing software for e-Fatura / SAF-T PT (e.g. Moloni, InvoiceXpress, PHC, Primavera)
• GDPR / CNPD compliance for customer data processing
• Brand authorization documents for protected categories (electronics warranties, cosmetics, baby products)
• CE, WEEE and REACH compliance documentation where applicable

2. Applying via the KuantoKusta Seller Portal

You apply through the Official KuantoKusta Seller Application at kuantokusta.pt/vender. The KK seller team reviews your fiscal documentation, product range and pricing posture — approval typically takes 7–14 business days. Once approved, you receive a Seller ID, OAuth 2.0 client credentials (client ID + client secret) and access to developers.kuantokusta.pt for API documentation.

3. Product Listing & Content Rules

Because KuantoKusta inherits a comparator UX, product matching is unusually strict — listings tied to a clean GTIN/EAN convert faster and surface higher:

• Title: Brand + product line + key spec, 60–140 characters
• Images: White background, min 1000×1000px, up to 8 images, no watermarks or overlay text
• Description: HTML-friendly, minimum 250 characters in Portuguese (English accepted for IT/tech)
• Category mapping: KuantoKusta taxonomy ID + category-specific attributes
• GTIN/EAN barcode: Practically mandatory — without it, the comparator cannot align your offer to the canonical product card
• Warranty terms: Portuguese consumer law requires 3-year warranty on most goods — must be declared

KuantoKusta Commission Rates (2026)

KuantoKusta commissions in 2026 range from 4% to 18% depending on the category, with Portuguese VAT (23% standard, 13% intermediate, 6% reduced) applied separately on top of the merchant's gross price. Shipping fees, optional KK Cash cashback contribution (1–5%) and Preço Mínimo premium placement costs are additional. Below are the three commission bands every Portuguese seller needs to internalize before pricing a SKU:

Net margin formula: Selling price − Commission − VAT − KK Cash contribution − Shipping − COGS = Net profit. Zunapro's pricing module runs this calculation per SKU and per category on every sync, and refuses to publish prices that fall below your minimum margin threshold.

KuantoKusta API Integration — Technical Details

The KuantoKusta Marketplace API is a RESTful interface that lets sellers programmatically synchronize products, stock, orders, prices, shipping and returns with the KuantoKusta backend. Base URL: https://api.kuantokusta.pt/marketplace/ — documentation lives at developers.kuantokusta.pt.

API Authentication (OAuth 2.0)

Unlike the older HTTP Basic schemes used by some legacy PT platforms, KuantoKusta uses OAuth 2.0 client_credentials grant. Your client ID and client secret are exchanged for a bearer access token at /oauth/token; the token is then sent on every request in the Authorization: Bearer <token> header. Tokens expire (typically 1 hour) and must be refreshed — Zunapro handles refresh, retry and rotation automatically.

Main Endpoint Categories

• Products API — Create, update, deactivate listings; category & attribute mapping; EAN-based product matching
• Inventory API — Stock and price sync (bulk endpoint, up to 100 SKUs per request)
• Orders API — Order listing, status transitions, fulfillment confirmation, parcel association
• Shipment API — Carrier labels (CTT, DPD Portugal, MRW Portugal, Chronopost Portugal) and tracking number sync
• Returns / Claims API — Manage return requests, accept/refuse, refund processing
• Settlements API — Payouts, fees, reconciliation reports
• Webhooks — Real-time callbacks on order creation, status changes and price/stock updates

Rate Limits & Error Handling

Standard rate limits are around 10 requests per second per seller. Exceeding the limit returns 429 Too Many Requests with a Retry-After header. Common error codes: 400 (invalid product payload, missing EAN), 401 (expired token), 403 (category not authorized for your account), 404 (resource not found), 500 (platform error — retry with exponential backoff). Zunapro's connector implements idempotent retries, dead-letter queues and circuit-breakers so transient failures never produce duplicate orders or lost stock updates.

KuantoKusta Bulk Catalog Sync — XML & CSV Feeds

Bulk catalog sync lets you push your supplier or storefront catalog into KuantoKusta in one operation. Where the API is best for incremental updates, XML/CSV feeds are ideal for initial onboarding and for high-volume Portuguese distributors who maintain their inventory in spreadsheet form.

Feed Schema (KuantoKusta-Compatible)

The core fields KuantoKusta expects:

• seller_sku — Your internal SKU (used for stock & price idempotency)
• ean — GTIN-13/EAN-13 — required for canonical product matching
• brand, title, description (Portuguese preferred)
• category_id + attributes (color, size, capacity, etc.)
• stock_quantity, list_price, sale_price, vat_rate (23/13/6)
• warranty_months (36 default under DL 84/2021)
• shipping_profile_id, handling_days
• images[] (1–8 URLs), energy_label (for appliances under EU rules)

From Supplier Feed to KuantoKusta

Most Portuguese distributors (especially in IT, home appliances and electronics) expose XML or CSV catalogs. Zunapro's feed module:

1. Reads the supplier feed URL on an hourly or daily cron
2. Learns the category mapping — manual on first run, automatic thereafter
3. Normalizes attributes (brand, capacity, energy class, color)
4. Applies margin rules — markup, commission band, KK Cash contribution
5. Monitors stock — auto-deactivates SKUs that disappear from the supplier feed
6. Pushes to KuantoKusta via the Marketplace API

KuantoKusta Logistics — 3PL-Only Model

Unlike Amazon's FBA or Trendyol's TGF, KuantoKusta does not operate seller fulfillment centers. The platform is strictly 3PL (third-party logistics) — sellers ship from their own warehouse or contract a Portuguese 3PL provider. This keeps overhead low but puts the operational quality bar on you.

Supported Carriers

• CTT — Portugal's national postal operator, broadest mainland + Azores/Madeira coverage
• DPD Portugal — Best for next-day urban delivery, strong B2C tracking
• MRW Portugal — Iberian express specialist, fast cross-border to Spain
• Chronopost Portugal — Premium express, ideal for high-ticket electronics

Logistics Performance Targets

• Handling time: Ship within 24h of order confirmation for "Fast Ship" badge
• On-time delivery: ≥95% to maintain top seller status
• Tracking number sync: Pushed back to KuantoKusta within the same business day
• Returns acceptance: Process within 3 business days of receipt

Because the 3PL model places shipping accountability on the seller, multi-carrier orchestration is critical. Zunapro's shipping module picks the optimal carrier per parcel based on weight, destination postcode and customer preference, prints the label and pushes the tracking number back to KuantoKusta automatically.

KuantoKusta Seller Score, Cancellation Rate & Buy Box

KuantoKusta assigns every seller a public 1–10 score visible to shoppers — and this score directly determines who wins the Buy Box on a product card with multiple offers. Score drivers:

• Cancellation rate — Out-of-stock cancellations are the single largest penalty; >2% triggers warnings, >5% risks suspension
• Late shipment rate — Orders not dispatched within the declared handling window
• Return rate — Above category baseline (electronics 5–10%, home 10–15%, fashion 25%+)
• Customer reviews — Must stay above 4.0 stars; below 3.8 surfaces a warning badge to buyers
• Response time — Buyer messages should be answered within 24 hours
• Preço Mínimo compliance — Sellers honoring the lowest-price guarantee earn placement priority

Zunapro's real-time stock sync reduces cancellations by ~90% — every sale on your storefront or any connected marketplace decrements KuantoKusta inventory in 3–5 seconds, eliminating the oversell scenario that destroys seller scores.

KuantoKusta Advertising, KK Cash & Repricer

Advertising Surfaces

• Sponsored Listings — Top placement on comparison pages and search results (CPC based, EUR/click)
• KK Cash cashback contribution — 1–5% co-funded by the seller, dramatically lifts conversion on price-sensitive shoppers
• Preço Mínimo placement — Premium badge for sellers who honor the lowest-price guarantee
• Category-level banners — Display and brand store advertising for established merchants
• KuantoKusta Pro — Dedicated B2B program targeting Portuguese SMBs with bulk pricing tiers

Repricer — Winning the Comparator

Because KuantoKusta is fundamentally a price comparator, the Buy Box battle is fierce: when 10+ sellers list the same EAN, the lowest qualified price (combined with seller score) wins. Zunapro's repricer module repositions your price against competitors in seconds — always above your minimum-margin floor. Combine with KK Cash and Preço Mínimo for compound conversion lift.

KuantoKusta e-Fatura & SAF-T PT Compliance

Every seller invoicing Portuguese B2C or B2B buyers must issue compliant e-Fatura invoices through AT-certified billing software and submit monthly SAF-T PT exports to Autoridade Tributária. Manual invoicing collapses past 100 orders/day.

Zunapro's e-Fatura module:

• Automatic invoice issuance the moment a KuantoKusta order is confirmed
• Integrations with AT-certified providers (Moloni, InvoiceXpress, PHC, Primavera, Vendus)
• Automatic credit note issuance on returns and refunds
• Monthly SAF-T PT export ready for AT submission
• PDF invoice automatically emailed to the customer plus optional SMS notification
• GDPR / CNPD-compliant data handling for buyer records

KuantoKusta Shipping — CTT, DPD Portugal, MRW Portugal, Chronopost

Because KuantoKusta is 3PL-only, your shipping mix is your operational moat. The four production-grade Portuguese carriers integrated with Zunapro:

• CTT — National coverage, including the Azores and Madeira, with the broadest pickup-point network
• DPD Portugal — Fast urban next-day, strong B2C tracking UX
• MRW Portugal — Iberian express, fastest option for cross-border PT↔ES
• Chronopost Portugal — Premium express for high-value or fragile electronics

Zunapro's multi-carrier module rate-shops the optimal carrier per order based on parcel weight, destination postcode and customer preference; it prints labels, pushes tracking numbers to KuantoKusta and updates the seller score in real time.

KuantoKusta Returns & Customer Service Management

Under Portuguese consumer law (DL 24/2014), buyers have a 14-day right of withdrawal on any distance contract — no justification required. Additionally, DL 84/2021 mandates a 3-year statutory warranty on most consumer goods. Returns are routine; mismanagement destroys seller score.

Standard KuantoKusta returns flow:

1. Buyer opens a return request through the KuantoKusta portal within 14 days of delivery
2. Seller arranges the reverse logistics (CTT, DPD Portugal, MRW Portugal or Chronopost Portugal)
3. Buyer ships the item back; seller inspects on arrival
4. Seller approves/rejects the return within 3 business days
5. If approved, refund is issued to the buyer's original payment method or KK Cash wallet
6. Zunapro automatically issues the e-Fatura credit note and updates inventory

Zunapro's returns module orchestrates every step — seller notifications, reverse-logistics labels, automatic credit note issuance and SLA tracking.

Zunapro × KuantoKusta — 4-Step Setup (10 Minutes)

1. Enter your KuantoKusta credentials — In the Zunapro panel, open Marketplace → KuantoKusta and paste your Seller ID, OAuth client ID and client secret from the seller portal.
2. Connect your storefront — Pre-built connectors for Shopify, WooCommerce, Magento, PrestaShop, OpenCart and custom REST APIs. One URL + access key.
3. Category mapping wizard — Drag-and-drop your storefront categories onto KuantoKusta taxonomy; the AI suggester proposes the rest. EAN-based product matching runs automatically.
4. First sync — Products, stock, prices, orders and shipping all sync automatically. Within 10 minutes your KuantoKusta store is operating end-to-end from the Zunapro panel.

KuantoKusta Integration — Frequently Asked Questions