Formato de feed (ficheiro)

Damos a oportunidade aos nossos parceiros de fazerem o upload dos seus dados de produtos duma maneira fácil e rápida. Só terá que nos enviar um ficheiro com a lista de produtos que gostaria que aparecessem no Preços. Precisamos dos seguintes detalhes para cada produto:

• O ID único do produto na sua base de dados
• Nome de produto
• Descrição de produto
• Preço de produto
• Categoria de produto na sua base de dados

Nesta página, poderá ler um guia detalhado que lhe ajudará a criar o dito ficheiro.

Se, no entanto, não conseguir criar este ficheiro, poderá pedir ajuda para o email ((info@precos.com.pt).

Pode encontrar exemplos específicos no final desta página.

Guia para a criação do ficheiro

Campo	Descrição	Exemplo
code	O ID único que utiliza no seu sistema. Uma vez carregado, não deverá mudar o ID de produto.	Correcto: 12514 X5448B
name	O nome do produto. Até 100 carácteres. Sugerimos não utilizar letras maiúsculas, a não ser que seja essencial (eg: acrónimos)	Correcto: Computador portátil CX7330 camera Errado: COMPUTADOR PORTÁTIL
description	Uma descrição do produto até 4096 carácteres. Utilize letras maiúsculas só quando necessário (eg: acrónimos).
price	O preço total com IVA. Só utilizar números.	Correcto: 3500 Errado: 3 500 3.500,00
category	A categoria do produto na sua base de dados. Para separar os níveis diferentes de cada categoria, separar com ">".	Correcto: Electrónica > Cinema em casa > Leitores DVD Errado: Leitores DVD

Campos sugeridos

Campo	Descrição	Exemplo
image_url	O URL que refere à imagem do produto. Se tiver várias imagens, indique o URL da imagem com a maior resolução. Faça só o upload de imagens de produto. Não indique URLs de imagens a dizer "Brevemente" ou o logotipo da sua empresa.	Correcto: http://www.example.com/images/45884.jpg Errado: /images/45884.jpg http://www.example.com/images/brevemente.jpg
product_url	O URL referente à página que contém o produto. Se não tiver uma página separada para o seu produto, deixe este campo vazio!	Correcto: http://www.example.com/prod.php?id=45 Errado: www.example.com
manufacturer	O fabricante do produto (eg: Sony). Não utilize o ID usado no seu sistema.	Correcto: Sony Canon Errado: 12234
ean	European Article Number. O número de código barras europeu do produto.

Campos opcionais

Campo	Descrição
property_color property_size ... property_resolution	Detalhes específicos do produto (parâmetros técnicos, peso, tamanho, cor etc...). Comece o campo com "property_" e continue com um nome alusivo ao parâmetro em questão Este campo ajudará a filtrar e comparar dentro de categorias.

Formato XML

Pode também criar um ficheiro XML. Entre as etiquetas <shop> e </shop> pode introduzir toda a informação relativa à sua loja. Entre as etiquetas <product> e </products> pode introduzir toda a informação sobre o produto. Entre as etiquetas <product> e </product> pode introduzir a descrição do produto específico.

Exemplo:

<?xml version="1.0" encoding="UTF-8" ?>
<shop>
    <products>
    ...
    <product>
     <id>12554</id>
     <url>http://www.example.com/products.php?id=12554</url>
     <price>91125</price>
     <category>Computadores &gt; Monitores</category>
     <picture>http://www.example.com/images/12554.jpg</picture>
     <name>SyncMaster 913N</name>
     <manufacturer>Samsung</manufacturer>
     <description>O monitor SyncMaster 913N TFT é o melhor
 monitor: 8 ms Rapid Response...</description>
    </product>
    <product>
     <id>a305</id>
     <url>http://www.example.com/products.php?id=a3057</url>
     <price>42831</price>
     <categoryId>Electrónica &gt; Camara</categoryId>
     <picture>http://www.example.com/images/a3057.jpg</picture>
     <name>Coolpix 2200</name>
     <manufacturer>Nikon</manufacturer>
     <description>Simplicidade digital. A Coolpix 2200 compact,
 é uma câmara digital leve... </description>
    </product>
   ...
   </products>
  ...
</shop>

Também pode formatar da seguinte maneira: A única diferença ao formato acima referido é que a lista de categorias da loja vem antes dos produtos entre as etiquetas <categories> and </categories> assim podemos referir o ID, adicionado à lista de categorias com <categoryId> adicionado na propriedade de produtos:

Exemplo:

<?xml version="1.0" encoding="UTF-8" ?>
<shop>
   <categories>
    <category id="1" parentId="0">Computadores</category>
    <category id="2" parentId="0">Electrónica</category>
    <category id="3" parentId="0">Aparelhos de cozinha</category>
    <category id="1200" parentId="1">Monitores</category>
    <category id="2340" parentId="1">Portáteis</category>
    <category id="4211" parentId="2">Câmaras Digitais</category>
    <category id="4210" parentId="3">Microondas</category>
    ...
   </categories>
   <products>
    ...
    <product>
     <id>12554</id>
     <url>http://www.example.com/products.php?id=12554</url>
     <price>1125</price>
     <categoryId>1200</categoryId>
     <picture>http://www.example.com/images/12554.jpg</picture>
     <name>SyncMaster 913N</name>
     <manufacturer>Samsung</manufacturer>
     <description>O monitor SyncMaster 913N TFT é o melhor
 monitor: 8 ms Rapid Response... </description>
    </product>
    <product>
     <id>a305</id>
     <url>http://www.example.com/products.php?id=a3057</url>
     <price>42831</price>
     <categoryId>4211</categoryId>
     <picture>http://www.example.com/images/a3057.jpg</picture>
     <name>Coolpix 2200</name>
     <manufacturer>Nikon</manufacturer>
     <description> Simplicidade digital. A Coolpix 2200 compact,
 é uma câmara digital leve... </description>
    </product>
   ...
   </products>
  ...
</shop>

Formato CSV

Para construir ficheiros .CSV (Comma separated file - ficheiro separado por vírgulas). A primeira linha contém os nome dos campos, todas as outras linhas contêm detalhes dos produtos.

Exemplo:

code,manufacturer,name,description,price,category,image_url,product_url
"12554","Samsung","SyncMaster 913N","20" Samsung SyncMaster LS20MEWSFV/XAA Widescreen Flat Panel LCD Monitor com 300 Brightness, 800:1 Contrast Ratio, 2ms Response Time, VGA, DVI-D, Vista Certified (Black, Retail) Caracteristicas: Especificação de produto: Área de visualização 21. 3 polegadas Display Colors 16. 7 Milhões Pixel Pitch 0. 258 x 0. 258 Brightness 300 cd/m2 Contrast Ratio 800:1 (DCR 3000:1) Viewing Angle (H/V): 160 / 160 Response Time 2 ms (GTG) Max/Native Resolution 1680x1050 Interface 15pin D-sub, DVI-D Horizontal Frequency 30-81 kHz Vertical Frequency 56 ~ 75 Hz Power Consumption AC: 100-240 VAC Consumption: 130W Dimension (WxDxH) Set(W*H*D)(mm) (with stand) - 476. 0*396. 4*219. 3 Set(W*H*D)(mm) (w/o stand) - 476. 0*65. 2*329 Packing(W*H*D)(mm) - 563*166*451",91125,
"Monitor > TFT Monitor","http://www.example.com/images/12554.jpg","http://www.example.com/products.php?id=12554"
"a3057","Nikon","Coolpix 2200","Canon EOS 30D Digital SLR Câmara - EOS30DBODY/ Body Only/ 8. 2 Megapixel CMOS Sensor/ DIGIC II Image Processor/ Auto Pop-Up Retractable Built-In Flash/ 2. 5 TFT Color Liquid-Crystal Monitor/ 9-Point Wide-Area AF With A Dual Precision Sensor/ Black Finish",42831,"Cameras > Digital
 Câmaras","http://www.example.com/images/a3057.jpg","http://www.example.com/products.php?id=a3057"

Pode também criar ficheiros .CSV utilizando o Microsoft Excel ou Open Office, ao escolher "Guardar como..." no menu. Em tipo de ficheiro, escolher (.CSV).