Integração KuantoKusta: Marketplace API, comparador e gestão de vendas centralizada

Sobre o KuantoKusta: fundação, evolução e posicionamento

Fundação e história (2003 – Hoje)

O KuantoKusta nasceu em 2003 no Porto, fundado por Paulo Pimenta com um grupo de parceiros. Foi o primeiro grande motor de comparação de preços português, dominando durante anos o segmento de Eletrónica, IT e Tecnologia — categorias onde a comparação de preços é decisiva. Durante a década de 2010, expandiu para um catálogo generalista, com integração de milhares de lojistas portugueses e internacionais.

Em 2018, o KuantoKusta pivotou de comparador puro para marketplace transacional completo: o cliente passou a poder comprar diretamente no kuantokusta.pt, sem ser redirecionado para a loja do vendedor. Esta mudança consolidou a plataforma como um dos três principais marketplaces de Portugal — ao lado da Worten Marketplace e da FNAC.pt. O HQ mantém-se no Porto, num campus tecnológico próprio.

Estrutura societária (2025)

• KuantoKusta SA — Entidade jurídica detentora da plataforma, sede no Porto
• Paulo Pimenta — Fundador e administrador executivo
• Equipa fundadora e parceiros iniciais — Mantêm participações relevantes
• Investidores institucionais portugueses — Apoio em rondas de capital de crescimento

Posicionamento no e-commerce português

Em 2024, o KuantoKusta representa cerca de 10%–12% do tráfego comparado de e-commerce em Portugal, ficando atrás da Amazon.es/PT e da Worten em vendas brutas, mas liderando em comparação de preços e categorias técnicas. A app mobile do KuantoKusta é uma das mais descarregadas no segmento "Compras" em Portugal, com forte uso pré-compra para validar preço antes de fechar a transação.

Dimensão e volume de vendas KuantoKusta (2024–2025)

A KuantoKusta SA não publica resultados detalhados, mas os indicadores recolhidos no mercado e através de parceiros confirmam um crescimento sustentado pós-pivot a marketplace, com forte concentração em Eletrónica e Pequenos Eletrodomésticos.

Ano	GMV PT (EUR)	Visitantes/mês	Vendedores 3P	Categorias-chave
2018	~€40 M	2,2 M	~250	Eletrónica, IT
2022	~€120 M	3,4 M	~600	+ Casa, Beleza
2024	~€180 M	4,0 M+	800+	Generalista
2025 (estimativa)	~€210 M	4,5 M	950+	+ Pet, DIY, Auto

O motor de tráfego do KuantoKusta continua a ser o seu ADN de comparador: o utilizador chega à plataforma para procurar o melhor preço de um produto específico (intenção alta), o que se traduz em taxas de conversão superiores à média do setor para vendedores com preço competitivo. Para o vendedor, isto significa que entrar no KuantoKusta é entrar num funil de utilizadores já decididos a comprar.

Tornar-se vendedor no KuantoKusta (regras 2026)

1. Requisitos legais e fiscais

Para vender no KuantoKusta tem de ter atividade aberta junto da Autoridade Tributária (AT) em Portugal. Empresário em nome individual, Lda. ou SA — todas as formas jurídicas são aceites, mas tem obrigatoriamente de poder emitir fatura via software certificado pela AT e submeter o SAF-T PT mensalmente.

• NIF português ativo e atividade declarada na AT
• Certidão permanente (Lda./SA) ou comprovativo de atividade (ENI)
• IBAN nacional — os pagamentos do marketplace creditam para esta conta
• Software de faturação certificado pela AT (Moloni, InvoiceXpress, Vendus, Sage, Cegid Primavera, etc.)
• SAF-T PT — submissão mensal obrigatória até dia 5 do mês seguinte
• Marca registada (categorias como beleza, joalharia, brinquedos podem exigir comprovativo)
• Política de devoluções compatível com DL 24/2014 (14 dias de livre resolução)

2. Candidatura no portal de vendedores

