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/productsvocê 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
categoriaoumarca. A plataforma Vnda utiliza a funcionalidade de tags, e durante a criação do produto você pode utilizar o campotag_listpara 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çã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 month ago