Perguntas frequentesEspecificações datafeedArtigo

O que um datafeed (ficheiro de produtos)?

Para listar os produtos no ShopMania deve criar e carregar um datafeed de produtos. Um datafeed de produtos é um datafeed formatado em txt, CSV ou XML e contem várias informações sobre os seus produtos, como: nome produto, preço, categoria, etc. Os campos devem ser delimitados por uma barra vertical (|) e as linhas por uma nova linha (\n).

Está é a formatação dum datafeed padrão em txt e CSV:

categoria completa | fabricante | modelo | ID produto | nome do produto | descrição | URL Produto | URL imagem | preço | moeda | custo transporte | disponibilidade | GTIN (UPC/EAN/ISBN)

Os campos seguintes são obrigatórios: Categoria, ID produto, Nome do produto, URL Produto, URL Imagem e Preço. GTIN é obrigatório para livros; neste caso deve adicionar o código ISBN. Não é suficiente só a inclusão destes campos no seu datafeed de produtos, deve assegurar-se também que a informação incluída é correta. Porém, para uma listagem correta, recomendamos a inclusão de todos os campos mencionados acima no seu arquivo de produtos e não só os campos obrigatórios.

Os campos inseridos devem conter a seguinte informação:

Campo Descrição Exemplo
Categoria Deve conter a categoria do site com o caminho complete da categoria raiz até a sub-categoria onde são listados os produtos (Categoria-Subcategoria).

Limite: 255 caracteres
Electrodomésticos > Electrodomésticos Pequenos > Microondas
Fabricante O nome do fabricante ou a marca do produto.

Limite: 100 caracteres
Nokia
Modelo O código de identificação do produto atribuído pelo fabricante (MPN, EAN, UPC ou ISBN).

Limite: 100 caracteres
Para a Placa de vídeo Gigabyte Nvidia GeForce 210 512MB DDR2, o modelo é "GV-N210OC-512I"
ID produto O código único pelo qual os produtos são identificados na sua loja. É recomendado não modificar o código durante a listagem dos produtos.

Limite: 100 caracteres
12345, 12346, 123457
Nome do produto O nome do produto como aparece no seu site.

Limite: 255 caracteres
Placa de vídeo Gigabyte Nvidia GeForce 210 512MB
Descrição produto A descrição do produto; não utilize tags HTML, código Javascript, imagens ou qualquer tipo de ficheiro multimídia.

Limite: 200 caracteres
Com a nova Sony W350 obtém imagens fascinantes daquela paisagem especial apenas com o movimento da câmara de um lado para o outro.
URL produto O URL para a página do produto. http://example.com/view-product?prod-id=12345
URL imagem A URL para a imagem principal do produto. Recomendamos que utilize uma imagem em tamanho grande, com boa qualidade e que corresponda ao seu produto.
Não aceitamos qualquer tipo de informação embutida na imagem, como o logótipo, marca d'água, ou textos promocionais.
http://example.com/images/12345.jpg
Preço O preço do produto deve incluir todas as taxas, com exepção da taxa para o custo da entrega que deverá ser inserida num campo separado.
Não são aceites os preços só para uma categoria específica de clientes.
O preço não deverá incluir a moeda: EUR.
120.45
Moeda A moeda do preço. EUR
Custo entrega O custo da entrega para o produto.

Para exibir o custo da entrega no seu datafeed deve marcar a opção “Definido para cada produto”. O custo da entrega deverá ser expressado na mesma moeda que o preço dos produtos.

A entrega grátis deverá ser marcada com zero (0.00).
2.5
Disponibilidade Contem as especificações acerca da disponibilidade de um produto. Os valores aceites para este campo são:
- In stock / Em estoque: Inclua este valor se tem a certeza que a entrega será realizada (ou em processo de ser entregue) em 3 dias úteis ou menos. Por exemplo se o item estiver disponível no seu armazém.
- Available for order / Sob encomenda: Inclua este valor se vai demorar 4 dias ou mais até a entrega será enviada para o cliente. Por exemplo, se não tiver o item no seu armazém, mas tem a certeza que irá a chegar dentro de alguns dias. Para produtos inéditos, utilize o valor Preorder / Disponível em pré-venda.
- Out of stock / Fora do estoque: Se atualmente não aceita encomendas para este produto.
- Preorder / Disponível em pré-venda: Aceita encomendas para este produto, mas ainda não foi lançado.

Nota: Se está a utilizar outros valores para a informação sobre a disponibilidade no seu datafeed de produtos, tem que fazer a correspondência no seu painel de controle dos valores que utiliza com os utilizados pelo sistema ShopMania .
In stock / Em estoque
GTIN (UPC/EAN/ISBN) O principal conjunto de identificadores de produto são Global Trade Item Number (Número Global de Item Comercial), que inclui UPC - Universal Product Code, EAN - European Article Number (na Europa) e ISBN - International Standard Book Number.

Estes valores são muito importantes para fazer a correspondência entre as pesquisas dos usuários e os seus produtos. É obrigatório fornecer o ISBN para livros. No entanto, nós recomendamos que fornece os identificadores GTIN para todos os produtos, por que no futuro pode tornar-se obrigatório

