Envie para Hopi os produtos
que valem a pena mostrar.

A Hopi é um app turco de fidelidade e cashback para celular, com mais de 12,6 milhões de membros e parcerias com mais de 250 marcas nos setores de moda, supermercado, alimentação, viagens, tecnologia e outros. Os compradores ganham Paracık — a moeda de recompensa da Hopi, em que 1 Paracık equivale a 1 lira turca — toda vez que compram em uma marca parceira e apresentam seu QR code da Hopi no pagamento, seja na loja física ou on-line. Esses saldos de Paracık podem ser usados em compras futuras em qualquer marca parceira, sem valor mínimo de carrinho, até expirarem no fim do mês que marca um ano desde que foram ganhos.

Em 2021, a Hopi também lançou o Hopishop, uma camada de marketplace dentro do app em que as marcas parceiras anunciam produtos diretamente para navegação e compra, com uma estrutura semelhante à de outros marketplaces turcos, como Trendyol ou Hepsiburada. Essa distinção é importante para a gestão de feeds: a mecânica central de fidelidade da Hopi funciona por meio de integração de códigos no nível da transação, e não de um catálogo de produtos, enquanto o Hopishop é a parte do ecossistema que realmente consome dados de produtos estruturados.

Para as marcas que vendem pelo Hopishop, um feed de produtos limpo e atualizado determina se os itens ficam visíveis para a base de membros do app que navega por promoções e ofertas, e se os dados de preço, estoque e variantes estão corretos no momento da compra. Como os anúncios do Hopishop ficam dentro de um app que milhões de pessoas já abrem para conferir ofertas de cashback, manter os dados de produtos sincronizados reduz a chance de receber pedidos de itens sem estoque, com preço errado ou mal categorizados — problemas que aparecem rapidamente em um marketplace com emissão automática de notas fiscais e geração de etiquetas de envio vinculadas aos dados dos pedidos.

Vale deixar explícita uma distinção que confunde muitos lojistas: conectar-se à "Hopi" para campanhas de cashback é uma integração diferente de conectar um feed de produtos ao Hopishop. A própria documentação da Hopi descreve as parcerias com marcas como um processo de integração de códigos — a equipe da Hopi, a equipe da marca e os fornecedores de software de PDV, e-commerce e ERP da marca se coordenam para incorporar um código de campanha ao fluxo de checkout, de modo que os Paracık sejam concedidos e resgatados corretamente. O acompanhamento das vendas dessas campanhas é feito por meio de relatórios no estilo de afiliados e links com UTM, e não por um catálogo de produtos.

1. Se o seu objetivo é rodar campanhas de cashback/desconto pelo app da Hopi, você precisa da integração de códigos no nível do checkout descrita acima — isso é coordenado diretamente com a equipe de parcerias da Hopi e com seu fornecedor de PDV/e-commerce, e não por meio de um feed.
2. Se o seu objetivo é anunciar e vender produtos dentro do Hopishop, essa é a integração relevante para feeds, e ela funciona como um upload de produtos padrão de marketplace.

A Feedance é relevante para o segundo caso. Se você não tem certeza de qual se aplica ao seu negócio, essa é uma pergunta para o seu gerente de conta da Hopi antes de iniciar qualquer trabalho de feed.

A Hopi não publicou uma especificação de feed pública e de autoatendimento (não foi encontrado nenhum esquema XML/JSON aberto, portal para desenvolvedores ou documentação de campos para o Hopishop, nem em turco nem em inglês). Na prática, com base em guias do painel do vendedor e em documentação de integradores terceiros, os lojistas se conectam ao Hopishop de uma destas formas:

1. Gestão manual ou em massa de produtos no painel do vendedor do Hopishop, incluindo arquivos de modelo para download destinados à criação de produtos em massa, atualizações de preço e atualizações de estoque.
2. Integração por meio de plataformas de e-commerce/ERP que já têm um conector para o Hopishop (exemplos citados por integradores incluem Ticimax, T-Soft e StockMount), que cuidam da correspondência de categorias e da transferência de produtos em nome do lojista.
3. Geração personalizada de XML do ERP para o Hopishop, como em ferramentas de integração publicadas de forma independente que associam produtos entre um sistema ERP e o Hopishop antes de enviá-los.

