Hepsiburada Marketplace Sync - Atualize stock e preços por API ou CSV

A sua loja é a fonte da verdade. O marketplace deve segui-la.

Vender na Hepsiburada significa manter três coisas atualizadas em cada anúncio: o preço, o stock disponível e o prazo de expedição. Se o fizer à mão, acaba a reexportar uma folha de cálculo todas as manhãs; se se esquecer um dia, ou vende existências que já não tem ou fica com um preço que não queria oferecer. Este módulo transforma o seu catálogo do PrestaShop na fonte única e leva as alterações para o outro lado.

Duas formas de entregar, um só construtor de linhas

• Exportação CSV — descarregue um ficheiro com as colunas exatas, pela ordem exata, que o carregador em massa da Hepsiburada espera, e carregue-o pelos seus próprios meios no portal do vendedor.
• Listing API — introduza as suas credenciais e o módulo comunica diretamente com a Hepsiburada. Aponte um cron para o endereço fornecido e as alterações de stock e de preço são entregues sozinhas.

Ambas as vias passam pelo mesmo construtor de linhas, por isso o ficheiro que descarrega e os dados que a API envia coincidem sempre. Se alguma vez precisar de verificar o que a API está a fazer, descarregue o ficheiro.

O que envia — e o que deixa intacto

A equipa de catálogo da Hepsiburada é a dona do próprio anúncio, pelo que este módulo nunca toca nos nomes dos seus produtos, nem nas descrições, imagens, categorias ou atributos. Envia os campos que pertencem ao vendedor: preço sem impostos, existências disponíveis, prazo de expedição, etiquetas de transportadora e de morada, quantidade máxima de compra, e o tipo e o comprimento da personalização. Nada que pertença ao catálogo deles é substituído.

Proteções, porque um preço errado sai caro

• "Hold back" (reter existências) — subtrai uma margem de segurança a cada quantidade antes de a enviar. Defina-a como 2 e um produto com 5 unidades em stock é oferecido com 3, para que uma encomenda do marketplace não possa vender a mais o que a sua loja acabou de vender.
• Multiplicador de preço — envia o preço da loja sem alterações, ou acrescenta uma margem para cobrir a comissão do marketplace. Os valores acima de 10 são rejeitados por serem considerados uma gralha, em vez de publicados.
• "Never send a price below" (nunca enviar um preço inferior a) — um limite mínimo de segurança. As linhas abaixo dele são retidas e comunicadas, em vez de irem para o ar com o número errado.
• "Never offer more than" (nunca oferecer mais do que) — limita a quantidade mostrada no marketplace, independentemente do que exista em armazém.

Os produtos desativados ou não disponíveis para encomenda são enviados com stock zero em vez de serem descartados, para que deixem de vender no marketplace em vez de ficarem lá a envelhecer discretamente.

Diz-lhe o que não pode ser enviado, e porquê

O painel de estado do separador Getting started (introdução) nomeia os produtos afetados em vez de o deixar a adivinhar: sem SKU e sem código de existências, um preço que dá zero, um preço abaixo do seu limite mínimo, um nome em falta no idioma de exportação. Os SKU duplicados são detetados antes de enviar — a Hepsiburada rejeita um lote inteiro se um deles aparecer duas vezes, por isso apanhá-lo de antemão poupa-lhe um carregamento completo de novo. O campo da transportadora é validado face às transportadoras que a Hepsiburada publica e avisa quando o nome não é reconhecido, algo que do lado deles é ignorado em silêncio.

Sincronização agendada que informa com honestidade

O separador Send (enviar) mostra um endereço de cron com token. Aponte o cron do seu alojamento para ele — de trinta em trinta minutos é o habitual — e, por predefinição, envia apenas o que mudou desde a última execução bem-sucedida; ao guardar produtos e com os movimentos de existências, os anúncios são marcados como alterados automaticamente. Acrescente &mode=full para reenviar tudo depois de a Hepsiburada ter rejeitado ou perdido um lote. O endpoint responde em JSON, de modo que uma ferramenta de monitorização consegue distinguir uma falha real de uma execução sem novidades; as execuções em simultâneo são recusadas para que uma execução lenta não se acumule, e regenerar o endereço invalida o anterior de imediato caso o URL alguma vez seja divulgado.

