Especificação técnica do feed de produtos

Transcrição

1 Especificação técnica do feed de produtos Para integrarmos a sua loja em UmSoLugar.com.br, recomendamos que você respeite as seguintes especificações técnicas: Formato dos arquivos suportados - CSV ou XML UmSóLugar importa os dados das lojas parceiras através de um arquivo CSV ou XML, que contenha informações relevantes sobre os seus produtos, sendo que o arquivo deve ser acessível constantemente num URL fixo. - Codificação Pedimos que utilize apenas uma única codificação em todo o arquivo, preferencialmente UTF- 8 ou ISO Aceitamos também o formato Windows Formato CSV A primeira linha do arquivo CSV, isto é, o cabeçalho, deve conter o nome dos atributos separados. Em seguida, inclua os valores correspondentes para cada um dos atributos, começando pela segunda linha. As colunas podem ser separadas uma vírgula, ponto e vírgula, tab ou o símbolo. Se os valores, como por exemplo a descrição dos produtos, contiverem algum dos separadores anteriormente mencionados, por favor insira os valores entre aspas. - URL dos Produtos O URL presente nesse atributo é um link direto para a página do produto visualizado em nossa plataforma, onde o usuário poderá ter acesso a mais informações e efetuar a compra. Por favor, não utilize o mesmo URL duas vezes. Atualização do feed - Sincronização automática O feed dos produtos é automaticamente carregado e sincronizado diversas vezes por dia, de forma a assegurarmos que os dados estejam sempre atualizados em nossa plataforma. É importante que o feed esteja disponível em um servidor web ou FTP, e que nos seja comunicado através de um URL fixo. - Disponibilidade dos produtos O feed deve ser atualizado diariamente de modo que só os produtos disponíveis sejam listados em UmSóLugar. Por favor, inclua apenas os produtos em estoque. - Mudanças no feed Qualquer mudança de maior importância no feed deve ser comunicada de imediato, como por exemplo a remoção de um número significativo de produtos listados, inserção de um novo atributo ou utilização de um campo para alguma outra finalidade. Se mudar o URL do feed, pedimos que nos informe igualmente com a maior brevidade por . O novo feed deverá ser por consequência validado pelas equipes comercial e de qualidade antes de sua integração em nossa plataforma. 1

2 Lista dos requisitos de atributos Atributos Referência do produto ou SKU Nome do produto Categoria Principal Subcategoria 2. Subcategoria Gênero Cor Descrição Limite: 255 Importante: uma vez que um produto é submetido, o SKU que pertence a ele não deve ser alterado durante a atualização do feed, nem ser usado para um produto diferente no futuro. Se houver necessidade de mudar os SKUs, por favor considere que o seu histórico de cliques será perdido. (dados numéricos também podem compor esse campo) Limite: 40 caracteres são visíveis em todos os dispositivos. Para telas de alta resolução, 50 caracteres são visíveis. Por favor, certifique-se de usar ao menos uma palavra-chave que descreve o produto (Exemplo: " Sapato ", " Perfume ", " Vestido") Se você incluir no nome de um produto as suas características (como cor, sexo ou marca), por favor, lembre-se de colocá-los também em campos separados (campo de cor, campo de gênero e de campo marca) Exemplo: "Tênis Nike Air Max preto ", " Nike Air Max 90 ", " Chanel N 5 Eau de Parfum ", " Mesa Dobrável " Tipo: Texto Por favor, seja o mais específico possível. É recomendado que a estrutura de categorias siga a mesma estrutura utilizada no UmSóLugar, de forma que os produtos sejam corretamente categorizados em nossa plataforma. Não use o caminho completo de categorias e nem designações com duplo sentido. Exemplo: "Roupas" Por favor, seja o mais específico possível. É aconselhável que a estrutura de subcategorias siga a estrutura utilizada pelo UmSóLugar, para que seus produtos possam ser classificados corretamente em nossa plataforma NÃO usar o caminho completo de categorias (utilizar subcategoria e 2a subcategoria). Não utilizar designações dúbias, como "Roupas e Acessórios". Exemplo: " T-shirt " Um máximo de 2 subcategorias podem ser descritas. Por favor, insira a subcategoria mais específica (profunda). Se você não nos fornecer a sua subcategoria mais específica, o seu produto vai ser ordenado na categoria acima. Exemplo: "T-shirts de Manga Longa" Possíveis formatos: - Adultos: mulheres, homens, unisex - Crianças: meninas, meninos, crianças, bebês Não há entradas múltiplas por produto. Unisex só é permitido para adultos (mulheres e homens). Se você quer que seus produtos sejam visíveis tanto para meninos e meninas, você deve usar "crianças" como gênero. Tipo: Apenas texto Cor predominante do produto. Não há entradas múltiplas por produto. Se um produto está disponível em várias cores, por favor insira todas as cores como diferentes produtos - portanto, com diferentes SKUs e diferentes URLs de imagem. Produtos coloridos devem ser descritos como " colorido " ou " multicolorido ". Evite termos ambíguos como "Creme", "Pêssego", "Pérola", "Marinho", pois o nosso sistema não os reconhece como cores. 2

