Integração OLX Portugal: API, OLX Pro e gestão de classificados+venda nova

Sobre a OLX Portugal: fundação, grupo Prosus e posição no mercado

Fundação e história (2006 – hoje)

A OLX foi fundada globalmente em 2006 por Alec Oxenford e Fabrice Grinda, dois empreendedores conhecidos pela criação de marketplaces de classificados online em mercados emergentes. Em 2009, a OLX entrou em Portugal e, ao longo dos anos seguintes, consolidou o setor ao adquirir e integrar os principais concorrentes locais: o Custojusto.pt e o Coisas.com — duas marcas históricas do mercado português de classificados absorvidas pela OLX Portugal.

Em 2010, a OLX foi adquirida pela Naspers, gigante sul-africano de media e internet. Em 2019, com a reestruturação do grupo, a Prosus N.V. (cotada em Amesterdão como AMS:PRX) tornou-se a entidade que detém e gere o portefólio internet do grupo, incluindo todo o OLX Group. Atualmente a sede da OLX Portugal fica em Lisboa e a empresa opera uma rede global ligada à OLX Brasil, Polónia, Roménia, Ucrânia e dezenas de outros países.

Estrutura societária do OLX Group (2025)

• Prosus N.V. (AMS:PRX) — entidade-mãe direta do OLX Group, sediada nos Países Baixos
• Naspers Limited — empresa-mãe da Prosus, sediada na África do Sul (JSE:NPN)
• OLX Group — holding operacional das marcas OLX em 30+ países
• Alec Oxenford e Fabrice Grinda — fundadores históricos (saída do operacional após 2019)
• Imovirtual — site irmão imobiliário em Portugal, partilha tecnologia e por vezes integração com a OLX

Posição no e-commerce e classificados em Portugal

A OLX é, com larga margem, o #1 site de classificados+marketplace de Portugal, ultrapassando claramente os históricos Custojusto.pt e Coisas.com (que entretanto absorveu). Mais de um terço dos portugueses com acesso à internet utilizam OLX pelo menos uma vez por mês; a sua aplicação móvel é uma das mais descarregadas em Portugal nas lojas Google Play e App Store. Nos automóveis, a OLX domina o C2C e tem fortíssima presença B2C através do OLX Pro com stands de automóveis em todo o país.

Volume e dimensão da OLX Portugal (dados 2024–2025)

A OLX consolidou-se nos últimos anos como a plataforma incontornável dos classificados+marketplace em Portugal. Os indicadores de utilizadores ativos, anúncios publicados e leads de comprador crescem dois dígitos ano após ano, apoiados na app móvel e na estratégia OLX Pro para profissionais.

Ano	Utilizadores ativos PT	Anúncios/ano	Contas OLX Pro	Categoria líder
2020	3,2M	18M	3K	Carros
2022	4,1M	24M	5K	Carros
2024	5M+	30M+	8K+	Carros + Imóveis
2025 (estimativa)	5,5M	34M	10K	Carros + Imóveis

Este crescimento é alimentado pela enorme procura nas categorias Carros (B2C de stands + C2C particular), Imóveis (com sinergia ao site irmão Imovirtual), Eletrónica (smartphones, gaming, recondicionado) e Moda. Para vendedores profissionais, publicar na OLX é o canal mais rápido e barato de chegar a 5M+ portugueses ativos mensalmente.

Abrir conta OLX Pro em Portugal (regras 2026)

1. Requisitos legais e fiscais

Para abrir uma conta OLX Pro em Portugal precisa de NIF empresarial ativo. Pode ser empresário em nome individual (ENI), sociedade por quotas (Lda.) ou sociedade anónima (S.A.). Para categorias específicas — stand automóvel, mediação imobiliária — a OLX exige documentação adicional. Em todos os casos é obrigatório emitir fatura SAF-T PT e cumprir as obrigações da Autoridade Tributária (AT).