A candidatura faz-se em kuantokusta.pt/vender. O processo de aprovação demora normalmente entre 7 e 14 dias úteis, dependendo da categoria e da qualidade do catálogo apresentado. Após aprovação, recebe credenciais OAuth 2.0: Seller ID, Client ID e Client Secret — necessários para a integração técnica.

📥 Pedido Oficial Vendedor KuantoKusta kuantokusta.pt/vender — pedido gratuito, 7–14 dias úteis aprovação →

3. Regras de conteúdo e catálogo

O KuantoKusta, sendo de origem comparador, é particularmente exigente com a qualidade da ficha de produto e da identificação inequívoca do item (para casar com fichas já existentes no comparador):

• EAN/GTIN obrigatório — é o principal critério de matching com o catálogo central do comparador
• Título: marca + modelo + característica chave (40–120 caracteres)
• Imagens: fundo branco, mínimo 800×800px, máximo 6 fotos, sem marcas de água
• Descrição: HTML suportado, mínimo 150 caracteres, sem links externos
• Atributos técnicos: preencher tabela de especificações (cor, dimensões, voltagem, potência) — crítico em Eletrónica
• Preço: tem de incluir IVA português (23%/13%/6%) e ser visível na ficha

Comissões KuantoKusta (2026)

As comissões do KuantoKusta variam entre 4% e 18% consoante a categoria, com a particularidade de a plataforma manter taxas baixas em Eletrónica e IT — fruto da sua herança de comparador focado em tecnologia. Acresce IVA 23% sobre a comissão e, opcionalmente, custos de CPC para destaques patrocinados. Abaixo as três bandas principais:

Cálculo de margem líquida: Preço de venda − Comissão − IVA da comissão − Custo de transporte − KK Cash (se aplicável) − Custo do produto = Lucro líquido. O módulo de pricing da Zunapro calcula automaticamente este valor para cada SKU e categoria, e dispara alertas se o produto descer abaixo do limiar mínimo de margem definido.

Integração KuantoKusta Marketplace API — detalhes técnicos

A KuantoKusta Marketplace API é uma API REST que permite gerir produtos, stock, preços, encomendas, expedições e devoluções de forma programática. Base URL: https://api.kuantokusta.pt/marketplace/. Documentação oficial em developers.kuantokusta.pt.

Autenticação OAuth 2.0

A API utiliza OAuth 2.0 com Client Credentials Grant. O vendedor envia client_id e client_secret a /oauth/token e recebe um access token válido por 1 hora. O token é depois usado no header Authorization: Bearer {token} em todos os pedidos. A Zunapro renova tokens automaticamente antes da expiração — sem nenhuma intervenção do vendedor.

Principais grupos de endpoints

• Catalog API — criar/atualizar produtos, matching por EAN, atributos técnicos
• Offers API — preço, stock e prazo de entrega por SKU (bulk: 100 itens/pedido)
• Orders API — listar encomendas, aceitar/rejeitar, atualizar estado
• Shipments API — etiquetas, tracking codes, transportadora associada
• Returns API — pedidos de devolução nos 14 dias legais (DL 24/2014)
• Invoices API — submissão da fatura SAF-T PT por encomenda
• Webhooks — notificações push de nova encomenda, alteração de estado, devolução

Rate limit e gestão de erros

O rate limit por vendedor situa-se em 5 pedidos por segundo (varia por endpoint). Excedido, devolve 429 Too Many Requests. Códigos comuns: 400 (payload inválido), 401 (token expirado), 404 (EAN não encontrado no catálogo central), 422 (atributos obrigatórios em falta), 500 (erro temporário — retry). O conector da Zunapro implementa exponential backoff, retry inteligente e dead-letter queue para garantir que nenhuma operação se perde.

Carregamento em massa e matching por EAN

Sendo o KuantoKusta um comparador, o matching de EAN/GTIN com o catálogo central é o passo mais crítico de todo o processo. Quando o EAN encontra ficha existente, o seu produto entra automaticamente na lista de ofertas comparadas — passando logo a ser visível para milhares de utilizadores em modo "comparar preços".