Ligar produtos, e combinações

Cada anúncio da Hepsiburada tem um HepsiburadaSku. Cole-o no separador Hepsiburada da ficha de produto, ou use "Link products automatically" (ligar produtos automaticamente) se as suas referências do PrestaShop já corresponderem aos seus códigos de existências de vendedor na Hepsiburada. As combinações são totalmente suportadas: cada uma é ligada e tem preço em separado, porque a Hepsiburada trata cada variante como um anúncio próprio.

O que a versão 2.0 corrigiu

A versão 1.x calculava sempre o preço a partir de wholesale_price, um campo que a maioria das lojas deixa vazio, pelo que todos os preços exportados saíam a 0,00. A versão 2.0 usa por predefinição o preço de venda, recusa-se a exportar um preço zero e avisa quando o preço de custo é selecionado como origem num catálogo sem preços de custo. A versão 1.x também escrevia o SKU em cada actionProductUpdate, pelo que qualquer outra via de gravação — uma alteração de existências, o web service, outro módulo — o apagava em silêncio; a 2.0 só escreve quando o formulário de produto trouxe realmente esses campos. As ligações passam a ser guardadas por loja, em vez de um único SKU por produto a nível global, e a 1.x guardava as credenciais da API mas nunca enviava qualquer pedido para lado nenhum, por isso a atualização deixa a API desligada até que a ative deliberadamente.

Compatibilidade

PrestaShop 1.7, 8 e 9, sem overrides, em oito idiomas: alemão, espanhol, francês, inglês, italiano, neerlandês, polaco e turco. Preparado para multiloja — as ligações são guardadas por loja, por isso o mesmo produto pode ter SKU da Hepsiburada diferentes em lojas diferentes, e a página de definições indica-lhe sempre sobre que loja está a atuar. Ao desinstalar, são removidas as tabelas e as definições do módulo; os seus anúncios da Hepsiburada mantêm os últimos valores recebidos e simplesmente deixam de ser atualizados.

Perguntas frequentes

Preciso da API ou basta-me um ficheiro?

Qualquer uma das duas. Descarregue o CSV e carregue-o no portal do vendedor, ou ative a API e deixe um cron entregar as alterações. Ambas produzem dados idênticos.

Vai alterar os títulos ou as imagens dos meus produtos na Hepsiburada?

Não. Esses pertencem à equipa de catálogo deles. O módulo envia apenas preço, existências, prazo de expedição, etiquetas de transportadora e de morada, quantidade máxima e definições de personalização.

Como evito vender a mais?

Defina uma quantidade a reter ("Hold back"). Cada valor de existências é reduzido nessa quantidade antes de ser enviado, por isso o marketplace nunca vê as suas últimas unidades.

Que credenciais é que a API precisa?

As credenciais da Listing API da Hepsiburada, que não são as de acesso ao portal do vendedor — peça-as à Hepsiburada. Um 401 significa que o nome de utilizador ou a palavra-passe estão errados, um 403 que não têm acesso à Listing API e um 404 que o ID de vendedor está errado. Existe um botão "Test connection" (testar ligação) que mostra a mensagem exata devolvida por eles.

Suporta combinações?

Sim. Cada combinação é ligada e tem preço em separado, porque a Hepsiburada trata cada variante como um anúncio próprio.

Porque é que o meu carregamento inteiro foi rejeitado?

Quase sempre por um SKU duplicado — a Hepsiburada rejeita o lote inteiro se um deles aparecer duas vezes. O painel de estado encontra os duplicados antes de enviar.

Os meus preços da 1.x foram todos exportados a zero. Já está resolvido?

Sim. Isso devia-se ao facto de a 1.x calcular o preço a partir do campo de preço de custo, que a maioria das lojas deixa vazio. A versão 2.0 usa o preço de venda por predefinição e recusa-se a exportar um preço zero.