Integração Hopi

Para as marcas que vendem pelo Hopishop, um feed de produtos limpo e atualizado determina se os itens estão visíveis para os membros do aplicativo que navegam por ofertas e promoções, e se os preços, o estoque e os dados de variantes estão corretos no momento da compra. Como os anúncios do Hopishop estão dentro de um aplicativo que milhões de pessoas já usam para verificar ofertas de cashback, manter os dados dos produtos sincronizados reduz a probabilidade de pedidos de itens fora de estoque, com preços incorretos ou categorizados incorretamente — problemas que surgem rapidamente em um marketplace com faturamento automatizado e geração de etiquetas de envio vinculada aos dados do pedido.

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

1. Se o seu objetivo é executar campanhas de cashback/desconto através do aplicativo Hopi, você precisa da integração de código no nível do checkout descrita acima — isso é coordenado diretamente com a equipe de parcerias da Hopi e seu provedor de PDV/e-commerce, não por meio de um feed.
2. Se o seu objetivo é listar e vender produtos dentro do Hopishop, essa é a integração relevante para o feed, e funciona como um upload de produto padrão de marketplace.

A Feedance é relevante para o segundo caso. Se você não tiver certeza de qual se aplica ao seu negócio, essa é uma questão para o seu gerente de contas Hopi antes que qualquer trabalho de alimentação seja iniciado.

A Hopi não publicou uma especificação pública de feed de autoatendimento (não foram encontrados esquemas XML/JSON abertos, portal de desenvolvedores ou documentação em nível de campo para o Hopishop, nem em turco nem em inglês). Na prática, com base nos guias do painel do vendedor e na documentação de integradores terceirizados, os lojistas se conectam ao Hopishop de algumas maneiras:

1. Gerenciamento manual ou em massa de produtos dentro do painel do vendedor Hopishop, incluindo arquivos de modelo para download para criação em massa de produtos, atualizações de preços e atualizações de estoque.
2. Integração por meio de plataformas de e-commerce/ERP que já possuem um conector 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 comerciante.
3. Geração personalizada de XML de ERP para Hopishop, como visto em ferramentas de integração publicadas independentemente, que fazem a correspondência de produtos entre um sistema ERP e o Hopishop antes de enviá-los.

As credenciais da API (um token de acesso) para o Hopishop são obtidas diretamente com o suporte ao lojista do Hopishop, em vez de por meio de auto-registro aberto. Como não há uma especificação publicada para servir de base com certeza, a abordagem prática é confirmar os requisitos de campo e o método de entrega atuais com o contato da sua conta Hopishop e, em seguida, mapear seu catálogo de origem para esse formato — que é exatamente o tipo de mapeamento que o Feedance foi desenvolvido para realizar assim que os campos de destino forem conhecidos.

A Hopi não publicou uma especificação oficial de atributos para os feeds. Os atributos abaixo provêm de uma análise detalhada, feita por terceiros, dos formulários de produto único e de upload em massa do painel de vendedores da Hopishop, e não de um documento oficial de desenvolvimento da Hopi. Considere-os como um ponto de partida confiável, e não como uma especificação atualizada garantida, e confirme-os com o seu próprio painel de vendedores antes de mapear um feed.

Como o Hopishop não oferece um formato de feed aberto e universalmente documentado, conectá-lo através do Feedance é um processo de coordenação e mapeamento, em vez de um modelo de um clique:

1. Confirme o status da sua conta de comerciante/vendedor Hopishop e obtenha seu método de entrega e credenciais atuais diretamente com o suporte ao comerciante Hopishop.
2. Identifique os campos obrigatórios e o formato de entrega (modelo de upload do painel, formato do conector ERP ou XML) atuais para sua conta, visto que isso não foi padronizado na documentação pública.
3. Conecte seu catálogo principal de produtos — da sua loja virtual, ERP ou feed existente — ao Feedance como fonte única de informações confiáveis.
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 para quaisquer requisitos específicos do painel que você confirmou na etapa 2.
5. Gere a saída no formato que sua conexão Hopishop realmente utiliza e valide um pequeno lote de anúncios antes de enviar seu catálogo completo.
6. Automatize atualizações recorrentes para que as alterações de preço e estoque do seu lado cheguem ao Hopishop sem a necessidade de reenvios manuais.