Estrutura do feed Zunapro → KuantoKusta

Campos enviados pelo conector em cada SKU:

• ean / gtin — identificador primário de matching
• brand, title, productCode, sku
• categoryId KuantoKusta + attributes (cor, dimensões, potência)
• stock, price (com IVA), vatRate (6/13/23)
• shippingCost, handlingTime (dias úteis até expedição)
• images (até 6 URLs), description (HTML)
• warranty — campo obrigatório para Eletrónica (3 anos legais em PT)

Sincronização automática a partir do ERP / loja

A Zunapro lê o seu catálogo a partir de qualquer fonte (Shopify, WooCommerce, Magento, PrestaShop, Jumpseller, Sage, Primavera, Moloni, feed XML/CSV) e:

1. Faz matching por EAN com o catálogo central do KuantoKusta
2. Cria fichas novas quando não existe correspondência (com submissão para revisão)
3. Normaliza atributos técnicos e completa campos em falta com IA
4. Aplica margem + comissão automaticamente ao preço final
5. Sincroniza stock em 3–5 segundos entre todos os canais (loja, KuantoKusta, Worten, FNAC)
6. Faz upload via API respeitando rate limits

Logística e expedição — KuantoKusta é 3PL puro

Ao contrário da Amazon (com FBA) ou da Worten Marketplace (com armazém centralizado), o KuantoKusta opera exclusivamente em modelo 3PL: o vendedor é responsável por toda a logística — armazenagem, picking, packing e expedição. Não existe rede de fulfillment nativa do KuantoKusta. Esta é uma característica estrutural a ter em conta no plano operacional.

Transportadoras integradas pela Zunapro

• CTT Expresso — cobertura nacional, ideal para encomendas standard até 30 kg
• DPD Portugal — entregas premium e tracking detalhado, forte em Lisboa/Porto
• MRW Portugal — express, mesmo-dia em grandes centros urbanos
• Chronopost Portugal — entregas internacionais e B2B, prazos garantidos
• CTT Pickup Point — entregas em locker (pontos CTT, lojas parceiras)

Custos típicos de expedição em Portugal Continental

• Encomenda standard 0–2 kg: €3,50 – €5,90 (CTT/DPD)
• Encomenda 2–10 kg: €5,90 – €9,90
• Volume grande (TV, eletrodoméstico): €15 – €45 (DPD/Chronopost)
• Açores e Madeira: surtaxa de €4 – €15 por encomenda
• Devoluções: o vendedor pode oferecer recolha gratuita (boost de conversão) ou cobrar ao cliente

KK Cash, Preço Mínimo e Sponsored Listings

KK Cash — o programa de cashback

O KK Cash é o programa de cashback nativo do KuantoKusta. Devolve entre 1% e 5% do valor da compra como saldo utilizável em encomendas futuras. É um dos principais drivers de fidelização da plataforma e gera repeat purchase rates significativamente acima da média. Para o vendedor, participar em campanhas KK Cash aumenta a visibilidade e o ranking interno — em troca, parte do cashback é financiado pelo vendedor.

Garantia "KuantoKusta Preço Mínimo"

A garantia Preço Mínimo é uma promessa histórica do KuantoKusta: se o cliente encontrar o mesmo produto mais barato em 24 horas dentro da plataforma, o KuantoKusta compensa a diferença. Esta lógica reforça o ADN de comparador e tem uma consequência clara para o vendedor: quem não tem repricer perde Buy Box. A Zunapro inclui regras dedicadas para esta dinâmica — ajusta preço face à oferta mais barata mantendo sempre a margem mínima configurada.

Sponsored Listings (CPC)

• Sponsored Products — destaque no topo dos resultados de comparação (CPC, €/clique)
• Banners de marca — display nas páginas de categoria
• KuantoKusta Pro B2B — secção dedicada a clientes profissionais, com convites a vendedores selecionados
• App push notifications — campanhas pagas para utilizadores frequentes

e-Fatura, SAF-T PT e obrigações fiscais

Em Portugal, todas as vendas no KuantoKusta exigem fatura emitida por software certificado pela AT e a submissão mensal do ficheiro SAF-T PT até dia 5 do mês seguinte. A não conformidade resulta em coimas e em suspensão da conta de vendedor.

O módulo de e-Fatura da Zunapro:

• Emissão automática de fatura no momento em que a encomenda KuantoKusta entra no painel
• Integração nativa com Moloni, InvoiceXpress, Vendus, Cegid Primavera e Sage
• Faturas de devolução automáticas quando o cliente exerce o direito de livre resolução (14 dias, DL 24/2014)
• Submissão do SAF-T PT mensal para a AT
• Envio automático do PDF da fatura por e-mail ao cliente
• Cumprimento integral do RGPD/CNPD no tratamento dos dados do comprador

Devoluções, garantias e direitos do consumidor

O quadro legal português é dos mais protetores da União Europeia. O vendedor KuantoKusta tem de cumprir:

• 14 dias de livre resolução (DL 24/2014) — o cliente devolve sem necessidade de justificação
• Garantia legal de 3 anos em bens móveis (DL 84/2021), com presunção de conformidade alargada
• RAEE — recolha e reciclagem de equipamentos eletrónicos (responsabilidade alargada do produtor)
• REACH — informação sobre substâncias químicas (relevante em cosmética, brinquedos, têxteis)
• Marcação CE — obrigatória em eletrónica, brinquedos, equipamento elétrico
• Livro de Reclamações eletrónico — acessível ao consumidor com até 15 dias úteis para resposta

O módulo de devoluções da Zunapro automatiza o ciclo completo: recebe o pedido via API do KuantoKusta, gera etiqueta de retorno com a transportadora, emite fatura de devolução, devolve stock ao seu inventário e regista o evento para SAF-T PT.

Pontuação de vendedor e indicadores críticos

O KuantoKusta atribui uma pontuação interna de 1 a 5 a cada vendedor que afeta o ranking nos resultados de comparação. Fatores principais:

• Taxa de cancelamento — Cancelamentos por falta de stock são fortemente penalizados; acima de 3% gera aviso, acima de 7% pode levar a suspensão
• Tempo de expedição — Tem de cumprir o handling time prometido na ficha
• Taxa de devolução — Acima da média da categoria desencadeia revisão
• Avaliações dos clientes — Não deve descer abaixo de 4,2/5
• Tempo de resposta a mensagens — Máximo 24 horas em dias úteis
• Cumprimento da política Preço Mínimo — Ofertas inflacionadas após match são penalizadas

A sincronização de stock em 3–5 segundos da Zunapro reduz em ~90% o risco de cancelamento por rutura — quando vende noutro canal, o KuantoKusta é atualizado em segundos.

Integração KuantoKusta com Zunapro — instalação em 4 passos (10 minutos)

1. Introduza as credenciais KuantoKusta — No painel Zunapro, vá a Marketplace → KuantoKusta e introduza Seller ID, Client ID e Client Secret (OAuth 2.0) recebidos após aprovação.
2. Ligue a sua loja ou ERP — Conectores prontos para Shopify, WooCommerce, PrestaShop, Magento, Jumpseller, Moloni, Sage e Cegid Primavera. URL + access key e está ligado.
3. Assistente de mapeamento de categorias — Arraste-e-largue para mapear as suas categorias para o catálogo KuantoKusta. A IA da Zunapro propõe correspondências e completa em minutos.
4. Primeira sincronização — Produtos, stock, preços, encomendas, expedições e e-Fatura — tudo começa a sincronizar automaticamente. Em 10 minutos a sua loja KuantoKusta é gerida a partir do painel Zunapro.

Perguntas frequentes sobre a integração KuantoKusta