Importante!
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.
Produto | Fluxo | Tipo da Mensagem | Versão MSU | Formato |
---|---|---|---|---|
TOTVS Protheus | Envia | Sincrona | 3.004 | JSON |
TOTVS OMNI | Recebe | Sincrona | 3.004 | JSON |
Dica!
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.
Cadastro do adapter StockLevel
No modulo Configurador (SIFACFG), acesse Ambientes/Schedule/Adapter E.a.i
Clique em incluir e cadastre a rotina responsável pela mensagem StockLevel, como mostra o vídeo abaixo:
Auxilio no preenchimento dos campos
Rotina Protheus | Mensagem | Descrição | Envia | Recebe | Método Protheus | Operação | Condição de envio | Canal de Envio | Versão | Alias | Rota | Formato |
MATA225 | Stocklevel | Saldo de Produto | Sim | Não | Assíncrono | Todas | PAD.APP | 3.004 | SB2 | SUA_ROTA | JSON |
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.
Cadastro do agendamento do SCHEDESTMG
- No Configurador ( SIGACFG) acesse Schedule / Agent.
- Essa tela lista todos os agentes cadastrados e as tarefas atribuídas a cada um. Aqui é possível inicializar ou parar os agentes (todos ou de cada vez) através da seguinte barra de opções:
- Para criar um novo agente, clique na opção “Cadastro”
Auxilio no preenchimento dos campos
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.
Cadastro e integração do Saldo em estoque
- No Estoque/Custos (SIGAEST) acesse Atualizações / Saldos / Inicial (MATA220).
- Inclua o saldo inicial para o produto com as informações necessárias, como mostra o vídeo abaixo:
Dica!
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.
Mensagem gerada e enviada para o TOTVS OMNI
Visualizar o dado gerado
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:
- Acesse o ambiente Configurador (SIGACFG) em Ambiente/Schedule/Schedule, opção EAI:
- Em seguida posicione o cursos na mensagem gerada e clique no ícone da Lupa e em seguida, Visualizar mensagem original, como mostra o vídeo abaixo:
Demais informações
Fluxo da integração de Saldo de Produto
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.
Legendas de status da mensagem
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
Próximo passo
Vamos lá!
Após integrar o saldo em estoque de um produto, vamos para o próximo passo, Integrando Preços