3 Marca Material Descrição do produto Preço Preço antigo Preço a partir de Preço base Parcelamento Moeda Custos de envio Marca ou fabricante do produto. Por favor note que, caso não haja nenhum campo para a marca, podemos mapear esta informação de outros campos, mas apenas em caso de marcas com mais de 4 letras. Material principal ou a composição percentual do produto. Por exemplo: 80% algodão, 20% de seda ou algodão Bio NÃO inserir o conteúdo do produto - esta informação deve ser colocada na descrição (por exemplo os ingredientes em cosméticos). Os atributos exatos e mais relevantes de um item. Por favor, seja o mais específico possível. Importante: tags HTML não devem ser utilizadas. Descrição deve ser colocada em somente um campo do feed. Nenhuma separação entre a descrição longa e curta é aceita. A descrição do produto não é rastreada pelo Google e não gera conteúdo duplicado. Tipo: somente numérico Preço atual do produto / preço de varejo Dígito decimal, que é separado por vírgula. Nenhuma moeda é permitida neste campo. Preços negativos ou mais de duas casas decimais após o ponto não são permitidos. (por favor use um ponto final "." Ex.: 9.49). Tipo: somente numérico Este campo é necessário se você quiser exibir os novos preços em relação aos preços antigos, em destaque no UmSóLugar (por favor use um ponto final "." Ex : 9,49). O valor do desconto será calculado automaticamente pelo nosso sistema. Por favor, note que nós não exibimos descontos se eles são menores que 5% ou maiores que 97%. (A informação Preço Antigo é necessária apenas para os produtos com desconto). Tipo: somente numérico Preço inicial para óculos. Nenhuma moeda é permitida neste campo. Dados obrigatórios para mantimentos, vinho, alimentos para animais e todos os produtos em que o preço está relacionada com uma unidade de medição específica. Preço por unidade. Por favor note que você deve usar a moeda neste campo (veja o exemplo abaixo). Descrições de texto são permitidas. Utilize este campo em vez de escrever o preço base na descrição do produto. Exemplo: 30 Reais / 1 kg, 5 BRL / 1 litro, R$ 13 / 100ml, etc. Esta coluna é necessária se você desejar mostrar a opção máxima de parcelamento de pagamento de um determinado produto. Exemplo correto coluna parcelamento abaixo (seguir exatamente este ex.): <PARCELAMENTO> 3x R$33,32 </PARCELAMENTO> Não utilizar formas tipo: [12 vezes de 26,66], [12 x R$ 26,66] ou outras que não a deste exemplo acima. Tipo: símbolo ou texto Moeda única. Possível representação: "Reais", "BRL" ou "R$". Podemos oferecer-lhe a possibilidade de converter a moeda estrangeira em moeda nacional. Por exemplo EUR para BRL. Por favor, note: se a moeda for diferente que a do mercado-alvo, entre em contato com nosso representante de vendas. Tipo: Numérico ou texto Esta informação pode ser o valor para entrega relativo à região do consumidor, ou 3