A Hopi não divulgou uma frequência de atualização obrigatória ou recomendada para o Hopishop. Integradores terceirizados descrevem os níveis de estoque como sendo "mantidos atualizados" por meio de sistemas de contabilidade/ERP conectados e com as vendas sendo reportadas diariamente, o que sugere que a sincronização diária, no mínimo, é prática padrão entre os vendedores que utilizam conectores automatizados. Como prática geral no comércio eletrônico, preço e estoque devem ser sincronizados pelo menos diariamente — e idealmente em tempo quase real para itens de alta rotatividade ou com estoque limitado — visto que um anúncio em um marketplace que mostre disponibilidade ou preço incorretos representa um risco direto de cancelamento de pedidos e sobrecarga de suporte.

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

1. Incompatibilidade de categoria: Produtos mapeados para uma categoria Hopishop incorreta ou não suportada são uma causa comum de falhas na listagem e correspondência durante a configuração da integração.
2. Campos obrigatórios ausentes: Anúncios que não contenham um campo obrigatório, como código de barras, taxa de IVA, transportadora ou prazo de entrega, geralmente são rejeitados ou ficam incompletos no painel do vendedor.
3. Lacunas nos dados das variantes: Produtos com variantes que não possuem imagens, preços ou informações de estoque específicos para cada variante geralmente não são exibidos corretamente em anúncios baseados em variantes.
4. Credenciais desatualizadas: Como o acesso à API da Hopishop é concedido manualmente pelo suporte ao lojista, em vez de ser feito por autoatendimento, tokens de acesso expirados ou mal configurados são um problema recorrente de integração relatado por conectores de terceiros.

Caso se depare com uma mensagem de erro não abordada aqui, a forma mais confiável é confirmar seu significado diretamente com o suporte ao lojista da Hopishop, visto que a Hopi não publica uma lista de códigos de erro.

Estas são práticas recomendadas gerais para feeds de marketplaces, não requisitos específicos da comunidade Hopi:

1. Mantenha os títulos dos produtos claros e ricos em atributos (marca, modelo, especificações principais) em vez de promocionais, já que a busca no marketplace e o posicionamento na categoria geralmente priorizam títulos descritivos em detrimento de textos de marketing.
2. Atribua a categoria de correspondência mais específica disponível, em vez de uma categoria geral, para reduzir os erros de listagem e 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 exclusivos em todas as atualizações — essas são as chaves que a maioria das ferramentas de atualização em massa e integração usa para corresponder às suas listagens existentes.
4. Sincronize o estoque e o preço pelo menos diariamente, e com mais frequência para estoques limitados ou de alta rotatividade, para evitar pedidos de produtos indisponíveis.
5. Forneça dados completos em nível de variante (imagens, preço, estoque) para cada combinação de tamanho/cor, em vez de apenas para o produto principal, já que variantes incompletas são uma causa comum de problemas na exibição dos anúncios.

Hopi é a mesma coisa que Hopishop?
Não. O Hopi é o aplicativo de fidelidade/cashback baseado nas recompensas Paracık e nos códigos de campanha das marcas; o Hopishop é um marketplace dentro do aplicativo Hopi, lançado em 2021, onde marcas parceiras listam e vendem produtos diretamente. O gerenciamento de feeds se aplica ao Hopishop, não ao mecanismo de cashback do Hopi.

A Hopi publica uma API pública para feeds de produtos?
Não que isso pudesse ser verificado. Não existe um portal público para desenvolvedores nem uma especificação de feed aberta para o Hopishop; as credenciais e os detalhes de integração são obtidos diretamente com o suporte ao lojista do Hopishop, e muitos vendedores integram-se por meio de plataformas de e-commerce/ERP que já possuem um conector para o Hopishop.

Preciso de uma empresa registrada para vender na Hopishop?
Sim — assim como outros marketplaces turcos, o Hopishop exige uma empresa registrada para fins fiscais que possa emitir faturas; abrir uma loja em si é gratuito, de acordo com as orientações para comerciantes publicadas por integradores terceirizados.

O Feedance consegue gerar um feed pronto para o Hopishop automaticamente, sem nenhuma configuração?
Não é algo que funcione imediatamente, pois a Hopishop não possui uma especificação pública definida. O Feedance pode mapear e automatizar seu feed assim que você confirmar os requisitos atuais de campo e entrega com o suporte ao lojista da Hopishop, e manter esse feed sincronizado dali em diante.

Qual é a coisa mais importante a corrigir antes de conectar um feed Hopishop?
Primeiro, certifique-se de mapear corretamente as categorias. A atribuição incorreta de categorias é a causa mais frequentemente citada de problemas em 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.