• NIF empresarial ativo na AT
• Certidão permanente (sociedades comerciais)
• IBAN PT50 para faturação e recebimentos
• Licença IMPIC (mediação imobiliária)
• Alvará automóvel e registo de stand (categoria Carros B2C)
• Software certificado AT ou faturador integrado (Zunapro, PHC, Primavera, Sage, Moloni)
• Livro de reclamações eletrónico para vendas B2C

2. Candidatura ao painel OLX Pro

A candidatura faz-se em olx.pt/pro. O prazo de aprovação é tipicamente de 3 a 7 dias úteis. Após aprovação recebe o ID da conta OLX Pro, a API key e o API secret — estes três valores são críticos para configurar a integração na Zunapro.

3. Regras de conteúdo dos anúncios

A OLX aplica regras de qualidade estritas aos anúncios para evitar duplicados, fraudes e conteúdo enganador:

• Título: entre 30 e 70 caracteres, deve conter marca + modelo + característica-chave
• Fotografias: mínimo 1, ideal 6 a 12, formato JPG/PNG, sem marcas de água nem números de telefone
• Descrição: mínimo 200 caracteres, sem links externos nem dados de contacto duplicados
• Categoria + atributos: Carros exigem matrícula, km, combustível, caixa; Imóveis exigem tipologia, área útil, certificado energético
• Preço: campo numérico obrigatório (ou "A combinar"); na categoria Imóveis o preço sem IVA
• Localização: distrito + concelho + freguesia obrigatórios

Preços e taxas da OLX Pro Portugal (2026)

A OLX Portugal segue um modelo misto: anúncios gratuitos para particulares (com boosts pagos opcionais) e subscrição mensal para contas Pro. Os planos OLX Pro vão de 15€ a 60€/mês, conforme categoria e número de anúncios ativos. Abaixo as três faixas principais:

Cálculo de margem real: Preço de venda − IVA (23%/13%/6%) − Subscrição OLX Pro (rateio por anúncio) − Boosts opcionais − Custo de envio CTT/DPD − Custo do produto = Margem líquida. O módulo de pricing Zunapro faz este cálculo por categoria e por anúncio, avisa quando a margem desce abaixo do mínimo definido e ativa o repricer automático.

Integração API OLX Portugal — detalhes técnicos

A API OLX Pro é uma interface REST que permite a vendedores profissionais gerir programaticamente anúncios, stock, fotografias, leads de comprador, mensagens e relatórios. URL base: https://api.olx.pt/v1/pro/{accountId}/

Autenticação da API

A API OLX Pro usa OAuth 2.0 com client credentials, complementado por API key + API secret entregues no header Authorization. Os tokens de acesso têm validade de 1 hora; o refresh token dura 30 dias. Por segurança recomenda-se rodar o secret a cada 6–12 meses no painel olx.pt/pro.

Principais endpoints

• Listings API — criar, atualizar, eliminar e renovar anúncios, mapear categoria + atributos
• Inventory API — sincronização de stock e preço (bulk até 100 anúncios/pedido)
• Leads API — listar leads de comprador, marcar como respondida, exportar para CRM
• Messages API — caixa de mensagens OLX, resposta automática, templates
• Boosts API — aplicar Destacar, Topo, Bump programaticamente em horas-alvo
• Reports API — métricas de visualizações, contactos, custo por lead, faturação Pro
• Webhooks — eventos em tempo real para novos contactos, anúncios moderados, expiração

Rate limit e gestão de erros

O rate limit da API OLX Pro é de 10 pedidos por segundo por conta Pro. Quando excedido devolve 429 Too Many Requests. Códigos de erro frequentes: 400 (dados de anúncio inválidos), 401 (token expirado), 403 (categoria sem permissão para a conta), 404 (anúncio/categoria inexistente), 422 (validação de conteúdo — foto com número de telefone, etc.), 500 (erro OLX — repetir). O integrador Zunapro implementa exponential backoff retry, dead-letter queue e alertas em tempo real para todos estes casos.

Categorias OLX Portugal e estratégia por vertical

