Olá, desenvolvedor!

 

Neste post abordaremos como funciona a categorização de produtos no Plug4Market.

 

Dentro da nossa ferramenta, existem dois tipos de categorias. As categorias personalizadas e as categorias por marketplace.

 

Sumário

1. Como criar e utilizar as Categorias Personalizadas

   1.1. Via painel

   1.2 Via API

2. Como utilizar as categorias por marketplace

  2.1 Via painel

  2.2 Via API

 

1- Como criar e utilizar as categorias personalizadas

1.1- Via painel

Para utilizar as categorias personalizadas via painel, basta acessar a aba "Categorias Personalizadas" dentro do menu "Produtos":

 

Dentro deste painel, é possível criar categorias pelo botão do canto superior direito "Criar Categoria". 

 

 

Caso o lojista utilize um e-commerce (Vtex, Loja Integrada, Magento 2, etc), é importante que a categoria seja criada exatamente com os mesmos dados da categoria no canal, isto é, o exato mesmo nome e mesmo ID.

Caso o lojista não possua categorias no canal de vendas, o Plug4Market irá cadastrar a categoria criada pelo painel no canal.

 

Como atribuir categorias criadas aos produtos?

Uma vez criadas, as categorias podem ser atribuídas aos produtos de duas formas:

 

1- Pela tela de atribuição:

Neste caso, basta selecionar os produtos, a categoria, e clicar em "Vincukar".

 

2- Pela importação de planilha:

 

Neste caso, basta baixar uma planilha modelo pela tela de importação. Essa planilha modelo trará todas as categorias personalizadas criadas e os produtos de acordo com o filtro acionado (todos, categorizados ou não categorizados).

 

Na aba "Categorias", aparecerão as categorias criadas com seus respectivos ID's 

 

Na aba "Produtos", basta adicionar as categorias a serem atribuídas nas colunas G, H e I:

Obs: é obrigatório preencher apenas o campo de ID da categoria. Os demais são opcionais, recomendamos que o lojista os preencham para ter mais controle no processo.

 

1.2- Via API

Como criar categorias: 

URL:

Sandbox: POST https://api.sandbox.plug4market.com.br/custom-categories

Produção: POST https://api.plug4market.com.br/custom-categories

 

Exemplo de request:

{
   "name": "Artigos Esportivos",
   "alternativeId": "10000",
   "fatherAlternativeId": "10001"
}

Além da rota de criação de categorias, existem as rotas auxiliares para consulta e exclusão delas. Para mais detalhes, consulte o nosso swagger: https://api.sandbox.plug4market.com.br/docs#tag/Categorias-Personalizadas

 

É possível, também, atribuir uma categoria a um produto via API. Para isto, basta utilizar o campo "customCategory". O campo pode ser utilizado tanto na rota de CRIAÇÃO do produto quanto na rota de EDIÇÃO do mesmo.

 

Exemplo de uso: 

"customCategory": {
   "alternativeId": "00026-1"
}

 

 

2- Como utilizar as categorias por marketplace:

 

Os marketplaces (canais como Mercado Livre, Amazon, Shopee, etc) não permitem criar categorias, sendo assim, podemos apenas utilizar as categorias disponibilizadas pelo canal em questão.

Para trabalhar com estes canais, faremos uma atribuição das categorias personalizadas às categorias dos marketplaces.

 

2.1- Via Painel

Este processo pode ser realizado pela tela de Categorias Personalizadas, dentro do menu "Configurações".

 

Ao selecionar o marketplace ao qual as categorias serão atribuídas, serão mostradas todas as categorias disponibilizadas pelo canal de vendas em questão, Basta atribuir a categoria personalizada já criada à uma dessas categorias:

 

 

2.2- Via API

 

Primeiro passo: Consultar categorias por marketplace

Nesta etapa, obteremos os ID's das categorias nos marketplaces

 

URL:

Sandbox: GET https://api.sandbox.plug4market.com.br/categories/{saleChannelId}

Produção: GET https://api.plug4market.com.br/categories/{saleChannelId}

 

Exemplo de retorno:

[
   {
      "id": "63d956915b6f1e0011c768d6",
      "text": "Artigos Esportivos",
      "parent": "#",
      "children": false
   }
]

Para mais detalhes sobre a rota, consultar o swagger: https://api.sandbox.plug4market.com.br/docs#tag/Categorias-do-Canal-de-Vendas

 

Segundo passo: Vincular categoria personalizada

 

URL:

Sandbox: POST https://api.sandbox.plug4market.com.br/categories/{saleChannelId}

Produção: POST https://api.plug4market.com.br/categories/{saleChannelId}

 

Exemplo de request:

{
   "categories": [
      {
         "alternativeId": "1231121"
      },
      {
         "alternativeId": "1232121"
      }
   ],
   "saleChannelCategoryId": "17938239011",
   "saleChannel": 1
}

Para mais detalhes sobre a rota, consultar o swagger: https://api.sandbox.plug4market.com.br/docs#tag/Categorias-Personalizadas/operation/CustomCategoriesController_saleChannelCategory

 

Uma vez que a categoria foi vinculada, basta atribuí-la aos produtos (pode ser feito via API ou pelo painel) e, caso o produto seja enviado para o marketplace, o sistema irá atribuir a categoria vinculada automaticamente.