| Informações |
|---|
|
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 |
...
Pré-requisitos:
- Configuração do adapter Stocklevel. Para detalhes, acesse o link: Cadastro de Adapters / Cadastro De/Para Empresas.
Importante 
- Configuração do Envio ativo para produtos com estoque alterado desde o último envio, acesse o link: SCHEDESTMG
- Cadastro de Produto - ITEM
- Cadastro De/Para Armazém
- Cadastro De/Para Filial
- Configuração Mozart
...
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:
| Conector de Widget |
|---|
| width | 600 |
|---|
| url | https://www.youtube.com/watch?v=F_svqGhH12M |
|---|
| height | 400 |
|---|
|
| Informações |
|---|
| title | 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 | | 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”
| Conector de Widget |
|---|
| width | 600 |
|---|
| url | https://www.youtube.com/watch?v=wO6_4UKhIHw |
|---|
| height | 400 |
|---|
|
| Informações |
|---|
| title | 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:
| Conector de Widget |
|---|
| width | 600 |
|---|
| url | https://www.youtube.com/watch?v=UWFQOkOdl1o |
|---|
| height | 400 |
|---|
|
| 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
| Dica |
|---|
| title | 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
Image Added e em seguida, Visualizar mensagem original, como mostra o vídeo abaixo:
| Conector de Widget |
|---|
| width | 600 |
|---|
| url | https://www.youtube.com/watch?v=qBnfiEe320g |
|---|
| height | 400 |
|---|
|
| Expandir |
|---|
| title | Exemplo da mensagem StockLevel |
|---|
|
| Bloco de código |
|---|
| Inserir json de StockLevel |
|
Demais informações
| Dica |
|---|
| title | 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. |
| Informações |
|---|
| title | Legendas de status da mensagem |
|---|
|
A mensagem pode ter diversos tipos de status e cada um deles esta vinculado a uma legenda sendo elas: Image Added Aguardando execução
Image Added Executando
Image Added Finalizada
Image Added Falhou
Image Added Bloqueado
Image Added Não entregue
Image Added Recusada
Image Added Entregue
|
Próximo passo
| Dica |
|---|
|
Após integrar o saldo em estoque de um produto, vamos para o próximo passo, Integrando Preços |
Importante: o registro será enviado toda vez que confirmar alguma ação: Inclusão ou Exclusão de uma nota de entrada, nota de saida ou movimentação de estqoue.
Registro do envio da mensagem no EAI Protheus e "Visualizar Mensagem Original"
...