A OLX Portugal opera em 9 categorias principais, cada uma com regras, preços e perfis de comprador distintos. A estratégia da Zunapro é especializada por vertical:

Carros, Motas e Comerciais

É a maior categoria da OLX Portugal em valor transacionado. Domina o C2C particular e tem fortíssima presença de stands B2C através do OLX Pro. Importa: 360º de fotografias, ficha técnica completa (km, combustível, caixa, ano, IPO), histórico de manutenção e preço competitivo com o mercado Standvirtual/AutoSAPO. A Zunapro liga ao DMS do stand e atualiza viaturas automaticamente.

Imóveis

Segunda maior categoria. Forte sinergia com o site irmão Imovirtual — muitas agências publicam em ambos. Exige certificado energético, área útil, tipologia, distrito/concelho/freguesia. A Zunapro tem conector específico para CRM imobiliário (eGO, idealista CRM, Casafari).

Eletrónica, Moda, Casa, Animais, Emprego, Serviços

Categorias com forte presença de retalhistas e vendedores recondicionados. A Eletrónica é dominada por smartphones (iPhone, Samsung), gaming (PS5, Xbox) e equipamento foto/vídeo. Para estas verticais o envio via CTT, DPD Portugal ou MRW é cada vez mais comum, com etiqueta de envio gerada diretamente do painel Zunapro.

Bump, Destaque e Topo — algoritmo de visibilidade

O algoritmo da OLX combina três sinais para decidir a ordem dos resultados de pesquisa:

• Relevância — correspondência entre as palavras pesquisadas e o título/descrição/categoria
• Frescura — anúncios recentes ou renovados aparecem mais acima
• Boosts pagos — Destacar, Topo e Bump diário sobem o anúncio artificialmente nos resultados

Pelas regras da OLX, anúncios "Topo" ficam fixos no topo da página de pesquisa durante 7 dias, com selo amarelo. O "Destacar" coloca uma moldura colorida e o "Bump diário" reinicia a frescura todos os dias automaticamente.

Envios OLX Portugal — CTT, DPD Portugal, MRW

A OLX Portugal não tem fulfillment próprio (ao contrário de marketplaces como Amazon ou eBay). É plataforma de classificados+marketplace onde o vendedor trata da expedição. Nas categorias Carros, Imóveis e Animais a entrega é feita pessoalmente (meet-in-person). Nas categorias Eletrónica, Moda e Casa cada vez mais vendedores oferecem envio para todo o país.

Transportadoras integradas no painel Zunapro:

• CTT — Correio Verde, Correio Azul, EMS e CTT Expresso; rede de balcões e Pontos CTT
• DPD Portugal — entrega 24h em todo o continente, Pickup points
• MRW — entregas urgentes em 24h, especial Lisboa/Porto
• Chronopost / Nacex — opções adicionais para volumes superiores

O módulo multi-transportadora Zunapro escolhe automaticamente o operador mais barato consoante peso, volume e CEP de destino; imprime a etiqueta com um clique e envia o número de seguimento ao comprador via SMS e email.

Reputação OLX Pro e taxa de resposta

A OLX atribui a cada conta Pro uma reputação de 1 a 10, baseada em respostas a leads, avaliações de comprador, taxa de anúncios moderados e tempo no ar. Esta reputação influencia diretamente:

• Taxa de resposta — leads não respondidas em 24h penalizam pesadamente; meta: responder em <2h
• Anúncios moderados — fotografias com número de telefone, conteúdo proibido ou duplicados sucessivos suspendem a conta
• Avaliações de comprador — manter média acima de 4,2/5
• Selo "Verificado" — exige NIF validado e número de telefone confirmado por SMS
• Antiguidade — contas com mais de 12 meses recebem boost de visibilidade gratuito

Com a sincronização automática de stock da Zunapro reduz em 90% o risco de anúncios marcados manualmente como "vendido" demasiado tarde — quando o item é vendido no seu site ou noutro marketplace, o anúncio OLX é fechado em 3 a 5 segundos.

