Integração de produtos
Como consultar, criar, alterar e excluir produtos e suas variações via integração de API.
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}
eGET /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
oumarca
. A plataforma Vnda utiliza a funcionalidade de tags, e durante a criação do produto você pode utilizar o campotag_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 as variantes 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ção | Como fazer |
Leitura de Variantes | Utilize o método GET /api/v2/products/{product_id}/variants para consultar todas variantes de um produto, com a opção de refinar a busca por algum parâmetro desejado. É possível também buscar uma variante específica GET /api/v2/products/{product_id}/variants/{sku} .
|
Criação de Variantes | Crie variantes através do método POST /api/v2/products/{product_id}/variants .
|
Atualização de Variantes | A atualização de variantes pode ser feita através do método PATCH /api/v2/products/{product_id}/variants/{sku} .
|
Exclusão de Variantes | A 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.
Updated about 1 year ago