Mais informação sobre o GTIN em Wikipedia.
- UPC: um identificador numérico único para produtos comerciais que é associado normalmente com o código de barras impresso na mercadoria de varejo;
12-dígitos, como 001234567891
Mais informação sobre o UPC em Wikipedia.

- EAN: um identificador numérico único para produtos comerciais que é associado normalmente com o código de barras impresso na mercadoria de varejo;
13- dígitos, como 1001234567891
Mais informação sobre o EAN em Wikipedia.

- ISBN: um identificador numérico único para livros comercias que pode ser encontrado na parte de trás de livro junto com o código de barras;
10 ou 13-dígitos, como 0451524233
Se você tiver ambos, insere somente os número de 13-dígitos;
Mais informação sobre o ISBN em Wikipedia.


Datafeed de produtos em XML

Podemos também processar datafeeds em formato XML, se contêm pelo menos os campos obrigatórios. Pode definir os seus próprios tags (etiquetas) ou utilizar os tags do nosso exemplo abaixo.

Modelo datafeed XML:

<store>
<products>
...
<Product>
<MPC>12554</MPC>
<Category>Computers - Monitors</Category>
<Manufacturer>Samsung</Manufacturer >
<MPN>12350</MPN>
<Name>SyncMaster 206BW</Name>
<Description>Samsung 15.6" Widescreen LCD - 1360x768, 500... </Description>
<URL>http://www.example.com/products.php?id=a3057</URL>
<Image>http://www.example.com/products.jpg</Image>
<Price>431</Price>
<Currency>EUR</Currency>
<Shipping>15</Shipping>
<Availability>In stock / Em estoque</Availability>
<GTIN>1001234567891</GTIN>
</Product>


Notas:

- As linhas de produtos que não contêm informação correta são automaticamente rejeitadas. No seu painel de controle na seção “Estatísticas produtos” encontra a informação completa acerca dos campos rejeitados;
- Os campos ausentes devem ser separados por dois caracteres consecutivos. Este é um modelo de datafeed sem o campo do Modelo: categoria | fabricante | modelo | id produto | nome do produto | descrição | url produto | url imagem | preço | moeda | custo entrega
- A descrição do produto não deve conter linguagem promocional, descontos de preços, tags html, custos se entrega ou texto só em maiúsculas;
- Antes de enviar o seu datafeed é preciso eliminar todas as linhas novas ou outros caracteres utilizados como separadores de campo;
- A categoria do produto deve ser completa: Categoria / Subcategoria1 / Subcategoria2. Exemplo: Computadores – Periféricos – Monitores. Aceitamos somente arquivos de produtos que contêm as categorias do site e não as categorias do sistema ShopMania;
- A URL de imagem e de produto devem ser completas e começar com http://
- Tem que indicar claramente a visibilidade do item na página de produto ou exibindo o status (In stock / Em estoque, Available for order / Sob encomenda, Out of stock / Fora do estoque, Preorder / Disponível em pré-venda), ou mencionado quantos dias é que a entrega demora. Os itens que não estão mais disponíveis para a venda devem ser excluidos do datafeed completamente.

Submeter o datafeed na conta ShopMania

Deve entrar na sua conta ShopMania e ir para a seção Configurações - Configurações upload. Dependendo no tipo do seu arquivo, deve escolher o método de upload (auto ou manual) e inserir o URL para o seu datafeed no caso dos datafeeds automáticos ou carregar o datafeed para o método manual.

Métodos de upload

1. Auto – para a criação do datafeed de produtos, ShopMania dispões scripts automáticos para as plataformas ecommerce mais populares: OSCommerce, OSCommerce v3, ZenCart, Virtuemart, Virtuemart 2, JoomShopping, phpShop, CSCart, CSCart 4, XCart, CubeCart, SunShop, OpenCart, PHPMass, OOS Shop, xtCommerce, Interspire, PrestaShop, Magento, Shop-Script, Shop-Script Premium, Creloaded, QuickCart, PinnacleCart, Ubercart, TomatoCart, eShop, ShopperPress, WP e-Commerce, WP e-Commerce 3.8, WP Online Store, WP Store, WP StoreBox, WooCommerce, LogiVert, INDIGO Shop, PHP + MySQL, ASP + MySQL.

Para os sites que não utilizem nenhuma das plataformas enumeradas acima, disponibilizamos modelos de scripts: PHP + MySQL, ASP + MySQL, ASP + SQLServer si ASP + MsAccess. Estes scripts devem ser personalizados por um programador para coincidirem com a base de dados do seu site.

Clique aqui para mais detalhes acerca da instalação dos scripts para o datafeed.

2. Manual - é recomendado que insira 50 produtos no seu datafeed de produtos. O datafeed deve ser atualizado cada vez que houver mudanças de preços e estoque e pelo menos cada 30 dias. Tem em conta que se o arquivo não for atualizado por mais de 30 dias, a listagem para a sua loja será automaticamente suspensa.

Demora entre 1 e 3 dias úteis para a aprovação do datafeed e a listagem dos produtos no site. Se não receber nenhuma notificação durante um longo período de tempo, entre em contato conosco por email support@shopmania.pt.

Listado em: Especificações datafeed