As credenciais de API (um token de acesso) do Hopishop são obtidas diretamente com o suporte a lojistas do Hopishop, e não por meio de um cadastro aberto. Como não existe uma especificação publicada que sirva de base com segurança, a abordagem prática é confirmar os requisitos atuais de campos e o método de entrega com o seu contato no Hopishop e, em seguida, mapear seu catálogo de origem para esse formato — exatamente o tipo de mapeamento que a Feedance foi criada para fazer quando os campos de destino são conhecidos.

A Hopi não publicou uma especificação oficial de feed com atributos. Os atributos abaixo vêm de um passo a passo detalhado, feito por terceiros, dos formulários de produto individual e de upload em massa do painel do vendedor do Hopishop, e não de um documento oficial da Hopi para desenvolvedores — trate-os como um ponto de partida confiável, e não como uma especificação atual garantida, e confirme no seu próprio painel do vendedor antes de mapear um feed.

Como o Hopishop não oferece um formato de feed aberto e documentado de forma universal, conectá-lo pela Feedance é um processo de coordenação e mapeamento, e não um modelo de um clique:

1. Confirme o status da sua conta de lojista/vendedor no Hopishop e obtenha o método de entrega atual e as credenciais diretamente com o suporte a lojistas do Hopishop.
2. Identifique os campos obrigatórios atuais e o formato de entrega (modelo de upload no painel, formato do conector de ERP ou XML) da sua conta, já que isso não foi padronizado em documentação pública.
3. Conecte seu catálogo mestre de produtos — da sua loja, do ERP ou de um feed existente — à Feedance como fonte única da verdade.
4. Mapeie os campos do seu catálogo para os atributos que o Hopishop espera atualmente (nome, categoria, código do produto, código de barras, marca, dados de variantes, preço, IVA, estoque, transportadora, prazo de entrega, imagens), ajustando conforme os requisitos específicos do painel que você confirmou na etapa 2.
5. Gere a saída no formato que a sua conexão com o Hopishop realmente consome e valide um pequeno lote de anúncios antes de enviar o catálogo completo.
6. Automatize as atualizações recorrentes para que as mudanças de preço e estoque do seu lado cheguem ao Hopishop sem novos uploads manuais.

A Hopi não publicou uma frequência de atualização obrigatória ou recomendada para o Hopishop. Integradores terceiros descrevem os níveis de estoque como "mantidos atualizados" por meio de sistemas contábeis/ERP conectados e as vendas sendo reportadas diariamente, o que sugere que a sincronização pelo menos diária é prática padrão entre os vendedores que usam conectores automatizados. Como prática geral de e-commerce, preço e estoque devem ser sincronizados pelo menos diariamente — e, idealmente, quase em tempo real para itens de giro rápido ou com estoque limitado —, já que um anúncio de marketplace com disponibilidade ou preço incorretos gera risco direto de cancelamentos de pedidos e de sobrecarga no atendimento.

Não foi encontrada nenhuma lista pública e específica da Hopi com mensagens de erro ou códigos de rejeição do Hopishop. Os problemas abaixo são padrões gerais de integração com marketplaces observados por integradores de e-commerce turcos que trabalham com o Hopishop e marketplaces semelhantes — use-os como checklist, e não como textos de erro verificados da Hopi:

1. Categoria incompatível: produtos mapeados para uma categoria do Hopishop errada ou sem suporte são uma causa citada com frequência de falhas de anúncio e de correspondência durante a configuração da integração.
2. Campos obrigatórios ausentes: anúncios sem um campo obrigatório, como código de barras, alíquota de IVA, transportadora ou prazo de entrega, normalmente são rejeitados ou ficam incompletos no painel do vendedor.
3. Lacunas nos dados de variantes: produtos com variantes sem imagens, preço ou estoque por variante costumam não ser exibidos corretamente em anúncios baseados em variantes.
4. Credenciais desatualizadas: como o acesso à API do Hopishop é emitido manualmente pelo suporte a lojistas, e não por autoatendimento, tokens de acesso expirados ou mal configurados são um obstáculo recorrente de integração relatado por conectores terceiros.

Se você encontrar uma mensagem de erro não abordada aqui, o caminho mais confiável é confirmar o significado diretamente com o suporte a lojistas do Hopishop, já que a Hopi não publica uma referência pública de códigos de erro.

Estas são boas práticas gerais de feed para marketplaces, e não requisitos específicos da Hopi:

1. Mantenha os títulos dos produtos claros e ricos em atributos (marca, modelo, especificação principal), em vez de promocionais, já que a busca e o posicionamento em categorias de marketplaces normalmente favorecem títulos descritivos em vez de textos de marketing.
2. Atribua a categoria correspondente mais específica disponível, em vez de uma categoria pai ampla, para reduzir os erros de anúncio e de correspondência que os integradores apontam consistentemente como a principal causa de problemas de upload em marketplaces.
3. Mantenha os valores de código de barras e código do produto estáveis e únicos entre as atualizações — essas são as chaves que a maioria das ferramentas de atualização em massa e de integração usa para associar seus anúncios existentes.
4. Sincronize estoque e preço pelo menos diariamente, e com mais rapidez para estoques limitados ou de giro rápido, para evitar pedidos de itens indisponíveis.
5. Forneça dados completos no nível da variante (imagens, preço, estoque) para cada combinação de tamanho/cor, e não apenas para o produto pai, já que variantes incompletas são uma fonte comum de problemas de exibição nos anúncios.

A Hopi é a mesma coisa que o Hopishop?
Não. A Hopi é o app de fidelidade/cashback baseado em recompensas Paracık e em códigos de campanha das marcas; o Hopishop é um recurso de marketplace dentro do app da Hopi, lançado em 2021, em que as marcas parceiras anunciam e vendem produtos diretamente. A gestão de feeds se aplica ao Hopishop, e não à mecânica de campanhas de cashback da Hopi.

A Hopi publica uma API pública de feed de produtos?
Não que tenha sido possível verificar. Não há portal público para desenvolvedores nem especificação de feed aberta para o Hopishop; as credenciais e os detalhes de integração são obtidos diretamente com o suporte a lojistas do Hopishop, e muitos vendedores se integram por meio de plataformas de e-commerce/ERP que já têm um conector para o Hopishop.

Preciso ter uma empresa registrada para vender no Hopishop?
Sim — assim como outros marketplaces turcos, o Hopishop exige uma empresa com registro fiscal que possa emitir notas fiscais; a abertura da loja em si é gratuita, segundo orientações para lojistas publicadas por integradores terceiros.

A Feedance consegue gerar automaticamente um feed pronto para o Hopishop sem nenhuma configuração?
Não de forma imediata, porque o Hopishop não tem uma especificação pública fixa. A Feedance pode mapear e automatizar seu feed depois que você confirmar os requisitos atuais de campos e de entrega com o suporte a lojistas do Hopishop e, a partir daí, manter esse feed sincronizado.

Qual é a coisa mais útil a corrigir antes de conectar um feed ao Hopishop?
Acerte primeiro o mapeamento de categorias. A atribuição incorreta de categorias é a causa citada com mais frequência de problemas de anúncios em marketplaces na documentação de integradores, e afeta tudo o que vem depois — visibilidade, posicionamento na busca e conjuntos de atributos obrigatórios.

O Hopi é um aplicativo móvel turco de fidelidade e cashback. Os membros acumulam Paracık, a moeda de recompensa do Hopi, quando compram em marcas parceiras nas lojas físicas ou online, e podem gastá-la em compras futuras com qualquer marca parceira. O aplicativo trabalha com marcas de moda, supermercado, alimentação, viagens, tecnologia e outros setores.

O Hopi também mantém o Hopishop, um marketplace dentro do aplicativo onde as marcas parceiras listam produtos que os membros podem navegar e comprar. Essa é a parte do Hopi que usa dados de produto. Participar das campanhas de cashback do Hopi é uma integração separada, que conecta o checkout e os sistemas de ponto de venda de uma marca ao Hopi, e não exige um feed de produtos.

O Hopi não publicou uma especificação de feed pública para o Hopishop. Os lojistas geralmente gerenciam os produtos pelo painel do vendedor do Hopishop com modelos de envio em massa, por meio de plataformas de e-commerce ou ERP que oferecem um conector para o Hopishop ou por integrações XML personalizadas combinadas com o suporte do Hopishop, que também fornece as credenciais da API.

Para os vendedores no Hopishop, dados de produto precisos mantêm a loja dentro do aplicativo confiável. Nomes de produto, categorias, códigos de barras, dados de marca e variantes, imagens, preços e níveis de estoque corretos ajudam os membros a encontrar produtos e reduzem pedidos de itens fora de estoque ou com preço errado.