Histórico da Página

Informações

title	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

...

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 - (integrado)
Cadastro De/Para Armazém
Cadastro De/Para Filial
Configuração Mozart

O envio da mensagem STOCKLEVEL, é realizado a cada movimentação de saldo de produto:

Inclusão para validação do saldo em estoque, e envio da mensagem única Stocklevel.
Documento de Entrada.
Inclusão Alteração e Exclusão de saldo Inicial do Produto
Inclusão Alteração e Exclusão de Transferências Simples
Movimentação Interna de Produtos
Inclusão Alteração Exclusão e Cópia de Pedido de Venda
Liberação de Regras (Faturamento de Pedido)
Prep Doc. de Saída (Faturamento de Pedido)
Carga Inicial de Produtos - Envio de Saldo de Todos os Produtos que atendam as condições definidas no Adapter da mensagem: Cadastro de Adapters / Cadastro De/Para Empresas.

1. Inclusão de Saldo Inicial - Produto Simples ( Entrada de Saldo em Estoque ):

O cadastro de Saldo inicial, atualiza o saldo inicial do produto no Protheus, e integra via mensagem única a quantidade ao sistema CIASHOP.

Pré condição: Produto já cadastrado em ambas as bases:

Incluir pela Rotina de Saldo inicial do Protheus, Saldo para o Produto já integrado.

Image Removed

Clique em Confirmar para salvar e integrar o Saldo, com o sistema da Ciashop.

...

Importante: o registro será enviado toda vez que confirmar alguma ação: Inclusão, Alteração ou Exclusão.

Registro do envio da mensagem no EAI Protheus e "Visualizar Mensagem Original"

Image Removed

...

Aguarando processamento: Indica a quantidade de processos específicos, por exemplo (Reserva) estão aguardando na fila para serem executados.
Processando: Significa que após aguardar na fila o arquivo é envidado para ser processado.
Processado: Significa que o arquivo foi processado com sucesso, como por exemplo, enviou uma reserva para o Protheus e o mesmo retorno uma mensagem de sucesso.
Error: Significa que receberá o log de erro da integração especifica, tanto ao tentar enviar quanto AguardoCallback com retorno de erro.
Reprocessar: Indica que a mensagem estava processando e teve algum tipo de erro ou uma possível instabilidade e a mensagem irá reprocessar novamente

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

maxLevel	2

Produto	Fluxo	Tipo da Mensagem	Versão MSU	Formato
TOTVS Protheus	Envia	Sincrona	3.004	JSON
TOTVS OMNI	Recebe	Sincrona	3.004	JSON

Dica

title	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

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”

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

title	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

title	Json

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