Como montar o CSV para carga de produtos

Como montar o CSV para carga de produtos


 

1. Introdução

Neste tutorial você irá entender o modelo a ser seguido para geração do CSV 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 CSV e seus respectivos parâmetros, são:

Atributo Tipo Descrição
groupId 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))
sku String ID do produto. (Tamanho máx. 240 caracteres)
barCode String Código de barras do produto. (Tamanho máx. 240 caracteres)
category String Categoria do produto (Ex. Eletronicos>TV). (Tamanho máx. 255 caracteres)
title String Título do produto. (Tamanho máx. 200 caracteres)
description 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.
linkLomadee String Link do produto para Lomadee. (Tamanho máx. 4094 caracteres)
link String Link do produto para o Buscapé. (Tamanho máx. 4094 caracteres)
images Array Array de imagens do produto. (Tamanho máx. 4094 caracteres cada imagem)
prices Json no formato JSON, deve conter os seguintes atributos: type, price, priceLomadee e installment. Na seção 3 você pode encontrar um exemplo de célula para prices.
quantity Integer Quantidade disponível.
isbn String Código ISBN para livros.
sizeHeight Double Altura do produto (cm).
sizeLength Double Comprimento do produto (cm).
sizeWidth Double Largura do produto (cm).
weightValue Integer Peso do produto (gramas).
technicalSpecifications Map Mapa de especificações técnicas do produto, há um modelo deste atributo na seção 3.
productAttributes Map Características principais do produto (características que podem gerar variação entre o mesmo produto, exemplo: Cor, Voltagem, Tamanho, etc).

 

2. Modelo de CSV

A seguir você encontra um modelo de arquivo CSV (desconsidere as aspas duplas):

groupId;sku;barCode;category;title;description;linkLomadee;link;images;prices;quantity;isbn;sizeHeight;sizeLength;sizeWidth;weightValue;technicalSpecification; productAttributes
"";"";"";"";"";"";"";"";["",...,""];[{"type":"","price":0.0,"priceLomadee":0.0,"installment":0,"installmentValue":0.0}];0;"";0.0;0.0;0.0;0;{"":"",...,"":""};{"":"",...,"":""}


**Neste caso, o delimitador de coluna utilizado foi o ponto e vírgula, mas esta pode ser escolhida pelo usuário a partir do serviço de carga.

 

3. Observações e detalhes

Cabeçalho do arquivo

A primeira linha do seu arquivo deve conter os nomes dos atributos de cada célula e nas linhas abaixo seus valores, seguindo a estrutura do cabeçalho, como no modelo de CSV colocado acima.

Array de imagens do produto (images):

O array deve ser feito na seguinte forma: ["URL_1", "URL_2", ... , "URL_N"].

Modelo de JSON para prices:

Deverá ser enviado um JSON no seguinte formato: [{"type":"","price":0, "priceLomadee":0,"installment":0}, {"type":"","price":0, "priceLomadee":0,"installment":0,"installmentValue":0}]

Especificações técnicas (technicalSpecifications):

Deverá ser enviado um JSON (Map) no seguinte formato: {"Nome_da_especificação_1" : "Valor_da_especificação_2", "Nome_da_especificação_2" : "Valor_da_especificação_2"}.

Atributos do produto (productAttributes):

Deverá ser enviado um JSON (Map) no seguinte formato: {"Nome_do_atributo_1" : "Valor_do_atributo_1", "Nome_do_atributo_2" : "Valor_do_atributo_2"}.

4. Exemplo

Neste exemplo temos 3 ofertas, as 2 primeiras utilizam o recurso de grouID 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:

** Note que neste exemplo utilizamos o delimitador ";", que pode ser especificado na carga de produtos.