O cadastro de Saldo de estoque será atualizado no sistema TOTVS Protheus, e será integrado com o sistema TOTVS OMNI através de comunicação de Mensagem Única.

Caso queira verificar os campos que compõem a mensagem de Saldo de estoque, acesse  https://api.totvs.com.br/legado  Clique no Link: Mensagem Padronizada, depois em  Lista de Serviços e busque a mensagem Stocklevel.

Através dessa documentação vamos te ajudar a integrar o Saldo em estoque de produto entre TOTVS Protheus e TOTVS OMNI.

Antes de realizar a integração de um saldo em estoque, vamos realizar o cadastro do Adapter no modulo Configurador (SIGACFG).

• Mas afinal o que é um Adapter?

O  Adapter é uma rotina responsável pela mensagem (StockLevel) e seu cadastro é necessário para definir algumas informações importantes, como por exemplo, o tipo da mensagem JSON ou XML, se será possível enviar e receber a mensagem ou somente uma dessas opções.

Também vamos precisar realizar o cadastro da rotina SCHEDESTMG, como um agendamento no schedule do TOTVS Protheus, abaixo o exemplo.

• Importante: Como pré-requisito para o cadastro do Adapter é imprescindível ter o Cadastro de Rota.

Importante: O campo Condição de envio pode ser preenchido com uma função ou expressão logica, para determinar se o saldo em estoque do produto em questão será enviado ou não.

Importante: Para mais informações do cadastro do agendamento da rotina SCHEDESTMG.

• Código: Valor sequencial que representa o identificador único desse agente no sistema. Ele é preenchido automaticamente.

• Usuário: Usuário do Protheus que será utilizado para inicializar o processo.

• Nome do usuário: Nome do usuário no sistema. É preenchido à partir do Usuário selecionado no campo anterior.

• Rotina: SCHEDESTMG ( Rotina de geração de mensagens STOKCLEVEL do EAI Protheus).

• Data: Qual a data da execução do agendamento.

• Hora: Qual a hora em que a função será executada.

• Empresa/Filial: Qual empresa e filial será aberta no momento da execução. Novamente, repare que esses campos não invalidam funcionalidades que abram e utilizem um ambiente diferente.
• Módulo: Qual o módulo do Protheus que será utilizado na execução do agendamento. Essa informação é importante pois interfere na forma como o Protheus irá consumir as licenças disponíveis para a execução do job.
• Nome do Módulo: O nome do módulo selecionado no campo anterior e é preenchido automaticamente.
• Habilitada:Flag que determina se a execução do agendamento está habilitada ou não.
• Descrição: Descrição livre sobre o agendamento.

O que o saldo inicial precisa ter para ser integrado com o TOTVS OMNI corretamente?

• O produto deve estar integrado corretamente com o TOTVS OMNI.

O saldo em estoque será integrado somente na inclusão do Saldo Inicial?

• Não, qualquer tipo de movimentação no saldo em estoque do produto será integrado, desde que os campos  B2_DMOV + B2_HMOV  tenha seu conteúdo maior ou igual aos campos B2_DULT + B2_HULT .

Já tenho diversos saldos de estoque que atende os dados informados acima e quero integra-los, o que eu faço?

Neste caso deve ser realizado a execução da Carga inicial.

Após realizar a inclusão do saldo inicial e suas demais informações necessárias para integra-lo é possível visualizar a mensagem gerada e enviada para o TOTVS OMNI, para isso siga o passo a passo abaixo:

Após realizar a inclusão do Saldo inicial ou movimentação do estoque no TOTVS Protheus será gerado a mensagem StockLevel no EAI do configurador, essa mensagem é disparada ao TOTVS OMNI através da ROTA cadastrada e vinculado ao Adapter ITEM.

Quando recepcionado e processada a mensagem StockLevel pelo TOTVS OMNI, o mesmo retorna uma mensagem para o Protheus informando sucesso ou falha na integração, que também pode ser visualizada no monitor do EAI.

A mensagem pode ter diversos tipos de status e cada um deles esta vinculado a uma legenda sendo elas:

Aguardando execução

Executando

Finalizada

Falhou

Bloqueado

Não entregue

Recusada

Entregue

Após integrar o saldo em estoque de um produto, vamos para o próximo passo, Integrando Preços