Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Informações
titleImportante!

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.

Índice
maxLevel2

ProdutoFluxoTipo da MensagemVersão MSUFormato
TOTVS ProtheusEnviaSincrona3.004JSON
TOTVS OMNIRecebeSincrona3.004JSON
Dica
titleDica!

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?

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

  1. No modulo Configurador (SIFACFG), acesse Ambientes/Schedule/Adapter E.a.i

  2. Clique em incluir e cadastre a rotina responsável pela mensagem StockLevel, como mostra o vídeo abaixo:

Conector de Widget
width600
urlhttps://www.youtube.com/watch?v=F_svqGhH12M
height400


Informações
titleAuxilio no preenchimento dos campos

Rotina Protheus

Mensagem

Descrição

Envia

Recebe

Método Protheus

Operação

Condição de envio

Canal de Envio

VersãoAliasRotaFormato
MATA225StocklevelSaldo de ProdutoSimNãoAssíncronoTodas
PAD.APP3.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 

  1.  No Configurador ( SIGACFG) acesse Schedule / Agent. 
  2. 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: 
  3. Para criar um novo agente, clique na opção “Cadastro”

Aguardando UPLOAD do Vídeo


Informações
titleAuxilio 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

  1. No Estoque/Custos (SIGAEST) acesse Atualizações / Saldos / Inicial (MATA220).
  2. Inclua o saldo inicial para o produto com as informações necessárias, como mostra o vídeo abaixo:

Conector de Widget
width600
urlhttps://www.youtube.com/watch?v=UWFQOkOdl1o
height400


Dica
titleDica!

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
titleVisualizar 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:


  1. Acesse o ambiente Configurador (SIGACFG) em Ambiente/Schedule/Schedule, opção EAI:
  2. 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:

Conector de Widget
width600
urlhttps://www.youtube.com/watch?v=qBnfiEe320g
height400


Expandir
titleExemplo da mensagem StockLevel
Bloco de código
titleJson
Inserir json de StockLevel

Demais informações

Dica
titleFluxo 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
titleLegendas 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

Dica
titleVamos lá!

Após integrar um Produto, vamos para o próximo passo, Integrando Preços