Á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 ProtheusEnviaSincrona43.005 API004JSON
TOTVS OMNIRecebeSincrona43.005004JSON
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 modulo Configurador (SIFACFG), acesse Ambientes/Schedule/Adapter E.a.i

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

...

titleAssistir o vídeo

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.000004

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 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”

...

titleAssistir o vídeo

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

...


Informações
titleAuxilio no preenchimento dos campos

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


  • Código: Valor  Valor sequencial que representa o identificador único desse agente no sistema. Ele é preenchido automaticamente.
  • Usuário: Usuário do Protheus que  que será utilizado para inicializar o processo.

  • Nome do usuário: Nome do usuário no sistema. É preenchido à partir do Usuário selecionado  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  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  O nome do módulo selecionado no campo anterior e é preenchido automaticamente.
  • Habilitada:Flag que  que determina se a execução do agendamento está habilitada ou não.
  • Descriçã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:

...

titleAssistir o vídeo

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 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  para isso siga o passo a passo abaixo:


  1. Acesse o ambiente Configurador (SIGACFG) em em Ambiente/Schedule/Schedule, opção EAI EAI:
  2. Em seguida posicione o cursos na mensagem gerada e clique no ícone da Lupa da Lupa Image Modified e em seguida, Visualizar mensagem original, como  como mostra o vídeo abaixo:

...

titleAssistir o vídeo

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

...


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

...

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:

Image Modified Aguardando execução

Image Modified Executando

Image Modified Finalizada

Image Modified Falhou

Image Modified Bloqueado

Image Modified Não entregue

Image Modified Recusada

Image Modified Entregue


Próximo passo

Dica
titleVamos lá!

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