Produtos

Detalhes sobre os conceitos de produtos.

Categorias

Caso seu Marketplace possua conceitos de categorias de produtos pré-definidas e portanto as mesmas sejam obrigatórias para o cadastro de uma oferta, onde o integrador deve enviar o identificador da categoria durante o envio de ofertas, é necessário que sejam implementadas as APIs de categorias.

Notifique o integrador sobre a convenção de seu Marketplace, ou seja, se existem categorias pré-definidas ou não e se as mesmas são obrigatórias ou não para a integração de produtos, assim o integrador poderá fazer esta configuração no envio de produtos.

Produtos e Skus

Em produtos a sua integração precisa realizar as seguintes ações:

• Consultar todos os produtos

• Criar produto

• Consultar produto específico

• Atualizar produto específico

• Deletar um produto específico

• Consultar todas as variações de um produto

• Criar variação em produto

• Consultar variação específica

• Atualizar variação de produto

• Deletar variação de um produto

• Consultar produtos com filtro

• Criação e Atualização em lote de produtos

• Consultar atualizações de status de produtos adicionados na fila

• Deletar uma variação de produto da fila

• Consultar Log de integração

Atualização de Produtos Ao enviar o POST de um produto, não será possível a alteração da categoria de um produto através do PUT, por isso tenha certeza de enviar o produto na categoria correta, caso contrário você terá de excluir o produto através do DELETE.

O desenvolvimento do endpoint de products é importante para que o seller possa enviar/criar, consultar, atualizar e deletar os seus produtos no Marketplace, a nossa API de products utiliza o conceito de produtos e SKUs, conhecida também por:

• Produto e variação de produto

• Produto pai e produto filho

• Produto simples e produto composto

Quando eu devo utilizar o envio de produtos em lote?

Todas as vezes em que você tiver uma carga muito grande de criação ou atualizações a serem feitas, você deverá utilizar a atualização em lote.

Cenário 01: Na carga inicial de produtos, durante o processo de implantação do seller, deve ser enviado um lote para criação de produtos, dessa forma com uma única chamada, a integração enviará todos os produtos do seller para o marketplace

Cenário 02: Uma nova coleção de produtos chegou na loja do seller, e ele deseja disponibilizar estes no marketplace, a Linx indica a utilização da criação de produtos em lote.

Cenário 03: Imagine que o seller fez muitas alterações em vários produtos e precisa replicar essas informações para o Marketplace, para isso a Linx indica a utilização da atualização de produtos em lote.

Qual o limite de produtos que posso enviar em 1 lote?

O limite é de 100 produtos por lote (batch)

A API possui o conceito de Produtos e Skus (variações de produto), sendo que um produto deverá possuir ao menos uma variação. Ou seja, caso o produto seja simples (sem variação), no array variations deverá ser enviado os detalhes do produto como uma variação, conforme exemplo abaixo:

{
  "id": "000100",
  "name": "Camiseta",
  .
  ...
  "variations": [
  {
      "sku": "000100"
    }
  ]
}

Status de Produtos

New – O produto recebe o status: New quando ele é cadastrado com sucesso, mas ainda não foi publicado.

InReview – O produto recebe o Status: InReview quando ele passa algum tipo de moderação.

A moderação é uma das formas de o Marketplace verificar se o cadastro do produto está correto e liberá-lo ou recusa-lo por algum motivo.

OBS: Atualmente nós não temos implementado a moderação de produto no Marketplace, por esse motivo nenhum produto terá esse status no momento.

Published – O produto recebe o status: Published quando ele está publicado no Marketplace.

Inactive – O produto recebe o status: Inactive quando a integração enviar no cadastro ou na atualização do produto o Active = False

Failed – O produto recebe o status: Failed quando ele foi cadastrado, mas teve algum erro ao ser publicado no Marketplace.

Venda sem estoque

É possível informar quais variações terão vendas mesmo sem ter estoque

Na criação das variações no campo:

backorderlimit aqui você informará qual é o limite da venda sem estoque.

backordertime aqui você informará qual o tempo de manuseio para venda de itens sem estoque.

Regras do cadastro de imagens

Cada Marketplace terá as suas próprias configurações de dimensões mínimas para o envio de imagens de produtos, para saber quais são as dimensões entre em contato com o Marketplace. Os formatos aceitos são JPG e PNG.

Mais detalhes sobre API de Produtos em: