Entrega do feed: SFTP ou URL, horários e proteções

O CSV de artigos é a fonte de verdade do teu catálogo: o que está no ficheiro é publicado, o que muda é atualizado e o que desaparece é retirado dos portais. Esta página explica como o entregar e o que o Portal Hero faz para que um mau dia do ficheiro não se transforme num mau dia de vendas. O formato de colunas está na especificação completa.

Duas formas de o entregar

Por SFTP. Damos-te um utilizador e uma palavra-passe para sftp.portalhero.pro e escreves o ficheiro na pasta upload com o nome item_feed.csv. O acesso está restringido por rede: precisamos do IP ou dos IPs a partir dos quais vais enviar o ficheiro para os adicionar à lista de acesso. Se mudas de servidor ou de fornecedor, avisa-nos antes; é a causa mais habitual de «enviei o ficheiro e não se atualiza».

Por URL. Publicas o ficheiro num URL e o Portal Hero descarrega-o em cada execução. Se o URL precisa de autenticação, indicas-nos os cabeçalhos que devemos enviar no pedido. É a opção mais cómoda quando o teu ERP ou a tua loja já geram um feed.

Em ambos os casos o ficheiro é sobrescrito: não é preciso enviar incrementais nem avisar das mudanças.

Quando é processado

A sincronização corre várias vezes por dia, às horas que escolheres durante o registo. O habitual é agendá-la logo depois de o teu sistema gerar o ficheiro e, se o teu stock roda depressa, repeti-la ao meio-dia e à tarde. Cada execução compara o ficheiro com o publicado e só toca no que mudou, por isso um catálogo grande não demora mais por se sincronizar com frequência.

O que acontece se o ficheiro chegar mal

Um feed vazio, cortado a meio ou com as colunas trocadas não deve apagar o teu catálogo. Antes de aplicar qualquer mudança, cada execução verifica três coisas:

1. Que o ficheiro é válido: cabeçalho esperado, codificação e separador corretos.
2. Que o volume é coerente: se o número de artigos cai de repente em relação à execução anterior, a sincronização é interrompida e avisamos-te em vez de retirar anúncios.
3. Que cada linha é publicável: as linhas com erros são descartadas uma a uma, com o seu motivo, sem bloquear as restantes.

Quando uma execução é interrompida, os teus anúncios ficam como estavam até chegar o ficheiro correto seguinte.

Onde ver o resultado

No dashboard tens o resultado de cada execução: artigos criados, atualizados e retirados por portal, e o detalhe das linhas descartadas. Se algo não bater certo, escreve-nos com a hora da execução e vemos contigo.