Importação de catálogo

Saiba como sincronizar o catálogo de produtos de sua loja

Importando o catálogo de produtos (Feed XML)

É utilizado o formato Product Feed Specification do Google para integração do catálogo via XML. A loja deve disponibilizar uma URL e informar a frequência de atualização do arquivo para que se possa fazer o download do feed e sincronizar os dados do catálogo.

O arquivo XML deve listar o catálogo completo da loja. Produtos que não existiam na última sincronização serão adicionados à nossa base de dados; produtos existentes serão atualizados e produtos que tornaram-se ausentes no XML serão removidos.

  • Note que os campos devem estar na **ordem definida neste documento.
  • Deve estar em "encoding" UTF-8

Namespaces do Feed XML

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

g: -> http://feeds.dc.chaordicsystems.com/v1/files/schemas/gxml.xsd
c: -> http://feeds.dc.chaordicsystems.com/v1/files/schemas/chaordic.xsd
Sem namespace -> http://feeds.dc.chaordicsystems.com/v1/files/schemas/RSS20.xsd

<?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

Campos do produto

Exemplo de Feed no formato XML

Feed XML minímo

<?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 XML 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>

XML Feed com suporte para integração Chaordic JS (chaordic_meta.product)

<?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>

Validando o XML

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

xmlstarlet fo meuarquivo.xml

📘

Opa! Está com a URL do feed em mãos?

Informe o responsável técnico de integração enviando um email para [email protected]


Did this page help you?