O cadastro de Saldo de estoque será atualizado no sistema Protheus, e será integrado com o sistema VTEX 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.
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
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.
Abaixo está ilustrado dois exemplos de movimentações de estoque, sendo (01) uma movimentação de entrada de quantidade no Estoque, e (01) uma movimentação de saída de quantidade do Estoque.
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 VTEX.
Pré condição: Produto já cadastrado em ambas as bases:
Incluir pela Rotina de Saldo inicial do Protheus, Saldo para o Produto já integrado.
Clique em Confirmar para salvar e integrar o Saldo, com o sistema da VTEX.
Verificação da integração via Mensagem Única
Conferir os envios de mensagens no caminho abaixo :
Pelo configurador, em Schedule:
Acessar SIGACFG / Configurador / Ambiente / Schedule / Schedule, selecionar EAI na coluna esquerda.
Na coluna direita em Transações, selecionar uma mensagem (legenda cor Cinza - Finalizada) no browse e após clicar na lupa e selecionar “ Visualizar Mensagem Original”, onde será aberto o arquivo XML com os dados da tag.
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 Clicar na Lupa e "Visualizar Mensagem Original"
- VTEX - Recebimento
No sistema VTEX - Manager, através do menu da esquerda, entrar em:
Catálogo / Produtos e SKUs
Selecionar o Produto que foi integrado o Saldo em Estoque, e clicar em "Visualizar Estoque (logístics)"
É demonstrado as quantidades integradas de todos os armazéns do Produto.
Nesse momento, somos redirecionados para a seção de Estoque & Entrega / Painéis, mas diretamente aos detalhes daquele produto. Também seria possível acessá-lo diretamente através desse caminho.
Protheus – Recebimento da Response Message (Mensagens assíncronas)
Recebimento de respostas
- Sucesso: Indica que a mensagem foi processada com sucesso pela VTEX e já esta no Manager do E-Commerce.
- Erro: Indica que a mensagem teve erro ao ser processada, e o motivo do erro esta descrito na mensagem de resposta da VTEX.
Mensagem única do STOCKLEVEL
Selecionar a mensagem desejada, clicar na Lupa e clique na opção Visualizar Mensagem Original:
Código da Função: STOCKLEVEL
Descrição da Mensagem: TotvsMessage STOCKLEVEL Response Message
Tipo da Trasação: Recebimento
Tipo da Mensagem: Response Message
UUID da Mensagem Original: 0daa55f5-49b4-4dd4-8dbb-403e1b2a2755
2 - Faturamento de Pedido - ( Saída de Saldo em Estoque )
Pré condição: Produto já integrado.
Incluir Pedido de Vendas.
Clicar em Salvar
Passo a passo - Liberação de Regras:
Selecionar o Pedido de Vendas gerado
Clicar e Outras Ações
Realizar a Prep de Doc de Saída - Clicando em AVANÇAR
Realizar a liberação de Crédito e Estoque:
Atualizações/Pedidos/Liberação de Crédito e Estoque
Liberar Todos
Resultado esperado:
Conferir tabela SB2 (Saldos Fisico e Financeiro) no Protheus e Quantidade Pedido de Vendas/Empenhada
Verificação da integração via Mensagem Única:
Conferir os envios de mensagens no caminho abaixo :
Pelo configurador, em Schedule:
Acessar SIGACFG / Configurador / Ambiente / Schedule / Schedule, selecionar EAI na coluna esquerda.
Na coluna direita em Transações, selecionar uma mensagem (legenda cor Cinza - Finalizada) no browse e após clicar na lupa e selecionar “ Visualizar Mensagem Original”, onde será aberto o arquivo XML com os dados da tag.
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 clique na Lupa, e "Visualizar Mensagem Original"
Passo a passo - Faturamento do Pedido de Venda Sem Bloqueio de Regras:
Atualizações/Pedidos/Pedidos de Venda
Selecionar o Pedido de Vendas Sem Bloqueios a Faturar
Clicar e Outras Ações
Realizar a Prep de Doc de Saída - Clicando em AVANÇAR
Selecionar o número e série de NF a ser gerada, Clicar em OK
Verificação da integração via Mensagem Única
Conferir os envios de mensagens no caminho abaixo :
Pelo configurador, em Schedule:
Acessar SIGACFG / Configurador / Ambiente / Schedule / Schedule, selecionar EAI na coluna esquerda.
Na coluna direita em Transações, selecionar uma mensagem (legenda cor Cinza - Finalizada) no browse e após clicar na lupa e selecionar “ Visualizar Mensagem Original”, onde será aberto o arquivo XML com os dados da tag.
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 clicar na Lupa e "Visualizar Mensagem Original"
A mensagem será atualizada com as TAGs alteradas:
- VTEX - Recebimento
No sistema VTEX, seguir o mesmo caminho exemplificado no fluxo anterior para verificar a diminuição da quantidade de produtos em estoque.
Protheus – Recebimento da Response Message (Mensagens assíncronas)
Recebimento de respostas
- Sucesso: Indica que a mensagem foi processada com sucesso pela VTEX e já esta no Manager do E-Commerce.
- Erro: Indica que a mensagem teve erro ao ser processada, e o motivo do erro esta descrito na mensagem de resposta da VTEX.
Mensagem única do STOCKLEVEL
Selecionar a mensagem desejada, clicar na Lupa e clique na opção Visualizar Mensagem Original:
Código da Função: STOCKLEVEL
Descrição da Mensagem: TotvsMessage STOCKLEVEL Response Message
Tipo da Trasação: Recebimento
Tipo da Mensagem: Response Message
UUID da Mensagem Original: 0daa55f5-49b4-4dd4-8dbb-403e1b2a2755