Integração MultiClubes x Estoque (Protheus)

1. VISÃO GERAL

Este manual tem a finalidade de apresentar a integração, as configurações, os cenários previstos com dados para a integração com o estoque entre os sistemas de clubes MultiClubes e o ERP Protheus.
Para a integração com o Estoque, todos os produtos são cadastrados no Protheus e enviados ao MultiVendas pelo serviço de integração do MultiClubes.
As vendas realizadas no MultiVendas serão registradas no Protheus no módulo SIGALOJA.
Toda a movimentação de estoque será gerenciada pelas mensagens de integração e registadas no módulo SIGALOJA.

2. INTEGRAÇÃO MULTICLUBES X ESTOQUE (PROTHEUS)

2.1. Pré-requisitos

Para a configuração do EAI, o webservice do Protheus já deve estar configurado e com os Jobs em execução. Não é necessária a configuração do portal. Para mais detalhes sobre a configuração de webservices no Protheus, consulte: http://tdn.totvs.com/display/public/PROT/Configurar+Portais+e+Webservices.

2.2. Configurações

2.2.1. Configurações Protheus

2.2.1.1. Schedule e E.A.I Protheus

A configuração do schedule do Protheus permite que as rotinas que fazem a integração possam ser executadas de acordo com agendamento, possibilitando que o processamento da integração seja efetuado constantemente. Isto garante o processamento de toda a fila de mensagens do EAI.
Segue exemplo de configuração do Schedule do Protheus para processamento do EAI:

2.2.1.2. Inclusão de Agents

Para cadastrar um Agent acesse, no módulo Configurador (SIGACFG), Ambiente/Schedule/Schedule. Clique em Agent/Cadastro e a tela de cadastro será apresentada. O cadastro deve ser efetuado conforme o exemplo abaixo:

2.2.1.3. Monitoramento de Agents

Nesta visão são exibidas informações sobre o status dos Agents e também sobre os eventos de cada um.

2.2.1.4. Agendamento de Rotinas no Schedule Protheus

Para cadastrar as rotinas no Schedule do Protheus acesse, no módulo Configurador (SIGACFG), Ambiente/Schedule/Schedule. Clique em agendamentos e verifique quais rotinas estão agendadas para execução.

Para esta integração, os agendamentos abaixo devem estar cadastrados:

Para mais detalhes acerca da configuração do Schedule Protheus, acesse: Schedule Protheus.

2.2.1.5. Cadastro de Adapter E.A.I

Para que a integração ocorra é necessário configurar as mensagens no cadastro de Adapters do Protheus. Para cadastrar as rotinas no Schedule do Protheus acesse, no módulo Configurador (SIGACFG), Ambiente/Schedule/Adapter E.A.I. Clique em incluir.

2.2.1.5.1. Adapter E.A.I: ITEM

Mensagem Única: 1-Sim
Rotina: MATA010
Mensagem: ITEM
Descrição: DESCRIÇÃO GENÉRICA DO PRODUTO
Envia: 1 - Sim
Recebe: 1 - Sim
Método: 1 - Síncrono
Operação: 1 - Todas
Canal Envio: 2 - EAI
Versão Envio: 4.005
Fonte: MATI010
Data: 19/09/2018 - 15:02:40

2.2.1.5.2. Adapter E.A.I: RETAILSALES

Mensagem Única: 1-Sim
Rotina: LOJA701
Mensagem: RETAILSALES
Descrição: VENDA ASSISTIDA
Envia: 2 – Não
Recebe: 1 - Sim
Método: 1 - Síncrono
Operação: 1 - Todas
Canal Envio: 2 – EAI
Versão Envio: 2.001
Fonte: LOJI701
Data: 13/08/18 - 10:56:43

2.2.1.5.3. Adapter E.A.I: STOCKLEVEL

Mensagem Única: 1-Sim
Rotina: MATA225
Mensagem: STOCKLEVEL
Descrição: CONSULTA SALDO
Envia: 1 – Sim
Recebe: 1 - Sim
Método: 1 - Síncrono
Operação: 1 – Todas
Canal Envio: 2 – EAI
Versão Envio: 3.000
Fonte: MATI225
Data: 08/14/18 - 11:52:08

2.2.1.5.4. Adapter E.A.I: STOCKTURNOVER

Mensagem Única: 1-Sim
Rotina: MATA241
Mensagem: STOCKTURNOVER
Descrição: BAIXA DE ESTOQUE
Envia: 2 – Não
Recebe: 1 - Sim
Método: 1 - Síncrono
Operação: 1 – Todas
Canal Envio: 2 – EAI
Versão Envio: 1.005
Fonte: MATI241
Data: 12/27/17 - 15:42:31

2.2.1.6. Parâmetros

Para acessar a lista de parâmetros acesse:
1- SIGACFG;
2- Ambiente > Cadastros > Parâmetros;
3- Clique na lupa e preencha o parâmetro desejado;
4- Após localizar o parâmetro desejado, clique na folha com o lápis (Editar).

2.2.1.6.1. Parâmetro MV_EAIURL2

O parâmetro MV_EAIURL2 deve ser preenchido com o canal configurado para o envio das mensagens do Protheus para o MultiClubes.

2.2.1.6.2. Parâmetro MV_TESVEND

O parâmetro MV_TESVEND deve ser preenchido com um TES de saída existente no cadastro de Tipos de Entrada e Saída (MATA080). Normalmente cadastra-se um genérico apenas para a integração do MultiClubes.

2.2.1.6.3. Parâmetro MV_TESSERV

O parâmetro MV_TESVSERV deve ser preenchido com um TES de saída existente no cadastro de Tipos de Entrada e Saída (MATA080). Normalmente cadastra-se um genérico apenas para a integração do MultiClubes.

