Catálogo de Produtos

A sincronização do catálogo é o primeiro passo do processo de integração, pois nos permite conhecer todos os produtos comercializados pela loja. A importação da base de clientes e compras recentes permite rodar nossos motores de personalização e gerar recomendações antes mesmo do início da operação da nossa suíte de soluções.

Opa! Está com a URL do feed em mãos?
Informe o responsável pela integração enviando um email para atendimento@linximpulse.com.br.

Importando o catálogo via Feed XML

Por aqui nós utilizamos o formato Product Feed Specification do Google para integração do catálogo via XML. Sua loja deve disponibilizar uma URL e informar a frequência de atualização do arquivo, para que possamos fazer o download do feed e sincronizar os dados do catálogo.

O arquivo XML deve listar o catálogo completo da loja, logo:

  • Produtos que não existiam na última sincronização serão adicionados à nossa base de dados
  • Produtos existentes serão atualizados
  • Produtos que tornaram-se ausentes no XML serão removidos.

Para verificar se o XML é válido e está pronto para a importação é sugerido a utilização da ferramenta xmlstartlet

xmlstartlet
xmlstarlet fo meuarquivo.xml

Namespaces do Feed XML

Os elementos do XML definidos pelos namespaces serão validados com os seguintes Schemas:

Feed XML
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rss xmlns:g="http://base.google.com/ns/1.0"
     xmlns:c="http://www.chaordic.com.br/ns/catalog/1.0" version="2.0">
....

Campos do cabeçalho

<title>
string

Nome da loja

<link>
string

URL da loja.

<description>
string

Breve descrição sobre a loja.

<last_build_date>
string

Data da última atualização do conteúdo do feed.

Campos do produto <item>

<g:item_group_id>
string

Identificador único do produto. Quando uma lista de SKUs pertencer a um produto, este campo funciona como agrupador dos SKUS.

<g:id>
stringrequired

Identificador único do SKU.

<title>
stringrequired

Título comum para todas as variações do mesmo produto.

<description>
string

Descrição do produto.

<link>
stringrequired

URL para página de detalhamento do produto ou SKU.

<g:product_type>
stringrequired

Utilize esse elemento caso sua loja não possua mais de uma categoria/sub com o mesmo nome. Declare-as na ordem em que aparecem na navegação (Cat > Sub > Subsub, ...)

Exemplo: Móveis > Sala > Cadeiras

Os parametros <g:product_type> e <c:categories> são mutuamente excludentes. Escolha uma das duas abordagens e certifique-se de que feed contém apenas um dos dois padrões.

<c:categories>
Category[]required
Utilize esse método caso sua loja possua mais de uma categoria/sub com o mesmo nome. Para cada categoria/sub da lista, declare um subelemento c:category com o nome da categoria dentro do elemento e os seguintes atributos:
Os parametros <g:product_type> e <c:categories> são mutuamente excludentes. Escolha uma das duas abordagens e certifique-se de que feed contém apenas um dos dois padrões.

<g:image_link>
stringrequired

Utilize esse elemento caso deseje informar apenas uma imagem para o produto/SKU.
Os parametros <g:image_link> e <c:images> são mutuamente excludentes. Escolha uma das duas abordagens e certifique-se de que feed contém apenas um dos dois padrões.

<c:images>
Image[]required
Utilize esse elemento caso deseje informar várias imagens em diferentes tamanhos. Para cada imagem da lista, declare um subelemento c:image com o nome a URL da imagem dentro do elemento e os seguintes atributos:
Os parametros <g:image_link> e <c:images> são mutuamente excludentes. Escolha uma das duas abordagens e certifique-se de que feed contém apenas um dos dois padrões.

<g:sale_price>
stringrequired

Preço de venda atual, comumente apresentado no ecommerce como preço "por". O valor deve ser apresentado juntamente com a moeda no formato ISO 4217.

<g:price>
string

