Inserção de Produto

A operação de inserção de produtos da API Fbits permite que sejam inseridos produtos de diversas maneiras, nessa documentação explicaremos em detalhes quais as possibilidades e o que deve ser feito para inserir um produto de acordo com cada uma delas.

Para inserir um produto é necessário realizar um post no endpoint /produtos enviando os dados mínimos necessários para a criação de um novo produto na plataforma. Informações como: nome, preço, fabricante, entre outros.

Um ponto importante do cadastro de produtos é a relação entre produtos e atributos, e a forma como os produtos se relacionam entre si. Um produto pode ter diversas modificações, por exemplo: cores, tamanhos, preços, voltagens, pesos, etc. Nesse caso é necessário escolhermos como queremos agrupar essas variações. Nós podemos fazer isso de duas formas, agrupando produtos diferentes pelo que chamamos de ParentId ou agrupando diversos variantes a um único produto. Caso o produto não possua variações também é possível inserir um produto sem agrupa-lo a nenhum outro.

Produto Sem Variações

Um produto sem variações, onde não existem opções como cor, tamanho ou voltagem para serem selecionadas pelo usuário deve ser inserido sem agrupamento algum e com a sua lista de atributos vazia. Nesse caso quando o usuário acessar a página do produto será apresentada apenas a opção de quantidade de itens desejados para a compra. Ver mais

Agrupamento por Parent Id

O Parent Id nada mais é que um código interno utilizado para que possamos identificar produtos diferentes que devem ser exibidos em conjunto na tela de produto. Dessa forma é possível ter produtos que possuem url's diferentes e que aparecem separados no resultado da busca sendo exibidos como um único produto quando visualizados na página do produto. Ver mais

Agrupamento por Produto Variante

No agrupamento por produto variante, ao invés de termos diversos produtos, nós temos único produto e suas variações. Ao agrupar dessa forma, no resultado da busca será exibido apenas um item do produto, mesmo que existam diversas variações. A url do produto é uma só e suas variações são exibidas na página de produto da mesma forma que no agrupamento por Parent Id. Ver mais

A Api Fbits diferencia cada uma dessas formas de agrupamento através dos campos IdPaiExterno, IdVinculoExterno e Sku. Na seção referente a cada um dos tipos de agrupamento pode ser encontrada uma explicação completa de como estes campos devem estar preenchidos para que o produto seja inserido da forma desejada.