Como montar o XML para carga de produtos

Como montar o XML para carga de produtos


 

1. Introdução

Neste tutorial você irá entender o modelo a ser seguido para geração do XML utilizado para realizar carga de produtos pela API do Buscapé.

A descrição dos serviços da API do Buscapé pode ser encontrado aqui.

As informações que devem ser enviadas através do XML e seus respectivos parâmetros, são:

Atributo Tipo Descrição
data_atualizacao String Data de atualização da carga.
produtos>produto>agrupador String Agrupador de um produto (Deverá para agrupar variações diferentes de um produto. Exemplo: Tenis xxx Branco (sku=100 - groupId=1), Tenis xxx Preto (sku=200 - groupId=1), Tenis xxx Azul (sku=300 - groupId=1))
produtos>produto>título String Título da oferta. (Tamanho máx. 240 caracteres)
produtos>produto>descricao String Descrição/Sinopse do produto, aceita tags HTML:
  • <p>, <br>, <b>, <strong>, <i>, <div>, <span>
Não serão aceitos script e/ou css inline, ou qualquer outra tag não listada acima.
produtos>produto>canal_buscape>canal_url String URL da oferta com os parâmetros necessários para esse canal. (Tamanho máx. 4094 caracteres)
produtos>produto>canal_buscape>
valores>valor>forma_de_pagamento
String Forma de pagamento referente a esse preço
  • boleto
  • cartao_avista
  • cartao_parcelado_sem_juros
  • cartao_parcelado_com_juros
produtos>produto>canal_buscape>
valores>valor>parcelamento
String Quantidade de parcelas (Exemplo: 5x de R$ 100,00).
produtos>produto>canal_buscape>
valores>valor>canal_preco
String Preço total (exemplo: "R$ 500,00").
produtos>produto>canal_lomadee>canal_url String URL da oferta com os parâmetros necessários para esse canal. (Tamanho máx. 4094 caracteres)
produtos>produto>canal_lomadee>
valores>valor>forma_de_pagamento
String Forma de pagamento referente a esse preço
  • boleto
  • cartao_avista
  • cartao_parcelado_sem_juros
  • cartao_parcelado_com_juros
produtos>produto>canal_lomadee>
valores>valor>parcelamento
String Quantidade de parcelas (Exemplo: 5x de R$ 100,00).
produtos>produto>canal_lomadee>
valores>valor>canal_preco
String Preço total (exemplo: "R$ 500,00").
produtos>produto>id_oferta String SKU (Tamanho máx. 240 caracteres)
produtos>produto>imagens>imagem String Link da imagem da Oferta. (Tamanho máx. 4094 caracteres cada imagem)
produtos>produto>categoria String Categoria da Oferta, o mais completo possível e o mais relevante possível. (Tamanho máx. 255 caracteres)
produtos>produto>isbn String Código ISBN da Oferta.
produtos>produto>cod_barra String Código de Barras (Tamanho máx. 240 caracteres)
produtos>produto>disponibilidade Integer Quantidade desta oferta em estoque.
produtos>produto>altura Double Altura do produto (em cm).
produtos>produto>comprimento Double Comprimento do produto (em cm).
produtos>produto>largura Double Largura do produto (em cm).
produtos>produto>peso Integer Peso do produto (em gramas).
produtos>produto>especificacoes List<especificacao> Especificações técnicas do produto (Exemplo: Tamanho da tela, tipo de material, marca, etc)
produtos>produto>especificacoes>
especificacao>nome
String Nome da especificação técnica do produto.
produtos>produto>especificacoes>
especificacao>valor
String Valor da especificação técnica do produto.
produtos>produto>atributos List<atributo> Características principais do produto (características que podem gerar variação entre o mesmo produto, exemplo: Cor, Voltagem, Tamanho, etc)
produtos>produto>atributos>
atributo>nome
String Nome do atributo do produto.
produtos>produto>atributos>
atributo>valor
String Valor do atributo do produto.

 

2. Modelo de XML

A seguir você encontra um modelo de arquivo XML que pode ser usado na nossa integração:

<?xml version=”1.0” encoding=”ISO-8859-1”?>
<buscape>
	<data_atualizacao></data_atualizacao>
	<produtos>
		<produto>
			<agrupador></agrupador>
			<titulo></titulo>
			<descricao></descricao>
			<canal_buscape>
				<canal_url></canal_url>
				<valores>
					<valor>
						<forma_de_pagamento></forma_de_pagamento>
						<parcelamento></parcelamento>
						<canal_preco></canal_preco>
					</valor>
        	                        .
                	                .
                        		.
				</valores>
			</canal_buscape>
			<canal_lomadee>
				<canal_url></canal_url>
				<valores>
					<valor>
						<forma_de_pagamento></forma_de_pagamento>
						<parcelamento></parcelamento>
						<canal_preco></canal_preco>
					</valor>
        	                        .
                	                .
                        		.
				</valores>
			</canal_lomadee>
			<id_oferta></id_oferta>
			<imagens>
                	        <imagem</imagem>
                        	.
	                        .
        	                .
	                </imagens>
			<categoria></categoria>
			<isbn></isbn>
			<cod_barra></cod_barra>
			<disponibilidade></disponibilidade>
			<altura></altura>
			<comprimento></comprimento>
			<largura></largura>
			<peso></peso>
			<especificacoes>
				<especificacao> 
					<nome></nome>
					<valor></valor>
				</especificacao>
				.
				.
			</especificacoes>
			<atributos>
				<atributo>
					<nome></nome>
					<valor></valor>
				</atributo>
				.
				.
			</atributos>
		</produto>
		.
		.
		.
	</produtos>
</buscape>

 

3. Exemplo

Neste exemplo temos 3 ofertas, as 2 primeiras utilizam o recurso de groupID para agrupar as diferentes variações de um produto, já o 3º produto da lista não possui groupID, isto é, o produto não possui variações:

<?xml version=”1.0” encoding=”ISO-8859-1”?>
<buscape>
	<data_atualizacao>06/04/2015</data_atualizacao>
	<produtos>
		<produto>
			<agrupador>10019</agrupador>
			<titulo>Tênis Olympikus Strong</titulo>
			<descricao>Produzido para que as mulheres tenham a rotina e os treinos na academia muito mais cômodos, a Olympikus criou o Tênis Olympikus Strong 43198923 com a tecnologia Glider Tech no EVA de seu solado. Esta tecnologia proporciona a melhoria na absorção de impactos e, ainda, dá mais leveza ao calçado. Este tênis tem, em sua parte superior, telas feitas em materiais leves e flexíveis, que permitem a transpiração dos seus pés. Não deixe de garantir o seu!</descricao>
			<canal_buscape>
				<canal_url>http://www.example.com/tenis-olympikus-strong-43198923-w.html</canal_url>
				<valores>
					<valor>
						<forma_de_pagamento>boleto</forma_de_pagamento>
						<parcelamento>1x de R$ 89,99</parcelamento>
						<canal_preco>R$ 89,99</canal_preco>
					</valor>
					<valor>
						<forma_de_pagamento>cartao_parcelado_com_juros</forma_de_pagamento>
						<parcelamento>12x de R$ 9,99</parcelamento>
						<canal_preco>R$ 119,88</canal_preco>
					</valor>
				</valores>
			</canal_buscape>
			<canal_lomadee>
				<canal_url>http://www.example.com/tenis-olympikus-strong-43198923-w.html?utm=lomadee</canal_url>
				<valores>
					<valor>
						<forma_de_pagamento>boleto</forma_de_pagamento>
						<parcelamento>1x de R$ 99,99</parcelamento>
						<canal_preco>R$ 99,99</canal_preco>
					</valor>
					<valor>
						<forma_de_pagamento>cartao_parcelado_com_juros</forma_de_pagamento>
						<parcelamento>12x de R$ 14,90</parcelamento>
						<canal_preco>R$ 178,8</canal_preco>
					</valor>
				</valores>
			</canal_lomadee>
			<id_oferta>43198923</id_oferta>
			<imagens>
                	        <imagem>http://www.example.com/tenis-olympikus-strong-43198923-w.jpg</imagem>
                	        <imagem>http://www.example.com/tenis-olympikus-strong-43198923-w-2.jpg</imagem>
	                </imagens>
			<categoria>Moda Feminina>Tenis</categoria>
			<cod_barra>4319892343198923</cod_barra>
			<disponibilidade>50</disponibilidade>
			<altura>20.5</altura>
			<comprimento>80.5</comprimento>
			<largura>40.5</largura>
			<peso>305</peso>
			<especificacoes>
				<especificacao>
					<nome>Estilo</nome>
					<valor>Training</valor>
				</especificacao>
				<especificacao>
					<nome>Solado</nome>
					<valor>EVA com tecnologia Glider Tech (sistema que melhora a absorção de impactos e adiciona leveza ao calçado)</valor>
				</especificacao>
			</especificacoes>
			<atributos>
				<atributo>
					<nome>Tamanho</nome>
					<valor>35</valor>
				</atributo>
				<atributo>
					<nome>Cor</nome>
					<valor>AZUL/ROSA</valor>
				</atributo>
			</atributos>
		</produto>
		<produto>
			<agrupador>10019</agrupador>
			<titulo>Tênis Olympikus Strong</titulo>
			<descricao>Produzido para que as mulheres tenham a rotina e os treinos na academia muito mais cômodos, a Olympikus criou o Tênis Olympikus Strong 43198923 com a tecnologia Glider Tech no EVA de seu solado. Esta tecnologia proporciona a melhoria na absorção de impactos e, ainda, dá mais leveza ao calçado. Este tênis tem, em sua parte superior, telas feitas em materiais leves e flexíveis, que permitem a transpiração dos seus pés. Não deixe de garantir o seu!</descricao>
			<canal_buscape>
				<canal_url>http://www.example.com/tenis-olympikus-strong-43198923-w.html</canal_url>
				<valores>
					<valor>
						<forma_de_pagamento>boleto</forma_de_pagamento>
						<parcelamento>1x de R$ 89,99</parcelamento>
						<canal_preco>R$ 89,99</canal_preco>
					</valor>
					<valor>
						<forma_de_pagamento>cartao_parcelado_com_juros</forma_de_pagamento>
						<parcelamento>12x de R$ 9,99</parcelamento>
						<canal_preco>R$ 119,88</canal_preco>
					</valor>
				</valores>
			</canal_buscape>
			<canal_lomadee>
				<canal_url>http://www.example.com/tenis-olympikus-strong-43198923-w.html?utm=lomadee</canal_url>
				<valores>
					<valor>
						<forma_de_pagamento>boleto</forma_de_pagamento>
						<parcelamento>1x de R$ 99,99</parcelamento>
						<canal_preco>R$ 99,99</canal_preco>
					</valor>
					<valor>
						<forma_de_pagamento>cartao_parcelado_com_juros</forma_de_pagamento>
						<parcelamento>12x de R$ 14,90</parcelamento>
						<canal_preco>R$ 178,8</canal_preco>
					</valor>
				</valores>
			</canal_lomadee>
			<id_oferta>43198923</id_oferta>
			<imagens>
                	        <imagem>http://www.example.com/tenis-olympikus-strong-43198923-w.jpg</imagem>
                	        <imagem>http://www.example.com/tenis-olympikus-strong-43198923-w-2.jpg</imagem>
	                </imagens>
			<categoria>Moda Feminina>Tenis</categoria>
			<cod_barra>4319892343198923</cod_barra>
			<disponibilidade>50</disponibilidade>
			<altura>20.5</altura>
			<comprimento>80.5</comprimento>
			<largura>40.5</largura>
			<peso>305</peso>
			<especificacoes>
				<especificacao>
					<nome>Estilo</nome>
					<valor>Training</valor>
				</especificacao>
				<especificacao>
					<nome>Solado</nome>
					<valor>EVA com tecnologia Glider Tech (sistema que melhora a absorção de impactos e adiciona leveza ao calçado)</valor>
				</especificacao>
			</especificacoes>
			<atributos>
				<atributo>
					<nome>Tamanho</nome>
					<valor>36</valor>
				</atributo>
				<atributo>
					<nome>Cor</nome>
					<valor>AZUL/PRETO</valor>
				</atributo>
			</atributos>
		</produto>
		<produto>
			<titulo>Smartphone Asus ZenFone 5 Z2560 8GB Desbloqueado</titulo>
			<descricao>Com certeza você já quis um smartphone que não trave, que seja realmente bonito, com design inovador e com uma bateria dure o dia todo.&lt;br&gt;E se esse Smartphone também tiver uma câmera incrível, com recursos que só as câmeras profissionais são capazes de oferecer.&lt;br&gt;E ainda tenha uma tecnologia que permita fotografar no escuro, com ganho de 400% em luminosidade.&lt;br&gt;Todos querem um Smartphone assim, por isso a ASUS trouxe para o Brasil, o Zenfone 5. O Smartphone com essas e muitas outras características que vão te surpreender. Simples, eficiente e bonito, assim é o Zenfone 5.&lt;br&gt;Design exclusivo com corte a laser e acabamento cerâmico, câmera Traseira de 8MP e Frontal de 2MP com a incrível tecnologia ASUS PixelMaster, dual SIM com armazenamento de 8 GB, tela HD IPS de 5” polegadas e processador Intel com 2 GB de memória RAM.</descricao>
			<canal_buscape>
				<canal_url>http://www.example.com/smartphone-asus-zenfone-5-branco-8mp-8gb-3g-wifi.html</canal_url>
				<valores>
					<valor>
						<forma_de_pagamento>boleto</forma_de_pagamento>
						<parcelamento>1x de R$ 680,25</parcelamento>
						<canal_preco>R$ 680,25</canal_preco>
					</valor>
					<valor>
						<forma_de_pagamento>cartao_parcelado_com_juros</forma_de_pagamento>
						<parcelamento>10x de R$ 74,90</parcelamento>
						<canal_preco>R$ 749,00</canal_preco>
					</valor>
				</valores>
			</canal_buscape>
			<canal_lomadee>
				<canal_url>http://www.example.com/smartphone-asus-zenfone-5-branco-8mp-8gb-3g-wifi.html?utm=lomadee</canal_url>
				<valores>
					<valor>
						<forma_de_pagamento>boleto</forma_de_pagamento>
						<parcelamento>1x de R$ 680,25</parcelamento>
						<canal_preco>R$ 680,25</canal_preco>
					</valor>
					<valor>
						<forma_de_pagamento>cartao_parcelado_com_juros</forma_de_pagamento>
						<parcelamento>10x de R$ 74,90</parcelamento>
						<canal_preco>R$ 749,00</canal_preco>
					</valor>
				</valores>
			</canal_lomadee>
			<id_oferta>UXA501BCOB</id_oferta>
			<imagens>
                	        <imagem>http://www.example.com/smartphone-asus-zenfone-5-branco-8mp-8gb-3g-wifi.jpg</imagem>
                	        <imagem>http://www.example.com/smartphone-asus-zenfone-5-branco-8mp-8gb-3g-wifi-2.jpg</imagem>
	                </imagens>
			<categoria>Eletronicos>Smartphone</categoria>
			<cod_barra>4319892343198923</cod_barra>
			<disponibilidade>50</disponibilidade>
			<altura>20.5</altura>
			<comprimento>80.5</comprimento>
			<largura>40.5</largura>
			<peso>305</peso>
			<especificacoes>
				<especificacao>
					<nome>Sistema Operacional</nome>
					<valor>Android 4.3</valor>
				</especificacao>
				<especificacao>
					<nome>Tamanho da Tela</nome>
					<valor>5"</valor>
				</especificacao>
			</especificacoes>
			<atributos>
				<atributo>
					<nome>Cor</nome>
					<valor>Branco</valor>
				</atributo>
			</atributos>
		</produto>
	</produtos>
</buscape>