Preço anterior de listagem do produto, comumente apresentado no ecommerce como preço "de”. O valor deve ser apresentado juntamente com a moeda no formato ISO 4217.

<g:installment>
Installment
Deve conter o número máximo de parcelas ou número de parcelas padrão exibido na página do produto.

<g:availability>
stringrequired

Quando o produto/SKU estiver com estoque disponível para vendas esta tag deve conter "in stock", caso contrário, deve conter "out of stock".

<g:brand>
string

Marca do produto.

<g:gender>
string

Quando necessário, pode-se informar o gênero a que se destina o produto.

<g:color>
string

Cor do SKU.

<g:size>
string

Tamanhos disponíveis do SKU. Pode ser um valor numérico (36, 37, 38 ...) ou textual (P, M, G, ...)

<g:shipping>
Shipping

Valor do frete, caso seja comum para qualquer localidade do país. O valor deve ser apresentado juntamente com a moeda no formato ISO 4217.

<g:condition>
string

Informa se o produto é novo “new”, usado “used” ou “refurbished”.

<c:tags>
Tag[]
Conjunto de tags do produto/SKU. Utilize esse elemento caso deseje informar uma ou mais tags para um produto. Para cada tag, declare um subelemento c:tag com o valor dentro dele.
<c:details>
Detail[]
Utilize esse elemento caso deseje informar um ou mais detalhes para um produto. Para cada detalhe, declare um subelemento c:detail com o valor dentro dele e os seguintes atributos:
<c:specs>
Spec[]
Conjunto de especificações adicionais para o SKU que não estão definidos nos elementos anteriores. Utilize esse elemento caso deseje informar uma ou mais especificação para um SKU. Para cada especificação, declare um subelemento c:spec com o valor dentro dele e os seguintes atributos:
Edit this page on GitHub
Feed Recomendado
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rss xmlns:g="http://base.google.com/ns/1.0"
     version="2.0">
  <channel>
    <title>YOUR store products</title>
    <link>http://www.yourstore.com.br/</link>
    <description>This is a Feed with recommended fields</description>
    <item>
      <g:id>AAA01</g:id> <!-- The sku id -->
      <title>Casaco Feminino Jeans Com Bolsos</title>
      <description>Casaco feminino elaborado em jeans com composição 100% algodão.</description>
      <g:google_product_category>Vestuário e acessórios &gt; Roupas</g:google_product_category>
      <g:product_type>Feminino &gt; Jaquetas</g:product_type>
      <link>http://www.yourstore.com.br/Jaquetas/Casaco-Feminino-Jeans-Com-Bolsos/p</link>
      <g:image_link>http://img-yourstore.com.br/images/AAA.jpg</g:image_link>
      <g:condition>new</g:condition>
      <g:availability>in stock</g:availability>
      <g:price>159.99 BRL</g:price>
      <g:sale_price>159.99 BRL</g:sale_price>
      <g:gtin>7909245516136</g:gtin>
      <g:brand>Brand</g:brand>
      <g:item_group_id>AAA</g:item_group_id> <!-- The product id -->
      <g:color>AZUL</g:color>
      <g:gender>FEMALE</g:gender>
      <g:age_group>adult</g:age_group>
      <g:size>P</g:size>
      <g:shipping>
        <g:country>BR</g:country>
        <g:service>Frete Grátis</g:service>
        <g:price>0.0 BRL</g:price>
      </g:shipping>
      <g:installment>
        <g:months>5</g:months>
        <g:amount>31.99 BRL</g:amount>
      </g:installment>
    </item>
    <item>
      <g:id>AAA02</g:id> <!-- The sku id -->
      <title>Casaco Feminino Jeans Com Bolsos</title>
      <description>Casaco feminino elaborado em jeans com composição 100% algodão.</description>
      <g:google_product_category>Vestuário e acessórios &gt; Roupas</g:google_product_category>
      <g:product_type>Feminino &gt; Jaquetas</g:product_type>
      <link>http://www.yourstore.com.br/Jaquetas/Casaco-Feminino-Jeans-Com-Bolsos/p</link>
      <g:image_link>http://img-yourstore.com.br/images/AAA.jpg</g:image_link>
      <g:condition>new</g:condition>
      <g:availability>in stock</g:availability>
      <g:price>159.99 BRL</g:price>
      <g:sale_price>159.99 BRL</g:sale_price>
      <g:gtin>7909245516136</g:gtin>
      <g:brand>Brand</g:brand>
      <g:item_group_id>AAA</g:item_group_id> <!-- The product id -->
      <g:color>AZUL</g:color>
      <g:gender>FEMALE</g:gender>
      <g:age_group>adult</g:age_group>
      <g:size>P</g:size>
      <g:shipping>
        <g:country>BR</g:country>
        <g:service>Frete Grátis</g:service>
        <g:price>0.0 BRL</g:price>
      </g:shipping>
      <g:installment>
        <g:months>5</g:months>
        <g:amount>31.99 BRL</g:amount>
      </g:installment>
    </item>
  </channel>
