Integração de Produtos

PRODUTO

O KPL fornece três tipos de produtos para comercialização.

Produto filho
É o produto(sku) final para venda.

Exemplo:
Camiseta tamanho P preta(sku: 123456789)
Camiseta tamanho M preta(sku: 123456788)
Camiseta tamanho G preta(sku: 123456787)

Caminho:
Comercial e Faturamento / Cadastros / Produtos / Produtos
inserir-produto

 

 

 

 

 

 


Para que o produto esteja disponível para o consumo na API (método ProdutosDisponiveis) é necessário vincular os produtos na interface e na unidade de negócio utilizada nesta integração.

Produto pai
É o produto que permite a escolha de variações (do produto filho).
O produto pai pode possuir um SKU mas não é um produto real. Ele é apenas um produto que faz a referência das variações.
Este produto atrela os filhos ao produto pai.

Exemplo:
Camiseta Preta
Neste exemplo das camisetas, o produto fornecerá as opções de tamanho(P/M/G).
É possível fornecer infinitas opções de variação (no KPL, isto é chamado de descritores pré-definidos), como por exemplo: cor, voltagem, tamanho, etc…
Quando o produto pai for exibido, será liberada a compra do produto filho. Atenção: o cliente jamais irá concluir uma compra de um produto pai.

Caminho:
Comercial e Faturamento / Cadastros / Produtos / Produtos

Para cadastrar as variações de um produto, primeiro insira o produto pai no KPL.
Faça a busca do produto pai, o selecione, então clique no botão “Gerar skus”, conforme mostra a imagem abaixo:
inserir-filhos-grupo

 

 

 

 

 

 

 

Atenção: Novamente, para que o produto esteja disponível para o consumo na API (método ProdutosDisponiveis) é necessário vincular os produtos na interface e na unidade de negócio utilizada nesta integração.

Produto kit
É o produto que possui vários componentes (produto do tipo “combo”). Neste caso, quando o cliente realiza uma compra, a compra é realizada considerando todos estes componentes.
O kit possui seu próprio SKU, pois é um produto real (sku: 987654321).

Exemplo:
Kit Beleza (sku 222222)
2 sabonentes glicerina (sku 523523)
1 xampu ervas (sku 23523)
1 creme de corpo (sku 111111)

Neste exemplo o produto será vendido com todos componenentes: 2 sabonetes + 1 xampu + 1 creme de corpo
O cliente receberá todos os componentes do kit. Cada componente é um produto que deve estar cadastrado na KLP. Ou seja, neste exemplo, temos 4 produtos.

Caminho:
Comercial e Faturamento / Cadastros / Produtos / Produtos
E então proceda o cadastro de um produto normalmente, porém acesse a aba COMPONENTES.
Na aba componentes, selecione a opção que o produto é um KIT e adicione os itens deste KIT:
inserir-kit

 

 

 

 

 

 

 

Detalhe: Mais uma vez, para que o produto esteja disponível para o consumo na API é necessário vincular na interface e na unidade de negócio utilizada nesta integração.

Vincular produto na interface

Acesse o menu:
Comercial e Faturamento / Cadastros / Produtos / Produtos
E então efetue a busca pelo(s) produto(s) que deseja atrelar a interface.
inserir-a-interface

 

 

 

 

 

 

 

 

Adicione uma ou mais interfaces que deseja que o produto seja exportado (via método ProdutosDisponiveis).

Vincular produto na unidade de negócio

Caminho:
Comercial e Faturamento / Cadastros / Produtos / Produtos
E então efetue a busca pelo produto que deseja atrelar a unidade de negócio.
atrelar-unidade-negocio

 

 

 

 

 

 

 

Clique em “Editar”, e na aba “Unidade de negócios” selecione uma ou mais unidades de negócio que deseja atrelar o produto.


ESTOQUE

O KPL esta preparado para trabalhar com múltiplos almoxarifados de estoque.
Para nossos testes de integração, podemos utilizar o documento auxiliar de movimentação de estoque para realizar movimentações no estoque dos produtos.

Caminho:
Estoques / Movimentações / Documento auxiliar de movimentação de estoque
estoque-documento-auxiliar-movimentac%cc%a7a%cc%83o-estoque

 

 

 

 

 

 

 

Ao clicar em inserir, será solicitado um nome e os produtos para esta movimentação de estoque.

estoque-adicionando-item-movimentacao-estoque

 

 

 

 

 

 

 

 

Adicione os produtos que irá dar entrada de estoque e salve a movimentação.

Sugerimos que faça esta entrada no estoque de faturamento, pois apenas este estoque permite o faturamento e despacho dos produtos.

estoque-processar-movimentacao-estoque

 

 

 

 

 

 

 

 

Com a movimentação salva, basta clicar em processar para que o novo estoque seja adicionado aos itens contidos na movimentação.

Ao realizar uma movimentação do estoque do produto, você pode consultar as alterações via método EstoquesDisponiveis.

PREÇO

O KPL esta preparado para trabalhar com múltiplas listas de preço.
Para cadastrar ou editar uma nova lista de preços, acesse o caminho abaixo.