2.2.1.7. Cadastros Básicos

2.2.1.7.1. Locais de Estoque

Para cadastrar um local de estoque no Protheus acesse:
1- SIGAEST;
2- Atualizações > Cadastros > Produto > Locais de estoque;
3- Clique em incluir.

Preencha os campos “Código” e “Descrição” e os demais campos pode deixar com o conteúdo padrão.

2.2.1.7.2. Tipos de Movimentação

Para cadastrar um Tipo de Movimentação acesse:
1- SIGAEST;
2- Atualizações > Cadastros > Movimentações > Internas;
3- Clique em Incluir.

Preencha os campos conforme orientação a seguir:
1- Para Devolução:

Código: 001(Ou algum <= 500)
Tipo TM: D – Devolução
Descrição: Entrada Multiclubes
Aprop. Indir.: Não
Atu. Empenho: Não
Transf. MOD: Não
Valorizado: Não
Envia p/CQ: Não
Libera PV: Não
Qtd Zero: Não
Custeia OP: Não
Cod.Cat83:<branco>

2- Para Requisição:

Código: 501(Ou algum > 500)
Tipo TM: R – Requisição
Descrição: Saída Multiclubes
Aprop. Indir.: Não
Atu. Empenho: Não
Transf. MOD: Não
Valorizado: Não
Envia p/CQ: Não
Libera PV: Não
Qtd Zero: Não
Custeia OP: Não
Cod.Cat83:<branco>

2.2.2. Configurações MultiClubes

Todas as configurações e operações relacionadas à integração ERP do MultiClubes se encontram em Administração > Integração ERP.

2.2.2.1. Conexão

2.2.2.1.1. Base Tanque

Para a configuração de conexão e tipo de integração acesse Editar > Configurações.

Informe os dados para a integração conforme as informações a seguir:

Até este ponto o MultiClubes integra os movimentos com o banco de integração. A partir desse ponto será realizada a configuração para o envio das informações da base tanque para o Protheus.

2.2.2.1.2. Conexão E.A.I. do Protheus

Para a configuração de conexão com o serviço do Protheus acesse Editar > Propriedades.

Informe os parâmetros para a integração do Protheus conforme os dados a seguir:

2.2.3. Configurações MultiVendas

Para acessar as configurações de integração ERP no MultiVendas acesse Sistema > Configurações do sistema, depois clique na aba “Integração ERP”.

2.2.3.1. Locais de Estoque

Para configurar o local de estoque do Protheus em que os produtos da loja definida serão baixados, clique em Lojas e estoques e preencha os campos:

Código da loja: Código da loja no MultiClubes que será considerada na mensagem enviada.
Código estoque: Código do local de estoque cadastrado no Protheus em que os produtos serão baixados.

2.2.3.2. Unidades de Medida

As unidades de medida não possuem tratamento especial. Visto que os produtos no MultiVendas são tratados pela unidade de venda. Os cadastros do Protheus devem seguir o mesmo padrão na primeira unidade de medida para que não haja divergência de saldos.

2.3. Cenários de Testes

2.3.1. Integração de Produtos

No Protheus, em um módulo diferente do SIGALOJA, inclua um produto. Os campos necessários para que o MultiVendas efetue a venda são: Código, Descrição, Unidade, Preço de Venda, Pos.IPI/NCM e CEST, caso o produto possua substituição tributária. Na maior parte dos módulos o caminho é Atualizações > Cadastros > Produtos.

Pasta Cadastrais:

Pasta Impostos:

Pasta Outros:

Acessar o MultiVendas e verificar se o produto foi integrado:

2.3.2. Integração de Vendas

2.3.2.1. Cenário 01

Venda de produto no PDV com emissão de documento fiscal e pagamento em dinheiro sem troco.
Pagamento: Dinheiro
Tipo de produto: Produto
Valor: R$1,00
Quantidade: 2

Previsão:

Pagamento:

Recebimento:

2.3.2.2. Cenário 02

Venda de produto no PDV com emissão de documento fiscal e pagamento em dinheiro com troco.
Pagamento: Dinheiro
Tipo de produto: Produto
Valor: R$1,00
Valor pago: R$2,00
Troco: R$1,00
Quantidade: 1

2.3.2.3. Cenário 03

Venda de produto no PDV com taxa de acréscimo, emissão de documento fiscal e pagamento em dinheiro com troco.
Pagamento: Dinheiro
Tipo de produto: Produto
Valor: R$ 1,00
Acréscimo: 10%
Valor pago: R$2,00
Troco: R$0,90
Quantidade: 1

2.3.2.4. Cenário 04

Venda de produto no PDV com desconto sobre o total, emissão de documento fiscal e pagamento em dinheiro sem troco.
Pagamento: Dinheiro
Tipo de produto: Produto
Valor: R$ 1,00
Desconto: R$0,50
Valor pago: R$0,50
Quantidade: 1

2.3.2.5. Cenário 05

Venda de produto no PDV com taxa de acréscimo, desconto sobre o total, emissão de documento fiscal e pagamento em dinheiro sem troco.
Pagamento: Dinheiro
Tipo de produto: Produto
Valor: R$ 1,00
Acréscimo: 10%
Desconto: 5%
Valor pago: R$1,05
Quantidade: 1

2.3.2.6. Cenário 06

Cancelamento da última venda.
Pagamento: Dinheiro
Tipo de produto: Produto
Valor: R$ 1,00
Acréscimo: 10%
Desconto: 5%
Valor pago: R$1,05
Quantidade: 1

3. MENSAGENS HOMOLOGADAS