</rss>
Feed Mínimo
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rss xmlns:date="http://exslt.org/dates-and-times"
     xmlns:g="http://base.google.com/ns/1.0"
     version="2.0">
  <channel>
    <title>YOUR store products</title>
    <link>http://www.yourstore.com.br/</link>     
    <description>This is a valid sample feed with minimum required data</description>
    <last_build_date>2015-08-29T18:50:51</last_build_date>
    <item>
      <g:id>123</g:id>
      <title>Casaco Feminino Jeans Com Bolsos</title>
      <g:product_type>Feminino &gt; Jaquetas</g:product_type>
      <!-- OR with CDATA <g:product_type><![CDATA[Feminino > Jaquetas]]></g:product_type> -->
      <link>http://www.yourstore.com.br/Jaquetas/Casaco-Feminino-Jeans-Com-Bolsos/p</link>
      <g:image_link>http://img-yourstore.com.br/images/AAA.jpg</g:image_link>
      <g:availability>in stock</g:availability>
      <g:price>159.99 BRL</g:price>
      <g:sale_price>159.99 BRL</g:sale_price>
      <g:installment>
        <g:months>5</g:months>
        <g:amount>31.99 BRL</g:amount>
      </g:installment>
    </item>
  </channel>
</rss>
Feed Completo
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rss xmlns:g="http://base.google.com/ns/1.0"
     xmlns:c="http://www.chaordic.com.br/ns/catalog/1.0" version="2.0">
