Pular para o conteúdo

Integração de produtos

A integração de produtos permite que a loja adicione, exclua e consulte itens no catálogo via API. Para integrar os produtos da sua loja com seu ERP, você pode:

  • Consultar os produtos da loja: utilizando os métodos GET /api/v2/products/{id} e GET /api/v2/products ` para consultar todos os produtos ou um produto específico do catálogo da loja.
  • Criar novos produtos: utilizando o método POST /api/v2/products você cria novos produtos para o catálogo. Para utilizar a API de produtos e adicionar novos itens ao catálogo atente-se que:
    • Depois de criar um novo produto você deve criar também as variantes do mesmo, pois é a partir delas que os produtos terão características, disponibilidade em estoque e preço cadastrado. Saiba mais como manipular as variantes de ações em variantes que virá a seguir.
    • Durante a criação de um produto não há agrupadores, como por exemplo categoria ou marca. A plataforma Olist Ecommerce utiliza a funcionalidade de tags, e durante a criação do produto você pode utilizar o campo tag_list para vincular um produto em tags que devem ser criadas previamente. Saiba mais em Integração de tags (categorias).
  • Atualizar produtos: utilizando o método PATCH /api/v2/products/{id}
  • Excluir produtos: utilizando o método DELETE /api/v2/products/{id}
  • Tratar asvariantes de um produto: para adicionar, consultar e deletar o segundo nível de informações de um produto. Com as variantes você adiciona características como cor ou tamanho de um mesmo produto. Veja como manipular as variantes na tabela a seguir.
AçãoComo fazer
Leitura de VariantesUtilize o método GET /api/v2/products/{product_id}/variants para consultar todas variantes de um produto. É possível também buscar uma variante específica em GET /api/v2/products/{product_id}/variants/{sku}.
Criação de VariantesCrie variantes através do método POST /api/v2/products/{product_id}/variants.
Atualização de VariantesA atualização de variantes pode ser feita através do método PATCH /api/v2/products/{product_id}/variants/{sku}.
Exclusão de VariantesA exclusão de variantes pode ser feita através de um DELETE /api/v2/products/{product_id}/variants/sku.

Nestes métodos o {id} é o código identificador retornado nas buscas ou na resposta do cadastro de produtos.