Caminho:
Comercial e Faturamento / Cadastros / Preços / Lista de Preços
preco-cadastro-lista-preco

 

 

 

 

 

 

 

 

É necessário atrelar a lista de preço com sua unidade de negócio e comercialização.

Todas as listas de preço cadastradas ficam disponíveis no cadastro de produto, no caminho abaixo.

Caminho:
Comercial e Faturamento / Cadastros / Produtos / Produtos
preco-preco-no-produto

 

 

 

 

 

 

 

 

Em um produto podemos possuir uma ou mais listas de preços disponíveis.

No KPL também é possível reajustar o preço de diversos produtos de uma forma muito simples.

Acesse o menu:
Comercial e Faturamento / Cadastros / Preços / Preços de produtos
preco-reajustar-precos

 

 

 

 

 

 

 

 

Neste local é possível reajustar o preço de diversos produtos de uma vez.
EXEMPLO DE CONSUMO DE PRODUTO, PREÇO, E ESTOQUE

O fluxo correto para consumo de produto e seu preço e estoque é o seguinte:

Faça o consumo do método: ProdutosDisponiveis

Ao receber a lista dos produtos que estão em fila é necessário confirmar o recebimento e o cadastro do produto através do método: ConfirmarRecebimentoProduto

Sugerimos que armazene em sua base de dados o protocolo desta transação. Este dado é uma chave única. Com ele em mãos se torna mais simples realizar consultas em busca de erros, por exemplo.

Após realizar a confirmação do recebimento e cadastro do produto, é liberado para o consumo o Estoque e Preço dos produtos.

É necessário configurar em sua interface quais são os almoxarifados (estoque) e preços que serão exportados de sua interface. Veja abaixo como realizar estas 2 tarefas.

Caminho:
Integração / Replicação de Dados / Configuração de interfaces

Saída de Estoque
Selecione sua interface e localize o grupo saída de estoque:

lista_almoxarifado_exportado

 

 

 

 

 

 

 

 

 

 

Selecione um ou mais almoxarifados que serão exportados.

É possível permitir o agrupamento de todos os estoques transformando então o saldo de seu estoque em único. Para isso, na saída de estoque, selecione a opção “agrupar saldo de estoque”, conforme imagem abaixo:

agrupar_saldo_estoque

 

 

 

 

 

 

 

 

 

 

 

Saída de Preços
Selecione sua interface e localize o grupo saída de preço:

lista_preco_exportada

 

 

 

 

 

 

 

 

 

 

Selecione um ou mais listas de preços que serão exportadas.
Após efetuar as configurações necessárias, é possível utilizar os métodos abaixo:

Faça o consumo do estoque através do método: EstoquesDisponiveis

E a confirmação através do método: ConfirmarRecebimentoEstoque

Novamente sugerimos que armazene em sua base de dados o protocolo desta transação. Este dado é uma chave única e com ele em mãos se torna mais simples realizar consultas em busca de erros, por exemplo.

Faça o consumo do preço através do método: PrecosDisponiveis

E a confirmação através do método: ConfirmarRecebimentoPreco

Consumo de produto pai
Para o consumo de um produto pai é necessário primeiro o consumo e armazenamento de todos os produtos filhos e seus descritores para o correto vinculo entre o produto pai e suas variações (descritores).

Consuma o método: DescritoresPreDefinidosDisponiveis

E efetue a confirmação através do método: ConfirmarRecebimentoDescritorPreDefinido

Sugerimos novamente que armazene em sua base de dados o protocolo desta transação

Ao consumir os produtos existe um campo no XML chamado: CodigoProdutoPai. Caso este campo venha preenchido, sabemos então que este produto é uma variação e faz parte de um produto pai.

Os produtos que são filhos de um produto pai devem permanecer em uma árvore de vinculo com o produto pai.

Exemplo:
Produto Pai – Camisetas ID do produto: 123456
Produto Filho – Camiseta Preta ID do produto: 827818 – ID do produto pai: 123456
Produto Filho – Camiseta Verde ID do produto: 827813 – ID do produto pai: 123456
Produto Filho – Camiseta Azul ID do produto: 827855 – ID do produto pai: 123456

Perceba que todos os produtos filhos vinculam a um mesmo produto pai, assim sabemos que o produto “Camisetas” possui as seguintes variações: Preta, Verde e Azul.

Consumo de produto kit
Para o consumo de um produto kit basta verificar o node do XML chamado ProdutoKit. Caso este campo seja uma afirmação(true) armazene o produto como KIT e consuma seus componentes percorrendo o node ComponentesKit

Os componentes que compõe um produto kit devem permanecer em uma árvore de vinculo com o produto pai.

Exemplo:
Produto Pai – Camisetas ID do produto: 654321
Componente – Camiseta Preta ID do produto: 827818 – ID do produto kit: 654321
Componente – Camiseta Verde ID do produto: 827813 – ID do produto kit: 654321
Componente – Camiseta Azul ID do produto: 827855 – ID do produto kit: 654321