<channel>
    <title>YOUR store products</title>
    <link>http://www.yourstore.com.br/</link>
    <description>This is a feed with recommended + Chaordic Schema fields</description>
    <item>
        <g:item_group_id>AAA</g:item_group_id><!-- ID PARA AGRUPAR SKUS -->
        <g:id>AAA02</g:id>
        <title>Casaco Feminino Jeans Com Bolsos</title>
        <description>Casaco feminino elaborado em jeans com composição 100% algodão. Contempla gola tradicional, recortes frente, bolsos com fechamento por botão localizados na altura do busto e desgastes na coloração. Peça chave para os dias frios da estação!</description>
        <c:categories>
            <c:category>Outra categoria</c:category>
            <c:category c:id="1">Casa</c:category>
            <c:category c:id="2" c:parentId="1">Banheiro</c:category>
            <c:category c:id="3" c:parentId="2"><![CDATA[Utensílios]]></c:category>
        </c:categories>
        <link>http://www.yourstore.com.br/Jaquetas/Casaco-Feminino-Jeans-Com-Bolsos/p</link>
        <c:images>
            <c:image c:id="250x250">http://wwww.yourhost.com/images/bla.png</c:image>
            <c:image c:id="320x320">http://wwww.yourhost.com/images/bla_large.png</c:image>
        </c:images>
        <g:condition>new</g:condition>
        <g:availability>in stock</g:availability>
        <g:price>159.99 BRL</g:price>
        <g:sale_price>159.99 BRL</g:sale_price>
        <g:gtin>7909245516136</g:gtin>
        <g:brand>Brand</g:brand>        
        <g:color>AZUL</g:color>
        <g:gender>FEMALE</g:gender>
        <g:age_group>adult</g:age_group>
        <g:size>P</g:size>
        <g:shipping>
            <g:country>BR</g:country>
            <g:service>Frete Grátis</g:service>
            <g:price>0.0 BRL</g:price>
        </g:shipping>
        <g:installment>
            <g:months>5</g:months>
            <g:amount>31.99 BRL</g:amount>
        </g:installment>
        <c:tags>
            <c:tag>lancamento</c:tag>
            <c:tag>Verão</c:tag>
            <c:tag>Mais vendido</c:tag>
            <c:tag>Super vendido</c:tag>
        </c:tags>
        <c:details>
            <c:detail c:id="numPages">123</c:detail>
            <c:detail c:id="volts">110v</c:detail>
        </c:details>
        <c:specs>
            <c:spec c:id="flavor">baunilha</c:spec>
            <c:spec c:id="voltage">220v</c:spec>
            <c:spec c:id="size">G</c:spec>
            <c:spec c:id="color">azul</c:spec>
            <c:spec c:id="mediaType">Ebook</c:spec>
        </c:specs>
    </item>
    <item>
        <g:item_group_id>AAA</g:item_group_id><!-- ID PARA AGRUPAR SKUS -->
        <g:id>AAA01</g:id>
        <title>Casaco Feminino Jeans Com Bolsos</title>
        <description>Casaco feminino elaborado em jeans com composição 100% algodão. Contempla gola tradicional, recortes frente, bolsos com fechamento por botão localizados na altura do busto e desgastes na coloração. Peça chave para os dias frios da estação!</description>
        <c:categories>
            <c:category>Outra categoria</c:category>
            <c:category c:id="1">Casa</c:category>
            <c:category c:id="2" c:parentId="1">Banheiro</c:category>
            <c:category c:id="3" c:parentId="2"><![CDATA[Utensílios]]></c:category>
        </c:categories>
        <link>http://www.yourstore.com.br/Jaquetas/Casaco-Feminino-Jeans-Com-Bolsos/p</link>
        <c:images>
            <c:image c:id="250x250">http://wwww.yourhost.com/images/bla.png</c:image>
            <c:image c:id="320x320">http://wwww.yourhost.com/images/bla_large.png</c:image>
        </c:images>
        <g:condition>new</g:condition>
        <g:availability>in stock</g:availability>
        <g:price>159.99 BRL</g:price>
        <g:sale_price>159.99 BRL</g:sale_price>
        <g:gtin>7909245516136</g:gtin>
        <g:brand>Brand</g:brand>
        <g:gender>FEMALE</g:gender>
        <g:age_group>adult</g:age_group>
        <g:shipping>
            <g:country>BR</g:country>
            <g:service>Frete Grátis</g:service>
            <g:price>0.0 BRL</g:price>
        </g:shipping>
        <g:installment>
            <g:months>5</g:months>
            <g:amount>31.99 BRL</g:amount>
        </g:installment>
        <c:tags>
            <c:tag>lancamento</c:tag>
            <c:tag>Verão</c:tag>
            <c:tag>Mais vendido</c:tag>
            <c:tag>Super vendido</c:tag>
        </c:tags>
        <c:details>
            <c:detail c:id="numPages">123</c:detail>            
        </c:details>
        <c:specs>
            <c:spec c:id="flavor">baunilha</c:spec>
            <c:spec c:id="voltage">110v</c:spec>
            <c:spec c:id="size">G</c:spec>
            <c:spec c:id="color">azul</c:spec>
            <c:spec c:id="mediaType">Ebook</c:spec>
        </c:specs>
    </item>
</channel>
</rss>