Conformidade legal portuguesa — IVA, AT, RGPD, garantia

Vender na OLX Portugal como conta Pro implica cumprir todas as obrigações legais do comércio eletrónico em Portugal:

• IVA — taxa normal 23%, intermédia 13% (alimentação selecionada, restauração), reduzida 6% (livros, medicamentos, produtos essenciais); regiões autónomas têm taxas distintas
• Fatura SAF-T PT — emissão de fatura eletrónica em formato XML SAF-T conforme Portaria n.º 302/2016, comunicada à Autoridade Tributária (AT) via webservice
• e-Fatura AT — comunicação mensal de todas as faturas emitidas (até dia 12 do mês seguinte)
• RGPD + CNPD — proteção dos dados pessoais dos compradores, encarregado de proteção de dados se aplicável, registo de tratamentos
• Direito de livre resolução — 14 dias para venda à distância B2C (DL n.º 24/2014), aplica-se a contas Pro
• Garantia legal — 3 anos para bens novos B2C, "vícios ocultos" para bens usados (DL n.º 84/2021)
• RAEE — recolha e reciclagem obrigatórias para equipamentos elétricos e eletrónicos
• REACH + marcação CE — químicos, brinquedos, cosméticos, EPI
• Livro de reclamações eletrónico — obrigatório para todos os vendedores B2C em Portugal

e-Fatura e SAF-T PT automáticos com a Zunapro

O módulo de faturação Zunapro é software certificado pela Autoridade Tributária e oferece:

• Emissão automática de fatura simplificada ou fatura-recibo no momento do encerramento da venda OLX
• Comunicação automática à AT via webservice SAF-T PT
• Integração com Moloni, PHC, Primavera, Sage e Vendus
• Notas de crédito automáticas em devoluções
• Mapas mensais de IVA e SAF-T para o contabilista
• Envio automático do PDF da fatura ao comprador por email + SMS

Devoluções e atendimento ao comprador OLX

Ao contrário dos grandes marketplaces fechados (Amazon, Worten Marketplace), a OLX deixa a gestão de devoluções ao vendedor — exceto quando o vendedor é Pro e oferece envio: nesse caso aplica-se o direito de livre resolução de 14 dias do DL n.º 24/2014.

Processo padrão de devolução numa venda OLX Pro com envio:

1. O comprador comunica a intenção de devolução em 14 dias após a entrega
2. O vendedor envia uma etiqueta CTT/DPD pré-paga (ou o comprador paga o porte se contrato o estipular)
3. Após receber e verificar o item, o vendedor processa o reembolso em até 14 dias
4. É emitida nota de crédito automática (Zunapro) e comunicada à AT
5. A conta Pro do vendedor recebe avaliação do comprador

Para vendas C2C particulares ou meet-in-person (Carros, Imóveis, Animais) não se aplica devolução pós-venda salvo defeito oculto. O módulo de devoluções Zunapro automatiza notificações, emissão de nota de crédito e comunicação à AT.

Integração OLX Portugal com a Zunapro — instalação em 4 passos (10 minutos)

1. Inserir credenciais OLX Pro — no painel Zunapro, em Marketplace → OLX Portugal, introduza o ID da conta OLX Pro, a API key e o API secret obtidos em olx.pt/pro.
2. Ligar o seu site existente — conetores prontos para Shopify, WooCommerce, PrestaShop, Magento, OpenCart e site próprio via XML. Basta inserir URL da API + access key.
3. Assistente de mapeamento de categorias — arraste as categorias do seu site para as categorias OLX correspondentes. A IA da Zunapro sugere mapeamentos e completa em minutos.
4. Primeira sincronização — anúncios, stock, preços, leads, mensagens, envios — tudo arranca em sincronização bidirecional. Em 10 minutos a sua conta OLX Pro Portugal é gerida a partir do painel Zunapro.

Perguntas frequentes sobre a integração OLX Portugal (FAQ)