4 Tempo de entrega Tamanhos Altura do salto URL da Imagem URL das Imagem Auxiliares 1-4 URL do produto In Stock também pode ser o valor de entrega para compras a partir de um determinado valor. Utilizar no máximo 30 caracteres. Exemplo: "Grátis > R$150" ou "Variável" ou "Grátis". Informações sobre o tempo de entrega exato. Liste apenas produtos que estão atualmente disponíveis. NÃO listar quaisquer produtos indisponíveis. Se qualquer produto está esgotado, por favor, delete esse produto do feed. Utilize informação concisa, por exemplo: "1-2 dias úteis". Separe todos os tamanhos disponíveis com uma vírgula ou ponto e vírgula em uma linha. Por exemplo: 40,41,42 Meios tamanhos podem ser separados por um ponto ou uma vírgula. Por exemplo 40; 40,5; 41; 41,5 Por favor, não use o mesmo separador para meios tamanhos e tamanhos diferentes. Exemplos: - 40,5; 41; 41,4 -> os meios tamanhos é dado com uma vírgula, a separação entre os tamanhos com um ponto e vírgula. - 40,5, 41, 41,5 -> os meios tamanhos são separados por um ponto e os tamanhos com uma vírgula. Por favor, não use qualquer faixa de tamanho ou semelhante. Exemplos 38-46, 1/3 Tamanhos (sapatos e meias): 39, 39.5,40,40.5,41,42 Tamanhos (Fashion): Tamanho único, único, 36, 38, 40, S, M, L, XL, Plus Size, P, M, G, GG Tamanhos (móveis): L: 30 A: 60 P: 50 ou 200x60x220 ou 80x200, 140x200, 200x220 ou largura 220, profundidade de 80, altura 200 ou T: 200 centímetros; B: 190 centímetros ou T50xB90xH150 Tamanhos (sport - bicicletas): 24 polegadas, 26 polegadas, 28 polegadas Valor exato de um tamanho de salto. Exemplo: 3,5cm Tipo: url link A imagem principal de um produto. É uma imagem visível na tela e a primeira imagem que os usuários vêem na página de detalhe do produto. A imagem deve exibir com precisão o produto e incluir o mínimo ou nenhuma produção na imagem. A imagem principal deve ter um fundo de cor branca, cinza ou luz sólida. Por favor, evite quaisquer selos, tabelas de tamanho, etc. Tamanho mínimo (para usar a nossa função de zoom): 1024x1024 pixels. O tamanho mínimo é de 250 x 250 pixels. Fotos acima 12 Mpix não serão aceitas Por favor, não use quaisquer imagens duplicadas. Todo produto precisa de uma URL exata. Possíveis formatos: JPEG, GIF ou PNG. Tipo: url link Imagens alternativas do produto. Ângulos diversos, detalhes. Ao todo, podemos mapear 4 imagens diferentes. Por favor, note: Se você não fornecer uma imagem auxiliar, por favor deixe este campo vazio. Apenas URLs de imagens são permitidas neste campo. Tipo: url link URL da página do produto. Esta será a página para a qual os usuários serão redirecionados após efetuar o clique no produto na plataforma UmSóLugar. Não utilizar nenhum caractere especial. Aqui você encontra um lista de caracteres especiais. Se seu produto estiver diponíivel, favor colocar: disponíivel ou in stock neste campo/atributo. Se seu produto não estiver disponível, favor colocar out of stock ou não disponível ou indisponível ou fora de estoque ou esgotado ou inativo. 4

5 CPC Cupom Padrões Looks EAN Se você quiser ajustar valores de CPC individuais, você terá que inserir um CPC nesta coluna. Tipo: Alfanumérico. IDEM doc Trata-se de um código promocional que os usuários poderão usar posteriormente no momento da compra. Tipo: apenas texto Possíveis padrões: xadrez, floral, listras, animal print, etc. Tipo: apenas texto Looks possíveis: hippie, elegante, casual, skatista, etc. Tipo: apenas numérico Número Europeu de Artigo (European Article Number) Número de 13 algarismos que o cliente pode utilizar para procurar um produto específico. Produtos não listados Lista dos produtos não listados em nossa plataforma UmSóLugar: CDs, DVDs, livros, lentes de contato com grau, brinquedos eróticos, desktop e outros produtos de informática, eletrodomésticos, eletrônicos. Exemplo de XML <?xml version="1.0" encoding="utf-8"?> <items> <item> <itemid>asd234234asd</itemid> <name>bota Timberland EK Suede Deck</name> <fullcategory=topcategory>calçados</fullcategory> <category>botas</category> <category_2>botas Esportivas</category_2> <gender>masculino </gender> <color>marrom</color> <brand>timberland</brand> <material>couro</material> <description>a Bota Timberland EK Suede Deck é perfeita para quem procura estilo e conforto. Fabricada com materiais premium que garantem durabilidade e resistência.</description> <price>259,90</price> <oldprice>299,90</oldprice> <parcelamento>10 X R$ 25,99</parcelamento> <currency>reais</currency> <availability>3 dias 48h 1 semana</availability> <deliverytime>3 dias úteis</deliverytime> <shippingcosts>18,50</shippingcosts> <sizes>38, 39, 40, 41</sizes> <hellsizes>1,5cm</heelsizes> <image> <deeplink> omevalue</deeplink> <imageaux1> imageaux1> <imageaux2> imageaux2> <imageaux3> imageaux3> <instock>in stock> <cpc>0,15</cpc> <coupon>umsolugar123</coupon> <lastmodified> :00:00</lastModified> <ean> </ean> 5

6 <pattern>liso</pattern> <extra2> <looks>aventureiro</looks> <baseprice>200.00/kg</baseprice> </item> </items> Nota: Neste exemplo XML a lista de produtos está inserida na tag <items></items> e cada produto está, por sua vez, inserido entre os tags <item></item>. O nome dado às tags individuais dos produtos tem que ser diferente do nome do tag da lista de todos os produtos. Os tags do exemplo XML seguem as mesmas especificações do exemplo do feed CSV. Visão do Produto Desconto: diferença percentual entre o preço atual e o preço antigo Imagem do produto Categoria, marca Preço anterior e preço com desconto Nome da loja Custos de envio/frete Clicando no símbolo os usuários são redirecionados para a página do produto em nossa plataforma, onde poderão ver todas as informações sobre o mesmo. Página do Produto 6

7 Imagens auxiliares Marca Descrição Tamanhos Altura do Salto Tempo de Entrega Material... 7