Feed XML/YML: sincronize o stock da sua loja em 15 minutos

Um catálogo online só é útil enquanto está certo. Preço desatualizado, produto esgotado que aparece como disponível, referência nova que nunca chega à montra — cada um destes erros custa encomendas e confiança. A boa notícia: se a sua loja já usa um software de gestão ou uma loja online, o catálogo que lá existe pode alimentar a const.pt automaticamente. A configuração típica demora cerca de 15 minutos e, a partir daí, a sincronização deixa de ser trabalho manual.

Três formas de manter o catálogo sincronizado

Na const.pt, uma loja de materiais tem três caminhos para carregar e atualizar produtos, todos geridos na Área do Parceiro:

Método	Para quem	Frequência de atualização
Feed XML/YML por URL	Lojas com e-commerce ou ERP que exporta feed	Automática, a plataforma vai buscar o ficheiro periodicamente
Upload de ficheiro	Lojas que mantêm o catálogo em ficheiro local	Manual, sempre que carregar uma nova versão
API com push token	Lojas com equipa técnica ou integrador	Em tempo quase real, controlada pelo seu sistema

Não é preciso escolher para sempre: muitas lojas começam com upload manual, passam ao feed por URL quando o volume cresce e adotam a API quando querem refletir vendas de balcão no stock online ao minuto.

O que é um feed XML/YML

Um feed é um ficheiro estruturado que descreve o seu catálogo: cada produto com nome, categoria, preço, unidade, disponibilidade e, idealmente, imagem e descrição. O formato YML (Yandex Market Language) é um dialeto de XML muito usado por plataformas de e-commerce e ERPs; a const.pt aceita ambos. Se a sua loja online já exporta um feed para comparadores de preços ou marketplaces, é muito provável que esse mesmo ficheiro sirva sem alterações.

Os campos que interessam:

• Identificador único do produto (referência interna ou SKU) — é o que permite atualizar em vez de duplicar;
• Nome completo — quanto mais específico, melhor a pesquisa encontra o produto ("Argamassa de reboco M10 saco 30 kg", não "argamassa");
• Categoria — ajuda o motor de pesquisa a classificar o produto na taxonomia da plataforma;
• Preço e moeda — indique se é com ou sem IVA, de forma consistente em todo o feed;
• Disponibilidade — em stock, por encomenda ou esgotado;
• Imagem e descrição — opcionais, mas aumentam claramente a conversão.

Produtos com nomes vagos ou sem categoria não ficam de fora, mas aparecem pior posicionados nos resultados. Vale a pena investir uma tarde a limpar a nomenclatura no sistema de origem — o benefício propaga-se a todos os canais.

Passo a passo na Área do Parceiro

1. Aceda à Área do Parceiro

Entre em app.const.pt com a conta da sua loja. No painel do fornecedor encontra a secção de catálogo, onde vivem as três opções de carregamento.

2. Ligue o feed por URL

Se o seu sistema publica o feed num endereço público (por exemplo, https://asualoja.pt/feed.xml):

1. Cole o URL do feed no campo respetivo;
2. A plataforma valida o ficheiro e mostra uma pré-visualização — quantos produtos foram reconhecidos, que campos foram lidos, que avisos existem;
3. Confirme a importação.

A partir daqui, a const.pt volta a ler o feed periodicamente e aplica as diferenças: preços novos, produtos adicionados, artigos que saíram do catálogo. Não precisa de fazer nada — a montra acompanha o seu sistema de gestão.

3. Ou carregue o ficheiro manualmente

Sem feed público? Exporte o ficheiro XML/YML do seu software e carregue-o diretamente na mesma secção. O processamento é idêntico — validação, pré-visualização, importação. A diferença é que a atualização acontece quando voltar a carregar uma versão nova. Para catálogos que mudam pouco (semanalmente, por exemplo), é perfeitamente suficiente.

4. Ou integre pela API com push token

Para lojas que querem controlo total, a Área do Parceiro permite gerar um token de API (push token). Com ele, o seu sistema — ERP, loja online, ou um script do seu integrador — envia atualizações diretamente para a const.pt no momento em que acontecem: uma venda ao balcão baixa o stock, uma alteração de preço reflete-se de imediato na montra.

Boas práticas com o token:

• Trate-o como uma palavra-passe: não o partilhe por email nem o coloque em código público;
• Se suspeitar de fuga, revogue-o e gere um novo na Área do Parceiro — a troca é imediata;
• Comece por sincronizar apenas stock e preço via API, mantendo o resto do catálogo no feed. É a combinação mais robusta.

Como saber se está tudo a funcionar

Depois da primeira importação, verifique três coisas:

1. Contagem de produtos: o número importado corresponde ao esperado? Divergências grandes normalmente indicam produtos sem identificador ou sem preço, que são ignorados com aviso.
2. Pesquisa real: procure na montra alguns produtos típicos da sua loja, como faria um cliente. O motor de pesquisa da const.pt entende sinónimos e variações ("placa de gesso", "gesso cartonado", "pladur"), mas nomes bem estruturados no feed melhoram sempre o resultado.
3. Preços e unidades: confirme meia dúzia de artigos ao acaso. Um erro sistemático de IVA ou de unidade detetado no primeiro dia poupa dores de cabeça.

Erros comuns e como evitá-los

• Feed sem identificadores estáveis: se o SKU muda a cada exportação, cada sincronização duplica o catálogo. Garanta que a referência interna é constante.
• Preços com IVA misturados com preços sem IVA: escolha uma convenção e aplique-a a todo o ficheiro.
• URL do feed protegido por login: a plataforma precisa de conseguir ler o ficheiro; se o seu sistema exige autenticação, use antes o upload manual ou a API.
• Catálogo "morto": ligar o feed uma vez e nunca mais olhar. Reserve dez minutos por mês para rever os avisos de importação na Área do Parceiro.

O retorno de 15 minutos

A sincronização automática do stock não é um luxo técnico — é o que transforma uma presença online estática numa montra em que os empreiteiros confiam. Quando um cliente pesquisa um material às 7h30, a caminho da obra, e vê que a sua loja o tem em stock a um preço atual, a probabilidade de a encomenda ser sua é alta. Quinze minutos de configuração hoje; catálogo sempre certo daqui para a frente.